29 lines
1.9 KiB
Markdown
29 lines
1.9 KiB
Markdown
|
# NEORV32 Port for running the RISC-V Architecture Tests
|
||
|
|
|
||
|
|
|
||
|
|
The following tasks are executed by the device makefiles:
|
||
|
|
|
||
|
|
* replace the original processor's IMEM rtl file by a simulation-optimized IMEM (ROM!)
|
||
|
|
* `sed` command is used to modify the default testbench (`neorv32/sim/neorv32_tb.simple.vhd`):
|
||
|
|
* enable/disable the required `CPU_EXTENSION_RISCV_xxx` VHDL configuration generics in the testbench (`neorv32/sim/neorv32_tb.simple.vhd`)
|
||
|
|
* set the processor memory configuration
|
||
|
|
* compile test code and install application image to processor's `rtl/core` folder
|
||
|
|
* compilation uses the `link.imem_rom.ld` linker script as default; code (the test code) is executed from simulation-optimized IMEM (which is read-only); data including signature is stored to DMEM
|
||
|
|
* certain areas in the DMEM are initialized using port code in `model_test.h` (`RVTEST` = 0xbabecafe and `SIGNATURE` = 0xdeadbeef); can be disabled using `RISCV_TARGET_FLAGS=-DNEORV32_NO_DATA_INIT`
|
||
|
|
* the processor is simulated using the default testbench
|
||
|
|
* the results are dumped via the SIM_MODE feature of UART0
|
||
|
|
* the according code can be found in the `RVMODEL_HALT` macro in `model_test.h`
|
||
|
|
* data output (the "signature") is zero-padded to be always a multiple of 16 bytes
|
||
|
|
|
||
|
|
|
||
|
|
**Notes**
|
||
|
|
|
||
|
|
:warning: The `Zifencei` test requires the r/w/e capabilities of the original IMEM rtl file.
|
||
|
|
Hence, the original file is restored for this test. Also, this test uses `link.imem_ram.ld` as linker script since the
|
||
|
|
IMEM is used as RAM to allow self-modifying code.
|
||
|
|
|
||
|
|
:information_source: The `RVMODEL_BOOT` macro in `model_test.h` provides a simple "dummy trap handler" that just advances
|
||
|
|
to the next instruction. This trap handler is required for some `C` tests as the NEORV32 will raise an illegal instruction
|
||
|
|
exception for **all** unimplemented instructions. The trap handler can be overriden (by changing `mtval` CSR) if a test
|
||
|
|
uses the defualt trap handler of the test framework.
|