Skip to content

Upgrade the bootcamp to Chisel 7 - #17

Merged
jserv merged 1 commit into
devfrom
chisel7
Nov 13, 2026
Merged

jserv merged 1 commit into
devfrom
chisel7

Conversation

@jserv

@jserv jserv commented Nov 13, 2026 •

Copy link
Copy Markdown

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.

Written for commit 742553f. Summary will update on new commits.

View guided diff Turn on auto-fix

cubic-dev-ai[bot]

This comment was marked as resolved.

Move the notebooks and the 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, so 2.6_chiseltest.ipynb becomes
2.6_chiselsim.ipynb. FixedPoint and dsptools no longer exist: the
notebooks use SInt and small typeclasses written in place, and the
rocket-chip AXI4 section is dropped. The Scala FIRRTL library is gone
too, so module 4 teaches the CHIRRTL text and the CIRCT flow.

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) follow.
@jserv
jserv merged commit 09b21e5 into dev Nov 13, 2026
2 checks passed
@jserv
jserv deleted the chisel7 branch November 13, 2026 04:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant