1/*************************************************************************************** 2* Copyright (c) 2021-2025 Beijing Institute of Open Source Chip (BOSC) 3* Copyright (c) 2020-2025 Institute of Computing Technology, Chinese Academy of Sciences 4* Copyright (c) 2020-2021 Peng Cheng Laboratory 5* 6* XiangShan is licensed under Mulan PSL v2. 7* You can use this software according to the terms and conditions of the Mulan PSL v2. 8* You may obtain a copy of Mulan PSL v2 at: 9* http://license.coscl.org.cn/MulanPSL2 10* 11* THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND, 12* EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT, 13* MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE. 14* 15* See the Mulan PSL v2 for more details. 16***************************************************************************************/ 17 18package top 19 20import chisel3._ 21import chisel3.util._ 22import xiangshan._ 23import utils._ 24import utility._ 25import system._ 26import org.chipsalliance.cde.config._ 27import freechips.rocketchip.tile.{BusErrorUnit, BusErrorUnitParams, MaxHartIdBits, XLen} 28import xiangshan.frontend.icache.ICacheParameters 29import freechips.rocketchip.devices.debug._ 30import openLLC.OpenLLCParam 31import freechips.rocketchip.diplomacy._ 32import xiangshan.backend.regfile.{IntPregParams, VfPregParams} 33import xiangshan.cache.DCacheParameters 34import xiangshan.cache.mmu.{L2TLBParameters, TLBParameters} 35import device.EnableJtag 36import huancun._ 37import coupledL2._ 38import coupledL2.prefetch._ 39 40class BaseConfig(n: Int, hasMbist: Boolean = false) extends Config((site, here, up) => { 41 case XLen => 64 42 case DebugOptionsKey => DebugOptions() 43 case SoCParamsKey => SoCParameters() 44 case CVMParamskey => CVMParameters() 45 case PMParameKey => PMParameters() 46 case XSTileKey => Seq.tabulate(n){ i => XSCoreParameters(HartId = i, hasMbist = hasMbist) } 47 case ExportDebug => DebugAttachParams(protocols = Set(JTAG)) 48 case DebugModuleKey => Some(DebugModuleParams( 49 nAbstractDataWords = (if (site(XLen) == 32) 1 else if (site(XLen) == 64) 2 else 4), 50 maxSupportedSBAccess = site(XLen), 51 hasBusMaster = true, 52 baseAddress = BigInt(0x38020000), 53 nScratch = 2, 54 crossingHasSafeReset = false, 55 hasHartResets = true 56 )) 57 case JtagDTMKey => JtagDTMKey 58 case MaxHartIdBits => log2Up(n) max 6 59 case EnableJtag => true.B 60}) 61 62// Synthesizable minimal XiangShan 63// * It is still an out-of-order, super-scalaer arch 64// * L1 cache included 65// * L2 cache NOT included 66// * L3 cache included 67class MinimalConfig(n: Int = 1) extends Config( 68 new BaseConfig(n).alter((site, here, up) => { 69 case XSTileKey => up(XSTileKey).map( 70 p => p.copy( 71 DecodeWidth = 6, 72 RenameWidth = 6, 73 RobCommitWidth = 8, 74 // FetchWidth = 4, // NOTE: make sure that FTQ SRAM width is not a prime number bigger than 256. 75 VirtualLoadQueueSize = 24, 76 LoadQueueRARSize = 24, 77 LoadQueueRAWSize = 12, 78 LoadQueueReplaySize = 24, 79 LoadUncacheBufferSize = 8, 80 LoadQueueNWriteBanks = 4, // NOTE: make sure that LoadQueue{RAR, RAW, Replay}Size is divided by LoadQueueNWriteBanks. 81 RollbackGroupSize = 8, 82 StoreQueueSize = 20, 83 StoreQueueNWriteBanks = 4, // NOTE: make sure that StoreQueueSize is divided by StoreQueueNWriteBanks 84 StoreQueueForwardWithMask = true, 85 // ============ VLSU ============ 86 VlMergeBufferSize = 16, 87 VsMergeBufferSize = 8, 88 UopWritebackWidth = 2, 89 // ============================== 90 RobSize = 48, 91 RabSize = 96, 92 FtqSize = 8, 93 IBufSize = 24, 94 IBufNBank = 6, 95 StoreBufferSize = 4, 96 StoreBufferThreshold = 3, 97 IssueQueueSize = 10, 98 IssueQueueCompEntrySize = 4, 99 intPreg = IntPregParams( 100 numEntries = 64, 101 numRead = None, 102 numWrite = None, 103 ), 104 vfPreg = VfPregParams( 105 numEntries = 160, 106 numRead = None, 107 numWrite = None, 108 ), 109 icacheParameters = ICacheParameters( 110 nSets = 64, // 16KB ICache 111 tagECC = Some("parity"), 112 dataECC = Some("parity"), 113 replacer = Some("setplru"), 114 cacheCtrlAddressOpt = Some(AddressSet(0x38022080, 0x7f)), 115 ), 116 dcacheParametersOpt = Some(DCacheParameters( 117 nSets = 64, // 32KB DCache 118 nWays = 8, 119 tagECC = Some("secded"), 120 dataECC = Some("secded"), 121 replacer = Some("setplru"), 122 nMissEntries = 4, 123 nProbeEntries = 4, 124 nReleaseEntries = 8, 125 nMaxPrefetchEntry = 2, 126 enableTagEcc = true, 127 enableDataEcc = true, 128 cacheCtrlAddressOpt = Some(AddressSet(0x38022000, 0x7f)) 129 )), 130 // ============ BPU =============== 131 EnableLoop = false, 132 EnableGHistDiff = false, 133 FtbSize = 256, 134 FtbWays = 2, 135 RasSize = 8, 136 RasSpecSize = 16, 137 TageTableInfos = 138 Seq((512, 4, 6), 139 (512, 9, 6), 140 (1024, 19, 6)), 141 SCNRows = 128, 142 SCNTables = 2, 143 SCHistLens = Seq(0, 5), 144 ITTageTableInfos = 145 Seq((256, 4, 7), 146 (256, 8, 7), 147 (512, 16, 7)), 148 // ================================ 149 itlbParameters = TLBParameters( 150 name = "itlb", 151 fetchi = true, 152 useDmode = false, 153 NWays = 4, 154 ), 155 ldtlbParameters = TLBParameters( 156 name = "ldtlb", 157 NWays = 4, 158 partialStaticPMP = true, 159 outsideRecvFlush = true, 160 outReplace = false, 161 lgMaxSize = 4 162 ), 163 sttlbParameters = TLBParameters( 164 name = "sttlb", 165 NWays = 4, 166 partialStaticPMP = true, 167 outsideRecvFlush = true, 168 outReplace = false, 169 lgMaxSize = 4 170 ), 171 hytlbParameters = TLBParameters( 172 name = "hytlb", 173 NWays = 4, 174 partialStaticPMP = true, 175 outsideRecvFlush = true, 176 outReplace = false, 177 lgMaxSize = 4 178 ), 179 pftlbParameters = TLBParameters( 180 name = "pftlb", 181 NWays = 4, 182 partialStaticPMP = true, 183 outsideRecvFlush = true, 184 outReplace = false, 185 lgMaxSize = 4 186 ), 187 btlbParameters = TLBParameters( 188 name = "btlb", 189 NWays = 4, 190 ), 191 l2tlbParameters = L2TLBParameters( 192 l3Size = 4, 193 l2Size = 4, 194 l1nSets = 4, 195 l1nWays = 4, 196 l1ReservedBits = 1, 197 l0nSets = 4, 198 l0nWays = 8, 199 l0ReservedBits = 0, 200 spSize = 4, 201 ), 202 L2CacheParamsOpt = Some(L2Param( 203 name = "L2", 204 ways = 8, 205 sets = 128, 206 echoField = Seq(huancun.DirtyField()), 207 prefetch = Nil, 208 clientCaches = Seq(L1Param( 209 "dcache", 210 isKeywordBitsOpt = p.dcacheParametersOpt.get.isKeywordBitsOpt 211 )), 212 )), 213 L2NBanks = 2, 214 prefetcher = None // if L2 pf_recv_node does not exist, disable SMS prefetcher 215 ) 216 ) 217 case SoCParamsKey => 218 val tiles = site(XSTileKey) 219 up(SoCParamsKey).copy( 220 L3CacheParamsOpt = Option.when(!up(EnableCHI))(up(SoCParamsKey).L3CacheParamsOpt.get.copy( 221 sets = 1024, 222 inclusive = false, 223 clientCaches = tiles.map{ core => 224 val clientDirBytes = tiles.map{ t => 225 t.L2NBanks * t.L2CacheParamsOpt.map(_.toCacheParams.capacity).getOrElse(0) 226 }.sum 227 val l2params = core.L2CacheParamsOpt.get.toCacheParams 228 l2params.copy(sets = 2 * clientDirBytes / core.L2NBanks / l2params.ways / 64) 229 }, 230 simulation = !site(DebugOptionsKey).FPGAPlatform, 231 prefetch = None 232 )), 233 OpenLLCParamsOpt = Option.when(up(EnableCHI))(OpenLLCParam( 234 name = "LLC", 235 ways = 8, 236 sets = 2048, 237 banks = 4, 238 clientCaches = Seq(L2Param()) 239 )), 240 L3NBanks = 1 241 ) 242 }) 243) 244 245// Non-synthesizable MinimalConfig, for fast simulation only 246class MinimalSimConfig(n: Int = 1) extends Config( 247 new MinimalConfig(n).alter((site, here, up) => { 248 case XSTileKey => up(XSTileKey).map(_.copy( 249 dcacheParametersOpt = None, 250 softPTW = true 251 )) 252 case SoCParamsKey => up(SoCParamsKey).copy( 253 L3CacheParamsOpt = None, 254 OpenLLCParamsOpt = None 255 ) 256 }) 257) 258 259case class WithNKBL1D(n: Int, ways: Int = 8) extends Config((site, here, up) => { 260 case XSTileKey => 261 val sets = n * 1024 / ways / 64 262 up(XSTileKey).map(_.copy( 263 dcacheParametersOpt = Some(DCacheParameters( 264 nSets = sets, 265 nWays = ways, 266 tagECC = Some("secded"), 267 dataECC = Some("secded"), 268 replacer = Some("setplru"), 269 nMissEntries = 16, 270 nProbeEntries = 8, 271 nReleaseEntries = 18, 272 nMaxPrefetchEntry = 6, 273 enableTagEcc = true, 274 enableDataEcc = true, 275 cacheCtrlAddressOpt = Some(AddressSet(0x38022000, 0x7f)) 276 )) 277 )) 278}) 279 280case class L2CacheConfig 281( 282 size: String, 283 ways: Int = 8, 284 inclusive: Boolean = true, 285 banks: Int = 1, 286 tp: Boolean = true, 287 enableFlush: Boolean = false 288) extends Config((site, here, up) => { 289 case XSTileKey => 290 require(inclusive, "L2 must be inclusive") 291 val nKB = size.toUpperCase() match { 292 case s"${k}KB" => k.trim().toInt 293 case s"${m}MB" => (m.trim().toDouble * 1024).toInt 294 } 295 val upParams = up(XSTileKey) 296 val l2sets = nKB * 1024 / banks / ways / 64 297 upParams.map(p => p.copy( 298 L2CacheParamsOpt = Some(L2Param( 299 name = "L2", 300 ways = ways, 301 sets = l2sets, 302 clientCaches = Seq(L1Param( 303 "dcache", 304 sets = 2 * p.dcacheParametersOpt.get.nSets / banks, 305 ways = p.dcacheParametersOpt.get.nWays + 2, 306 aliasBitsOpt = p.dcacheParametersOpt.get.aliasBitsOpt, 307 vaddrBitsOpt = Some(p.GPAddrBitsSv48x4 - log2Up(p.dcacheParametersOpt.get.blockBytes)), 308 isKeywordBitsOpt = p.dcacheParametersOpt.get.isKeywordBitsOpt 309 )), 310 reqField = Seq(utility.ReqSourceField()), 311 echoField = Seq(huancun.DirtyField()), 312 tagECC = Some("secded"), 313 dataECC = Some("secded"), 314 enableTagECC = true, 315 enableDataECC = true, 316 dataCheck = Some("oddparity"), 317 enablePoison = true, 318 prefetch = Seq(BOPParameters()) ++ 319 (if (tp) Seq(TPParameters()) else Nil) ++ 320 (if (p.prefetcher.nonEmpty) Seq(PrefetchReceiverParams()) else Nil), 321 enableL2Flush = enableFlush, 322 enablePerf = !site(DebugOptionsKey).FPGAPlatform && site(DebugOptionsKey).EnablePerfDebug, 323 enableRollingDB = site(DebugOptionsKey).EnableRollingDB, 324 enableMonitor = site(DebugOptionsKey).AlwaysBasicDB, 325 elaboratedTopDown = !site(DebugOptionsKey).FPGAPlatform, 326 hasMbist = p.hasMbist, 327 hasSramCtl = p.hasSramCtl, 328 )), 329 L2NBanks = banks 330 )) 331}) 332 333case class L3CacheConfig(size: String, ways: Int = 8, inclusive: Boolean = true, banks: Int = 1) extends Config((site, here, up) => { 334 case SoCParamsKey => 335 val nKB = size.toUpperCase() match { 336 case s"${k}KB" => k.trim().toInt 337 case s"${m}MB" => (m.trim().toDouble * 1024).toInt 338 } 339 val sets = nKB * 1024 / banks / ways / 64 340 val tiles = site(XSTileKey) 341 val clientDirBytes = tiles.map{ t => 342 t.L2NBanks * t.L2CacheParamsOpt.map(_.toCacheParams.capacity).getOrElse(0) 343 }.sum 344 up(SoCParamsKey).copy( 345 L3NBanks = banks, 346 L3CacheParamsOpt = Option.when(!up(EnableCHI))(HCCacheParameters( 347 name = "L3", 348 level = 3, 349 ways = ways, 350 sets = sets, 351 inclusive = inclusive, 352 clientCaches = tiles.map{ core => 353 val l2params = core.L2CacheParamsOpt.get.toCacheParams 354 l2params.copy(sets = 2 * clientDirBytes / core.L2NBanks / l2params.ways / 64, ways = l2params.ways + 2) 355 }, 356 enablePerf = !site(DebugOptionsKey).FPGAPlatform && site(DebugOptionsKey).EnablePerfDebug, 357 ctrl = Some(CacheCtrl( 358 address = 0x39000000, 359 numCores = tiles.size 360 )), 361 reqField = Seq(utility.ReqSourceField()), 362 sramClkDivBy2 = true, 363 sramDepthDiv = 4, 364 tagECC = Some("secded"), 365 dataECC = Some("secded"), 366 simulation = !site(DebugOptionsKey).FPGAPlatform, 367 prefetch = Some(huancun.prefetch.L3PrefetchReceiverParams()), 368 tpmeta = Some(huancun.prefetch.DefaultTPmetaParameters()) 369 )), 370 OpenLLCParamsOpt = Option.when(up(EnableCHI))(OpenLLCParam( 371 name = "LLC", 372 ways = ways, 373 sets = sets, 374 banks = banks, 375 fullAddressBits = 48, 376 clientCaches = tiles.map { core => 377 val l2params = core.L2CacheParamsOpt.get 378 l2params.copy(sets = 2 * clientDirBytes / core.L2NBanks / l2params.ways / 64, ways = l2params.ways + 2) 379 }, 380 enablePerf = !site(DebugOptionsKey).FPGAPlatform && site(DebugOptionsKey).EnablePerfDebug, 381 elaboratedTopDown = !site(DebugOptionsKey).FPGAPlatform 382 )) 383 ) 384}) 385 386class WithL3DebugConfig extends Config( 387 L3CacheConfig("256KB", inclusive = false) ++ L2CacheConfig("64KB") 388) 389 390class MinimalL3DebugConfig(n: Int = 1) extends Config( 391 new WithL3DebugConfig ++ new MinimalConfig(n) 392) 393 394class DefaultL3DebugConfig(n: Int = 1) extends Config( 395 new WithL3DebugConfig ++ new BaseConfig(n) 396) 397 398class WithFuzzer extends Config((site, here, up) => { 399 case DebugOptionsKey => up(DebugOptionsKey).copy( 400 EnablePerfDebug = false, 401 ) 402 case SoCParamsKey => up(SoCParamsKey).copy( 403 L3CacheParamsOpt = up(SoCParamsKey).L3CacheParamsOpt.map(_.copy( 404 enablePerf = false, 405 )), 406 OpenLLCParamsOpt = up(SoCParamsKey).OpenLLCParamsOpt.map(_.copy( 407 enablePerf = false, 408 )), 409 ) 410 case XSTileKey => up(XSTileKey).zipWithIndex.map{ case (p, i) => 411 p.copy( 412 L2CacheParamsOpt = Some(up(XSTileKey)(i).L2CacheParamsOpt.get.copy( 413 enablePerf = false, 414 )), 415 ) 416 } 417}) 418 419class CVMCompile extends Config((site, here, up) => { 420 case CVMParamskey => up(CVMParamskey).copy( 421 KeyIDBits = 5, 422 HasMEMencryption = true, 423 HasDelayNoencryption = false 424 ) 425 case XSTileKey => up(XSTileKey).map(_.copy( 426 HasBitmapCheck = true, 427 HasBitmapCheckDefault = false)) 428}) 429 430class CVMTestCompile extends Config((site, here, up) => { 431 case CVMParamskey => up(CVMParamskey).copy( 432 KeyIDBits = 5, 433 HasMEMencryption = true, 434 HasDelayNoencryption = true 435 ) 436 case XSTileKey => up(XSTileKey).map(_.copy( 437 HasBitmapCheck =true, 438 HasBitmapCheckDefault = true)) 439}) 440 441class MinimalAliasDebugConfig(n: Int = 1) extends Config( 442 L3CacheConfig("512KB", inclusive = false) 443 ++ L2CacheConfig("256KB", inclusive = true) 444 ++ WithNKBL1D(128) 445 ++ new MinimalConfig(n) 446) 447 448class MediumConfig(n: Int = 1) extends Config( 449 L3CacheConfig("4MB", inclusive = false, banks = 4) 450 ++ L2CacheConfig("512KB", inclusive = true) 451 ++ WithNKBL1D(128) 452 ++ new BaseConfig(n) 453) 454 455class FuzzConfig(dummy: Int = 0) extends Config( 456 new WithFuzzer 457 ++ new DefaultConfig(1) 458) 459 460class DefaultConfig(n: Int = 1) extends Config( 461 L3CacheConfig("16MB", inclusive = false, banks = 4, ways = 16) 462 ++ L2CacheConfig("1MB", inclusive = true, banks = 4) 463 ++ WithNKBL1D(64, ways = 4) 464 ++ new BaseConfig(n, true) 465) 466 467class CVMConfig(n: Int = 1) extends Config( 468 new CVMCompile 469 ++ new DefaultConfig(n) 470) 471 472class CVMTestConfig(n: Int = 1) extends Config( 473 new CVMTestCompile 474 ++ new DefaultConfig(n) 475) 476 477class WithCHI extends Config((_, _, _) => { 478 case EnableCHI => true 479}) 480 481class KunminghuV2Config(n: Int = 1) extends Config( 482 L2CacheConfig("1MB", inclusive = true, banks = 4, tp = false) 483 ++ new DefaultConfig(n) 484 ++ new WithCHI 485) 486 487class KunminghuV2MinimalConfig(n: Int = 1) extends Config( 488 L2CacheConfig("128KB", inclusive = true, banks = 1, tp = false) 489 ++ WithNKBL1D(32, ways = 4) 490 ++ new MinimalConfig(n) 491 ++ new WithCHI 492) 493 494class XSNoCTopConfig(n: Int = 1) extends Config( 495 (new KunminghuV2Config(n)).alter((site, here, up) => { 496 case SoCParamsKey => up(SoCParamsKey).copy(UseXSNoCTop = true) 497 }) 498) 499 500class XSNoCTopMinimalConfig(n: Int = 1) extends Config( 501 (new KunminghuV2MinimalConfig(n)).alter((site, here, up) => { 502 case SoCParamsKey => up(SoCParamsKey).copy(UseXSNoCTop = true) 503 }) 504) 505 506class XSNoCDiffTopConfig(n: Int = 1) extends Config( 507 (new XSNoCTopConfig(n)).alter((site, here, up) => { 508 case SoCParamsKey => up(SoCParamsKey).copy(UseXSNoCDiffTop = true) 509 }) 510) 511 512class XSNoCDiffTopMinimalConfig(n: Int = 1) extends Config( 513 (new XSNoCTopConfig(n)).alter((site, here, up) => { 514 case SoCParamsKey => up(SoCParamsKey).copy(UseXSNoCDiffTop = true) 515 }) 516) 517 518class FpgaDefaultConfig(n: Int = 1) extends Config( 519 (L3CacheConfig("3MB", inclusive = false, banks = 1, ways = 6) 520 ++ L2CacheConfig("1MB", inclusive = true, banks = 4) 521 ++ WithNKBL1D(64, ways = 4) 522 ++ new BaseConfig(n)).alter((site, here, up) => { 523 case DebugOptionsKey => up(DebugOptionsKey).copy( 524 AlwaysBasicDiff = false, 525 AlwaysBasicDB = false 526 ) 527 case SoCParamsKey => up(SoCParamsKey).copy( 528 L3CacheParamsOpt = Some(up(SoCParamsKey).L3CacheParamsOpt.get.copy( 529 sramClkDivBy2 = false, 530 )), 531 ) 532 }) 533) 534 535class FpgaDiffDefaultConfig(n: Int = 1) extends Config( 536 (L3CacheConfig("3MB", inclusive = false, banks = 1, ways = 6) 537 ++ L2CacheConfig("1MB", inclusive = true, banks = 4) 538 ++ WithNKBL1D(64, ways = 4) 539 ++ new BaseConfig(n)).alter((site, here, up) => { 540 case DebugOptionsKey => up(DebugOptionsKey).copy( 541 AlwaysBasicDiff = true, 542 AlwaysBasicDB = false 543 ) 544 case SoCParamsKey => up(SoCParamsKey).copy( 545 UseXSTileDiffTop = true, 546 L3CacheParamsOpt = Some(up(SoCParamsKey).L3CacheParamsOpt.get.copy( 547 sramClkDivBy2 = false, 548 )), 549 ) 550 }) 551) 552 553class FpgaDiffMinimalConfig(n: Int = 1) extends Config( 554 (new MinimalConfig(n)).alter((site, here, up) => { 555 case DebugOptionsKey => up(DebugOptionsKey).copy( 556 AlwaysBasicDiff = true, 557 AlwaysBasicDB = false 558 ) 559 case SoCParamsKey => up(SoCParamsKey).copy( 560 UseXSTileDiffTop = true, 561 L3CacheParamsOpt = Some(up(SoCParamsKey).L3CacheParamsOpt.get.copy( 562 sramClkDivBy2 = false, 563 )), 564 ) 565 }) 566) 567