xref: /XiangShan/src/main/scala/xiangshan/Bundle.scala (revision 8744445e22fc180e4bd362b0da906f7e0f776bc1)
1c6d43980SLemover/***************************************************************************************
2c6d43980SLemover* Copyright (c) 2020-2021 Institute of Computing Technology, Chinese Academy of Sciences
3f320e0f0SYinan Xu* Copyright (c) 2020-2021 Peng Cheng Laboratory
4c6d43980SLemover*
5c6d43980SLemover* XiangShan is licensed under Mulan PSL v2.
6c6d43980SLemover* You can use this software according to the terms and conditions of the Mulan PSL v2.
7c6d43980SLemover* You may obtain a copy of Mulan PSL v2 at:
8c6d43980SLemover*          http://license.coscl.org.cn/MulanPSL2
9c6d43980SLemover*
10c6d43980SLemover* THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND,
11c6d43980SLemover* EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
12c6d43980SLemover* MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
13c6d43980SLemover*
14c6d43980SLemover* See the Mulan PSL v2 for more details.
15c6d43980SLemover***************************************************************************************/
16c6d43980SLemover
171e3fad10SLinJiaweipackage xiangshan
181e3fad10SLinJiawei
191e3fad10SLinJiaweiimport chisel3._
205844fcf0SLinJiaweiimport chisel3.util._
219aca92b9SYinan Xuimport xiangshan.backend.rob.RobPtr
22f06ca0bfSLingrui98import xiangshan.backend.CtrlToFtqIO
23de169c67SWilliam Wangimport xiangshan.backend.decode.{ImmUnion, XDecode}
245c1ae31bSYinan Xuimport xiangshan.mem.{LqPtr, SqPtr}
2566b0d0c3Szhanglinjuanimport xiangshan.frontend.PreDecodeInfo
26f00290d7SLingrui98import xiangshan.frontend.HasBPUParameter
27bcce877bSYinan Xuimport xiangshan.frontend.{AllFoldedHistories, CircularGlobalHistory, GlobalHistory, ShiftingGlobalHistory}
287447ee13SLingrui98import xiangshan.frontend.RASEntry
292b8b2e7aSWilliam Wangimport xiangshan.frontend.BPUCtrl
30e0d9a9f0SLingrui98import xiangshan.frontend.FtqPtr
31c2ad24ebSLingrui98import xiangshan.frontend.CGHPtr
32e0d9a9f0SLingrui98import xiangshan.frontend.FtqRead
33f06ca0bfSLingrui98import xiangshan.frontend.FtqToCtrlIO
34ceaf5e1fSLingrui98import utils._
353c02ee8fSwakafaimport utility._
36b0ae3ac4SLinJiawei
372fbdb79bSLingrui98import scala.math.max
38d471c5aeSLingrui98import Chisel.experimental.chiselName
392225d46eSJiawei Linimport chipsalliance.rocketchip.config.Parameters
4088825c5cSYinan Xuimport chisel3.util.BitPat.bitPatToUInt
41bcce877bSYinan Xuimport xiangshan.backend.exu.ExuConfig
42b6982e83SLemoverimport xiangshan.backend.fu.PMPEntry
4314a6653fSLingrui98import xiangshan.frontend.Ftq_Redirect_SRAMEntry
44dd6c0695SLingrui98import xiangshan.frontend.AllFoldedHistories
4567402d75SLingrui98import xiangshan.frontend.AllAheadFoldedHistoryOldestBits
461e3fad10SLinJiawei
47627c0a19Szhanglinjuanclass ValidUndirectioned[T <: Data](gen: T) extends Bundle {
483803411bSzhanglinjuan  val valid = Bool()
4935fe60e8SLingrui98  val bits = gen.cloneType.asInstanceOf[T]
50fe211d16SLinJiawei
513803411bSzhanglinjuan}
523803411bSzhanglinjuan
53627c0a19Szhanglinjuanobject ValidUndirectioned {
54627c0a19Szhanglinjuan  def apply[T <: Data](gen: T) = {
55627c0a19Szhanglinjuan    new ValidUndirectioned[T](gen)
563803411bSzhanglinjuan  }
573803411bSzhanglinjuan}
583803411bSzhanglinjuan
591b7adedcSWilliam Wangobject RSFeedbackType {
6067682d05SWilliam Wang  val tlbMiss = 0.U(3.W)
6167682d05SWilliam Wang  val mshrFull = 1.U(3.W)
6267682d05SWilliam Wang  val dataInvalid = 2.U(3.W)
6367682d05SWilliam Wang  val bankConflict = 3.U(3.W)
6467682d05SWilliam Wang  val ldVioCheckRedo = 4.U(3.W)
651b7adedcSWilliam Wang
66eb163ef0SHaojin Tang  val feedbackInvalid = 7.U(3.W)
67eb163ef0SHaojin Tang
6867682d05SWilliam Wang  def apply() = UInt(3.W)
691b7adedcSWilliam Wang}
701b7adedcSWilliam Wang
712225d46eSJiawei Linclass PredictorAnswer(implicit p: Parameters) extends XSBundle {
72097c2688SLingrui98  val hit    = if (!env.FPGAPlatform) Bool() else UInt(0.W)
73097c2688SLingrui98  val taken  = if (!env.FPGAPlatform) Bool() else UInt(0.W)
74097c2688SLingrui98  val target = if (!env.FPGAPlatform) UInt(VAddrBits.W) else UInt(0.W)
7551b2a476Szoujr}
7651b2a476Szoujr
772225d46eSJiawei Linclass CfiUpdateInfo(implicit p: Parameters) extends XSBundle with HasBPUParameter {
78f226232fSzhanglinjuan  // from backend
7969cafcc9SLingrui98  val pc = UInt(VAddrBits.W)
80f226232fSzhanglinjuan  // frontend -> backend -> frontend
81f226232fSzhanglinjuan  val pd = new PreDecodeInfo
828a5e9243SLinJiawei  val rasSp = UInt(log2Up(RasSize).W)
832e947747SLinJiawei  val rasEntry = new RASEntry
84c2ad24ebSLingrui98  // val hist = new ShiftingGlobalHistory
85dd6c0695SLingrui98  val folded_hist = new AllFoldedHistories(foldedGHistInfos)
8667402d75SLingrui98  val afhob = new AllAheadFoldedHistoryOldestBits(foldedGHistInfos)
8767402d75SLingrui98  val lastBrNumOH = UInt((numBr+1).W)
88b37e4b45SLingrui98  val ghr = UInt(UbtbGHRLength.W)
89c2ad24ebSLingrui98  val histPtr = new CGHPtr
90e7b046c5Szoujr  val specCnt = Vec(numBr, UInt(10.W))
91fe3a74fcSYinan Xu  // need pipeline update
928a597714Szoujr  val br_hit = Bool()
932e947747SLinJiawei  val predTaken = Bool()
94b2e6921eSLinJiawei  val target = UInt(VAddrBits.W)
959a2e6b8aSLinJiawei  val taken = Bool()
96b2e6921eSLinJiawei  val isMisPred = Bool()
97d0527adfSzoujr  val shift = UInt((log2Ceil(numBr)+1).W)
98d0527adfSzoujr  val addIntoHist = Bool()
9914a6653fSLingrui98
10014a6653fSLingrui98  def fromFtqRedirectSram(entry: Ftq_Redirect_SRAMEntry) = {
101c2ad24ebSLingrui98    // this.hist := entry.ghist
102dd6c0695SLingrui98    this.folded_hist := entry.folded_hist
10367402d75SLingrui98    this.lastBrNumOH := entry.lastBrNumOH
10467402d75SLingrui98    this.afhob := entry.afhob
105c2ad24ebSLingrui98    this.histPtr := entry.histPtr
10614a6653fSLingrui98    this.rasSp := entry.rasSp
107c2d1ec7dSLingrui98    this.rasEntry := entry.rasTop
10814a6653fSLingrui98    this
10914a6653fSLingrui98  }
110b2e6921eSLinJiawei}
111b2e6921eSLinJiawei
1125844fcf0SLinJiawei// Dequeue DecodeWidth insts from Ibuffer
113de169c67SWilliam Wangclass CtrlFlow(implicit p: Parameters) extends XSBundle {
1145844fcf0SLinJiawei  val instr = UInt(32.W)
1155844fcf0SLinJiawei  val pc = UInt(VAddrBits.W)
116de169c67SWilliam Wang  val foldpc = UInt(MemPredPCWidth.W)
117baf8def6SYinan Xu  val exceptionVec = ExceptionVec()
11872951335SLi Qianruo  val trigger = new TriggerCf
119faf3cfa9SLinJiawei  val pd = new PreDecodeInfo
120cde9280dSLinJiawei  val pred_taken = Bool()
121c84054caSLinJiawei  val crossPageIPFFix = Bool()
122de169c67SWilliam Wang  val storeSetHit = Bool() // inst has been allocated an store set
123980c1bc3SWilliam Wang  val waitForRobIdx = new RobPtr // store set predicted previous store robIdx
124d1fe0262SWilliam Wang  // Load wait is needed
125d1fe0262SWilliam Wang  // load inst will not be executed until former store (predicted by mdp) addr calcuated
126d1fe0262SWilliam Wang  val loadWaitBit = Bool()
127d1fe0262SWilliam Wang  // If (loadWaitBit && loadWaitStrict), strict load wait is needed
128d1fe0262SWilliam Wang  // load inst will not be executed until ALL former store addr calcuated
129d1fe0262SWilliam Wang  val loadWaitStrict = Bool()
130de169c67SWilliam Wang  val ssid = UInt(SSIDWidth.W)
131884dbb3bSLinJiawei  val ftqPtr = new FtqPtr
132884dbb3bSLinJiawei  val ftqOffset = UInt(log2Up(PredictWidth).W)
1335844fcf0SLinJiawei}
1345844fcf0SLinJiawei
13572951335SLi Qianruo
1362225d46eSJiawei Linclass FPUCtrlSignals(implicit p: Parameters) extends XSBundle {
1372ce29ed6SLinJiawei  val isAddSub = Bool() // swap23
138dc597826SJiawei Lin  val typeTagIn = UInt(1.W)
139dc597826SJiawei Lin  val typeTagOut = UInt(1.W)
1402ce29ed6SLinJiawei  val fromInt = Bool()
1412ce29ed6SLinJiawei  val wflags = Bool()
1422ce29ed6SLinJiawei  val fpWen = Bool()
1432ce29ed6SLinJiawei  val fmaCmd = UInt(2.W)
1442ce29ed6SLinJiawei  val div = Bool()
1452ce29ed6SLinJiawei  val sqrt = Bool()
1462ce29ed6SLinJiawei  val fcvt = Bool()
1472ce29ed6SLinJiawei  val typ = UInt(2.W)
1482ce29ed6SLinJiawei  val fmt = UInt(2.W)
1492ce29ed6SLinJiawei  val ren3 = Bool() //TODO: remove SrcType.fp
150e6c6b64fSLinJiawei  val rm = UInt(3.W)
151579b9f28SLinJiawei}
152579b9f28SLinJiawei
1535844fcf0SLinJiawei// Decode DecodeWidth insts at Decode Stage
1542225d46eSJiawei Linclass CtrlSignals(implicit p: Parameters) extends XSBundle {
155*8744445eSMaxpicca-Li  val debug_globalID = UInt(XLEN.W)
15620e31bd1SYinan Xu  val srcType = Vec(3, SrcType())
15720e31bd1SYinan Xu  val lsrc = Vec(3, UInt(5.W))
1589a2e6b8aSLinJiawei  val ldest = UInt(5.W)
1599a2e6b8aSLinJiawei  val fuType = FuType()
1609a2e6b8aSLinJiawei  val fuOpType = FuOpType()
1619a2e6b8aSLinJiawei  val rfWen = Bool()
1629a2e6b8aSLinJiawei  val fpWen = Bool()
1639a2e6b8aSLinJiawei  val isXSTrap = Bool()
1642d366136SLinJiawei  val noSpecExec = Bool() // wait forward
1652d366136SLinJiawei  val blockBackward = Bool() // block backward
16645a56a29SZhangZifei  val flushPipe = Bool() // This inst will flush all the pipe when commit, like exception but can commit
167c2a8ae00SYikeZhou  val selImm = SelImm()
168b0ae3ac4SLinJiawei  val imm = UInt(ImmUnion.maxLen.W)
169a3edac52SYinan Xu  val commitType = CommitType()
170579b9f28SLinJiawei  val fpu = new FPUCtrlSignals
171aac4464eSYinan Xu  val isMove = Bool()
172d4aca96cSlqre  val singleStep = Bool()
173c88c3a2aSYinan Xu  // This inst will flush all the pipe when it is the oldest inst in ROB,
174c88c3a2aSYinan Xu  // then replay from this inst itself
175c88c3a2aSYinan Xu  val replayInst = Bool()
176be25371aSYikeZhou
17788825c5cSYinan Xu  private def allSignals = srcType ++ Seq(fuType, fuOpType, rfWen, fpWen,
1786e7c9679Shuxuan0307    isXSTrap, noSpecExec, blockBackward, flushPipe, selImm)
17988825c5cSYinan Xu
18088825c5cSYinan Xu  def decode(inst: UInt, table: Iterable[(BitPat, List[BitPat])]): CtrlSignals = {
18188825c5cSYinan Xu    val decoder = freechips.rocketchip.rocket.DecodeLogic(inst, XDecode.decodeDefault, table)
18288825c5cSYinan Xu    allSignals zip decoder foreach { case (s, d) => s := d }
1834d24c305SYikeZhou    commitType := DontCare
184be25371aSYikeZhou    this
185be25371aSYikeZhou  }
18688825c5cSYinan Xu
18788825c5cSYinan Xu  def decode(bit: List[BitPat]): CtrlSignals = {
18888825c5cSYinan Xu    allSignals.zip(bit.map(bitPatToUInt(_))).foreach{ case (s, d) => s := d }
18988825c5cSYinan Xu    this
19088825c5cSYinan Xu  }
191b6900d94SYinan Xu
192b6900d94SYinan Xu  def isWFI: Bool = fuType === FuType.csr && fuOpType === CSROpType.wfi
193f025d715SYinan Xu  def isSoftPrefetch: Bool = {
194f025d715SYinan Xu    fuType === FuType.alu && fuOpType === ALUOpType.or && selImm === SelImm.IMM_I && ldest === 0.U
195f025d715SYinan Xu  }
1965844fcf0SLinJiawei}
1975844fcf0SLinJiawei
1982225d46eSJiawei Linclass CfCtrl(implicit p: Parameters) extends XSBundle {
1995844fcf0SLinJiawei  val cf = new CtrlFlow
2005844fcf0SLinJiawei  val ctrl = new CtrlSignals
2015844fcf0SLinJiawei}
2025844fcf0SLinJiawei
2032225d46eSJiawei Linclass PerfDebugInfo(implicit p: Parameters) extends XSBundle {
2048b8e745dSYikeZhou  val eliminatedMove = Bool()
205*8744445eSMaxpicca-Li  // val fetchTime = UInt(XLEN.W)
206ebb8ebf8SYinan Xu  val renameTime = UInt(XLEN.W)
207ebb8ebf8SYinan Xu  val dispatchTime = UInt(XLEN.W)
208ebb8ebf8SYinan Xu  val enqRsTime = UInt(XLEN.W)
209ebb8ebf8SYinan Xu  val selectTime = UInt(XLEN.W)
210ebb8ebf8SYinan Xu  val issueTime = UInt(XLEN.W)
211ebb8ebf8SYinan Xu  val writebackTime = UInt(XLEN.W)
212*8744445eSMaxpicca-Li  // val commitTime = UInt(XLEN.W)
213*8744445eSMaxpicca-Li  val runahead_checkpoint_id = UInt(XLEN.W)
214*8744445eSMaxpicca-Li  val tlbFirstReqTime = UInt(XLEN.W)
215*8744445eSMaxpicca-Li  val tlbRespTime = UInt(XLEN.W) // when getting hit result (including delay in L2TLB hit)
216ba4100caSYinan Xu}
217ba4100caSYinan Xu
21848d1472eSWilliam Wang// Separate LSQ
2192225d46eSJiawei Linclass LSIdx(implicit p: Parameters) extends XSBundle {
220915c0dd4SYinan Xu  val lqIdx = new LqPtr
2215c1ae31bSYinan Xu  val sqIdx = new SqPtr
22224726fbfSWilliam Wang}
22324726fbfSWilliam Wang
224b2e6921eSLinJiawei// CfCtrl -> MicroOp at Rename Stage
2252225d46eSJiawei Linclass MicroOp(implicit p: Parameters) extends CfCtrl {
22620e31bd1SYinan Xu  val srcState = Vec(3, SrcState())
22720e31bd1SYinan Xu  val psrc = Vec(3, UInt(PhyRegIdxWidth.W))
22820e31bd1SYinan Xu  val pdest = UInt(PhyRegIdxWidth.W)
22920e31bd1SYinan Xu  val old_pdest = UInt(PhyRegIdxWidth.W)
2309aca92b9SYinan Xu  val robIdx = new RobPtr
231fe6452fcSYinan Xu  val lqIdx = new LqPtr
232fe6452fcSYinan Xu  val sqIdx = new SqPtr
2338b8e745dSYikeZhou  val eliminatedMove = Bool()
2347cef916fSYinan Xu  val debugInfo = new PerfDebugInfo
2359d4e1137SYinan Xu  def needRfRPort(index: Int, isFp: Boolean, ignoreState: Boolean = true) : Bool = {
236bcce877bSYinan Xu    val stateReady = srcState(index) === SrcState.rdy || ignoreState.B
237bcce877bSYinan Xu    val readReg = if (isFp) {
238bcce877bSYinan Xu      ctrl.srcType(index) === SrcType.fp
239bcce877bSYinan Xu    } else {
240bcce877bSYinan Xu      ctrl.srcType(index) === SrcType.reg && ctrl.lsrc(index) =/= 0.U
241a338f247SYinan Xu    }
242bcce877bSYinan Xu    readReg && stateReady
243a338f247SYinan Xu  }
2445c7674feSYinan Xu  def srcIsReady: Vec[Bool] = {
245c9ebdf90SYinan Xu    VecInit(ctrl.srcType.zip(srcState).map{ case (t, s) => SrcType.isPcOrImm(t) || s === SrcState.rdy })
2465c7674feSYinan Xu  }
2476ab6918fSYinan Xu  def clearExceptions(
2486ab6918fSYinan Xu    exceptionBits: Seq[Int] = Seq(),
2496ab6918fSYinan Xu    flushPipe: Boolean = false,
2506ab6918fSYinan Xu    replayInst: Boolean = false
2516ab6918fSYinan Xu  ): MicroOp = {
2526ab6918fSYinan Xu    cf.exceptionVec.zipWithIndex.filterNot(x => exceptionBits.contains(x._2)).foreach(_._1 := false.B)
2536ab6918fSYinan Xu    if (!flushPipe) { ctrl.flushPipe := false.B }
2546ab6918fSYinan Xu    if (!replayInst) { ctrl.replayInst := false.B }
255c88c3a2aSYinan Xu    this
256c88c3a2aSYinan Xu  }
257a19215ddSYinan Xu  // Assume only the LUI instruction is decoded with IMM_U in ALU.
258a19215ddSYinan Xu  def isLUI: Bool = ctrl.selImm === SelImm.IMM_U && ctrl.fuType === FuType.alu
259bcce877bSYinan Xu  // This MicroOp is used to wakeup another uop (the successor: (psrc, srcType).
260bcce877bSYinan Xu  def wakeup(successor: Seq[(UInt, UInt)], exuCfg: ExuConfig): Seq[(Bool, Bool)] = {
261bcce877bSYinan Xu    successor.map{ case (src, srcType) =>
262bcce877bSYinan Xu      val pdestMatch = pdest === src
263bcce877bSYinan Xu      // For state: no need to check whether src is x0/imm/pc because they are always ready.
264bcce877bSYinan Xu      val rfStateMatch = if (exuCfg.readIntRf) ctrl.rfWen else false.B
265bcce877bSYinan Xu      val fpMatch = if (exuCfg.readFpRf) ctrl.fpWen else false.B
266bcce877bSYinan Xu      val bothIntFp = exuCfg.readIntRf && exuCfg.readFpRf
267bcce877bSYinan Xu      val bothStateMatch = Mux(SrcType.regIsFp(srcType), fpMatch, rfStateMatch)
268bcce877bSYinan Xu      val stateCond = pdestMatch && (if (bothIntFp) bothStateMatch else rfStateMatch || fpMatch)
269bcce877bSYinan Xu      // For data: types are matched and int pdest is not $zero.
270bcce877bSYinan Xu      val rfDataMatch = if (exuCfg.readIntRf) ctrl.rfWen && src =/= 0.U else false.B
271bcce877bSYinan Xu      val dataCond = pdestMatch && (rfDataMatch && SrcType.isReg(srcType) || fpMatch && SrcType.isFp(srcType))
272bcce877bSYinan Xu      (stateCond, dataCond)
273bcce877bSYinan Xu    }
274bcce877bSYinan Xu  }
275bcce877bSYinan Xu  // This MicroOp is used to wakeup another uop (the successor: MicroOp).
276bcce877bSYinan Xu  def wakeup(successor: MicroOp, exuCfg: ExuConfig): Seq[(Bool, Bool)] = {
277bcce877bSYinan Xu    wakeup(successor.psrc.zip(successor.ctrl.srcType), exuCfg)
278bcce877bSYinan Xu  }
27974515c5aSYinan Xu  def isJump: Bool = FuType.isJumpExu(ctrl.fuType)
2805844fcf0SLinJiawei}
2815844fcf0SLinJiawei
28246f74b57SHaojin Tangclass XSBundleWithMicroOp(implicit p: Parameters) extends XSBundle {
283de169c67SWilliam Wang  val uop = new MicroOp
28446f74b57SHaojin Tang}
28546f74b57SHaojin Tang
28646f74b57SHaojin Tangclass MicroOpRbExt(implicit p: Parameters) extends XSBundleWithMicroOp {
287de169c67SWilliam Wang  val flag = UInt(1.W)
288de169c67SWilliam Wang}
289de169c67SWilliam Wang
2902225d46eSJiawei Linclass Redirect(implicit p: Parameters) extends XSBundle {
2919aca92b9SYinan Xu  val robIdx = new RobPtr
29236d7aed5SLinJiawei  val ftqIdx = new FtqPtr
29336d7aed5SLinJiawei  val ftqOffset = UInt(log2Up(PredictWidth).W)
294bfb958a3SYinan Xu  val level = RedirectLevel()
295bfb958a3SYinan Xu  val interrupt = Bool()
296c778d2afSLinJiawei  val cfiUpdate = new CfiUpdateInfo
297bfb958a3SYinan Xu
298de169c67SWilliam Wang  val stFtqIdx = new FtqPtr // for load violation predict
299de169c67SWilliam Wang  val stFtqOffset = UInt(log2Up(PredictWidth).W)
300fe211d16SLinJiawei
30120edb3f7SWilliam Wang  val debug_runahead_checkpoint_id = UInt(64.W)
30220edb3f7SWilliam Wang
3032d7c7105SYinan Xu  // def isUnconditional() = RedirectLevel.isUnconditional(level)
304bfb958a3SYinan Xu  def flushItself() = RedirectLevel.flushItself(level)
3052d7c7105SYinan Xu  // def isException() = RedirectLevel.isException(level)
306a25b1bceSLinJiawei}
307a25b1bceSLinJiawei
3082225d46eSJiawei Linclass Dp1ToDp2IO(implicit p: Parameters) extends XSBundle {
3095c7b21d5SYinan Xu  val intDqToDp2 = Vec(dpParams.IntDqDeqWidth, DecoupledIO(new MicroOp))
3105c7b21d5SYinan Xu  val fpDqToDp2 = Vec(dpParams.FpDqDeqWidth, DecoupledIO(new MicroOp))
3115c7b21d5SYinan Xu  val lsDqToDp2 = Vec(dpParams.LsDqDeqWidth, DecoupledIO(new MicroOp))
3125844fcf0SLinJiawei}
3135844fcf0SLinJiawei
3142b4e8253SYinan Xuclass ResetPregStateReq(implicit p: Parameters) extends XSBundle {
31560deaca2SLinJiawei  // NOTE: set isInt and isFp both to 'false' when invalid
31660deaca2SLinJiawei  val isInt = Bool()
31760deaca2SLinJiawei  val isFp = Bool()
31860deaca2SLinJiawei  val preg = UInt(PhyRegIdxWidth.W)
3195844fcf0SLinJiawei}
3205844fcf0SLinJiawei
3212225d46eSJiawei Linclass DebugBundle(implicit p: Parameters) extends XSBundle {
32272235fa4SWilliam Wang  val isMMIO = Bool()
3238635f18fSwangkaifan  val isPerfCnt = Bool()
3248b91a337SWilliam Wang  val paddr = UInt(PAddrBits.W)
32572951335SLi Qianruo  val vaddr = UInt(VAddrBits.W)
326*8744445eSMaxpicca-Li  /* add L/S inst info in EXU */
327*8744445eSMaxpicca-Li  // val L1toL2TlbLatency = UInt(XLEN.W)
328*8744445eSMaxpicca-Li  // val levelTlbHit = UInt(2.W)
329e402d94eSWilliam Wang}
3305844fcf0SLinJiawei
33146f74b57SHaojin Tangclass ExuInput(implicit p: Parameters) extends XSBundleWithMicroOp {
332dc597826SJiawei Lin  val src = Vec(3, UInt(XLEN.W))
3335844fcf0SLinJiawei}
3345844fcf0SLinJiawei
33546f74b57SHaojin Tangclass ExuOutput(implicit p: Parameters) extends XSBundleWithMicroOp {
336dc597826SJiawei Lin  val data = UInt(XLEN.W)
3377f1506e3SLinJiawei  val fflags = UInt(5.W)
33897cfa7f8SLinJiawei  val redirectValid = Bool()
33997cfa7f8SLinJiawei  val redirect = new Redirect
340e402d94eSWilliam Wang  val debug = new DebugBundle
3415844fcf0SLinJiawei}
3425844fcf0SLinJiawei
3432225d46eSJiawei Linclass ExternalInterruptIO(implicit p: Parameters) extends XSBundle {
34435bfeecbSYinan Xu  val mtip = Input(Bool())
34535bfeecbSYinan Xu  val msip = Input(Bool())
34635bfeecbSYinan Xu  val meip = Input(Bool())
347b3d79b37SYinan Xu  val seip = Input(Bool())
348d4aca96cSlqre  val debug = Input(Bool())
3495844fcf0SLinJiawei}
3505844fcf0SLinJiawei
3512225d46eSJiawei Linclass CSRSpecialIO(implicit p: Parameters) extends XSBundle {
35235bfeecbSYinan Xu  val exception = Flipped(ValidIO(new MicroOp))
3533fa7b737SYinan Xu  val isInterrupt = Input(Bool())
35435bfeecbSYinan Xu  val memExceptionVAddr = Input(UInt(VAddrBits.W))
35535bfeecbSYinan Xu  val trapTarget = Output(UInt(VAddrBits.W))
35635bfeecbSYinan Xu  val externalInterrupt = new ExternalInterruptIO
35735bfeecbSYinan Xu  val interrupt = Output(Bool())
35835bfeecbSYinan Xu}
35935bfeecbSYinan Xu
36046f74b57SHaojin Tangclass ExceptionInfo(implicit p: Parameters) extends XSBundleWithMicroOp {
3613a474d38SYinan Xu  val isInterrupt = Bool()
3623a474d38SYinan Xu}
3633a474d38SYinan Xu
3649aca92b9SYinan Xuclass RobCommitInfo(implicit p: Parameters) extends XSBundle {
365fe6452fcSYinan Xu  val ldest = UInt(5.W)
366fe6452fcSYinan Xu  val rfWen = Bool()
367fe6452fcSYinan Xu  val fpWen = Bool()
368a1fd7de4SLinJiawei  val wflags = Bool()
369fe6452fcSYinan Xu  val commitType = CommitType()
370fe6452fcSYinan Xu  val pdest = UInt(PhyRegIdxWidth.W)
371fe6452fcSYinan Xu  val old_pdest = UInt(PhyRegIdxWidth.W)
372884dbb3bSLinJiawei  val ftqIdx = new FtqPtr
373884dbb3bSLinJiawei  val ftqOffset = UInt(log2Up(PredictWidth).W)
374ccfddc82SHaojin Tang  val isMove = Bool()
3755844fcf0SLinJiawei
3769ecac1e8SYinan Xu  // these should be optimized for synthesis verilog
3779ecac1e8SYinan Xu  val pc = UInt(VAddrBits.W)
378fe6452fcSYinan Xu}
3795844fcf0SLinJiawei
3809aca92b9SYinan Xuclass RobCommitIO(implicit p: Parameters) extends XSBundle {
381ccfddc82SHaojin Tang  val isCommit = Bool()
382ccfddc82SHaojin Tang  val commitValid = Vec(CommitWidth, Bool())
3836474c47fSYinan Xu
384ccfddc82SHaojin Tang  val isWalk = Bool()
385c51eab43SYinan Xu  // valid bits optimized for walk
386ccfddc82SHaojin Tang  val walkValid = Vec(CommitWidth, Bool())
3876474c47fSYinan Xu
388ccfddc82SHaojin Tang  val info = Vec(CommitWidth, new RobCommitInfo)
38921e7a6c5SYinan Xu
3906474c47fSYinan Xu  def hasWalkInstr: Bool = isWalk && walkValid.asUInt.orR
3916474c47fSYinan Xu  def hasCommitInstr: Bool = isCommit && commitValid.asUInt.orR
3925844fcf0SLinJiawei}
3935844fcf0SLinJiawei
3941b7adedcSWilliam Wangclass RSFeedback(implicit p: Parameters) extends XSBundle {
39564e8d8bdSZhangZifei  val rsIdx = UInt(log2Up(IssQueSize).W)
396037a131fSWilliam Wang  val hit = Bool()
39762f57a35SLemover  val flushState = Bool()
3981b7adedcSWilliam Wang  val sourceType = RSFeedbackType()
399c7160cd3SWilliam Wang  val dataInvalidSqIdx = new SqPtr
400037a131fSWilliam Wang}
401037a131fSWilliam Wang
402d87b76aaSWilliam Wangclass MemRSFeedbackIO(implicit p: Parameters) extends XSBundle {
403d87b76aaSWilliam Wang  // Note: you need to update in implicit Parameters p before imp MemRSFeedbackIO
404d87b76aaSWilliam Wang  // for instance: MemRSFeedbackIO()(updateP)
405d87b76aaSWilliam Wang  val feedbackSlow = ValidIO(new RSFeedback()) // dcache miss queue full, dtlb miss
406d87b76aaSWilliam Wang  val feedbackFast = ValidIO(new RSFeedback()) // bank conflict
407d87b76aaSWilliam Wang  val rsIdx = Input(UInt(log2Up(IssQueSize).W))
408d87b76aaSWilliam Wang  val isFirstIssue = Input(Bool())
409d87b76aaSWilliam Wang}
410d87b76aaSWilliam Wang
411f06ca0bfSLingrui98class FrontendToCtrlIO(implicit p: Parameters) extends XSBundle {
4125844fcf0SLinJiawei  // to backend end
4135844fcf0SLinJiawei  val cfVec = Vec(DecodeWidth, DecoupledIO(new CtrlFlow))
414f06ca0bfSLingrui98  val fromFtq = new FtqToCtrlIO
4155844fcf0SLinJiawei  // from backend
416f06ca0bfSLingrui98  val toFtq = Flipped(new CtrlToFtqIO)
4171e3fad10SLinJiawei}
418fcff7e94SZhangZifei
419f1fe8698SLemoverclass SatpStruct(implicit p: Parameters) extends XSBundle {
42045f497a4Shappy-lx  val mode = UInt(4.W)
42145f497a4Shappy-lx  val asid = UInt(16.W)
42245f497a4Shappy-lx  val ppn  = UInt(44.W)
42345f497a4Shappy-lx}
42445f497a4Shappy-lx
425f1fe8698SLemoverclass TlbSatpBundle(implicit p: Parameters) extends SatpStruct {
42645f497a4Shappy-lx  val changed = Bool()
42745f497a4Shappy-lx
42845f497a4Shappy-lx  def apply(satp_value: UInt): Unit = {
42945f497a4Shappy-lx    require(satp_value.getWidth == XLEN)
43045f497a4Shappy-lx    val sa = satp_value.asTypeOf(new SatpStruct)
43145f497a4Shappy-lx    mode := sa.mode
43245f497a4Shappy-lx    asid := sa.asid
433f1fe8698SLemover    ppn := Cat(0.U(44-PAddrBits), sa.ppn(PAddrBits-1, 0)).asUInt()
43445f497a4Shappy-lx    changed := DataChanged(sa.asid) // when ppn is changed, software need do the flush
43545f497a4Shappy-lx  }
436fcff7e94SZhangZifei}
437f1fe8698SLemover
438f1fe8698SLemoverclass TlbCsrBundle(implicit p: Parameters) extends XSBundle {
439f1fe8698SLemover  val satp = new TlbSatpBundle()
440fcff7e94SZhangZifei  val priv = new Bundle {
441fcff7e94SZhangZifei    val mxr = Bool()
442fcff7e94SZhangZifei    val sum = Bool()
443fcff7e94SZhangZifei    val imode = UInt(2.W)
444fcff7e94SZhangZifei    val dmode = UInt(2.W)
445fcff7e94SZhangZifei  }
4468fc4e859SZhangZifei
4478fc4e859SZhangZifei  override def toPrintable: Printable = {
4488fc4e859SZhangZifei    p"Satp mode:0x${Hexadecimal(satp.mode)} asid:0x${Hexadecimal(satp.asid)} ppn:0x${Hexadecimal(satp.ppn)} " +
4498fc4e859SZhangZifei      p"Priv mxr:${priv.mxr} sum:${priv.sum} imode:${priv.imode} dmode:${priv.dmode}"
4508fc4e859SZhangZifei  }
451fcff7e94SZhangZifei}
452fcff7e94SZhangZifei
4532225d46eSJiawei Linclass SfenceBundle(implicit p: Parameters) extends XSBundle {
454fcff7e94SZhangZifei  val valid = Bool()
455fcff7e94SZhangZifei  val bits = new Bundle {
456fcff7e94SZhangZifei    val rs1 = Bool()
457fcff7e94SZhangZifei    val rs2 = Bool()
458fcff7e94SZhangZifei    val addr = UInt(VAddrBits.W)
45945f497a4Shappy-lx    val asid = UInt(AsidLength.W)
460f1fe8698SLemover    val flushPipe = Bool()
461fcff7e94SZhangZifei  }
4628fc4e859SZhangZifei
4638fc4e859SZhangZifei  override def toPrintable: Printable = {
464f1fe8698SLemover    p"valid:0x${Hexadecimal(valid)} rs1:${bits.rs1} rs2:${bits.rs2} addr:${Hexadecimal(bits.addr)}, flushPipe:${bits.flushPipe}"
4658fc4e859SZhangZifei  }
466fcff7e94SZhangZifei}
467a165bd69Swangkaifan
468de169c67SWilliam Wang// Bundle for load violation predictor updating
469de169c67SWilliam Wangclass MemPredUpdateReq(implicit p: Parameters) extends XSBundle  {
4702b8b2e7aSWilliam Wang  val valid = Bool()
471de169c67SWilliam Wang
472de169c67SWilliam Wang  // wait table update
473de169c67SWilliam Wang  val waddr = UInt(MemPredPCWidth.W)
4742b8b2e7aSWilliam Wang  val wdata = Bool() // true.B by default
475de169c67SWilliam Wang
476de169c67SWilliam Wang  // store set update
477de169c67SWilliam Wang  // by default, ldpc/stpc should be xor folded
478de169c67SWilliam Wang  val ldpc = UInt(MemPredPCWidth.W)
479de169c67SWilliam Wang  val stpc = UInt(MemPredPCWidth.W)
4802b8b2e7aSWilliam Wang}
4812b8b2e7aSWilliam Wang
4822225d46eSJiawei Linclass CustomCSRCtrlIO(implicit p: Parameters) extends XSBundle {
4832b8b2e7aSWilliam Wang  // Prefetcher
484ecccf78fSJay  val l1I_pf_enable = Output(Bool())
4852b8b2e7aSWilliam Wang  val l2_pf_enable = Output(Bool())
48685de5caeSLinJiawei  val l1D_pf_enable = Output(Bool())
48785de5caeSLinJiawei  val l1D_pf_train_on_hit = Output(Bool())
48885de5caeSLinJiawei  val l1D_pf_enable_agt = Output(Bool())
48985de5caeSLinJiawei  val l1D_pf_enable_pht = Output(Bool())
4905d13017eSLinJiawei  val l1D_pf_active_threshold = Output(UInt(4.W))
4915d13017eSLinJiawei  val l1D_pf_active_stride = Output(UInt(6.W))
492edbf1204SLinJiawei  val l1D_pf_enable_stride = Output(Bool())
493f1d78cf7SLinJiawei  val l2_pf_store_only = Output(Bool())
494ecccf78fSJay  // ICache
495ecccf78fSJay  val icache_parity_enable = Output(Bool())
496f3f22d72SYinan Xu  // Labeled XiangShan
4972b8b2e7aSWilliam Wang  val dsid = Output(UInt(8.W)) // TODO: DsidWidth as parameter
498f3f22d72SYinan Xu  // Load violation predictor
4992b8b2e7aSWilliam Wang  val lvpred_disable = Output(Bool())
5002b8b2e7aSWilliam Wang  val no_spec_load = Output(Bool())
501c7160cd3SWilliam Wang  val storeset_wait_store = Output(Bool())
502c7160cd3SWilliam Wang  val storeset_no_fast_wakeup = Output(Bool())
503c7160cd3SWilliam Wang  val lvpred_timeout = Output(UInt(5.W))
504f3f22d72SYinan Xu  // Branch predictor
5052b8b2e7aSWilliam Wang  val bp_ctrl = Output(new BPUCtrl)
506f3f22d72SYinan Xu  // Memory Block
507f3f22d72SYinan Xu  val sbuffer_threshold = Output(UInt(4.W))
508d10a581eSWilliam Wang  val ldld_vio_check_enable = Output(Bool())
509d10a581eSWilliam Wang  val soft_prefetch_enable = Output(Bool())
510a4e57ea3SLi Qianruo  val cache_error_enable = Output(Bool())
51137225120Ssfencevma  val uncache_write_outstanding_enable = Output(Bool())
512aac4464eSYinan Xu  // Rename
5135b47c58cSYinan Xu  val fusion_enable = Output(Bool())
5145b47c58cSYinan Xu  val wfi_enable = Output(Bool())
515af2f7849Shappy-lx  // Decode
516af2f7849Shappy-lx  val svinval_enable = Output(Bool())
517af2f7849Shappy-lx
518b6982e83SLemover  // distribute csr write signal
519b6982e83SLemover  val distribute_csr = new DistributedCSRIO()
52072951335SLi Qianruo
521ddb65c47SLi Qianruo  val singlestep = Output(Bool())
52272951335SLi Qianruo  val frontend_trigger = new FrontendTdataDistributeIO()
52372951335SLi Qianruo  val mem_trigger = new MemTdataDistributeIO()
52472951335SLi Qianruo  val trigger_enable = Output(Vec(10, Bool()))
525b6982e83SLemover}
526b6982e83SLemover
527b6982e83SLemoverclass DistributedCSRIO(implicit p: Parameters) extends XSBundle {
5281c746d3aScui fliter  // CSR has been written by csr inst, copies of csr should be updated
529b6982e83SLemover  val w = ValidIO(new Bundle {
530b6982e83SLemover    val addr = Output(UInt(12.W))
531b6982e83SLemover    val data = Output(UInt(XLEN.W))
532b6982e83SLemover  })
5332b8b2e7aSWilliam Wang}
534e19f7967SWilliam Wang
535e19f7967SWilliam Wangclass DistributedCSRUpdateReq(implicit p: Parameters) extends XSBundle {
536e19f7967SWilliam Wang  // Request csr to be updated
537e19f7967SWilliam Wang  //
538e19f7967SWilliam Wang  // Note that this request will ONLY update CSR Module it self,
539e19f7967SWilliam Wang  // copies of csr will NOT be updated, use it with care!
540e19f7967SWilliam Wang  //
541e19f7967SWilliam Wang  // For each cycle, no more than 1 DistributedCSRUpdateReq is valid
542e19f7967SWilliam Wang  val w = ValidIO(new Bundle {
543e19f7967SWilliam Wang    val addr = Output(UInt(12.W))
544e19f7967SWilliam Wang    val data = Output(UInt(XLEN.W))
545e19f7967SWilliam Wang  })
546e19f7967SWilliam Wang  def apply(valid: Bool, addr: UInt, data: UInt, src_description: String) = {
547e19f7967SWilliam Wang    when(valid){
548e19f7967SWilliam Wang      w.bits.addr := addr
549e19f7967SWilliam Wang      w.bits.data := data
550e19f7967SWilliam Wang    }
551e19f7967SWilliam Wang    println("Distributed CSR update req registered for " + src_description)
552e19f7967SWilliam Wang  }
553e19f7967SWilliam Wang}
55472951335SLi Qianruo
5550f59c834SWilliam Wangclass L1CacheErrorInfo(implicit p: Parameters) extends XSBundle {
5560f59c834SWilliam Wang  // L1CacheErrorInfo is also used to encode customized CACHE_ERROR CSR
5570f59c834SWilliam Wang  val source = Output(new Bundle() {
5580f59c834SWilliam Wang    val tag = Bool() // l1 tag array
5590f59c834SWilliam Wang    val data = Bool() // l1 data array
5600f59c834SWilliam Wang    val l2 = Bool()
5610f59c834SWilliam Wang  })
5620f59c834SWilliam Wang  val opType = Output(new Bundle() {
5630f59c834SWilliam Wang    val fetch = Bool()
5640f59c834SWilliam Wang    val load = Bool()
5650f59c834SWilliam Wang    val store = Bool()
5660f59c834SWilliam Wang    val probe = Bool()
5670f59c834SWilliam Wang    val release = Bool()
5680f59c834SWilliam Wang    val atom = Bool()
5690f59c834SWilliam Wang  })
5700f59c834SWilliam Wang  val paddr = Output(UInt(PAddrBits.W))
5710f59c834SWilliam Wang
5720f59c834SWilliam Wang  // report error and paddr to beu
5730f59c834SWilliam Wang  // bus error unit will receive error info iff ecc_error.valid
5740f59c834SWilliam Wang  val report_to_beu = Output(Bool())
5750f59c834SWilliam Wang
5760f59c834SWilliam Wang  // there is an valid error
5770f59c834SWilliam Wang  // l1 cache error will always be report to CACHE_ERROR csr
5780f59c834SWilliam Wang  val valid = Output(Bool())
5790f59c834SWilliam Wang
5800f59c834SWilliam Wang  def toL1BusErrorUnitInfo(): L1BusErrorUnitInfo = {
5810f59c834SWilliam Wang    val beu_info = Wire(new L1BusErrorUnitInfo)
5820f59c834SWilliam Wang    beu_info.ecc_error.valid := report_to_beu
5830f59c834SWilliam Wang    beu_info.ecc_error.bits := paddr
5840f59c834SWilliam Wang    beu_info
5850f59c834SWilliam Wang  }
5860f59c834SWilliam Wang}
587bc63e578SLi Qianruo
588bc63e578SLi Qianruo/* TODO how to trigger on next inst?
589bc63e578SLi Qianruo1. If hit is determined at frontend, then set a "next instr" trap at dispatch like singlestep
590bc63e578SLi Qianruo2. If it is determined at Load(meaning it must be "hit after", then it must not be a jump. So we can let it commit and set
591bc63e578SLi Qianruoxret csr to pc + 4/ + 2
592bc63e578SLi Qianruo2.5 The problem is to let it commit. This is the real TODO
593bc63e578SLi Qianruo3. If it is load and hit before just treat it as regular load exception
594bc63e578SLi Qianruo */
595bc63e578SLi Qianruo
596bc63e578SLi Qianruo// This bundle carries trigger hit info along the pipeline
597bc63e578SLi Qianruo// Now there are 10 triggers divided into 5 groups of 2
598bc63e578SLi Qianruo// These groups are
599bc63e578SLi Qianruo// (if if) (store store) (load loid) (if store) (if load)
600bc63e578SLi Qianruo
601bc63e578SLi Qianruo// Triggers in the same group can chain, meaning that they only
602bc63e578SLi Qianruo// fire is both triggers in the group matches (the triggerHitVec bit is asserted)
603bc63e578SLi Qianruo// Chaining of trigger No. (2i) and (2i+1) is indicated by triggerChainVec(i)
604bc63e578SLi Qianruo// Timing of 0 means trap at current inst, 1 means trap at next inst
605bc63e578SLi Qianruo// Chaining and timing and the validness of a trigger is controlled by csr
606bc63e578SLi Qianruo// In two chained triggers, if they have different timing, both won't fire
60784e47f35SLi Qianruo//class TriggerCf (implicit p: Parameters) extends XSBundle {
60884e47f35SLi Qianruo//  val triggerHitVec = Vec(10, Bool())
60984e47f35SLi Qianruo//  val triggerTiming = Vec(10, Bool())
61084e47f35SLi Qianruo//  val triggerChainVec = Vec(5, Bool())
61184e47f35SLi Qianruo//}
61284e47f35SLi Qianruo
61372951335SLi Qianruoclass TriggerCf(implicit p: Parameters) extends XSBundle {
61484e47f35SLi Qianruo  // frontend
61584e47f35SLi Qianruo  val frontendHit = Vec(4, Bool())
616ddb65c47SLi Qianruo//  val frontendTiming = Vec(4, Bool())
617ddb65c47SLi Qianruo//  val frontendHitNext = Vec(4, Bool())
61884e47f35SLi Qianruo
619ddb65c47SLi Qianruo//  val frontendException = Bool()
62084e47f35SLi Qianruo  // backend
62184e47f35SLi Qianruo  val backendEn = Vec(2, Bool()) // Hit(6) && chain(4) , Hit(8) && chain(4)
62284e47f35SLi Qianruo  val backendHit = Vec(6, Bool())
623ddb65c47SLi Qianruo//  val backendTiming = Vec(6, Bool()) // trigger enable fro chain
62484e47f35SLi Qianruo
62584e47f35SLi Qianruo  // Two situations not allowed:
62684e47f35SLi Qianruo  // 1. load data comparison
62784e47f35SLi Qianruo  // 2. store chaining with store
62884e47f35SLi Qianruo  def getHitFrontend = frontendHit.reduce(_ || _)
62984e47f35SLi Qianruo  def getHitBackend = backendHit.reduce(_ || _)
630ddb65c47SLi Qianruo  def hit = getHitFrontend || getHitBackend
631d7dd1af1SLi Qianruo  def clear(): Unit = {
632d7dd1af1SLi Qianruo    frontendHit.foreach(_ := false.B)
633d7dd1af1SLi Qianruo    backendEn.foreach(_ := false.B)
634d7dd1af1SLi Qianruo    backendHit.foreach(_ := false.B)
635d7dd1af1SLi Qianruo  }
63672951335SLi Qianruo}
63772951335SLi Qianruo
638bc63e578SLi Qianruo// these 3 bundles help distribute trigger control signals from CSR
639bc63e578SLi Qianruo// to Frontend, Load and Store.
64072951335SLi Qianruoclass FrontendTdataDistributeIO(implicit p: Parameters)  extends XSBundle {
64172951335SLi Qianruo    val t = Valid(new Bundle {
64272951335SLi Qianruo      val addr = Output(UInt(2.W))
64372951335SLi Qianruo      val tdata = new MatchTriggerIO
64472951335SLi Qianruo    })
64572951335SLi Qianruo  }
64672951335SLi Qianruo
64772951335SLi Qianruoclass MemTdataDistributeIO(implicit p: Parameters)  extends XSBundle {
64872951335SLi Qianruo  val t = Valid(new Bundle {
64972951335SLi Qianruo    val addr = Output(UInt(3.W))
65072951335SLi Qianruo    val tdata = new MatchTriggerIO
65172951335SLi Qianruo  })
65272951335SLi Qianruo}
65372951335SLi Qianruo
65472951335SLi Qianruoclass MatchTriggerIO(implicit p: Parameters) extends XSBundle {
65572951335SLi Qianruo  val matchType = Output(UInt(2.W))
65672951335SLi Qianruo  val select = Output(Bool())
65772951335SLi Qianruo  val timing = Output(Bool())
65872951335SLi Qianruo  val action = Output(Bool())
65972951335SLi Qianruo  val chain = Output(Bool())
66072951335SLi Qianruo  val tdata2 = Output(UInt(64.W))
66172951335SLi Qianruo}
662