commit	cd84f01317f602f27355c77ecbc3b557e484b15a	[log] [tgz]
author	David Gao <davidgao@google.com>	Fri Sep 19 18:39:59 2025 +0000
committer	David Gao <davidgao@google.com>	Fri Sep 19 21:02:19 2025 +0000
tree	e458cc5afff58aaae2ad0bf377abaf4a34724ff5
parent	f906d354f860f5e044a78598292a61a3e2fcf440 [diff]

tree: e458cc5afff58aaae2ad0bf377abaf4a34724ff5

README.md

Kelvin

Kelvin is a RISC-V32IM core with a custom instruction set.

Kelvin block diagram

More information on the design can be found in the overview.

Getting Started

If you are hardware engineer looking to integrate Kelvin into your design, check out our integration guide.
If you are a software engineer looking to write code for Kelvin, start with this tutorial.

Kelvin uses bazel as it's build system. The Verilated simulator for Kelvin can be generated using:

bazel build //tests/verilator_sim:core_sim

The verilog source for the Kelvin core can be generated using:

bazel build //hdl/chisel/src/kelvin:core_cc_library_emit_verilog

Verilog source for the Matcha SoC can be generated using:

bazel clean --expunge  # To generate the ToT sha
bazel build //hdl/chisel:matcha_kelvin_verilog