| Line 1... |
Line 1... |
|
Code samples:
|
|
=============
|
|
|
This directory contains a few test applications that can be simulated and run
|
This 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
|
on real hardware (except for the opcode test which can only be simulated). See
|
the readme file and the makefile for each program.
|
the readme file and the makefile for each program.
|
|
|
The makefiles have been tested with the CodeSourcery toolchain for windows (that
|
The makefiles have been tested with the CodeSourcery toolchain for windows (that
|
can be downloaded from www.codesourcery.com) and with the Buildroot toolchain
|
can be downloaded from www.codesourcery.com). They should work with other
|
|
toolchains and have been occasionally tested with the Buildroot toolchain
|
for GNU/Linux.
|
for GNU/Linux.
|
|
|
Most makefiles have two targets, to create a simulation test bench and a
|
Most makefiles have two targets, to create a simulation test bench and a
|
synthesizable demo.
|
synthesizable demo.
|
|
|
Target '*_sim' (e.g. 'hello_sim') will build the simulation test bench as vhdl
|
Target 'sim' will build the simulation test bench as vhdl file
|
file '/vhdl/tb/mips_tb1.vhdl'. This is the default test bench expected by the
|
'/vhdl/tb/mips_tb2.vhdl'. This is the default test bench expected by the
|
simulation script '/sim/mips_tb1.do'.
|
simulation script '/sim/mips_tb2.do'.
|
|
|
|
Target 'demo' will build a synthesizable demo as '/vhdl/demo/mips_mpu.vhdl'.
|
|
|
|
The build process will produce a number of binary files that can be run on the
|
|
software simulator. A DOS BATCH file has been provided for each sample that
|
|
runs the simulator with the proper parameters (swsim.bat).
|
|
|
|
|
Target '*_demo' will build a synthesizable demo as '/vhdl/demo/mips_mpu.vhdl'.
|
Support code library:
|
|
=====================
|
|
|
The build process will produce two binary files '*.code' and '*.data' that can
|
Many of the code samples use support code from an ad-hoc library included with
|
be run on the software simulator:
|
the project (src/common/libsoc). Before making any of the samples you should
|
|
make the library ('make' with no target). That will build file
|
|
'src/common/libsoc/libsoc.a'.
|
|
|
slite hello.code hello.data
|
|
|
|
Plus a listing file (*.lst) handy for debugging.
|
|
|
|
|
Building VHDL code from templates:
|
|
==================================
|
|
|
The python script 'bin2hdl.py' is used to insert binary data on vhdl templates.
|
The python script 'bin2hdl.py' is used by all the samples to insert binary data
|
|
on vhdl templates.
|
Assuming you have Python 2.5 or later in your machine, call the script with
|
Assuming you have Python 2.5 or later in your machine, call the script with
|
|
|
python bin2hdl.py --help
|
python bin2hdl.py --help
|
|
|
to get a short description.
|
to get a short description.
|
