RUN TESTS
=========

MANUALLY
--------

* Open modelsim
* Change Directory to /sim
* run 'build ../src/Tests/testbench.pro'

AUTOMATICALLY
-------------

* Open Terminal in /sim directory
* Run 'vsim -do test_all.do'

NOTE: After some time the compilation of the simulator gets sluggisly slow.
        I noticed that deleting the Libraries and re-creating them re-vitalizes the speed
        In order to do so start a simulation (so that the Library is loaded), make sure that you end the current simulation, and type 'RemoveAllLibraries'. After a vsim re-start everything shoudl run faster

RUN ON BOARD
============

COMMUNICATE WITH BOARD
----------------------
UART:   BAUDRATE 115200, 8N1
Login:  USER=root, PASS=root
MAC:    A2:F9:79:A9:F8:10

$picocom -b 115200 -d 8 -y n -p 1 /dev/ttyUSB0

NOTE: Before unplugging the board, execute the 'halt' command to shutdown the board and prevent data corruption.

The '~/test/udp_forwarder' is used to forward UDP packets ariving at the Linux side running on the ARM processor over to the FPGA, and back out.
USAGE: ~/test/udp_forwarder ADDRESS DOMAIN_ID
ADDRESS    The SRC IPv4 Address of the FPGA implementation (In x.x.x.x format)
           NOTE: The system has to have a interface with the same address
DOMAIN_ID  The Domain ID of the FPGA implementation

RBF FILE
--------

The board automatically flashes the 'soc_system.rbf' file in the root of the SD card to the FPGA.
In order to create a *.rbf file from a *.sof file, you have to follow following instructions:
* In Quartus go to "File"->"Convert Programming Files"
* Select "Programming file type" = "Raw Binary File (.rbf)"
* Select "Mode" = "Passive Parallel x16"
* Select output file name/location
* Select the respective *.sof file in "Input files to convert"
* Click "Generate"

NOTE: Don't forget to rename the file to "soc_system.rbf" when inserting it to the SD Card 
      (All other *.rbf files are ignored. You could thus keep multiple backup files around)