xref: /XiangShan/src/main/scala/xiangshan/backend/fu/CSR.scala (revision 0be64786e3f92090f2feec39645c2052ed97cd82)
1package xiangshan.backend.fu
2
3import chisel3._
4import chisel3.ExcitingUtils.{ConnectionType, Debug}
5import chisel3.util._
6import utils._
7import xiangshan._
8import xiangshan.backend._
9import xiangshan.frontend.BPUCtrl
10import xiangshan.backend.fu.util._
11
12trait HasExceptionNO {
13  def instrAddrMisaligned = 0
14  def instrAccessFault    = 1
15  def illegalInstr        = 2
16  def breakPoint          = 3
17  def loadAddrMisaligned  = 4
18  def loadAccessFault     = 5
19  def storeAddrMisaligned = 6
20  def storeAccessFault    = 7
21  def ecallU              = 8
22  def ecallS              = 9
23  def ecallM              = 11
24  def instrPageFault      = 12
25  def loadPageFault       = 13
26  def storePageFault      = 15
27
28  val ExcPriority = Seq(
29    breakPoint, // TODO: different BP has different priority
30    instrPageFault,
31    instrAccessFault,
32    illegalInstr,
33    instrAddrMisaligned,
34    ecallM, ecallS, ecallU,
35    storePageFault,
36    loadPageFault,
37    storeAccessFault,
38    loadAccessFault,
39    storeAddrMisaligned,
40    loadAddrMisaligned
41  )
42  val frontendSet = List(
43    // instrAddrMisaligned,
44    instrAccessFault,
45    illegalInstr,
46    instrPageFault
47  )
48  val csrSet = List(
49    illegalInstr,
50    breakPoint,
51    ecallU,
52    ecallS,
53    ecallM
54  )
55  val loadUnitSet = List(
56    loadAddrMisaligned,
57    loadAccessFault,
58    loadPageFault
59  )
60  val storeUnitSet = List(
61    storeAddrMisaligned,
62    storeAccessFault,
63    storePageFault
64  )
65  val atomicsUnitSet = (loadUnitSet ++ storeUnitSet).distinct
66  val allPossibleSet = (frontendSet ++ csrSet ++ loadUnitSet ++ storeUnitSet).distinct
67  val csrWbCount = (0 until 16).map(i => if (csrSet.contains(i)) 1 else 0)
68  val loadWbCount = (0 until 16).map(i => if (loadUnitSet.contains(i)) 1 else 0)
69  val storeWbCount = (0 until 16).map(i => if (storeUnitSet.contains(i)) 1 else 0)
70  val atomicsWbCount = (0 until 16).map(i => if (atomicsUnitSet.contains(i)) 1 else 0)
71  val writebackCount = (0 until 16).map(i => csrWbCount(i) + atomicsWbCount(i) + loadWbCount(i) + 2 * storeWbCount(i))
72  def partialSelect(vec: Vec[Bool], select: Seq[Int], dontCareBits: Boolean = true, falseBits: Boolean = false): Vec[Bool] = {
73    if (dontCareBits) {
74      val new_vec = Wire(ExceptionVec())
75      new_vec := DontCare
76      select.map(i => new_vec(i) := vec(i))
77      return new_vec
78    }
79    else if (falseBits) {
80      val new_vec = Wire(ExceptionVec())
81      new_vec.map(_ := false.B)
82      select.map(i => new_vec(i) := vec(i))
83      return new_vec
84    }
85    else {
86      val new_vec = Wire(Vec(select.length, Bool()))
87      select.zipWithIndex.map{ case(s, i) => new_vec(i) := vec(s) }
88      return new_vec
89    }
90  }
91  def selectFrontend(vec: Vec[Bool], dontCareBits: Boolean = true, falseBits: Boolean = false): Vec[Bool] =
92    partialSelect(vec, frontendSet, dontCareBits, falseBits)
93  def selectCSR(vec: Vec[Bool], dontCareBits: Boolean = true, falseBits: Boolean = false): Vec[Bool] =
94    partialSelect(vec, csrSet, dontCareBits, falseBits)
95  def selectLoad(vec: Vec[Bool], dontCareBits: Boolean = true, falseBits: Boolean = false): Vec[Bool] =
96    partialSelect(vec, loadUnitSet, dontCareBits, falseBits)
97  def selectStore(vec: Vec[Bool], dontCareBits: Boolean = true, falseBits: Boolean = false): Vec[Bool] =
98    partialSelect(vec, storeUnitSet, dontCareBits, falseBits)
99  def selectAtomics(vec: Vec[Bool], dontCareBits: Boolean = true, falseBits: Boolean = false): Vec[Bool] =
100    partialSelect(vec, atomicsUnitSet, dontCareBits, falseBits)
101  def selectAll(vec: Vec[Bool], dontCareBits: Boolean = true, falseBits: Boolean = false): Vec[Bool] =
102    partialSelect(vec, allPossibleSet, dontCareBits, falseBits)
103}
104
105class FpuCsrIO extends XSBundle {
106  val fflags = Output(Valid(UInt(5.W)))
107  val isIllegal = Output(Bool())
108  val dirty_fs = Output(Bool())
109  val frm = Input(UInt(3.W))
110}
111
112
113class PerfCounterIO extends XSBundle {
114  val retiredInstr = Input(UInt(3.W))
115  val value = Input(UInt(XLEN.W))
116}
117
118class CSRFileIO extends XSBundle {
119  val hartId = Input(UInt(64.W))
120  // output (for func === CSROpType.jmp)
121  val perf = new PerfCounterIO
122  val isPerfCnt = Output(Bool())
123  // to FPU
124  val fpu = Flipped(new FpuCsrIO)
125  // from rob
126  val exception = Flipped(ValidIO(new ExceptionInfo))
127  // to ROB
128  val isXRet = Output(Bool())
129  val trapTarget = Output(UInt(VAddrBits.W))
130  val interrupt = Output(Bool())
131  // from LSQ
132  val memExceptionVAddr = Input(UInt(VAddrBits.W))
133  // from outside cpu,externalInterrupt
134  val externalInterrupt = new ExternalInterruptIO
135  // TLB
136  val tlb = Output(new TlbCsrBundle)
137  // Custom microarchiture ctrl signal
138  val customCtrl = Output(new CustomCSRCtrlIO)
139}
140
141class CSR extends FunctionUnit with HasCSRConst
142{
143  val csrio = IO(new CSRFileIO)
144  val difftestIO = IO(new Bundle() {
145    val intrNO = Output(UInt(64.W))
146    val cause = Output(UInt(64.W))
147    val priviledgeMode = Output(UInt(2.W))
148    val mstatus = Output(UInt(64.W))
149    val sstatus = Output(UInt(64.W))
150    val mepc = Output(UInt(64.W))
151    val sepc = Output(UInt(64.W))
152    val mtval = Output(UInt(64.W))
153    val stval = Output(UInt(64.W))
154    val mtvec = Output(UInt(64.W))
155    val stvec = Output(UInt(64.W))
156    val mcause = Output(UInt(64.W))
157    val scause = Output(UInt(64.W))
158    val satp = Output(UInt(64.W))
159    val mip = Output(UInt(64.W))
160    val mie = Output(UInt(64.W))
161    val mscratch = Output(UInt(64.W))
162    val sscratch = Output(UInt(64.W))
163    val mideleg = Output(UInt(64.W))
164    val medeleg = Output(UInt(64.W))
165  })
166  difftestIO <> DontCare
167
168  val cfIn = io.in.bits.uop.cf
169  val cfOut = Wire(new CtrlFlow)
170  cfOut := cfIn
171  val flushPipe = Wire(Bool())
172
173  val (valid, src1, src2, func) = (
174    io.in.valid,
175    io.in.bits.src(0),
176    io.in.bits.uop.ctrl.imm,
177    io.in.bits.uop.ctrl.fuOpType
178  )
179
180  // CSR define
181
182  class Priv extends Bundle {
183    val m = Output(Bool())
184    val h = Output(Bool())
185    val s = Output(Bool())
186    val u = Output(Bool())
187  }
188
189  val csrNotImplemented = RegInit(UInt(XLEN.W), 0.U)
190
191  class MstatusStruct extends Bundle {
192    val sd = Output(UInt(1.W))
193
194    val pad1 = if (XLEN == 64) Output(UInt(27.W)) else null
195    val sxl  = if (XLEN == 64) Output(UInt(2.W))  else null
196    val uxl  = if (XLEN == 64) Output(UInt(2.W))  else null
197    val pad0 = if (XLEN == 64) Output(UInt(9.W))  else Output(UInt(8.W))
198
199    val tsr = Output(UInt(1.W))
200    val tw = Output(UInt(1.W))
201    val tvm = Output(UInt(1.W))
202    val mxr = Output(UInt(1.W))
203    val sum = Output(UInt(1.W))
204    val mprv = Output(UInt(1.W))
205    val xs = Output(UInt(2.W))
206    val fs = Output(UInt(2.W))
207    val mpp = Output(UInt(2.W))
208    val hpp = Output(UInt(2.W))
209    val spp = Output(UInt(1.W))
210    val pie = new Priv
211    val ie = new Priv
212    assert(this.getWidth == XLEN)
213  }
214
215  class SatpStruct extends Bundle {
216    val mode = UInt(4.W)
217    val asid = UInt(16.W)
218    val ppn  = UInt(44.W)
219  }
220
221  class Interrupt extends Bundle {
222    val e = new Priv
223    val t = new Priv
224    val s = new Priv
225  }
226
227  // Machine-Level CSRs
228
229  val mtvec = RegInit(UInt(XLEN.W), 0.U)
230  val mcounteren = RegInit(UInt(XLEN.W), 0.U)
231  val mcause = RegInit(UInt(XLEN.W), 0.U)
232  val mtval = RegInit(UInt(XLEN.W), 0.U)
233  val mepc = Reg(UInt(XLEN.W))
234
235  val mie = RegInit(0.U(XLEN.W))
236  val mipWire = WireInit(0.U.asTypeOf(new Interrupt))
237  val mipReg  = RegInit(0.U.asTypeOf(new Interrupt).asUInt)
238  val mipFixMask = GenMask(9) | GenMask(5) | GenMask(1)
239  val mip = (mipWire.asUInt | mipReg).asTypeOf(new Interrupt)
240
241  def getMisaMxl(mxl: Int): UInt = {mxl.U << (XLEN-2)}.asUInt()
242  def getMisaExt(ext: Char): UInt = {1.U << (ext.toInt - 'a'.toInt)}.asUInt()
243  var extList = List('a', 's', 'i', 'u')
244  if (HasMExtension) { extList = extList :+ 'm' }
245  if (HasCExtension) { extList = extList :+ 'c' }
246  if (HasFPU) { extList = extList ++ List('f', 'd') }
247  val misaInitVal = getMisaMxl(2) | extList.foldLeft(0.U)((sum, i) => sum | getMisaExt(i)) //"h8000000000141105".U
248  val misa = RegInit(UInt(XLEN.W), misaInitVal)
249
250  // MXL = 2          | 0 | EXT = b 00 0000 0100 0001 0001 0000 0101
251  // (XLEN-1, XLEN-2) |   |(25, 0)  ZY XWVU TSRQ PONM LKJI HGFE DCBA
252
253  val mvendorid = RegInit(UInt(XLEN.W), 0.U) // this is a non-commercial implementation
254  val marchid = RegInit(UInt(XLEN.W), 0.U) // return 0 to indicate the field is not implemented
255  val mimpid = RegInit(UInt(XLEN.W), 0.U) // provides a unique encoding of the version of the processor implementation
256  val mhartid = RegInit(UInt(XLEN.W), csrio.hartId) // the hardware thread running the code
257  val mstatus = RegInit(UInt(XLEN.W), 0.U)
258
259  // mstatus Value Table
260  // | sd   |
261  // | pad1 |
262  // | sxl  | hardlinked to 10, use 00 to pass xv6 test
263  // | uxl  | hardlinked to 00
264  // | pad0 |
265  // | tsr  |
266  // | tw   |
267  // | tvm  |
268  // | mxr  |
269  // | sum  |
270  // | mprv |
271  // | xs   | 00 |
272  // | fs   | 00 |
273  // | mpp  | 00 |
274  // | hpp  | 00 |
275  // | spp  | 0 |
276  // | pie  | 0000 | pie.h is used as UBE
277  // | ie   | 0000 | uie hardlinked to 0, as N ext is not implemented
278
279  val mstatusStruct = mstatus.asTypeOf(new MstatusStruct)
280  def mstatusUpdateSideEffect(mstatus: UInt): UInt = {
281    val mstatusOld = WireInit(mstatus.asTypeOf(new MstatusStruct))
282    val mstatusNew = Cat(mstatusOld.xs === "b11".U || mstatusOld.fs === "b11".U, mstatus(XLEN-2, 0))
283    mstatusNew
284  }
285
286  val mstatusMask = (~ZeroExt((
287    GenMask(XLEN-2, 38) | GenMask(31, 23) | GenMask(10, 9) | GenMask(2) |
288    GenMask(37) | // MBE
289    GenMask(36) | // SBE
290    GenMask(6)    // UBE
291  ), 64)).asUInt()
292
293  val medeleg = RegInit(UInt(XLEN.W), 0.U)
294  val mideleg = RegInit(UInt(XLEN.W), 0.U)
295  val mscratch = RegInit(UInt(XLEN.W), 0.U)
296
297  val pmpcfg0 = RegInit(UInt(XLEN.W), 0.U)
298  val pmpcfg1 = RegInit(UInt(XLEN.W), 0.U)
299  val pmpcfg2 = RegInit(UInt(XLEN.W), 0.U)
300  val pmpcfg3 = RegInit(UInt(XLEN.W), 0.U)
301  val pmpaddr0 = RegInit(UInt(XLEN.W), 0.U)
302  val pmpaddr1 = RegInit(UInt(XLEN.W), 0.U)
303  val pmpaddr2 = RegInit(UInt(XLEN.W), 0.U)
304  val pmpaddr3 = RegInit(UInt(XLEN.W), 0.U)
305
306  // Superviser-Level CSRs
307
308  // val sstatus = RegInit(UInt(XLEN.W), "h00000000".U)
309  val sstatusWmask = "hc6122".U
310  // Sstatus Write Mask
311  // -------------------------------------------------------
312  //    19           9   5     2
313  // 0  1100 0000 0001 0010 0010
314  // 0  c    0    1    2    2
315  // -------------------------------------------------------
316  val sstatusRmask = sstatusWmask | "h8000000300018000".U
317  // Sstatus Read Mask = (SSTATUS_WMASK | (0xf << 13) | (1ull << 63) | (3ull << 32))
318  val stvec = RegInit(UInt(XLEN.W), 0.U)
319  // val sie = RegInit(0.U(XLEN.W))
320  val sieMask = "h222".U & mideleg
321  val sipMask  = "h222".U & mideleg
322  val satp = if(EnbaleTlbDebug) RegInit(UInt(XLEN.W), "h8000000000087fbe".U) else RegInit(0.U(XLEN.W))
323  // val satp = RegInit(UInt(XLEN.W), "h8000000000087fbe".U) // only use for tlb naive debug
324  val satpMask = "h80000fffffffffff".U // disable asid, mode can only be 8 / 0
325  val sepc = RegInit(UInt(XLEN.W), 0.U)
326  val scause = RegInit(UInt(XLEN.W), 0.U)
327  val stval = Reg(UInt(XLEN.W))
328  val sscratch = RegInit(UInt(XLEN.W), 0.U)
329  val scounteren = RegInit(UInt(XLEN.W), 0.U)
330
331  // sbpctl
332  // Bits 0-7: {LOOP, RAS, SC, TAGE, BIM, BTB, uBTB}
333  val sbpctl = RegInit(UInt(XLEN.W), "h7f".U)
334  csrio.customCtrl.bp_ctrl.ubtb_enable := sbpctl(0)
335  csrio.customCtrl.bp_ctrl.btb_enable  := sbpctl(1)
336  csrio.customCtrl.bp_ctrl.bim_enable  := sbpctl(2)
337  csrio.customCtrl.bp_ctrl.tage_enable := sbpctl(3)
338  csrio.customCtrl.bp_ctrl.sc_enable   := sbpctl(4)
339  csrio.customCtrl.bp_ctrl.ras_enable  := sbpctl(5)
340  csrio.customCtrl.bp_ctrl.loop_enable := sbpctl(6)
341
342  // spfctl Bit 0: L1plusCache Prefetcher Enable
343  // spfctl Bit 1: L2Cache Prefetcher Enable
344  val spfctl = RegInit(UInt(XLEN.W), "h3".U)
345  csrio.customCtrl.l1plus_pf_enable := spfctl(0)
346  csrio.customCtrl.l2_pf_enable := spfctl(1)
347
348  // sdsid: Differentiated Services ID
349  val sdsid = RegInit(UInt(XLEN.W), 0.U)
350  csrio.customCtrl.dsid := sdsid
351
352  // slvpredctl: load violation predict settings
353  val slvpredctl = RegInit(UInt(XLEN.W), "h70".U) // default reset period: 2^17
354  csrio.customCtrl.lvpred_disable := slvpredctl(0)
355  csrio.customCtrl.no_spec_load := slvpredctl(1)
356  csrio.customCtrl.waittable_timeout := slvpredctl(8, 4)
357
358  val tlbBundle = Wire(new TlbCsrBundle)
359  tlbBundle.satp := satp.asTypeOf(new SatpStruct)
360  csrio.tlb := tlbBundle
361
362  // User-Level CSRs
363  val uepc = Reg(UInt(XLEN.W))
364
365  // fcsr
366  class FcsrStruct extends Bundle {
367    val reserved = UInt((XLEN-3-5).W)
368    val frm = UInt(3.W)
369    val fflags = UInt(5.W)
370    assert(this.getWidth == XLEN)
371  }
372  val fcsr = RegInit(0.U(XLEN.W))
373  // set mstatus->sd and mstatus->fs when true
374  val csrw_dirty_fp_state = WireInit(false.B)
375
376  def frm_wfn(wdata: UInt): UInt = {
377    val fcsrOld = WireInit(fcsr.asTypeOf(new FcsrStruct))
378    csrw_dirty_fp_state := true.B
379    fcsrOld.frm := wdata(2,0)
380    fcsrOld.asUInt()
381  }
382  def frm_rfn(rdata: UInt): UInt = rdata(7,5)
383
384  def fflags_wfn(update: Boolean)(wdata: UInt): UInt = {
385    val fcsrOld = fcsr.asTypeOf(new FcsrStruct)
386    val fcsrNew = WireInit(fcsrOld)
387    csrw_dirty_fp_state := true.B
388    if (update) {
389      fcsrNew.fflags := wdata(4,0) | fcsrOld.fflags
390    } else {
391      fcsrNew.fflags := wdata(4,0)
392    }
393    fcsrNew.asUInt()
394  }
395  def fflags_rfn(rdata:UInt): UInt = rdata(4,0)
396
397  def fcsr_wfn(wdata: UInt): UInt = {
398    val fcsrOld = WireInit(fcsr.asTypeOf(new FcsrStruct))
399    csrw_dirty_fp_state := true.B
400    Cat(fcsrOld.reserved, wdata.asTypeOf(fcsrOld).frm, wdata.asTypeOf(fcsrOld).fflags)
401  }
402
403  val fcsrMapping = Map(
404    MaskedRegMap(Fflags, fcsr, wfn = fflags_wfn(update = false), rfn = fflags_rfn),
405    MaskedRegMap(Frm, fcsr, wfn = frm_wfn, rfn = frm_rfn),
406    MaskedRegMap(Fcsr, fcsr, wfn = fcsr_wfn)
407  )
408
409  // Atom LR/SC Control Bits
410  //  val setLr = WireInit(Bool(), false.B)
411  //  val setLrVal = WireInit(Bool(), false.B)
412  //  val setLrAddr = WireInit(UInt(AddrBits.W), DontCare) //TODO : need check
413  //  val lr = RegInit(Bool(), false.B)
414  //  val lrAddr = RegInit(UInt(AddrBits.W), 0.U)
415  //
416  //  when (setLr) {
417  //    lr := setLrVal
418  //    lrAddr := setLrAddr
419  //  }
420
421  // Hart Priviledge Mode
422  val priviledgeMode = RegInit(UInt(2.W), ModeM)
423
424  // Emu perfcnt
425  val hasEmuPerfCnt = !env.FPGAPlatform
426  val nrEmuPerfCnts = if (hasEmuPerfCnt) 0x80 else 0x3
427
428  val emuPerfCnts    = List.fill(nrEmuPerfCnts)(RegInit(0.U(XLEN.W)))
429  val emuPerfCntCond = List.fill(nrEmuPerfCnts)(WireInit(false.B))
430  (emuPerfCnts zip emuPerfCntCond).map { case (c, e) => when (e) { c := c + 1.U } }
431
432  val emuPerfCntsLoMapping = (0 until nrEmuPerfCnts).map(i => MaskedRegMap(0x1000 + i, emuPerfCnts(i)))
433  val emuPerfCntsHiMapping = (0 until nrEmuPerfCnts).map(i => MaskedRegMap(0x1080 + i, emuPerfCnts(i)(63, 32)))
434  println(s"CSR: hasEmuPerfCnt:${hasEmuPerfCnt}")
435
436  // Perf Counter
437  val nrPerfCnts = 29  // 3...31
438  val perfCnts   = List.fill(nrPerfCnts)(RegInit(0.U(XLEN.W)))
439  val perfEvents = List.fill(nrPerfCnts)(RegInit(0.U(XLEN.W)))
440  val mcountinhibit = RegInit(0.U(XLEN.W))
441  val mcycle = RegInit(0.U(XLEN.W))
442  mcycle := mcycle + 1.U
443  val minstret = RegInit(0.U(XLEN.W))
444  minstret := minstret + RegNext(csrio.perf.retiredInstr)
445
446  // CSR reg map
447  val basicPrivMapping = Map(
448
449    //--- User Trap Setup ---
450    // MaskedRegMap(Ustatus, ustatus),
451    // MaskedRegMap(Uie, uie, 0.U, MaskedRegMap.Unwritable),
452    // MaskedRegMap(Utvec, utvec),
453
454    //--- User Trap Handling ---
455    // MaskedRegMap(Uscratch, uscratch),
456    // MaskedRegMap(Uepc, uepc),
457    // MaskedRegMap(Ucause, ucause),
458    // MaskedRegMap(Utval, utval),
459    // MaskedRegMap(Uip, uip),
460
461    //--- User Counter/Timers ---
462    // MaskedRegMap(Cycle, cycle),
463    // MaskedRegMap(Time, time),
464    // MaskedRegMap(Instret, instret),
465
466    //--- Supervisor Trap Setup ---
467    MaskedRegMap(Sstatus, mstatus, sstatusWmask, mstatusUpdateSideEffect, sstatusRmask),
468    // MaskedRegMap(Sedeleg, Sedeleg),
469    // MaskedRegMap(Sideleg, Sideleg),
470    MaskedRegMap(Sie, mie, sieMask, MaskedRegMap.NoSideEffect, sieMask),
471    MaskedRegMap(Stvec, stvec),
472    MaskedRegMap(Scounteren, scounteren),
473
474    //--- Supervisor Trap Handling ---
475    MaskedRegMap(Sscratch, sscratch),
476    MaskedRegMap(Sepc, sepc),
477    MaskedRegMap(Scause, scause),
478    MaskedRegMap(Stval, stval),
479    MaskedRegMap(Sip, mip.asUInt, sipMask, MaskedRegMap.Unwritable, sipMask),
480
481    //--- Supervisor Protection and Translation ---
482    MaskedRegMap(Satp, satp, satpMask, MaskedRegMap.NoSideEffect, satpMask),
483
484    //--- Supervisor Custom Read/Write Registers
485    MaskedRegMap(Sbpctl, sbpctl),
486    MaskedRegMap(Spfctl, spfctl),
487    MaskedRegMap(Sdsid, sdsid),
488    MaskedRegMap(Slvpredctl, slvpredctl),
489
490    //--- Machine Information Registers ---
491    MaskedRegMap(Mvendorid, mvendorid, 0.U, MaskedRegMap.Unwritable),
492    MaskedRegMap(Marchid, marchid, 0.U, MaskedRegMap.Unwritable),
493    MaskedRegMap(Mimpid, mimpid, 0.U, MaskedRegMap.Unwritable),
494    MaskedRegMap(Mhartid, mhartid, 0.U, MaskedRegMap.Unwritable),
495
496    //--- Machine Trap Setup ---
497    MaskedRegMap(Mstatus, mstatus, mstatusMask, mstatusUpdateSideEffect, mstatusMask),
498    MaskedRegMap(Misa, misa), // now MXL, EXT is not changeable
499    MaskedRegMap(Medeleg, medeleg, "hf3ff".U),
500    MaskedRegMap(Mideleg, mideleg, "h222".U),
501    MaskedRegMap(Mie, mie),
502    MaskedRegMap(Mtvec, mtvec),
503    MaskedRegMap(Mcounteren, mcounteren),
504
505    //--- Machine Trap Handling ---
506    MaskedRegMap(Mscratch, mscratch),
507    MaskedRegMap(Mepc, mepc),
508    MaskedRegMap(Mcause, mcause),
509    MaskedRegMap(Mtval, mtval),
510    MaskedRegMap(Mip, mip.asUInt, 0.U, MaskedRegMap.Unwritable),
511  )
512
513  // PMP is unimplemented yet
514  val pmpMapping = Map(
515    MaskedRegMap(Pmpcfg0, pmpcfg0),
516    MaskedRegMap(Pmpcfg1, pmpcfg1),
517    MaskedRegMap(Pmpcfg2, pmpcfg2),
518    MaskedRegMap(Pmpcfg3, pmpcfg3),
519    MaskedRegMap(PmpaddrBase + 0, pmpaddr0),
520    MaskedRegMap(PmpaddrBase + 1, pmpaddr1),
521    MaskedRegMap(PmpaddrBase + 2, pmpaddr2),
522    MaskedRegMap(PmpaddrBase + 3, pmpaddr3)
523  )
524
525  var perfCntMapping = Map(
526    MaskedRegMap(Mcountinhibit, mcountinhibit),
527    MaskedRegMap(Mcycle, mcycle),
528    MaskedRegMap(Minstret, minstret),
529  )
530  val MhpmcounterStart = Mhpmcounter3
531  val MhpmeventStart   = Mhpmevent3
532  for (i <- 0 until nrPerfCnts) {
533    perfCntMapping += MaskedRegMap(MhpmcounterStart + i, perfCnts(i))
534    perfCntMapping += MaskedRegMap(MhpmeventStart + i, perfEvents(i))
535  }
536
537  val mapping = basicPrivMapping ++
538                perfCntMapping ++
539                pmpMapping ++
540                emuPerfCntsLoMapping ++
541                (if (XLEN == 32) emuPerfCntsHiMapping else Nil) ++
542                (if (HasFPU) fcsrMapping else Nil)
543
544  val addr = src2(11, 0)
545  val csri = ZeroExt(src2(16, 12), XLEN)
546  val rdata = Wire(UInt(XLEN.W))
547  val wdata = LookupTree(func, List(
548    CSROpType.wrt  -> src1,
549    CSROpType.set  -> (rdata | src1),
550    CSROpType.clr  -> (rdata & (~src1).asUInt()),
551    CSROpType.wrti -> csri,
552    CSROpType.seti -> (rdata | csri),
553    CSROpType.clri -> (rdata & (~csri).asUInt())
554  ))
555
556  val addrInPerfCnt = (addr >= Mcycle.U) && (addr <= Mhpmcounter31.U)
557  csrio.isPerfCnt := addrInPerfCnt
558
559  // satp wen check
560  val satpLegalMode = (wdata.asTypeOf(new SatpStruct).mode===0.U) || (wdata.asTypeOf(new SatpStruct).mode===8.U)
561
562  // general CSR wen check
563  val wen = valid && func =/= CSROpType.jmp && (addr=/=Satp.U || satpLegalMode)
564  val modePermitted = csrAccessPermissionCheck(addr, false.B, priviledgeMode)
565  val perfcntPermitted = perfcntPermissionCheck(addr, priviledgeMode, mcounteren, scounteren)
566  val permitted = Mux(addrInPerfCnt, perfcntPermitted, modePermitted)
567  // Writeable check is ingored.
568  // Currently, write to illegal csr addr will be ignored
569  MaskedRegMap.generate(mapping, addr, rdata, wen && permitted, wdata)
570  io.out.bits.data := rdata
571  io.out.bits.uop := io.in.bits.uop
572  io.out.bits.uop.cf := cfOut
573  io.out.bits.uop.ctrl.flushPipe := flushPipe
574
575  // Fix Mip/Sip write
576  val fixMapping = Map(
577    MaskedRegMap(Mip, mipReg.asUInt, mipFixMask),
578    MaskedRegMap(Sip, mipReg.asUInt, sipMask, MaskedRegMap.NoSideEffect, sipMask)
579  )
580  val rdataDummy = Wire(UInt(XLEN.W))
581  MaskedRegMap.generate(fixMapping, addr, rdataDummy, wen, wdata)
582
583  when (csrio.fpu.fflags.valid) {
584    fcsr := fflags_wfn(update = true)(csrio.fpu.fflags.bits)
585  }
586  // set fs and sd in mstatus
587  when (csrw_dirty_fp_state || csrio.fpu.dirty_fs) {
588    val mstatusNew = WireInit(mstatus.asTypeOf(new MstatusStruct))
589    mstatusNew.fs := "b11".U
590    mstatusNew.sd := true.B
591    mstatus := mstatusNew.asUInt()
592  }
593  csrio.fpu.frm := fcsr.asTypeOf(new FcsrStruct).frm
594
595  // CSR inst decode
596  val isEbreak = addr === privEbreak && func === CSROpType.jmp
597  val isEcall  = addr === privEcall  && func === CSROpType.jmp
598  val isMret   = addr === privMret   && func === CSROpType.jmp
599  val isSret   = addr === privSret   && func === CSROpType.jmp
600  val isUret   = addr === privUret   && func === CSROpType.jmp
601
602  XSDebug(wen, "csr write: pc %x addr %x rdata %x wdata %x func %x\n", cfIn.pc, addr, rdata, wdata, func)
603  XSDebug(wen, "pc %x mstatus %x mideleg %x medeleg %x mode %x\n", cfIn.pc, mstatus, mideleg , medeleg, priviledgeMode)
604
605  // Illegal priviledged operation list
606  val illegalSModeSret = valid && isSret && priviledgeMode === ModeS && mstatusStruct.tsr.asBool
607
608  // Illegal priviledged instruction check
609  val isIllegalAddr = MaskedRegMap.isIllegalAddr(mapping, addr)
610  val isIllegalAccess = !permitted
611  val isIllegalPrivOp = illegalSModeSret
612
613  // def MMUPermissionCheck(ptev: Bool, pteu: Bool): Bool = ptev && !(priviledgeMode === ModeU && !pteu) && !(priviledgeMode === ModeS && pteu && mstatusStruct.sum.asBool)
614  // def MMUPermissionCheckLoad(ptev: Bool, pteu: Bool): Bool = ptev && !(priviledgeMode === ModeU && !pteu) && !(priviledgeMode === ModeS && pteu && mstatusStruct.sum.asBool) && (pter || (mstatusStruct.mxr && ptex))
615  // imem
616  // val imemPtev = true.B
617  // val imemPteu = true.B
618  // val imemPtex = true.B
619  // val imemReq = true.B
620  // val imemPermissionCheckPassed = MMUPermissionCheck(imemPtev, imemPteu)
621  // val hasInstrPageFault = imemReq && !(imemPermissionCheckPassed && imemPtex)
622  // assert(!hasInstrPageFault)
623
624  // dmem
625  // val dmemPtev = true.B
626  // val dmemPteu = true.B
627  // val dmemReq = true.B
628  // val dmemPermissionCheckPassed = MMUPermissionCheck(dmemPtev, dmemPteu)
629  // val dmemIsStore = true.B
630
631  // val hasLoadPageFault  = dmemReq && !dmemIsStore && !(dmemPermissionCheckPassed)
632  // val hasStorePageFault = dmemReq &&  dmemIsStore && !(dmemPermissionCheckPassed)
633  // assert(!hasLoadPageFault)
634  // assert(!hasStorePageFault)
635
636  //TODO: Havn't test if io.dmemMMU.priviledgeMode is correct yet
637  tlbBundle.priv.mxr   := mstatusStruct.mxr.asBool
638  tlbBundle.priv.sum   := mstatusStruct.sum.asBool
639  tlbBundle.priv.imode := priviledgeMode
640  tlbBundle.priv.dmode := Mux(mstatusStruct.mprv.asBool, mstatusStruct.mpp, priviledgeMode)
641
642  // Branch control
643  val retTarget = Wire(UInt(VAddrBits.W))
644  val resetSatp = addr === Satp.U && wen // write to satp will cause the pipeline be flushed
645  flushPipe := resetSatp || (valid && func === CSROpType.jmp && !isEcall)
646
647  retTarget := DontCare
648  // val illegalEret = TODO
649
650  when (valid && isMret) {
651    val mstatusOld = WireInit(mstatus.asTypeOf(new MstatusStruct))
652    val mstatusNew = WireInit(mstatus.asTypeOf(new MstatusStruct))
653    mstatusNew.ie.m := mstatusOld.pie.m
654    priviledgeMode := mstatusOld.mpp
655    mstatusNew.pie.m := true.B
656    mstatusNew.mpp := ModeU
657    mstatusNew.mprv := 0.U
658    mstatus := mstatusNew.asUInt
659    // lr := false.B
660    retTarget := mepc(VAddrBits-1, 0)
661  }
662
663  when (valid && isSret && !illegalSModeSret) {
664    val mstatusOld = WireInit(mstatus.asTypeOf(new MstatusStruct))
665    val mstatusNew = WireInit(mstatus.asTypeOf(new MstatusStruct))
666    mstatusNew.ie.s := mstatusOld.pie.s
667    priviledgeMode := Cat(0.U(1.W), mstatusOld.spp)
668    mstatusNew.pie.s := true.B
669    mstatusNew.spp := ModeU
670    mstatus := mstatusNew.asUInt
671    mstatusNew.mprv := 0.U
672    // lr := false.B
673    retTarget := sepc(VAddrBits-1, 0)
674  }
675
676  when (valid && isUret) {
677    val mstatusOld = WireInit(mstatus.asTypeOf(new MstatusStruct))
678    val mstatusNew = WireInit(mstatus.asTypeOf(new MstatusStruct))
679    // mstatusNew.mpp.m := ModeU //TODO: add mode U
680    mstatusNew.ie.u := mstatusOld.pie.u
681    priviledgeMode := ModeU
682    mstatusNew.pie.u := true.B
683    mstatus := mstatusNew.asUInt
684    retTarget := uepc(VAddrBits-1, 0)
685  }
686
687  io.in.ready := true.B
688  io.out.valid := valid
689
690  val csrExceptionVec = WireInit(cfIn.exceptionVec)
691  csrExceptionVec(breakPoint) := io.in.valid && isEbreak
692  csrExceptionVec(ecallM) := priviledgeMode === ModeM && io.in.valid && isEcall
693  csrExceptionVec(ecallS) := priviledgeMode === ModeS && io.in.valid && isEcall
694  csrExceptionVec(ecallU) := priviledgeMode === ModeU && io.in.valid && isEcall
695  // Trigger an illegal instr exception when:
696  // * unimplemented csr is being read/written
697  // * csr access is illegal
698  csrExceptionVec(illegalInstr) := (isIllegalAddr || isIllegalAccess) && wen
699  cfOut.exceptionVec := csrExceptionVec
700
701  /**
702    * Exception and Intr
703    */
704  val ideleg =  (mideleg & mip.asUInt)
705  def priviledgedEnableDetect(x: Bool): Bool = Mux(x, ((priviledgeMode === ModeS) && mstatusStruct.ie.s) || (priviledgeMode < ModeS),
706    ((priviledgeMode === ModeM) && mstatusStruct.ie.m) || (priviledgeMode < ModeM))
707
708  // send interrupt information to ROQ
709  val intrVecEnable = Wire(Vec(12, Bool()))
710  intrVecEnable.zip(ideleg.asBools).map{case(x,y) => x := priviledgedEnableDetect(y)}
711  val intrVec = mie(11,0) & mip.asUInt & intrVecEnable.asUInt
712  val intrBitSet = intrVec.orR()
713  csrio.interrupt := intrBitSet
714  mipWire.t.m := csrio.externalInterrupt.mtip
715  mipWire.s.m := csrio.externalInterrupt.msip
716  mipWire.e.m := csrio.externalInterrupt.meip
717
718  // interrupts
719  val intrNO = IntPriority.foldRight(0.U)((i: Int, sum: UInt) => Mux(intrVec(i), i.U, sum))
720  val raiseIntr = csrio.exception.valid && csrio.exception.bits.isInterrupt
721  XSDebug(raiseIntr, "interrupt: pc=0x%x, %d\n", csrio.exception.bits.uop.cf.pc, intrNO)
722
723  // exceptions
724  val raiseException = csrio.exception.valid && !csrio.exception.bits.isInterrupt
725  val hasInstrPageFault = csrio.exception.bits.uop.cf.exceptionVec(instrPageFault) && raiseException
726  val hasLoadPageFault = csrio.exception.bits.uop.cf.exceptionVec(loadPageFault) && raiseException
727  val hasStorePageFault = csrio.exception.bits.uop.cf.exceptionVec(storePageFault) && raiseException
728  val hasStoreAddrMisaligned = csrio.exception.bits.uop.cf.exceptionVec(storeAddrMisaligned) && raiseException
729  val hasLoadAddrMisaligned = csrio.exception.bits.uop.cf.exceptionVec(loadAddrMisaligned) && raiseException
730  val hasInstrAccessFault = csrio.exception.bits.uop.cf.exceptionVec(instrAccessFault) && raiseException
731  val hasLoadAccessFault = csrio.exception.bits.uop.cf.exceptionVec(loadAccessFault) && raiseException
732  val hasStoreAccessFault = csrio.exception.bits.uop.cf.exceptionVec(storeAccessFault) && raiseException
733
734  val raiseExceptionVec = csrio.exception.bits.uop.cf.exceptionVec
735  val exceptionNO = ExcPriority.foldRight(0.U)((i: Int, sum: UInt) => Mux(raiseExceptionVec(i), i.U, sum))
736  val causeNO = (raiseIntr << (XLEN-1)).asUInt() | Mux(raiseIntr, intrNO, exceptionNO)
737
738  val raiseExceptionIntr = csrio.exception.valid
739  XSDebug(raiseExceptionIntr, "int/exc: pc %x int (%d):%x exc: (%d):%x\n",
740    csrio.exception.bits.uop.cf.pc, intrNO, intrVec, exceptionNO, raiseExceptionVec.asUInt
741  )
742  XSDebug(raiseExceptionIntr,
743    "pc %x mstatus %x mideleg %x medeleg %x mode %x\n",
744    csrio.exception.bits.uop.cf.pc,
745    mstatus,
746    mideleg,
747    medeleg,
748    priviledgeMode
749  )
750
751  // mtval write logic
752  val memExceptionAddr = SignExt(csrio.memExceptionVAddr, XLEN)
753  when (hasInstrPageFault || hasLoadPageFault || hasStorePageFault) {
754    val tval = Mux(
755      hasInstrPageFault,
756      Mux(
757        csrio.exception.bits.uop.cf.crossPageIPFFix,
758        SignExt(csrio.exception.bits.uop.cf.pc + 2.U, XLEN),
759        SignExt(csrio.exception.bits.uop.cf.pc, XLEN)
760      ),
761      memExceptionAddr
762    )
763    when (priviledgeMode === ModeM) {
764      mtval := tval
765    }.otherwise {
766      stval := tval
767    }
768  }
769
770  when (hasLoadAddrMisaligned || hasStoreAddrMisaligned) {
771    mtval := memExceptionAddr
772  }
773
774  val deleg = Mux(raiseIntr, mideleg , medeleg)
775  // val delegS = ((deleg & (1 << (causeNO & 0xf))) != 0) && (priviledgeMode < ModeM);
776  val delegS = deleg(causeNO(3,0)) && (priviledgeMode < ModeM)
777  val tvalWen = !(hasInstrPageFault || hasLoadPageFault || hasStorePageFault || hasLoadAddrMisaligned || hasStoreAddrMisaligned) || raiseIntr // TODO: need check
778  val isXRet = io.in.valid && func === CSROpType.jmp && !isEcall
779
780  // ctrl block will use theses later for flush
781  val isXRetFlag = RegInit(false.B)
782  val retTargetReg = Reg(retTarget.cloneType)
783  when (io.flushIn) {
784    isXRetFlag := false.B
785  }.elsewhen (isXRet) {
786    isXRetFlag := true.B
787    retTargetReg := retTarget
788  }
789  csrio.isXRet := isXRetFlag
790  csrio.trapTarget := Mux(isXRetFlag,
791    retTargetReg,
792    Mux(delegS, stvec, mtvec)(VAddrBits-1, 0)
793  )
794
795  when (raiseExceptionIntr) {
796    val mstatusOld = WireInit(mstatus.asTypeOf(new MstatusStruct))
797    val mstatusNew = WireInit(mstatus.asTypeOf(new MstatusStruct))
798
799    when (delegS) {
800      scause := causeNO
801      sepc := SignExt(csrio.exception.bits.uop.cf.pc, XLEN)
802      mstatusNew.spp := priviledgeMode
803      mstatusNew.pie.s := mstatusOld.ie.s
804      mstatusNew.ie.s := false.B
805      priviledgeMode := ModeS
806      when (tvalWen) { stval := 0.U }
807    }.otherwise {
808      mcause := causeNO
809      mepc := SignExt(csrio.exception.bits.uop.cf.pc, XLEN)
810      mstatusNew.mpp := priviledgeMode
811      mstatusNew.pie.m := mstatusOld.ie.m
812      mstatusNew.ie.m := false.B
813      priviledgeMode := ModeM
814      when (tvalWen) { mtval := 0.U }
815    }
816
817    mstatus := mstatusNew.asUInt
818  }
819
820  XSDebug(raiseExceptionIntr && delegS, "sepc is writen!!! pc:%x\n", cfIn.pc)
821
822  def readWithScala(addr: Int): UInt = mapping(addr)._1
823
824  val difftestIntrNO = Mux(raiseIntr, causeNO, 0.U)
825
826  if (!env.FPGAPlatform) {
827    difftestIO.intrNO := RegNext(difftestIntrNO)
828    difftestIO.cause := RegNext(Mux(csrio.exception.valid, causeNO, 0.U))
829    difftestIO.priviledgeMode := priviledgeMode
830    difftestIO.mstatus := mstatus
831    difftestIO.sstatus := mstatus & sstatusRmask
832    difftestIO.mepc := mepc
833    difftestIO.sepc := sepc
834    difftestIO.mtval:= mtval
835    difftestIO.stval:= stval
836    difftestIO.mtvec := mtvec
837    difftestIO.stvec := stvec
838    difftestIO.mcause := mcause
839    difftestIO.scause := scause
840    difftestIO.satp := satp
841    difftestIO.mip := mipReg
842    difftestIO.mie := mie
843    difftestIO.mscratch := mscratch
844    difftestIO.sscratch := sscratch
845    difftestIO.mideleg := mideleg
846    difftestIO.medeleg := medeleg
847  }
848}
849