Google Git
Sign in
opensecura / sw / kelvin / 2d626f6ddf974a1f79be9e75d8257f12c7481752
commit2d626f6ddf974a1f79be9e75d8257f12c7481752[log] [tgz]
authorMichael Brooks <michaelbrooks@google.com>Mon May 06 20:17:46 2024 +0000
committerMichael Brooks <michaelbrooks@google.com>Tue May 07 19:04:57 2024 +0000
tree49c03573f56a09f013284bd2abb90cbc2b77e3c5
parentbe4ab9792ceddb48f6bcd49f10f795b50d00b6c5 [diff]
Support running a different Kelvin benchmark binary

Allow passing in of 'kelvin_benchmark_info' which is a dictionary
that contains the needed info for the kelvin_binary (e.g srcs).
This allows the benchmark to run a different Kelvin binary while
still keeping the SEC and SMC ones the same.

Tested:
best_of_times, silence with ISS+FPGA

Change-Id: Iabba3fd2e19524a66c3f530f095828e5201d0e9c
3 files changed
tree: 49c03573f56a09f013284bd2abb90cbc2b77e3c5
  1. benchmarks/
  2. build_tools/
  3. crt/
  4. docs/
  5. examples/
  6. host_tools/
  7. platforms/
  8. tests/
  9. tflm/
  10. third_party/
  11. toolchains/
  12. .bazelrc
  13. .bazelversion
  14. .gitignore
  15. CONTRIBUTING.md
  16. LICENSE
  17. PREUPLOAD.cfg
  18. README.md
  19. WORKSPACE
README.md

Kelvin SW Repository

This project contains the BSP to build the SW artifact that can run on the Kelvin core, and integrated as part of the Shodan repository.

The project supports two build systems -- Bazel and CMake -- for OSS integration reasons. Bazel is used by TFLM flow, while CMake is the build system for IREE.

Prerequisite

If you get this project from Project Shodan manifest, you are all set. If not, you need to have following projects as well to build the project successfully.

  • Kelvin crosscompile toolchain: Under <dir>/cache/toolchain_kelvin

This project needs to be at <dir>/sw/kelvin.

Code structure

  • build_tools: Build tool/rules for both Bazel and CMake
  • crt: Kelvin BSP
  • examples: Source code to build Kelvin SW artifacts.
  • host_tools: host tool to generate the intrinsic header and toolchain op files
  • platforms: Crosscompile platform setup for Bazel.
  • tests: Tests to exercise features of the Kelvin core.
  • tflm: Support code and optimized routines for TFLM.
  • third_party: Third party repositories for Bazel.
  • toolchains: Crosscomple toolchain setup for Bazel.

Build the project

Bazel

The project uses Bazel 5.1.1, to align with OpenTitan build system requirements.

bazel build //...

To run the unit tests (with the kelvin_sim ISS) Make sure the Environment variable $ROOTDIR is set to the root directory of the local repo (or run source build/setup.sh)

bazel test //...

CMake

TODO: Add CMake flow

Run the executable

The binaries can be simulated with the kelvin simulator, located at <dir>/sim/kelvin.

sim_kelvin <elf location>

Load the generated .bin binaries to the FPGA emulator/Renode simulator.