How ucb-bar/chipyard works
Chipyard is a Chisel-based framework for configuring and generating RISC-V SoCs, with supporting FPGA harnesses, FireSim simulation, and tapeout memory-macro compilation. The main workflow is configuration into a generated chip/system, then binding its ports and clocks to a simulation or FPGA harness. The README documents additional cores, accelerators, memory systems, and hardware flows, represented here at subsystem level where source was not sampled. Edges are limited to relationships shown in excerpts or documented in the README; unsampled subsystem wiring is not inferred.
Main entry points: HasHarnessInstantiators.scala Harness Instantiation · MacroCompiler.scala Macro Compiler · ChipTop.scala Chip Top · FireSim.scala FireSim Harness
Components 24
SoC Generation
- SoC Configurations
generators/chipyard/src/main/scala/config - Cores & Accelerators
generators/chipyard/src/main/scala/config - Digital System
generators/chipyard/src/main/scala/DigitalTop.scala - Chip Top
generators/chipyard/src/main/scala/ChipTop.scala - Clocking & Reset
generators/chipyard/src/main/scala/clocking/HasChipyardPRCI.scala
Chip Interfaces
- IO Binders
generators/chipyard/src/main/scala/iobinders/IOBinders.scala - IO Cells
generators/chipyard/src/main/scala/iocell/IOCell.scala - Harness Instantiation
generators/chipyard/src/main/scala/harness/HasHarnessInstantiators.scala - Harness Binders
generators/chipyard/src/main/scala/harness/HarnessBinders.scala
FireSim
- FireSim Harness
generators/firechip/chip/src/main/scala/FireSim.scala - Bridge Interfaces
generators/firechip/bridgeinterfaces/src/main/scala/TileTraceIO.scala - Host Bridge Stubs
generators/firechip/bridgestubs/src/main/cc/bridges/simplenic.cc - TSI Host Transport
generators/firechip/bridgestubs/src/main/cc/fesvr/firesim_tsi.cc
FPGA Harnesses
- FPGA Harnesses
fpga/src/main/scala - VC707 Harness
fpga/src/main/scala/vc707/TestHarness.scala - ZCU104 Harness
fpga/src/main/scala/zcu104/TestHarness.scala - Board Binders
fpga/src/main/scala/arty100t/HarnessBinders.scala - SD Boot Firmware
fpga/src/main/resources/vcu118/sdboot/sd.c
Tapeout Macros
- Macro Compiler
tools/tapeout/src/main/scala/macros/MacroCompiler.scala - Macro Cost Metrics
tools/tapeout/src/main/scala/macros/CostMetric.scala - Flop Mapping
tools/tapeout/src/main/scala/macros/SynFlopsPass.scala - Memory Macro Library
tools/tapeout/src/main/scala/macrolib/SRAM.scala
Other components
- SoC Designer
- Simulation & VLSI Flows
Connections 20
- SoC Designer → SoC Configurations: selects
README.md - SoC Configurations → Cores & Accelerators: configures
- Chip Top → Digital System: instantiates
generators/chipyard/src/main/scala/ChipTop.scala - Harness Instantiation → Chip Top: builds
generators/chipyard/src/main/scala/harness/HasHarnessInstantiators.scala - Chip Top → Clocking & Reset: uses clock schemes
generators/chipyard/src/main/scala/ChipTop.scala - IO Binders → IO Cells: generates cells
generators/chipyard/src/main/scala/iobinders/IOBinders.scala - Harness Instantiation → Harness Binders: applies binders
generators/chipyard/src/main/scala/harness/HasHarnessInstantiators.scala - FireSim Harness → Harness Instantiation: uses harness
generators/firechip/chip/src/main/scala/FireSim.scala - FireSim Harness → Bridge Interfaces: exposes bridges
- Host Bridge Stubs → Simulation & VLSI Flows: supports simulation
README.md - TSI Host Transport → Simulation & VLSI Flows: supports simulation
README.md - FPGA Harnesses → Simulation & VLSI Flows: supports FPGA simulation
README.md - VC707 Harness → Harness Instantiation: instantiates chips
fpga/src/main/scala/vc707/TestHarness.scala - ZCU104 Harness → Harness Instantiation: instantiates chips
fpga/src/main/scala/zcu104/TestHarness.scala - Board Binders → Harness Instantiation: binds harness ports
fpga/src/main/scala/arty100t/HarnessBinders.scala - SD Boot Firmware → FPGA Harnesses: boots board
- Macro Compiler → Macro Cost Metrics: uses cost metric
tools/tapeout/src/main/scala/macros/MacroCompiler.scala - Macro Compiler → Flop Mapping: runs mapping pass
tools/tapeout/src/main/scala/macros/MacroCompiler.scala - Macro Compiler → Memory Macro Library: compiles against
- Macro Compiler → Simulation & VLSI Flows: supports VLSI flow
README.md