# gemmini-rocc-tests

**Repository Path**: crosshairs/gemmini-rocc-tests

## Basic Information

- **Project Name**: gemmini-rocc-tests
- **Description**: Fork of seldridge/rocket-rocc-examples with tests for a systolic array based matmul accelerator
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-02-24
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## 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 `mobilenet/` will be installed in `build/mobilenet/`, 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`.