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) extends Config((site, here, up) => { 288 case XSTileKey => 289 require(inclusive, "L2 must be inclusive") 290 val nKB = size.toUpperCase() match { 291 case s"${k}KB" => k.trim().toInt 292 case s"${m}MB" => (m.trim().toDouble * 1024).toInt 293 } 294 val upParams = up(XSTileKey) 295 val l2sets = nKB * 1024 / banks / ways / 64 296 upParams.map(p => p.copy( 297 L2CacheParamsOpt = Some(L2Param( 298 name = "L2", 299 ways = ways, 300 sets = l2sets, 301 clientCaches = Seq(L1Param( 302 "dcache", 303 sets = 2 * p.dcacheParametersOpt.get.nSets / banks, 304 ways = p.dcacheParametersOpt.get.nWays + 2, 305 aliasBitsOpt = p.dcacheParametersOpt.get.aliasBitsOpt, 306 vaddrBitsOpt = Some(p.GPAddrBitsSv48x4 - log2Up(p.dcacheParametersOpt.get.blockBytes)), 307 isKeywordBitsOpt = p.dcacheParametersOpt.get.isKeywordBitsOpt 308 )), 309 reqField = Seq(utility.ReqSourceField()), 310 echoField = Seq(huancun.DirtyField()), 311 tagECC = Some("secded"), 312 dataECC = Some("secded"), 313 enableTagECC = true, 314 enableDataECC = true, 315 dataCheck = Some("oddparity"), 316 enablePoison = true, 317 prefetch = Seq(BOPParameters()) ++ 318 (if (tp) Seq(TPParameters()) else Nil) ++ 319 (if (p.prefetcher.nonEmpty) Seq(PrefetchReceiverParams()) else Nil), 320 enablePerf = !site(DebugOptionsKey).FPGAPlatform && site(DebugOptionsKey).EnablePerfDebug, 321 enableRollingDB = site(DebugOptionsKey).EnableRollingDB, 322 enableMonitor = site(DebugOptionsKey).AlwaysBasicDB, 323 elaboratedTopDown = !site(DebugOptionsKey).FPGAPlatform 324 )), 325 L2NBanks = banks 326 )) 327}) 328 329case class L3CacheConfig(size: String, ways: Int = 8, inclusive: Boolean = true, banks: Int = 1) extends Config((site, here, up) => { 330 case SoCParamsKey => 331 val nKB = size.toUpperCase() match { 332 case s"${k}KB" => k.trim().toInt 333 case s"${m}MB" => (m.trim().toDouble * 1024).toInt 334 } 335 val sets = nKB * 1024 / banks / ways / 64 336 val tiles = site(XSTileKey) 337 val clientDirBytes = tiles.map{ t => 338 t.L2NBanks * t.L2CacheParamsOpt.map(_.toCacheParams.capacity).getOrElse(0) 339 }.sum 340 up(SoCParamsKey).copy( 341 L3NBanks = banks, 342 L3CacheParamsOpt = Option.when(!up(EnableCHI))(HCCacheParameters( 343 name = "L3", 344 level = 3, 345 ways = ways, 346 sets = sets, 347 inclusive = inclusive, 348 clientCaches = tiles.map{ core => 349 val l2params = core.L2CacheParamsOpt.get.toCacheParams 350 l2params.copy(sets = 2 * clientDirBytes / core.L2NBanks / l2params.ways / 64, ways = l2params.ways + 2) 351 }, 352 enablePerf = !site(DebugOptionsKey).FPGAPlatform && site(DebugOptionsKey).EnablePerfDebug, 353 ctrl = Some(CacheCtrl( 354 address = 0x39000000, 355 numCores = tiles.size 356 )), 357 reqField = Seq(utility.ReqSourceField()), 358 sramClkDivBy2 = true, 359 sramDepthDiv = 4, 360 tagECC = Some("secded"), 361 dataECC = Some("secded"), 362 simulation = !site(DebugOptionsKey).FPGAPlatform, 363 prefetch = Some(huancun.prefetch.L3PrefetchReceiverParams()), 364 tpmeta = Some(huancun.prefetch.DefaultTPmetaParameters()) 365 )), 366 OpenLLCParamsOpt = Option.when(up(EnableCHI))(OpenLLCParam( 367 name = "LLC", 368 ways = ways, 369 sets = sets, 370 banks = banks, 371 fullAddressBits = 48, 372 clientCaches = tiles.map { core => 373 val l2params = core.L2CacheParamsOpt.get 374 l2params.copy(sets = 2 * clientDirBytes / core.L2NBanks / l2params.ways / 64, ways = l2params.ways + 2) 375 }, 376 enablePerf = !site(DebugOptionsKey).FPGAPlatform && site(DebugOptionsKey).EnablePerfDebug, 377 elaboratedTopDown = !site(DebugOptionsKey).FPGAPlatform 378 )) 379 ) 380}) 381 382class WithL3DebugConfig extends Config( 383 L3CacheConfig("256KB", inclusive = false) ++ L2CacheConfig("64KB") 384) 385 386class MinimalL3DebugConfig(n: Int = 1) extends Config( 387 new WithL3DebugConfig ++ new MinimalConfig(n) 388) 389 390class DefaultL3DebugConfig(n: Int = 1) extends Config( 391 new WithL3DebugConfig ++ new BaseConfig(n) 392) 393 394class WithFuzzer extends Config((site, here, up) => { 395 case DebugOptionsKey => up(DebugOptionsKey).copy( 396 EnablePerfDebug = false, 397 ) 398 case SoCParamsKey => up(SoCParamsKey).copy( 399 L3CacheParamsOpt = up(SoCParamsKey).L3CacheParamsOpt.map(_.copy( 400 enablePerf = false, 401 )), 402 OpenLLCParamsOpt = up(SoCParamsKey).OpenLLCParamsOpt.map(_.copy( 403 enablePerf = false, 404 )), 405 ) 406 case XSTileKey => up(XSTileKey).zipWithIndex.map{ case (p, i) => 407 p.copy( 408 L2CacheParamsOpt = Some(up(XSTileKey)(i).L2CacheParamsOpt.get.copy( 409 enablePerf = false, 410 )), 411 ) 412 } 413}) 414 415class CVMCompile extends Config((site, here, up) => { 416 case CVMParamskey => up(CVMParamskey).copy( 417 KeyIDBits = 5, 418 HasMEMencryption = true, 419 HasDelayNoencryption = false 420 ) 421 case XSTileKey => up(XSTileKey).map(_.copy( 422 HasBitmapCheck = true, 423 HasBitmapCheckDefault = false)) 424}) 425 426class CVMTestCompile extends Config((site, here, up) => { 427 case CVMParamskey => up(CVMParamskey).copy( 428 KeyIDBits = 5, 429 HasMEMencryption = true, 430 HasDelayNoencryption = true 431 ) 432 case XSTileKey => up(XSTileKey).map(_.copy( 433 HasBitmapCheck =true, 434 HasBitmapCheckDefault = true)) 435}) 436 437class MinimalAliasDebugConfig(n: Int = 1) extends Config( 438 L3CacheConfig("512KB", inclusive = false) 439 ++ L2CacheConfig("256KB", inclusive = true) 440 ++ WithNKBL1D(128) 441 ++ new MinimalConfig(n) 442) 443 444class MediumConfig(n: Int = 1) extends Config( 445 L3CacheConfig("4MB", inclusive = false, banks = 4) 446 ++ L2CacheConfig("512KB", inclusive = true) 447 ++ WithNKBL1D(128) 448 ++ new BaseConfig(n) 449) 450 451class FuzzConfig(dummy: Int = 0) extends Config( 452 new WithFuzzer 453 ++ new DefaultConfig(1) 454) 455 456class DefaultConfig(n: Int = 1) extends Config( 457 L3CacheConfig("16MB", inclusive = false, banks = 4, ways = 16) 458 ++ L2CacheConfig("1MB", inclusive = true, banks = 4) 459 ++ WithNKBL1D(64, ways = 4) 460 ++ new BaseConfig(n, true) 461) 462 463class CVMConfig(n: Int = 1) extends Config( 464 new CVMCompile 465 ++ new DefaultConfig(n) 466) 467 468class CVMTestConfig(n: Int = 1) extends Config( 469 new CVMTestCompile 470 ++ new DefaultConfig(n) 471) 472 473class WithCHI extends Config((_, _, _) => { 474 case EnableCHI => true 475}) 476 477class KunminghuV2Config(n: Int = 1) extends Config( 478 L2CacheConfig("1MB", inclusive = true, banks = 4, tp = false) 479 ++ new DefaultConfig(n) 480 ++ new WithCHI 481) 482 483class KunminghuV2MinimalConfig(n: Int = 1) extends Config( 484 L2CacheConfig("128KB", inclusive = true, banks = 1, tp = false) 485 ++ WithNKBL1D(32, ways = 4) 486 ++ new MinimalConfig(n) 487 ++ new WithCHI 488) 489 490class XSNoCTopConfig(n: Int = 1) extends Config( 491 (new KunminghuV2Config(n)).alter((site, here, up) => { 492 case SoCParamsKey => up(SoCParamsKey).copy(UseXSNoCTop = true) 493 }) 494) 495 496class XSNoCTopMinimalConfig(n: Int = 1) extends Config( 497 (new KunminghuV2MinimalConfig(n)).alter((site, here, up) => { 498 case SoCParamsKey => up(SoCParamsKey).copy(UseXSNoCTop = true) 499 }) 500) 501 502class XSNoCDiffTopConfig(n: Int = 1) extends Config( 503 (new XSNoCTopConfig(n)).alter((site, here, up) => { 504 case SoCParamsKey => up(SoCParamsKey).copy(UseXSNoCDiffTop = true) 505 }) 506) 507 508class XSNoCDiffTopMinimalConfig(n: Int = 1) extends Config( 509 (new XSNoCTopConfig(n)).alter((site, here, up) => { 510 case SoCParamsKey => up(SoCParamsKey).copy(UseXSNoCDiffTop = true) 511 }) 512) 513 514class FpgaDefaultConfig(n: Int = 1) extends Config( 515 (L3CacheConfig("3MB", inclusive = false, banks = 1, ways = 6) 516 ++ L2CacheConfig("1MB", inclusive = true, banks = 4) 517 ++ WithNKBL1D(64, ways = 4) 518 ++ new BaseConfig(n)).alter((site, here, up) => { 519 case DebugOptionsKey => up(DebugOptionsKey).copy( 520 AlwaysBasicDiff = false, 521 AlwaysBasicDB = false 522 ) 523 case SoCParamsKey => up(SoCParamsKey).copy( 524 L3CacheParamsOpt = Some(up(SoCParamsKey).L3CacheParamsOpt.get.copy( 525 sramClkDivBy2 = false, 526 )), 527 ) 528 }) 529) 530 531class FpgaDiffDefaultConfig(n: Int = 1) extends Config( 532 (L3CacheConfig("3MB", inclusive = false, banks = 1, ways = 6) 533 ++ L2CacheConfig("1MB", inclusive = true, banks = 4) 534 ++ WithNKBL1D(64, ways = 4) 535 ++ new BaseConfig(n)).alter((site, here, up) => { 536 case DebugOptionsKey => up(DebugOptionsKey).copy( 537 AlwaysBasicDiff = true, 538 AlwaysBasicDB = false 539 ) 540 case SoCParamsKey => up(SoCParamsKey).copy( 541 UseXSTileDiffTop = true, 542 L3CacheParamsOpt = Some(up(SoCParamsKey).L3CacheParamsOpt.get.copy( 543 sramClkDivBy2 = false, 544 )), 545 ) 546 }) 547) 548 549class FpgaDiffMinimalConfig(n: Int = 1) extends Config( 550 (new MinimalConfig(n)).alter((site, here, up) => { 551 case DebugOptionsKey => up(DebugOptionsKey).copy( 552 AlwaysBasicDiff = true, 553 AlwaysBasicDB = false 554 ) 555 case SoCParamsKey => up(SoCParamsKey).copy( 556 UseXSTileDiffTop = true, 557 L3CacheParamsOpt = Some(up(SoCParamsKey).L3CacheParamsOpt.get.copy( 558 sramClkDivBy2 = false, 559 )), 560 ) 561 }) 562) 563