https://github.com/ucb-bar/gemmini-rocc-tests
Fork of seldridge/rocket-rocc-examples with tests for a systolic array based matmul accelerator
https://github.com/ucb-bar/gemmini-rocc-tests
Last synced: 2 months ago
JSON representation
Fork of seldridge/rocket-rocc-examples with tests for a systolic array based matmul accelerator
- Host: GitHub
- URL: https://github.com/ucb-bar/gemmini-rocc-tests
- Owner: ucb-bar
- License: other
- Created: 2019-03-05T05:54:14.000Z (over 6 years ago)
- Default Branch: dev
- Last Pushed: 2025-02-15T04:42:11.000Z (4 months ago)
- Last Synced: 2025-03-30T02:06:50.763Z (2 months ago)
- Language: C
- Size: 163 MB
- Stars: 55
- Watchers: 13
- Forks: 42
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Quickstart
1. Clone submodules:
```bash
git submodule update --init --recursive
```
1. Build the tests in this repo:
```bash
./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](https://github.com/ucb-bar/esp-isa-sim). If you are using [Chipyard](https://github.com/ucb-bar/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`.
1. Run test programs on `spike`:
```bash
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:
```bash
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`.