1. build a test program image to run as a memory image (see .`./tools/setup_ds5_tools.scr` for example of setting up the environment variables to run the Arm DS tools available through AAA)
2. compile the rtl simulation target using the appropriate makefile target for the isntalled simulator (mti_sim in this example)
3. run the simulator with the pre-built test code
```
make code TESTNAME=hello (or another test from the `../testcodes/` directory)
make compile_mti
make run_mti TESTNAME=hello
```
As well as the simulation transcript the following log files are produced:
```
uart2.log -- ASCII character strings output from 'stdout' on UART2
tarmac0.log -- Instruction trace for the Cortex-M0 CPU executing the test code
tarmac1.log -- (instruction trace for a Cortex-M0 running the debug tester)
```
The directory can be cleaned up after running tests using:
```
make clean
```
## Getting to understand the microcontroller design:
The design has been documented using a _verilog-to-HTML_ tool; if the `../v2html_doc.tgz` file is decompressed and unpacked an HTML directory is built (`../v2html_doc`) which can then be inspected with a web browser: