commit	a48057d149e6c5c22f11dd62e728155c68a9c04f	[log] [tgz]
author	Derek Chow <derekjchow@google.com>	Tue Jul 29 16:54:11 2025 -0700
committer	Derek Chow <derekjchow@google.com>	Tue Jul 29 16:54:11 2025 -0700
tree	6f84e708a09e0ff178d2fed826a811d5be4c2850
parent	1561552b7494b62189413b3a2f8f8427c02c9643 [diff]

tree: 6f84e708a09e0ff178d2fed826a811d5be4c2850

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