How sfu-arch/muir-lib works
muIR is a Chisel library for generating configurable parallel dataflow accelerators. The principal workflow is to use a hardware designer’s generated dataflow design, composed from instruction-like nodes and control/loop logic, then connect its memory requests through memory controllers and interfaces. The README also documents configurable computation, arbitrary control paths, memory structures, and junctions. Several subsystem links are supported only by README descriptions; the graph omits unverified internal wiring because much of the source was not sampled.
Main entry points: UnifiedController.scala Unified controller · generator Generated designs · ComputeNode.scala Compute nodes · HandShaking.scala Handshake protocol
Components 20
Accelerator shell
- Accelerator core
src/main/scala/accel/Core.scala - Accelerator I/O
src/main/scala/accel/AccelIO.scala
Dataflow execution
- Compute nodes
src/main/scala/node/ComputeNode.scala - Control nodes
src/main/scala/control/BasicBlock.scala - Loop blocks
src/main/scala/loop/LoopBlock.scala - Floating-point units
src/main/scala/FPU/FPComputeNode.scala
Memory system
- Unified controller
src/main/scala/memory/UnifiedController.scala - Read/write arbiter
src/main/scala/memory/ReadWriteArbiter.scala - Read controllers
src/main/scala/memory/ReadTypMemoryController.scala - Write controllers
src/main/scala/memory/WriteTypMemoryController.scala - AXI cache
src/main/scala/memory/cache/AXICache.scala - Scratchpad memory
src/main/scala/memory/ScratchPadMemory.scala
Interfaces and concurrency
- Handshake protocol
src/main/scala/interfaces/HandShaking.scala - Stream junctions
src/main/scala/junctions - Task concurrency
src/main/scala/concurrent - Arbiter tree
src/main/scala/arbiters/ArbiterTree.scala - Memory interface
src/main/scala/interfaces
Generated designs
- Dataflow examples
src/main/scala/dataflow - Generated designs
src/main/scala/generator
Other components
- Hardware designer
Connections 20
- Hardware designer → Generated designs: specifies design
- Generated designs → Accelerator core: wraps design
- Generated designs → Compute nodes: instantiates
src/main/scala/generator/conv2dSerial.scala - Generated designs → Loop blocks: connects loop logic
src/main/scala/generator/conv2dSerial.scala - Compute nodes → Handshake protocol: uses protocol
- Compute nodes → Floating-point units: uses arithmetic
- Control nodes → Handshake protocol: uses protocol
- Loop blocks → Handshake protocol: exchanges signals
src/main/scala/loop/LoopBlock.scala - Accelerator core → Accelerator I/O: exposes interface
- Unified controller → Read/write arbiter: routes requests
src/main/scala/memory/UnifiedController.scala - Read/write arbiter → Memory interface: forwards requests
src/main/scala/memory/ReadWriteArbiter.scala - Read controllers → Arbiter tree: arbitrates inputs
src/main/scala/memory/ReadTypMemoryController.scala - Write controllers → Arbiter tree: arbitrates inputs
src/main/scala/memory/WriteTypMemoryController.scala - Unified controller → Read controllers: dispatches reads
src/main/scala/memory/UnifiedController.scala - Unified controller → Write controllers: dispatches writes
src/main/scala/memory/UnifiedController.scala - Unified controller → AXI cache: may use cache
- Unified controller → Scratchpad memory: may use scratchpad
- Dataflow examples → Compute nodes: demonstrates nodes
- Task concurrency → Accelerator core: supports task parallelism
- Stream junctions → Handshake protocol: connects streams