This is a virtual processor (VProc) based test bench, created from the template in the fw_development_tools repository (git@hydra:GIS_Embedded_Logic/fw_development_tools.git). This is documented on confluence at:
https://confluence.gisapps.co.uk/display/EL/Testbench+Template+with+VProc
It is recommended to read this document if you are unfamiliar with this type of test bench. Additional documents for this specific repository, if available, would be located in <reporoot>/firmware/top/doc. The following is a list of setup requirements with links to the relevant sections of the document.
1. Link to generic_ip
If just checked out a new repostitory a link must be made to a EL-GENERIC-IP repostory (git@hydra:GIS_Embedded_Logic/EL-GENERIC-IP.git). See:
https://confluence.gisapps.co.uk/display/EL/Testbench+Template+with+VProc#TestbenchTemplatewithVProc-GenericIP
2. Cutomising makefile
The makefile has defaults for the location of things like the modelsim root directory, or the genric library. These may need customising to the local set up if different from the defaults. See:
https://confluence.gisapps.co.uk/display/EL/Testbench+Template+with+VProc#TestbenchTemplatewithVProc-Customisingthetestbench
3. Compilation dependencies
If not done already, MinGW (in repo git@hydra:GIS_Embedded_Logic/mingw.git) must be available to compile the test bench. See:
https://confluence.gisapps.co.uk/display/EL/Testbench+Template+with+VProc#TestbenchTemplatewithVProc-CompilationTools
4. Running tests
When the setup is correct, from this directory (in cmd shell or equivalent) various commands are available to build and run the simulation. See:
https://confluence.gisapps.co.uk/display/EL/Testbench+Template+with+VProc#TestbenchTemplatewithVProc-Commands