Add tutorial config and tutorial patches

generators/chipyard/src/main/scala/ConfigFragments.scala

@@ -70,6 +70,18 @@ class WithTracegenTop extends Config((site, here, up) => {
 })
 
 
+class WithRenumberHarts(rocketFirst: Boolean = false) extends Config((site, here, up) => {
+  case RocketTilesKey => up(RocketTilesKey, site).zipWithIndex map { case (r, i) =>
+    r.copy(hartId = i + (if(rocketFirst) 0 else up(BoomTilesKey, site).length))
+  }
+  case BoomTilesKey => up(BoomTilesKey, site).zipWithIndex map { case (b, i) =>
+    b.copy(hartId = i + (if(rocketFirst) up(RocketTilesKey, site).length else 0))
+  }
+  case MaxHartIdBits => log2Up(up(BoomTilesKey, site).size + up(RocketTilesKey, site).size)
+})
+
+
+
 // ------------------
 // Multi-RoCC Support
 // ------------------

generators/chipyard/src/main/scala/config/BoomConfigs.scala

@@ -1,7 +1,5 @@
 package chipyard
 
-import chisel3._
-
 import freechips.rocketchip.config.{Config}
 
 // ---------------------
@@ -12,7 +10,7 @@ import freechips.rocketchip.config.{Config}
 class SmallBoomConfig extends Config(
   new chipyard.iobinders.WithUARTAdapter ++                      // display UART with a SimUARTAdapter
   new chipyard.iobinders.WithTieOffInterrupts ++                 // tie off top-level interrupts
-  new chipyard.iobinders.WithBlackBoxSimMem ++                        // drive the master AXI4 memory with a SimAXIMem
+  new chipyard.iobinders.WithBlackBoxSimMem ++                   // drive the master AXI4 memory with a SimAXIMem
   new chipyard.iobinders.WithTiedOffDebug ++                     // tie off debug (since we are using SimSerial for testing)
   new chipyard.iobinders.WithSimSerial ++                        // drive TSI with SimSerial for testing
   new testchipip.WithTSI ++                                      // use testchipip serial offchip link

generators/chipyard/src/main/scala/config/HeteroConfigs.scala

@@ -1,7 +1,5 @@
 package chipyard
 
-import chisel3._
-
 import freechips.rocketchip.config.{Config}
 
 // ---------------------
@@ -11,7 +9,7 @@ import freechips.rocketchip.config.{Config}
 class LargeBoomAndRocketConfig extends Config(
   new chipyard.iobinders.WithUARTAdapter ++                      // display UART with a SimUARTAdapter
   new chipyard.iobinders.WithTieOffInterrupts ++                 // tie off top-level interrupts
-  new chipyard.iobinders.WithBlackBoxSimMem ++                        // drive the master AXI4 memory with a SimAXIMem
+  new chipyard.iobinders.WithBlackBoxSimMem ++                   // drive the master AXI4 memory with a SimAXIMem
   new chipyard.iobinders.WithTiedOffDebug ++                     // tie off debug (since we are using SimSerial for testing)
   new chipyard.iobinders.WithSimSerial ++                        // drive TSI with SimSerial for testing
   new testchipip.WithTSI ++                                      // use testchipip serial offchip link
@@ -19,7 +17,7 @@ class LargeBoomAndRocketConfig extends Config(
   new chipyard.config.WithBootROM ++                             // use default bootrom
   new chipyard.config.WithUART ++                                // add a UART
   new chipyard.config.WithL2TLBs(1024) ++                        // use L2 TLBs
-  new boom.common.WithRenumberHarts ++                           // avoid hartid overlap
+  new chipyard.config.WithRenumberHarts ++                       // avoid hartid overlap
   new boom.common.WithLargeBooms ++                              // 3-wide boom
   new boom.common.WithNBoomCores(1) ++                           // single-core boom
   new freechips.rocketchip.subsystem.WithNoMMIOPort ++           // no top-level MMIO master port (overrides default set in rocketchip)
@@ -42,7 +40,7 @@ class HwachaLargeBoomAndHwachaRocketConfig extends Config(
   new chipyard.config.WithUART ++
   new chipyard.config.WithL2TLBs(1024) ++
   new hwacha.DefaultHwachaConfig ++                      // add hwacha to all harts
-  new boom.common.WithRenumberHarts ++
+  new chipyard.config.WithRenumberHarts ++
   new boom.common.WithLargeBooms ++
   new boom.common.WithNBoomCores(1) ++
   new freechips.rocketchip.subsystem.WithNoMMIOPort ++
@@ -64,7 +62,7 @@ class DualLargeBoomAndRocketConfig extends Config(
   new chipyard.config.WithBootROM ++
   new chipyard.config.WithUART ++
   new chipyard.config.WithL2TLBs(1024) ++
-  new boom.common.WithRenumberHarts ++
+  new chipyard.config.WithRenumberHarts ++
   new boom.common.WithLargeBooms ++
   new boom.common.WithNBoomCores(2) ++                       // 2 boom cores
   new freechips.rocketchip.subsystem.WithNoMMIOPort ++
@@ -89,7 +87,7 @@ class LargeBoomAndHwachaRocketConfig extends Config(
   new chipyard.config.WithMultiRoCC ++                                  // support heterogeneous rocc
   new chipyard.config.WithMultiRoCCHwacha(1) ++                         // put hwacha on hart-2 (rocket)
   new chipyard.config.WithL2TLBs(1024) ++
-  new boom.common.WithRenumberHarts ++
+  new chipyard.config.WithRenumberHarts ++
   new boom.common.WithLargeBooms ++
   new boom.common.WithNBoomCores(1) ++
   new freechips.rocketchip.subsystem.WithNoMMIOPort ++
@@ -113,7 +111,7 @@ class LargeBoomAndRV32RocketConfig extends Config(
   new chipyard.config.WithBootROM ++
   new chipyard.config.WithUART ++
   new chipyard.config.WithL2TLBs(1024) ++
-  new boom.common.WithRenumberHarts ++
+  new chipyard.config.WithRenumberHarts ++
   new boom.common.WithLargeBooms ++
   new boom.common.WithNBoomCores(1) ++
   new freechips.rocketchip.subsystem.WithNoMMIOPort ++
@@ -137,7 +135,7 @@ class DualLargeBoomAndDualRocketConfig extends Config(
   new chipyard.config.WithBootROM ++
   new chipyard.config.WithUART ++
   new chipyard.config.WithL2TLBs(1024) ++
-  new boom.common.WithRenumberHarts ++
+  new chipyard.config.WithRenumberHarts ++
   new boom.common.WithLargeBooms ++
   new boom.common.WithNBoomCores(2) ++                     // 2 boom cores
   new freechips.rocketchip.subsystem.WithNoMMIOPort ++
@@ -160,7 +158,7 @@ class LargeBoomAndRocketWithControlCoreConfig extends Config(
   new chipyard.config.WithUART ++
   new chipyard.config.WithControlCore ++  // add small control core to last hartid
   new chipyard.config.WithL2TLBs(1024) ++
-  new boom.common.WithRenumberHarts ++
+  new chipyard.config.WithRenumberHarts ++
   new boom.common.WithLargeBooms ++
   new boom.common.WithNBoomCores(1) ++
   new freechips.rocketchip.subsystem.WithNoMMIOPort ++

generators/chipyard/src/main/scala/config/RocketConfigs.scala

@@ -1,7 +1,5 @@
 package chipyard
 
-import chisel3._
-
 import freechips.rocketchip.config.{Config}
 
 // --------------
@@ -11,7 +9,7 @@ import freechips.rocketchip.config.{Config}
 class RocketConfig extends Config(
   new chipyard.iobinders.WithUARTAdapter ++                      // display UART with a SimUARTAdapter
   new chipyard.iobinders.WithTieOffInterrupts ++                 // tie off top-level interrupts
-  new chipyard.iobinders.WithBlackBoxSimMem ++                        // drive the master AXI4 memory with a SimAXIMem
+  new chipyard.iobinders.WithBlackBoxSimMem ++                   // drive the master AXI4 memory with a SimAXIMem
   new chipyard.iobinders.WithTiedOffDebug ++                     // tie off debug (since we are using SimSerial for testing)
   new chipyard.iobinders.WithSimSerial ++                        // drive TSI with SimSerial for testing
   new testchipip.WithTSI ++                                      // use testchipip serial offchip link

generators/chipyard/src/main/scala/config/TracegenConfigs.scala

@@ -1,7 +1,5 @@
 package chipyard
 
-import chisel3._
-
 import freechips.rocketchip.config.{Config}
 import freechips.rocketchip.rocket.{DCacheParams}
 

generators/chipyard/src/main/scala/config/TutorialConfigs.scala

@@ -0,0 +1,138 @@
+package chipyard
+
+import freechips.rocketchip.config.{Config}
+
+// This file is designed to accompany a live tutorial, with slides.
+// For each of 4 phases, participants will customize and build a
+// small demonstration config.
+
+// This file is designed to be used after running chipyard/scripts/tutorial-setup.sh,
+// which removes the SHA3 accelerator RTL, and provides participants
+// the experience of integrating external RTL.
+
+// This file was originally developed for the cancelled ASPLOS-2020
+// Chipyard tutorial. While the configs here work, the corresponding
+// slideware has not yet been created
+
+// NOTE: Configs should be read bottom-up, since they are applied bottom-up
+
+// Tutorial Phase 1: Configure the cores, caches
+class TutorialStarterConfig extends Config(
+  // IOBinders specify how to connect to IOs in our TestHarness
+  // These config fragments do not affect
+  new chipyard.iobinders.WithUARTAdapter ++       // Connect a SimUART adapter to display UART on stdout
+  new chipyard.iobinders.WithBlackBoxSimMem ++    // Connect simulated external memory
+  new chipyard.iobinders.WithTieOffInterrupts ++  // Do not simulate external interrupts
+  new chipyard.iobinders.WithTiedOffDebug ++      // Disconnect the debug module, since we use TSI for bring-up
+  new chipyard.iobinders.WithSimSerial ++         // Connect external SimSerial widget to drive TSI
+
+  // Config fragments below this line affect hardware generation
+  // of the Top
+  new testchipip.WithTSI ++                  // Add a TSI (Test Serial Interface)  widget to bring-up the core
+  new chipyard.config.WithNoGPIO ++          // Disable GPIOs.
+  new chipyard.config.WithBootROM ++         // Use the Chipyard BootROM
+  new chipyard.config.WithRenumberHarts ++   // WithRenumberHarts fixes hartids heterogeneous designs, if design is not heterogeneous, this is a no-op
+  new chipyard.config.WithUART ++            // Add a UART
+
+  // CUSTOMIZE THE CORE
+  // Uncomment out one (or multiple) of the lines below, and choose
+  // how many cores you want.
+  // new freechips.rocketchip.subsystem.WithNBigCores(1) ++ // Specify we want some number of Rocket cores
+  // new boom.common.WithSmallBooms ++                      // Specify all BOOM cores should be Small-sized (NOTE: other options are Medium/Large/Mega)
+  // new boom.common.WithNBoomCores(1) ++                   // Specify we want some number of BOOM cores
+
+  // CUSTOMIZE the L2
+  // Uncomment this line, and specify a size if you want to have a L2
+  // new freechips.rocketchip.subsystem.WithInclusiveCache(nBanks=1, nWays=4, capacityKB=128) ++
+
+  // For simpler designs, we want to minimize IOs on
+  // our Top. These config fragments remove unnecessary
+  // ports
+  new freechips.rocketchip.subsystem.WithNoMMIOPort ++
+  new freechips.rocketchip.subsystem.WithNoSlavePort ++
+  new freechips.rocketchip.subsystem.WithNExtTopInterrupts(0) ++
+  // BaseConfig configures "bare" rocketchip system
+  new freechips.rocketchip.system.BaseConfig
+)
+
+
+// Tutorial Phase 2: Integrate a TileLink or AXI4 MMIO device
+class TutorialMMIOConfig extends Config(
+  new chipyard.iobinders.WithUARTAdapter ++
+  new chipyard.iobinders.WithBlackBoxSimMem ++
+  new chipyard.iobinders.WithTieOffInterrupts ++
+  new chipyard.iobinders.WithTiedOffDebug ++
+  new chipyard.iobinders.WithSimSerial ++
+
+  new testchipip.WithTSI ++
+  new chipyard.config.WithNoGPIO ++
+  new chipyard.config.WithBootROM ++
+  new chipyard.config.WithRenumberHarts ++
+  new chipyard.config.WithUART ++
+
+  // Attach either a TileLink or AXI4 version of GCD
+  // Uncomment one of the below lines
+  // new chipyard.example.WithGCD(useAXI4=false) ++ // Use TileLink version
+  // new chipyard.example.WithGCD(useAXI4=true) ++  // Use AXI4 version
+
+  // For this demonstration we assume the base system is a single-core Rocket, for fast elaboration
+  new freechips.rocketchip.subsystem.WithNBigCores(1) ++
+  new freechips.rocketchip.subsystem.WithInclusiveCache ++
+  new freechips.rocketchip.subsystem.WithNoMMIOPort ++
+  new freechips.rocketchip.subsystem.WithNoSlavePort ++
+  new freechips.rocketchip.subsystem.WithNExtTopInterrupts(0) ++
+  new freechips.rocketchip.system.BaseConfig
+)
+
+// Tutorial Phase 3: Integrate a SHA3 RoCC accelerator
+class TutorialSha3Config extends Config(
+  new chipyard.iobinders.WithUARTAdapter ++
+  new chipyard.iobinders.WithBlackBoxSimMem ++
+  new chipyard.iobinders.WithTieOffInterrupts ++
+  new chipyard.iobinders.WithTiedOffDebug ++
+  new chipyard.iobinders.WithSimSerial ++
+
+  new testchipip.WithTSI ++
+  new chipyard.config.WithNoGPIO ++
+  new chipyard.config.WithBootROM ++
+  new chipyard.config.WithRenumberHarts ++
+  new chipyard.config.WithUART ++
+
+  // Uncomment this line once you added SHA3 to the build.sbt, and cloned the SHA3 repo
+  // new sha3.WithSha3Accel ++
+
+  // For this demonstration we assume the base system is a single-core Rocket, for fast elaboration
+  new freechips.rocketchip.subsystem.WithNBigCores(1) ++
+  new freechips.rocketchip.subsystem.WithInclusiveCache ++
+  new freechips.rocketchip.subsystem.WithNoMMIOPort ++
+  new freechips.rocketchip.subsystem.WithNoSlavePort ++
+  new freechips.rocketchip.subsystem.WithNExtTopInterrupts(0) ++
+  new freechips.rocketchip.system.BaseConfig
+)
+
+// Tutorial Phase 4: Integrate a Black-box verilog version of the SHA3 RoCC accelerator
+class TutorialSha3BlackBoxConfig extends Config(
+  new chipyard.iobinders.WithUARTAdapter ++
+  new chipyard.iobinders.WithBlackBoxSimMem ++
+  new chipyard.iobinders.WithTieOffInterrupts ++
+  new chipyard.iobinders.WithTiedOffDebug ++
+  new chipyard.iobinders.WithSimSerial ++
+
+  new testchipip.WithTSI ++
+  new chipyard.config.WithNoGPIO ++
+  new chipyard.config.WithBootROM ++
+  new chipyard.config.WithRenumberHarts ++
+  new chipyard.config.WithUART ++
+
+  // Uncomment these lines once SHA3 is integrated
+  // new sha3.WithSha3BlackBox ++ // Specify we want the Black-box verilog version of Sha3 Ctrl
+  // new sha3.WithSha3Accel ++
+
+  // For this demonstration we assume the base system is a single-core Rocket, for fast elaboration
+  new freechips.rocketchip.subsystem.WithNBigCores(1) ++
+  new freechips.rocketchip.subsystem.WithInclusiveCache ++
+  new freechips.rocketchip.subsystem.WithNoMMIOPort ++
+  new freechips.rocketchip.subsystem.WithNoSlavePort ++
+  new freechips.rocketchip.subsystem.WithNExtTopInterrupts(0) ++
+  new freechips.rocketchip.system.BaseConfig
+)