README.md 1.21 KB
Newer Older
1 2 3
Hints to get started
====================

4 5 6 7 8 9 10
Overview
--------

Most of the interesting stuff is in:

doc/        - an attempt at documenting it all
src/        - the source
11 12 13
src/vhdl    - vhdl sources
src/asm     - programs in gmpu assembly
rc/tools
14 15
test/       - testbenches

16 17 18 19 20 21 22 23 24 25 26
Tools
-----

Under tools are:

ihex2vhdl/  - a simple python script to conver ihex to vhdl rom
binutils/   - a series of patches to binutils to add gmpu support

If you want to assemble programs to run in the gmpu, you need to
compile binutils. More info is in the binutils/ subdir.

27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45
Testcases
---------

To run testcases, first make sure to run 'make all' in src/asm. A
prerequisite is to have the gmpu-elf binutils installed and in
your PATH.

Now, to run the vhdl testcases, type:

./test.sh

To run a single test with verbose output, type:

./test.sh -t test_soc -v

To run a single test in interactive modelsim, type:

./test.sh -t test_soc -m

46 47 48 49 50 51 52 53 54 55
Validation
----------

To validate the cpu, go to src/asm/validation and run make.

This will assemble a series of tests into vhdl roms, execute those
in vsim and compare the output cpu trace with the reference trace.

If any of these tests fail, the either the assembler is broken or the
cpu implementation has bugs.
56