commit	b6b2707a85fb5cf72e95799aeaa3c2a3819288f1	[log] [tgz]
author	Derek Chow <derekjchow@google.com>	Thu Jul 10 16:06:42 2025 -0700
committer	Derek Chow <derekjchow@google.com>	Thu Jul 10 17:58:48 2025 -0700
tree	5ca86a321c23c4e633f0c1240d2ffc2de27162c3
parent	03723753a137f663e23b86f6a1989098c006964e [diff]

tree: 5ca86a321c23c4e633f0c1240d2ffc2de27162c3

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