feat(hdl): Add rocket-chip AsyncQueue and smoke test

This commit introduces the `AsyncQueue` from the `chipsalliance/rocket-chip`
library to handle asynchronous clock domain crossings.

The key changes are:
- Added `rocket-chip` and `diplomacy` as external dependencies.
- Created a `chisel_library` for the `AsyncQueue` module and its
  dependencies from `rocket-chip`.
- Added `AsyncQueueSmokeTest.scala`, a ChiselSim-based smoke test that
  verifies the functionality of the `AsyncQueue` by passing a value
  between two different clock domains. The test also enables VCD waveform
  dumping for easier debugging.
- Updated the `chisel_library` Bazel rule to allow suppressing fatal
  warnings, which was necessary for the `rocket-chip` library.

This provides a robust and tested solution for handling asynchronous
FIFOs in the Chisel design.

Change-Id: I53ee24a52852ebd49f27a3e2f6792b88a828f978
5 files changed
tree: 7bb5f132f530d037b65753c50906b211aaa96250
  1. doc/
  2. examples/
  3. external/
  4. fpga/
  5. hdl/
  6. hw_sim/
  7. kelvin_test_utils/
  8. lib/
  9. platforms/
  10. rules/
  11. tests/
  12. third_party/
  13. toolchain/
  14. utils/
  15. .bazelrc
  16. .bazelversion
  17. .gitignore
  18. CONTRIBUTING.md
  19. LICENSE
  20. PREUPLOAD.cfg
  21. README.md
  22. WORKSPACE
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.

Building

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