Upgrade the bootcamp to Chisel 7

Merged
JS
4d ago
+3626-1795

Moves the notebooks and the whole toolchain from Chisel 3.6 to Chisel 7.16 (Scala 2.13.18, CIRCT firtool 1.160, ChiselSim on Verilator 5, almond 0.14.5), the same stack as CoralNPU and A-Minimal-Chisel-Project. chiseltest is replaced by ChiselSim (2.6_chiseltest.ipynb becomes 2.6_chiselsim.ipynb), FixedPoint and dsptools are replaced by SInt and small typeclasses written in the notebooks, the rocket-chip AXI4 section is dropped, and module 4 now teaches the CHIRRTL text and the CIRCT flow because the Scala FIRRTL library no longer exists. runtest.py now drives the Scala kernel with jupyter_client; the Dockerfile (Alpine 3.22, JDK 17, Verilator, preinstalled firtool), Binder, Install.md, README and the GitHub Actions workflow (ubuntu-24.04, newer action majors, dependabot, an offline smoke test) are updated to match.

Verified: all 19 notebooks run with runtest.py and report only the intended exercise errors; tests/test_visualizer.py passes; the amd64 image passes runtest.py on 0_demo, 2.1, 2.6 and 4.1 with --network none. Not verified: the arm64 image (firtool runs under qemu-user), Binder, and the bumped Actions majors.


Summary by cubic

Upgrades the bootcamp from Chisel 3.6 to Chisel 7.16, putting it on the same stack as CoralNPU and A-Minimal-Chisel-Project (Scala 2.13.18, CIRCT firtool 1.160, ChiselSim on Verilator 5, almond 0.14.5).

Migration

  • chiseltest is replaced by ChiselSim; 2.6_chiseltest.ipynb becomes 2.6_chiselsim.ipynb and tests use simulate(...).
  • FixedPoint and dsptools are removed; notebooks use SInt and small typeclasses written inline.
  • The rocket-chip AXI4 section is dropped.
  • Module 4 now teaches the CHIRRTL text and the CIRCT flow because the Scala FIRRTL library no longer exists.
  • runtest.py drives the Scala kernel with jupyter_client.
  • The Dockerfile (Alpine 3.22, JDK 17, Verilator, preinstalled firtool), Binder, Install.md, README, and the GitHub Actions workflow (ubuntu-24.04, newer action majors, dependabot, an offline smoke test) are updated.

Verification

  • All 19 notebooks run and report only the intended exercise errors; tests/test_visualizer.py passes.
  • Review findings are fixed: the 2.1 solutions use simulate, DecoupledGcd finishes when either operand is zero, the 4.x helpers treat extmodule instances as leaves and scan all expressions for reads, runtest.py bounds the whole cell, and Install.md lists curl.
  • The amd64 image passes runtest.py with --network none.
  • Not verified: the arm64 image (firtool under qemu-user), Binder, and the bumped Actions majors.