Skip to content

Latest commit

 

History

History
49 lines (33 loc) · 1.92 KB

README.md

File metadata and controls

49 lines (33 loc) · 1.92 KB

CHIMERA SDK

Chimera-SDK is a bare-metal development platform for ASICs based on the Chimera architecture, a microcontroller SoC for multi-cluster, heterogeneous systems.

Chimera and Chimera-SDK are developed as part of the PULP project, a joint effort between ETH Zurich and the University of Bologna.

License

Unless specified otherwise in the respective file headers, all code checked into this repository is made available under a permissive license. All software sources are licensed under Apache 2.0 (see LICENSE) or compatible licenses, with the exception of scripts/run_clang_format.py, which is licensed under the MIT license.

Getting started

If you are working on an IIS system, you can use the preinstalled SEPP packages to add the correct versions of the RISC-V toolchain and questasim into your path. If you use bash, you might run

riscv bash

If you are not on an IIS system, please ensure a RISC-V toolchain and questa installation are available in your path by checking that the output of

which riscv32-unknown-elf-gcc

is not empty.

To build the SDK and all tests contained in the SDK, run

mkdir build && cd build
cmake -DTARGET_PLATFORM=[YOURTARGETPLATFORM]  ../
cmake --build .

The resulting binaries will be stored in build/bin, and can be used within the chimera repo as tests.

CXX Formatting

To format all source files, run

python scripts/run_clang_format.py -ir sw/

Our CI uses llvm-12 for clang-format, so on IIS machines you may run

python scripts/run_clang_format.py -ir hal/ --clang-format-executable=/usr/pack/riscv-1.0-kgf/pulp-llvm-0.12.0/bin/clang-format

python scripts/run_clang_format.py -ir targets/ --clang-format-executable=/usr/pack/riscv-1.0-kgf/pulp-llvm-0.12.0/bin/clang-format

python scripts/run_clang_format.py -ir tests/ --clang-format-executable=/usr/pack/riscv-1.0-kgf/pulp-llvm-0.12.0/bin/clang-format