Quickstart

1. Clone submodules:

   git submodule update --init --recursive

2. Build the tests in this repo:

   ./build.sh

The tests' binaries will be installed in build/. The tests whose source code can be found in bareMetalC/ will be installed in build/bareMetalC/, the tests in imagenet/ will be installed in build/imagenet/, and so forth.

To run the tests yourself on a Gemmini ISA simulator, follow these steps:

1. Install esp-isa-sim. If you are using Chipyard, then running ./scripts/build-toolchains.sh esp-tools from Chipyard's root directory will install it for you. The ISA simulator is called spike.
2. Run test programs on spike:

   cd build/bareMetalC
   spike --extension=gemmini mvin_mvout-baremetal

Writing Your Own Gemmini Tests

bareMetalC/template.c is a template Gemmini test that you can base your own Gemmini tests off of. To write your own Gemmini test, run:

cp bareMetalC/template.c bareMetalC/my_test.c

Then, add my_test to the tests list at the top of bareMetalC/Makefile. Afterwards, running ./build.sh will install my_test-baremetal in build/bareMetalC.