Contents at a glance:

• .gitignore - helps Git ignore junk like generated files, build products, and temporary files.
• build.sc - instructs mill to build the Chisel project
• Makefile - rules to call mill
• playground/src - source directory
• playground/src/Elaborate.scala - wrapper file to call chisel command with the target module
• playground/test/src - tester directory
• playground/sim/src - simulation directory
• playground/sim/Elaborate.scala - wrapper file to call chisel command with the simulation module

First, install mill by referring to the documentation here.

To run all tests in this design (recommended for test-driven development):

make test

To generate Verilog:

make verilog

To run simple test:

make sim

To load program from bin and run test, copy $BIN-$ISA-nemu.bin to playground/sim/bin/, and run:

make BIN=$BIN [ISA=$ISA] sim

If ISA is not specified, it defaults to riscv64.

To disable difftest, run:

make BIN=$BIN DIFF=0 sim