Subversion Repositories ion

\chapter{Code samples}

\label{samples}

    Directory /src directory contains a few test applications that can be

    simulated and run on real hardware, except for the opcode test which can

    only be simulated. See the readme file and the makefile for each program.\\

    Please read the /src/reame.txt file for information that will probably be

    more up-to-date than this doc.\\

    The makefiles have been tested with the CodeSourcery toolchain for windows

    (that can be downloaded from www.codesourcery.com) and with the Buildroot

    toolchain for GNU/Linux.\\

    Most makefiles have two targets, to create a simulation test bench and a

    synthesizable demo.\\

    Target 'sim' will build the simulation test bench package files as described

    in section~\ref{logic_simulation}.

    Target 'demo' will build a synthesizable demo; it will compile the sample

    sources and place the resulting object code in file

    '/vhdl/demo/code\_rom\_pkg.vhdl' (note that the 'sim' target has to do this

    too).\\

    The build process will produce two or more binary files ('*.code' and

    '*.data', or '*.bin') that can be run on the software simulator, plus a

    listing file (*.lst) handy for debugging.\\

    All projects include a DOS batch file 'swsim.bat' that invokes the

    software simulator with the proper parameters. As an example, these are the

    contents of the 'swsim.bat' file for the 'hello' demo:

    \begin{verbatim}

    @rem Run software simulator in hands-off mode

    ..\..\tools\slite\slite\bin\Debug\slite.exe ^

        --bram=hello.code ^

        --trigger=bfc00000 ^

        --noprompt ^

        --nomips32 ^

        --map=hello.map ^

        --trace_log=trace_log.txt

    \end{verbatim}\\

    As you can see, the simulator is invoked in 'batch' or 'hands-off' mode, so

    the simulated program will be run to completion, generating a simulation

    log. The point of this is comparing that log to the log generated by the

    Modelsim simulation of the same program, as has already been explained.

    The python script 'bin2hdl.py' is used to insert binary data on vhdl

    templates.

    Assuming you have Python 2.5 or later in your machine, call the script with:

    \begin{verbatim}

    python bin2hdl.py --help

    \end{verbatim}\\

    to get a short description (see section~\ref{python_script}).