xref: /XiangShan/src/main/scala/xiangshan/mem/pipeline/LoadUnit.scala (revision a4d1b2d1ae4c6149f55fbcac48749c08714bfe0c)
1/***************************************************************************************
2* Copyright (c) 2020-2021 Institute of Computing Technology, Chinese Academy of Sciences
3* Copyright (c) 2020-2021 Peng Cheng Laboratory
4*
5* XiangShan is licensed under Mulan PSL v2.
6* You can use this software according to the terms and conditions of the Mulan PSL v2.
7* You may obtain a copy of Mulan PSL v2 at:
8*          http://license.coscl.org.cn/MulanPSL2
9*
10* THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND,
11* EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
12* MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
13*
14* See the Mulan PSL v2 for more details.
15***************************************************************************************/
16
17package xiangshan.mem
18
19import org.chipsalliance.cde.config.Parameters
20import chisel3._
21import chisel3.util._
22import utils._
23import utility._
24import xiangshan.ExceptionNO._
25import xiangshan._
26import xiangshan.backend.Bundles.{DynInst, MemExuInput, MemExuOutput}
27import xiangshan.backend.fu.PMPRespBundle
28import xiangshan.backend.fu.FuConfig._
29import xiangshan.backend.ctrlblock.{DebugLsInfoBundle, LsTopdownInfo}
30import xiangshan.backend.rob.RobPtr
31import xiangshan.backend.ctrlblock.DebugLsInfoBundle
32import xiangshan.backend.fu.util.SdtrigExt
33
34import xiangshan.cache._
35import xiangshan.cache.wpu.ReplayCarry
36import xiangshan.cache.mmu._
37import xiangshan.mem.mdp._
38
39class LoadToLsqReplayIO(implicit p: Parameters) extends XSBundle
40  with HasDCacheParameters
41  with HasTlbConst
42{
43  // mshr refill index
44  val mshr_id         = UInt(log2Up(cfg.nMissEntries).W)
45  // get full data from store queue and sbuffer
46  val full_fwd        = Bool()
47  // wait for data from store inst's store queue index
48  val data_inv_sq_idx = new SqPtr
49  // wait for address from store queue index
50  val addr_inv_sq_idx = new SqPtr
51  // replay carry
52  val rep_carry       = new ReplayCarry(nWays)
53  // data in last beat
54  val last_beat       = Bool()
55  // replay cause
56  val cause           = Vec(LoadReplayCauses.allCauses, Bool())
57  // performance debug information
58  val debug           = new PerfDebugInfo
59  // tlb hint
60  val tlb_id          = UInt(log2Up(loadfiltersize).W)
61  val tlb_full        = Bool()
62
63  // alias
64  def mem_amb       = cause(LoadReplayCauses.C_MA)
65  def tlb_miss      = cause(LoadReplayCauses.C_TM)
66  def fwd_fail      = cause(LoadReplayCauses.C_FF)
67  def dcache_rep    = cause(LoadReplayCauses.C_DR)
68  def dcache_miss   = cause(LoadReplayCauses.C_DM)
69  def wpu_fail      = cause(LoadReplayCauses.C_WF)
70  def bank_conflict = cause(LoadReplayCauses.C_BC)
71  def rar_nack      = cause(LoadReplayCauses.C_RAR)
72  def raw_nack      = cause(LoadReplayCauses.C_RAW)
73  def nuke          = cause(LoadReplayCauses.C_NK)
74  def need_rep      = cause.asUInt.orR
75}
76
77
78class LoadToLsqIO(implicit p: Parameters) extends XSBundle {
79  val ldin            = DecoupledIO(new LqWriteBundle)
80  val uncache         = Flipped(DecoupledIO(new MemExuOutput))
81  val ld_raw_data     = Input(new LoadDataFromLQBundle)
82  val forward         = new PipeLoadForwardQueryIO
83  val stld_nuke_query = new LoadNukeQueryIO
84  val ldld_nuke_query = new LoadNukeQueryIO
85  val trigger         = Flipped(new LqTriggerIO)
86}
87
88class LoadToLoadIO(implicit p: Parameters) extends XSBundle {
89  val valid      = Bool()
90  val data       = UInt(XLEN.W) // load to load fast path is limited to ld (64 bit) used as vaddr src1 only
91  val dly_ld_err = Bool()
92}
93
94class LoadUnitTriggerIO(implicit p: Parameters) extends XSBundle {
95  val tdata2      = Input(UInt(64.W))
96  val matchType   = Input(UInt(2.W))
97  val tEnable     = Input(Bool()) // timing is calculated before this
98  val addrHit     = Output(Bool())
99}
100
101class LoadUnit(implicit p: Parameters) extends XSModule
102  with HasLoadHelper
103  with HasPerfEvents
104  with HasDCacheParameters
105  with HasCircularQueuePtrHelper
106  with HasVLSUParameters
107  with SdtrigExt
108{
109  val io = IO(new Bundle() {
110    // control
111    val redirect      = Flipped(ValidIO(new Redirect))
112    val csrCtrl       = Flipped(new CustomCSRCtrlIO)
113
114    // int issue path
115    val ldin          = Flipped(Decoupled(new MemExuInput))
116    val ldout         = Decoupled(new MemExuOutput)
117
118    // vec issue path
119    val vecldin = Flipped(Decoupled(new VecPipeBundle))
120    val vecldout = Decoupled(new VecPipelineFeedbackIO(isVStore = false))
121
122    // data path
123    val tlb           = new TlbRequestIO(2)
124    val pmp           = Flipped(new PMPRespBundle()) // arrive same to tlb now
125    val dcache        = new DCacheLoadIO
126    val sbuffer       = new LoadForwardQueryIO
127    val lsq           = new LoadToLsqIO
128    val tl_d_channel  = Input(new DcacheToLduForwardIO)
129    val forward_mshr  = Flipped(new LduToMissqueueForwardIO)
130   // val refill        = Flipped(ValidIO(new Refill))
131    val l2_hint       = Input(Valid(new L2ToL1Hint))
132    val tlb_hint      = Flipped(new TlbHintReq)
133    // fast wakeup
134    // TODO: implement vector fast wakeup
135    val fast_uop = ValidIO(new DynInst) // early wakeup signal generated in load_s1, send to RS in load_s2
136
137    // trigger
138    val trigger = Vec(TriggerNum, new LoadUnitTriggerIO)
139
140    // prefetch
141    val prefetch_train            = ValidIO(new LdPrefetchTrainBundle()) // provide prefetch info to sms
142    val prefetch_train_l1         = ValidIO(new LdPrefetchTrainBundle()) // provide prefetch info to stream & stride
143    val prefetch_req              = Flipped(ValidIO(new L1PrefetchReq)) // hardware prefetch to l1 cache req
144    val canAcceptLowConfPrefetch  = Output(Bool())
145    val canAcceptHighConfPrefetch = Output(Bool())
146
147    // load to load fast path
148    val l2l_fwd_in    = Input(new LoadToLoadIO)
149    val l2l_fwd_out   = Output(new LoadToLoadIO)
150
151    val ld_fast_match    = Input(Bool())
152    val ld_fast_fuOpType = Input(UInt())
153    val ld_fast_imm      = Input(UInt(12.W))
154
155    // rs feedback
156    val wakeup = ValidIO(new DynInst)
157    val feedback_fast = ValidIO(new RSFeedback) // stage 2
158    val feedback_slow = ValidIO(new RSFeedback) // stage 3
159    val ldCancel = Output(new LoadCancelIO()) // use to cancel the uops waked by this load, and cancel load
160
161    // load ecc error
162    val s3_dly_ld_err = Output(Bool()) // Note that io.s3_dly_ld_err and io.lsq.s3_dly_ld_err is different
163
164    // schedule error query
165    val stld_nuke_query = Flipped(Vec(StorePipelineWidth, Valid(new StoreNukeQueryIO)))
166
167    // queue-based replay
168    val replay       = Flipped(Decoupled(new LsPipelineBundle))
169    val lq_rep_full  = Input(Bool())
170
171    // misc
172    val s2_ptr_chasing = Output(Bool()) // provide right pc for hw prefetch
173
174    // Load fast replay path
175    val fast_rep_in  = Flipped(Decoupled(new LqWriteBundle))
176    val fast_rep_out = Decoupled(new LqWriteBundle)
177
178    // Load RAR rollback
179    val rollback = Valid(new Redirect)
180
181    // perf
182    val debug_ls         = Output(new DebugLsInfoBundle)
183    val lsTopdownInfo    = Output(new LsTopdownInfo)
184    val correctMissTrain = Input(Bool())
185  })
186
187  val s1_ready, s2_ready, s3_ready = WireInit(false.B)
188
189  // Pipeline
190  // --------------------------------------------------------------------------------
191  // stage 0
192  // --------------------------------------------------------------------------------
193  // generate addr, use addr to query DCache and DTLB
194  val s0_valid         = Wire(Bool())
195  val s0_mmio_select   = Wire(Bool())
196  val s0_kill          = Wire(Bool())
197  val s0_can_go        = s1_ready
198  val s0_fire          = s0_valid && s0_can_go
199  val s0_mmio_fire     = s0_mmio_select && s0_can_go
200  val s0_out           = Wire(new LqWriteBundle)
201
202  // flow source bundle
203  class FlowSource extends Bundle {
204    val vaddr         = UInt(VAddrBits.W)
205    val mask          = UInt((VLEN/8).W)
206    val uop           = new DynInst
207    val try_l2l       = Bool()
208    val has_rob_entry = Bool()
209    val rsIdx         = UInt(log2Up(MemIQSizeMax).W)
210    val rep_carry     = new ReplayCarry(nWays)
211    val mshrid        = UInt(log2Up(cfg.nMissEntries).W)
212    val isFirstIssue  = Bool()
213    val fast_rep      = Bool()
214    val ld_rep        = Bool()
215    val l2l_fwd       = Bool()
216    val prf           = Bool()
217    val prf_rd        = Bool()
218    val prf_wr        = Bool()
219    val sched_idx     = UInt(log2Up(LoadQueueReplaySize+1).W)
220    val hlv           = Bool()
221    val hlvx          = Bool()
222    // Record the issue port idx of load issue queue. This signal is used by load cancel.
223    val deqPortIdx    = UInt(log2Ceil(LoadPipelineWidth).W)
224    // vec only
225    val isvec         = Bool()
226    val is128bit      = Bool()
227    val uop_unit_stride_fof = Bool()
228    val reg_offset    = UInt(vOffsetBits.W)
229    val vecActive     = Bool() // 1: vector active element or scala mem operation, 0: vector not active element
230    val is_first_ele  = Bool()
231    // val flowPtr       = new VlflowPtr
232    val usSecondInv   = Bool()
233    val mbIndex       = UInt(vlmBindexBits.W)
234    val elemIdx       = UInt(elemIdxBits.W)
235    val elemIdxInsideVd = UInt(elemIdxBits.W)
236    val alignedType   = UInt(alignTypeBits.W)
237  }
238  val s0_sel_src = Wire(new FlowSource)
239
240  // load flow select/gen
241  // src0: super load replayed by LSQ (cache miss replay) (io.replay)
242  // src1: fast load replay (io.fast_rep_in)
243  // src2: mmio (io.lsq.uncache)
244  // src3: load replayed by LSQ (io.replay)
245  // src4: hardware prefetch from prefetchor (high confidence) (io.prefetch)
246  // NOTE: Now vec/int loads are sent from same RS
247  //       A vec load will be splited into multiple uops,
248  //       so as long as one uop is issued,
249  //       the other uops should have higher priority
250  // src5: vec read from RS (io.vecldin)
251  // src6: int read / software prefetch first issue from RS (io.in)
252  // src7: load try pointchaising when no issued or replayed load (io.fastpath)
253  // src8: hardware prefetch from prefetchor (high confidence) (io.prefetch)
254  // priority: high to low
255  val s0_rep_stall           = io.ldin.valid && isAfter(io.replay.bits.uop.robIdx, io.ldin.bits.uop.robIdx)
256  val s0_super_ld_rep_valid  = io.replay.valid && io.replay.bits.forward_tlDchannel
257  val s0_ld_fast_rep_valid   = io.fast_rep_in.valid
258  val s0_ld_mmio_valid       = io.lsq.uncache.valid
259  val s0_ld_rep_valid        = io.replay.valid && !io.replay.bits.forward_tlDchannel && !s0_rep_stall
260  val s0_high_conf_prf_valid = io.prefetch_req.valid && io.prefetch_req.bits.confidence > 0.U
261  val s0_vec_iss_valid       = io.vecldin.valid
262  val s0_int_iss_valid       = io.ldin.valid // int flow first issue or software prefetch
263  val s0_l2l_fwd_valid       = io.l2l_fwd_in.valid
264  val s0_low_conf_prf_valid  = io.prefetch_req.valid && io.prefetch_req.bits.confidence === 0.U
265  dontTouch(s0_super_ld_rep_valid)
266  dontTouch(s0_ld_fast_rep_valid)
267  dontTouch(s0_ld_mmio_valid)
268  dontTouch(s0_ld_rep_valid)
269  dontTouch(s0_high_conf_prf_valid)
270  dontTouch(s0_vec_iss_valid)
271  dontTouch(s0_int_iss_valid)
272  dontTouch(s0_l2l_fwd_valid)
273  dontTouch(s0_low_conf_prf_valid)
274
275  // load flow source ready
276  val s0_super_ld_rep_ready  = WireInit(true.B)
277  val s0_ld_fast_rep_ready   = !s0_super_ld_rep_valid
278  val s0_ld_mmio_ready       = !s0_super_ld_rep_valid &&
279                               !s0_ld_fast_rep_valid
280  val s0_ld_rep_ready        = !s0_super_ld_rep_valid &&
281                               !s0_ld_fast_rep_valid &&
282                               !s0_ld_mmio_valid
283  val s0_high_conf_prf_ready = !s0_super_ld_rep_valid &&
284                               !s0_ld_fast_rep_valid &&
285                               !s0_ld_mmio_valid &&
286                               !s0_ld_rep_valid
287
288  val s0_vec_iss_ready       = !s0_super_ld_rep_valid &&
289                               !s0_ld_fast_rep_valid &&
290                               !s0_ld_mmio_valid &&
291                               !s0_ld_rep_valid &&
292                               !s0_high_conf_prf_valid
293
294  val s0_int_iss_ready       = !s0_super_ld_rep_valid &&
295                               !s0_ld_fast_rep_valid &&
296                               !s0_ld_mmio_valid &&
297                               !s0_ld_rep_valid &&
298                               !s0_high_conf_prf_valid &&
299                               !s0_vec_iss_valid
300
301  val s0_l2l_fwd_ready       = !s0_super_ld_rep_valid &&
302                               !s0_ld_fast_rep_valid &&
303                               !s0_ld_mmio_valid &&
304                               !s0_ld_rep_valid &&
305                               !s0_high_conf_prf_valid &&
306                               !s0_int_iss_valid &&
307                               !s0_vec_iss_valid
308
309  val s0_low_conf_prf_ready  = !s0_super_ld_rep_valid &&
310                               !s0_ld_fast_rep_valid &&
311                               !s0_ld_mmio_valid &&
312                               !s0_ld_rep_valid &&
313                               !s0_high_conf_prf_valid &&
314                               !s0_int_iss_valid &&
315                               !s0_vec_iss_valid &&
316                               !s0_l2l_fwd_valid
317  dontTouch(s0_super_ld_rep_ready)
318  dontTouch(s0_ld_fast_rep_ready)
319  dontTouch(s0_ld_mmio_ready)
320  dontTouch(s0_ld_rep_ready)
321  dontTouch(s0_high_conf_prf_ready)
322  dontTouch(s0_vec_iss_ready)
323  dontTouch(s0_int_iss_ready)
324  dontTouch(s0_l2l_fwd_ready)
325  dontTouch(s0_low_conf_prf_ready)
326
327  // load flow source select (OH)
328  val s0_super_ld_rep_select = s0_super_ld_rep_valid && s0_super_ld_rep_ready
329  val s0_ld_fast_rep_select  = s0_ld_fast_rep_valid && s0_ld_fast_rep_ready
330  val s0_ld_mmio_select      = s0_ld_mmio_valid && s0_ld_mmio_ready
331  val s0_ld_rep_select       = s0_ld_rep_valid && s0_ld_rep_ready
332  val s0_hw_prf_select       = s0_high_conf_prf_ready && s0_high_conf_prf_valid ||
333                               s0_low_conf_prf_ready && s0_low_conf_prf_valid
334  val s0_vec_iss_select      = s0_vec_iss_ready && s0_vec_iss_valid
335  val s0_int_iss_select      = s0_int_iss_ready && s0_int_iss_valid
336  val s0_l2l_fwd_select      = s0_l2l_fwd_ready && s0_l2l_fwd_valid
337  dontTouch(s0_super_ld_rep_select)
338  dontTouch(s0_ld_fast_rep_select)
339  dontTouch(s0_ld_mmio_select)
340  dontTouch(s0_ld_rep_select)
341  dontTouch(s0_hw_prf_select)
342  dontTouch(s0_vec_iss_select)
343  dontTouch(s0_int_iss_select)
344  dontTouch(s0_l2l_fwd_select)
345
346  s0_valid := (s0_super_ld_rep_valid ||
347               s0_ld_fast_rep_valid ||
348               s0_ld_rep_valid ||
349               s0_high_conf_prf_valid ||
350               s0_vec_iss_valid ||
351               s0_int_iss_valid ||
352               s0_l2l_fwd_valid ||
353               s0_low_conf_prf_valid) && !s0_ld_mmio_select && io.dcache.req.ready && !s0_kill
354
355  s0_mmio_select := s0_ld_mmio_select && !s0_kill
356
357  // which is S0's out is ready and dcache is ready
358  val s0_try_ptr_chasing      = s0_l2l_fwd_select
359  val s0_do_try_ptr_chasing   = s0_try_ptr_chasing && s0_can_go && io.dcache.req.ready
360  val s0_ptr_chasing_vaddr    = io.l2l_fwd_in.data(5, 0) +& io.ld_fast_imm(5, 0)
361  val s0_ptr_chasing_canceled = WireInit(false.B)
362  s0_kill := s0_ptr_chasing_canceled
363
364  // prefetch related ctrl signal
365  io.canAcceptLowConfPrefetch  := s0_low_conf_prf_ready && io.dcache.req.ready
366  io.canAcceptHighConfPrefetch := s0_high_conf_prf_ready && io.dcache.req.ready
367
368  // query DTLB
369  io.tlb.req.valid                   := s0_valid
370  io.tlb.req.bits.cmd                := Mux(s0_sel_src.prf,
371                                         Mux(s0_sel_src.prf_wr, TlbCmd.write, TlbCmd.read),
372                                         TlbCmd.read
373                                       )
374  io.tlb.req.bits.vaddr              := Mux(s0_hw_prf_select, io.prefetch_req.bits.paddr, s0_sel_src.vaddr)
375  io.tlb.req.bits.hyperinst          := s0_sel_src.hlv
376  io.tlb.req.bits.hlvx               := s0_sel_src.hlvx
377  io.tlb.req.bits.size               := Mux(s0_sel_src.isvec, s0_sel_src.alignedType(2,0), LSUOpType.size(s0_sel_src.uop.fuOpType))
378  io.tlb.req.bits.kill               := s0_kill
379  io.tlb.req.bits.memidx.is_ld       := true.B
380  io.tlb.req.bits.memidx.is_st       := false.B
381  io.tlb.req.bits.memidx.idx         := s0_sel_src.uop.lqIdx.value
382  io.tlb.req.bits.debug.robIdx       := s0_sel_src.uop.robIdx
383  io.tlb.req.bits.no_translate       := s0_hw_prf_select  // hw b.reqetch addr does not need to be translated
384  io.tlb.req.bits.debug.pc           := s0_sel_src.uop.pc
385  io.tlb.req.bits.debug.isFirstIssue := s0_sel_src.isFirstIssue
386
387  // query DCache
388  io.dcache.req.valid             := s0_valid
389  io.dcache.req.bits.cmd          := Mux(s0_sel_src.prf_rd,
390                                      MemoryOpConstants.M_PFR,
391                                      Mux(s0_sel_src.prf_wr, MemoryOpConstants.M_PFW, MemoryOpConstants.M_XRD)
392                                    )
393  io.dcache.req.bits.vaddr        := s0_sel_src.vaddr
394  io.dcache.req.bits.mask         := s0_sel_src.mask
395  io.dcache.req.bits.data         := DontCare
396  io.dcache.req.bits.isFirstIssue := s0_sel_src.isFirstIssue
397  io.dcache.req.bits.instrtype    := Mux(s0_sel_src.prf, DCACHE_PREFETCH_SOURCE.U, LOAD_SOURCE.U)
398  io.dcache.req.bits.debug_robIdx := s0_sel_src.uop.robIdx.value
399  io.dcache.req.bits.replayCarry  := s0_sel_src.rep_carry
400  io.dcache.req.bits.id           := DontCare // TODO: update cache meta
401  io.dcache.req.bits.lqIdx        := s0_sel_src.uop.lqIdx
402  io.dcache.pf_source             := Mux(s0_hw_prf_select, io.prefetch_req.bits.pf_source.value, L1_HW_PREFETCH_NULL)
403  io.dcache.is128Req              := s0_sel_src.is128bit
404
405  // load flow priority mux
406  def fromNullSource(): FlowSource = {
407    val out = WireInit(0.U.asTypeOf(new FlowSource))
408    out
409  }
410
411  def fromFastReplaySource(src: LqWriteBundle): FlowSource = {
412    val out = WireInit(0.U.asTypeOf(new FlowSource))
413    out.vaddr         := src.vaddr
414    out.mask          := src.mask
415    out.uop           := src.uop
416    out.try_l2l       := false.B
417    out.has_rob_entry := src.hasROBEntry
418    out.rep_carry     := src.rep_info.rep_carry
419    out.mshrid        := src.rep_info.mshr_id
420    out.rsIdx         := src.rsIdx
421    out.isFirstIssue  := false.B
422    out.fast_rep      := true.B
423    out.ld_rep        := src.isLoadReplay
424    out.l2l_fwd       := false.B
425    out.prf           := LSUOpType.isPrefetch(src.uop.fuOpType) && !src.isvec
426    out.prf_rd        := src.uop.fuOpType === LSUOpType.prefetch_r
427    out.prf_wr        := src.uop.fuOpType === LSUOpType.prefetch_w
428    out.sched_idx     := src.schedIndex
429    out.isvec         := src.isvec
430    out.is128bit      := src.is128bit
431    out.uop_unit_stride_fof := src.uop_unit_stride_fof
432    out.reg_offset    := src.reg_offset
433    out.vecActive     := src.vecActive
434    out.is_first_ele  := src.is_first_ele
435    out.usSecondInv   := src.usSecondInv
436    out.mbIndex       := src.mbIndex
437    out.elemIdx       := src.elemIdx
438    out.elemIdxInsideVd := src.elemIdxInsideVd
439    out.alignedType   := src.alignedType
440    out.hlv           := LSUOpType.isHlv(src.uop.fuOpType)
441    out.hlvx          := LSUOpType.isHlvx(src.uop.fuOpType)
442    out
443  }
444
445  // TODO: implement vector mmio
446  def fromMmioSource(src: MemExuOutput) = {
447    val out = WireInit(0.U.asTypeOf(new FlowSource))
448    out.vaddr        := 0.U
449    out.mask          := 0.U
450    out.uop           := src.uop
451    out.try_l2l       := false.B
452    out.has_rob_entry := false.B
453    out.rsIdx         := 0.U
454    out.rep_carry     := 0.U.asTypeOf(out.rep_carry)
455    out.mshrid        := 0.U
456    out.isFirstIssue  := false.B
457    out.fast_rep      := false.B
458    out.ld_rep        := false.B
459    out.l2l_fwd       := false.B
460    out.prf           := false.B
461    out.prf_rd        := false.B
462    out.prf_wr        := false.B
463    out.sched_idx     := 0.U
464    out.hlv           := LSUOpType.isHlv(src.uop.fuOpType)
465    out.hlvx          := LSUOpType.isHlvx(src.uop.fuOpType)
466    out.vecActive     := true.B
467    out
468  }
469
470  def fromNormalReplaySource(src: LsPipelineBundle): FlowSource = {
471    val out = WireInit(0.U.asTypeOf(new FlowSource))
472    out.vaddr         := src.vaddr
473    out.mask          := Mux(src.isvec, src.mask, genVWmask(src.vaddr, src.uop.fuOpType(1, 0)))
474    out.uop           := src.uop
475    out.try_l2l       := false.B
476    out.has_rob_entry := true.B
477    out.rsIdx         := src.rsIdx
478    out.rep_carry     := src.replayCarry
479    out.mshrid        := src.mshrid
480    out.isFirstIssue  := false.B
481    out.fast_rep      := false.B
482    out.ld_rep        := true.B
483    out.l2l_fwd       := false.B
484    out.prf           := LSUOpType.isPrefetch(src.uop.fuOpType) && !src.isvec
485    out.prf_rd        := src.uop.fuOpType === LSUOpType.prefetch_r
486    out.prf_wr        := src.uop.fuOpType === LSUOpType.prefetch_w
487    out.sched_idx     := src.schedIndex
488    out.isvec         := src.isvec
489    out.is128bit      := src.is128bit
490    out.uop_unit_stride_fof := src.uop_unit_stride_fof
491    out.reg_offset    := src.reg_offset
492    out.vecActive     := src.vecActive
493    out.is_first_ele  := src.is_first_ele
494    out.usSecondInv   := src.usSecondInv
495    out.mbIndex       := src.mbIndex
496    out.elemIdx       := src.elemIdx
497    out.elemIdxInsideVd := src.elemIdxInsideVd
498    out.alignedType   := src.alignedType
499    out.hlv           := LSUOpType.isHlv(src.uop.fuOpType)
500    out.hlvx          := LSUOpType.isHlvx(src.uop.fuOpType)
501    out
502  }
503
504  // TODO: implement vector prefetch
505  def fromPrefetchSource(src: L1PrefetchReq): FlowSource = {
506    val out = WireInit(0.U.asTypeOf(new FlowSource))
507    out.vaddr         := src.getVaddr()
508    out.mask          := 0.U
509    out.uop           := DontCare
510    out.try_l2l       := false.B
511    out.has_rob_entry := false.B
512    out.rsIdx         := 0.U
513    out.rep_carry     := 0.U.asTypeOf(out.rep_carry)
514    out.mshrid        := 0.U
515    out.isFirstIssue  := false.B
516    out.fast_rep      := false.B
517    out.ld_rep        := false.B
518    out.l2l_fwd       := false.B
519    out.prf           := true.B
520    out.prf_rd        := !src.is_store
521    out.prf_wr        := src.is_store
522    out.sched_idx     := 0.U
523    out
524  }
525
526  def fromVecIssueSource(src: VecPipeBundle): FlowSource = {
527    val out = WireInit(0.U.asTypeOf(new FlowSource))
528    out.vaddr         := src.vaddr
529    out.mask          := src.mask
530    out.uop           := src.uop
531    out.try_l2l       := false.B
532    out.has_rob_entry := true.B
533    // TODO: VLSU, implement vector feedback
534    out.rsIdx         := 0.U
535    // TODO: VLSU, implement replay carry
536    out.rep_carry     := 0.U.asTypeOf(out.rep_carry)
537    out.mshrid        := 0.U
538    // TODO: VLSU, implement first issue
539//    out.isFirstIssue  := src.isFirstIssue
540    out.fast_rep      := false.B
541    out.ld_rep        := false.B
542    out.l2l_fwd       := false.B
543    out.prf           := false.B
544    out.prf_rd        := false.B
545    out.prf_wr        := false.B
546    out.sched_idx     := 0.U
547    // Vector load interface
548    out.isvec               := true.B
549    // vector loads only access a single element at a time, so 128-bit path is not used for now
550    out.is128bit            := is128Bit(src.alignedType)
551    out.uop_unit_stride_fof := src.uop_unit_stride_fof
552    // out.rob_idx_valid       := src.rob_idx_valid
553    // out.inner_idx           := src.inner_idx
554    // out.rob_idx             := src.rob_idx
555    out.reg_offset          := src.reg_offset
556    // out.offset              := src.offset
557    out.vecActive           := src.vecActive
558    out.is_first_ele        := src.is_first_ele
559    // out.flowPtr             := src.flowPtr
560    out.usSecondInv         := src.usSecondInv
561    out.mbIndex             := src.mBIndex
562    out.elemIdx             := src.elemIdx
563    out.elemIdxInsideVd     := src.elemIdxInsideVd
564    out.alignedType         := src.alignedType
565    out.hlv                 := false.B
566    out.hlvx                := false.B
567    out
568  }
569
570  def fromIntIssueSource(src: MemExuInput): FlowSource = {
571    val out = WireInit(0.U.asTypeOf(new FlowSource))
572    out.vaddr         := src.src(0) + SignExt(src.uop.imm(11, 0), VAddrBits)
573    out.mask          := genVWmask(out.vaddr, src.uop.fuOpType(1,0))
574    out.uop           := src.uop
575    out.try_l2l       := false.B
576    out.has_rob_entry := true.B
577    out.rsIdx         := src.iqIdx
578    out.rep_carry     := 0.U.asTypeOf(out.rep_carry)
579    out.mshrid        := 0.U
580    out.isFirstIssue  := true.B
581    out.fast_rep      := false.B
582    out.ld_rep        := false.B
583    out.l2l_fwd       := false.B
584    out.prf           := LSUOpType.isPrefetch(src.uop.fuOpType)
585    out.prf_rd        := src.uop.fuOpType === LSUOpType.prefetch_r
586    out.prf_wr        := src.uop.fuOpType === LSUOpType.prefetch_w
587    out.sched_idx     := 0.U
588    out.hlv           := LSUOpType.isHlv(src.uop.fuOpType)
589    out.hlvx          := LSUOpType.isHlvx(src.uop.fuOpType)
590    out.vecActive     := true.B // true for scala load
591    out
592  }
593
594  // TODO: implement vector l2l
595  def fromLoadToLoadSource(src: LoadToLoadIO): FlowSource = {
596    val out = WireInit(0.U.asTypeOf(new FlowSource))
597    out.vaddr              := Cat(src.data(XLEN-1, 6), s0_ptr_chasing_vaddr(5,0))
598    out.mask               := genVWmask(0.U, LSUOpType.ld)
599    // When there's no valid instruction from RS and LSQ, we try the load-to-load forwarding.
600    // Assume the pointer chasing is always ld.
601    out.uop.fuOpType       := LSUOpType.ld
602    out.try_l2l            := true.B
603    // we dont care out.isFirstIssue and out.rsIdx and s0_sqIdx in S0 when trying pointchasing
604    // because these signals will be updated in S1
605    out.has_rob_entry      := false.B
606    out.rsIdx              := 0.U
607    out.mshrid             := 0.U
608    out.rep_carry          := 0.U.asTypeOf(out.rep_carry)
609    out.isFirstIssue       := true.B
610    out.fast_rep           := false.B
611    out.ld_rep             := false.B
612    out.l2l_fwd            := true.B
613    out.prf                := false.B
614    out.prf_rd             := false.B
615    out.prf_wr             := false.B
616    out.sched_idx          := 0.U
617    out.hlv                := LSUOpType.isHlv(out.uop.fuOpType)
618    out.hlvx               := LSUOpType.isHlvx(out.uop.fuOpType)
619    out
620  }
621
622  // set default
623  val s0_src_selector = Seq(
624    s0_super_ld_rep_select,
625    s0_ld_fast_rep_select,
626    s0_ld_mmio_select,
627    s0_ld_rep_select,
628    s0_hw_prf_select,
629    s0_vec_iss_select,
630    s0_int_iss_select,
631    (if (EnableLoadToLoadForward) s0_l2l_fwd_select else true.B)
632  )
633  val s0_src_format = Seq(
634    fromNormalReplaySource(io.replay.bits),
635    fromFastReplaySource(io.fast_rep_in.bits),
636    fromMmioSource(io.lsq.uncache.bits),
637    fromNormalReplaySource(io.replay.bits),
638    fromPrefetchSource(io.prefetch_req.bits),
639    fromVecIssueSource(io.vecldin.bits),
640    fromIntIssueSource(io.ldin.bits),
641    (if (EnableLoadToLoadForward) fromLoadToLoadSource(io.l2l_fwd_in) else fromNullSource())
642  )
643  s0_sel_src := ParallelPriorityMux(s0_src_selector, s0_src_format)
644
645  // address align check
646  val s0_addr_aligned = LookupTree(Mux(s0_sel_src.isvec, s0_sel_src.alignedType(1,0), s0_sel_src.uop.fuOpType(1, 0)), List(
647    "b00".U   -> true.B,                   //b
648    "b01".U   -> (s0_sel_src.vaddr(0)    === 0.U), //h
649    "b10".U   -> (s0_sel_src.vaddr(1, 0) === 0.U), //w
650    "b11".U   -> (s0_sel_src.vaddr(2, 0) === 0.U)  //d
651  ))
652  XSError(s0_sel_src.isvec && s0_sel_src.vaddr(3, 0) =/= 0.U && s0_sel_src.alignedType(2), "unit-stride 128 bit element is not aligned!")
653
654  // accept load flow if dcache ready (tlb is always ready)
655  // TODO: prefetch need writeback to loadQueueFlag
656  s0_out               := DontCare
657  s0_out.rsIdx         := s0_sel_src.rsIdx
658  s0_out.vaddr         := s0_sel_src.vaddr
659  s0_out.mask          := s0_sel_src.mask
660  s0_out.uop           := s0_sel_src.uop
661  s0_out.isFirstIssue  := s0_sel_src.isFirstIssue
662  s0_out.hasROBEntry   := s0_sel_src.has_rob_entry
663  s0_out.isPrefetch    := s0_sel_src.prf
664  s0_out.isHWPrefetch  := s0_hw_prf_select
665  s0_out.isFastReplay  := s0_sel_src.fast_rep
666  s0_out.isLoadReplay  := s0_sel_src.ld_rep
667  s0_out.isFastPath    := s0_sel_src.l2l_fwd
668  s0_out.mshrid        := s0_sel_src.mshrid
669  s0_out.isvec           := s0_sel_src.isvec
670  s0_out.is128bit        := s0_sel_src.is128bit
671  s0_out.uop_unit_stride_fof := s0_sel_src.uop_unit_stride_fof
672  // s0_out.rob_idx_valid   := s0_rob_idx_valid
673  // s0_out.inner_idx       := s0_inner_idx
674  // s0_out.rob_idx         := s0_rob_idx
675  s0_out.reg_offset      := s0_sel_src.reg_offset
676  // s0_out.offset          := s0_offset
677  s0_out.vecActive             := s0_sel_src.vecActive
678  s0_out.usSecondInv    := s0_sel_src.usSecondInv
679  s0_out.is_first_ele   := s0_sel_src.is_first_ele
680  s0_out.elemIdx        := s0_sel_src.elemIdx
681  s0_out.elemIdxInsideVd := s0_sel_src.elemIdxInsideVd
682  s0_out.alignedType    := s0_sel_src.alignedType
683  s0_out.mbIndex        := s0_sel_src.mbIndex
684  // s0_out.flowPtr         := s0_sel_src.flowPtr
685  s0_out.uop.exceptionVec(loadAddrMisaligned) := !s0_addr_aligned && s0_sel_src.vecActive
686  s0_out.forward_tlDchannel := s0_super_ld_rep_select
687  when(io.tlb.req.valid && s0_sel_src.isFirstIssue) {
688    s0_out.uop.debugInfo.tlbFirstReqTime := GTimer()
689  }.otherwise{
690    s0_out.uop.debugInfo.tlbFirstReqTime := s0_sel_src.uop.debugInfo.tlbFirstReqTime
691  }
692  s0_out.schedIndex     := s0_sel_src.sched_idx
693
694  // load fast replay
695  io.fast_rep_in.ready := (s0_can_go && io.dcache.req.ready && s0_ld_fast_rep_ready)
696
697  // mmio
698  io.lsq.uncache.ready := s0_mmio_fire
699
700  // load flow source ready
701  // cache missed load has highest priority
702  // always accept cache missed load flow from load replay queue
703  io.replay.ready := (s0_can_go && io.dcache.req.ready && (s0_ld_rep_ready && !s0_rep_stall || s0_super_ld_rep_select))
704
705  // accept load flow from rs when:
706  // 1) there is no lsq-replayed load
707  // 2) there is no fast replayed load
708  // 3) there is no high confidence prefetch request
709  io.vecldin.ready := s0_can_go && io.dcache.req.ready && s0_vec_iss_ready
710  io.ldin.ready := s0_can_go && io.dcache.req.ready && s0_int_iss_ready
711
712  // for hw prefetch load flow feedback, to be added later
713  // io.prefetch_in.ready := s0_hw_prf_select
714
715  // dcache replacement extra info
716  // TODO: should prefetch load update replacement?
717  io.dcache.replacementUpdated := Mux(s0_ld_rep_select || s0_super_ld_rep_select, io.replay.bits.replacementUpdated, false.B)
718
719  // load wakeup
720  // TODO: vector load wakeup?
721  io.wakeup.valid := !s0_sel_src.isvec && s0_fire && (s0_super_ld_rep_select || s0_ld_fast_rep_select || s0_ld_rep_select || s0_int_iss_select) || s0_mmio_fire
722  io.wakeup.bits := s0_out.uop
723
724  XSDebug(io.dcache.req.fire,
725    p"[DCACHE LOAD REQ] pc ${Hexadecimal(s0_sel_src.uop.pc)}, vaddr ${Hexadecimal(s0_sel_src.vaddr)}\n"
726  )
727  XSDebug(s0_valid,
728    p"S0: pc ${Hexadecimal(s0_out.uop.pc)}, lId ${Hexadecimal(s0_out.uop.lqIdx.asUInt)}, " +
729    p"vaddr ${Hexadecimal(s0_out.vaddr)}, mask ${Hexadecimal(s0_out.mask)}\n")
730
731  // Pipeline
732  // --------------------------------------------------------------------------------
733  // stage 1
734  // --------------------------------------------------------------------------------
735  // TLB resp (send paddr to dcache)
736  val s1_valid      = RegInit(false.B)
737  val s1_in         = Wire(new LqWriteBundle)
738  val s1_out        = Wire(new LqWriteBundle)
739  val s1_kill       = Wire(Bool())
740  val s1_can_go     = s2_ready
741  val s1_fire       = s1_valid && !s1_kill && s1_can_go
742  val s1_vecActive        = RegEnable(s0_out.vecActive, true.B, s0_fire)
743
744  s1_ready := !s1_valid || s1_kill || s2_ready
745  when (s0_fire) { s1_valid := true.B }
746  .elsewhen (s1_fire) { s1_valid := false.B }
747  .elsewhen (s1_kill) { s1_valid := false.B }
748  s1_in   := RegEnable(s0_out, s0_fire)
749
750  val s1_fast_rep_dly_kill = RegNext(io.fast_rep_in.bits.lateKill) && s1_in.isFastReplay
751  val s1_fast_rep_dly_err =  RegNext(io.fast_rep_in.bits.delayedLoadError) && s1_in.isFastReplay
752  val s1_l2l_fwd_dly_err  = RegNext(io.l2l_fwd_in.dly_ld_err) && s1_in.isFastPath
753  val s1_dly_err          = s1_fast_rep_dly_err || s1_l2l_fwd_dly_err
754  val s1_vaddr_hi         = Wire(UInt())
755  val s1_vaddr_lo         = Wire(UInt())
756  val s1_vaddr            = Wire(UInt())
757  val s1_paddr_dup_lsu    = Wire(UInt())
758  val s1_gpaddr_dup_lsu   = Wire(UInt())
759  val s1_paddr_dup_dcache = Wire(UInt())
760  val s1_exception        = ExceptionNO.selectByFu(s1_out.uop.exceptionVec, LduCfg).asUInt.orR   // af & pf exception were modified below.
761  val s1_tlb_miss         = io.tlb.resp.bits.miss
762  val s1_prf              = s1_in.isPrefetch
763  val s1_hw_prf           = s1_in.isHWPrefetch
764  val s1_sw_prf           = s1_prf && !s1_hw_prf
765  val s1_tlb_memidx       = io.tlb.resp.bits.memidx
766
767  s1_vaddr_hi         := s1_in.vaddr(VAddrBits - 1, 6)
768  s1_vaddr_lo         := s1_in.vaddr(5, 0)
769  s1_vaddr            := Cat(s1_vaddr_hi, s1_vaddr_lo)
770  s1_paddr_dup_lsu    := io.tlb.resp.bits.paddr(0)
771  s1_paddr_dup_dcache := io.tlb.resp.bits.paddr(1)
772  s1_gpaddr_dup_lsu   := io.tlb.resp.bits.gpaddr(0)
773
774  when (s1_tlb_memidx.is_ld && io.tlb.resp.valid && !s1_tlb_miss && s1_tlb_memidx.idx === s1_in.uop.lqIdx.value) {
775    // printf("load idx = %d\n", s1_tlb_memidx.idx)
776    s1_out.uop.debugInfo.tlbRespTime := GTimer()
777  }
778
779  io.tlb.req_kill   := s1_kill || s1_dly_err
780  io.tlb.resp.ready := true.B
781
782  io.dcache.s1_paddr_dup_lsu    <> s1_paddr_dup_lsu
783  io.dcache.s1_paddr_dup_dcache <> s1_paddr_dup_dcache
784  io.dcache.s1_kill             := s1_kill || s1_dly_err || s1_tlb_miss || s1_exception
785
786  // store to load forwarding
787  io.sbuffer.valid := s1_valid && !(s1_exception || s1_tlb_miss || s1_kill || s1_dly_err || s1_prf)
788  io.sbuffer.vaddr := s1_vaddr
789  io.sbuffer.paddr := s1_paddr_dup_lsu
790  io.sbuffer.uop   := s1_in.uop
791  io.sbuffer.sqIdx := s1_in.uop.sqIdx
792  io.sbuffer.mask  := s1_in.mask
793  io.sbuffer.pc    := s1_in.uop.pc // FIXME: remove it
794
795  io.lsq.forward.valid     := s1_valid && !(s1_exception || s1_tlb_miss || s1_kill || s1_dly_err || s1_prf)
796  io.lsq.forward.vaddr     := s1_vaddr
797  io.lsq.forward.paddr     := s1_paddr_dup_lsu
798  io.lsq.forward.uop       := s1_in.uop
799  io.lsq.forward.sqIdx     := s1_in.uop.sqIdx
800  io.lsq.forward.sqIdxMask := 0.U
801  io.lsq.forward.mask      := s1_in.mask
802  io.lsq.forward.pc        := s1_in.uop.pc // FIXME: remove it
803
804  // st-ld violation query
805  val s1_nuke_paddr_match = VecInit((0 until StorePipelineWidth).map(w => {Mux(s1_in.isvec && s1_in.is128bit,
806    s1_paddr_dup_lsu(PAddrBits-1, 4) === io.stld_nuke_query(w).bits.paddr(PAddrBits-1, 4),
807    s1_paddr_dup_lsu(PAddrBits-1, 3) === io.stld_nuke_query(w).bits.paddr(PAddrBits-1, 3))}))
808  val s1_nuke = VecInit((0 until StorePipelineWidth).map(w => {
809                       io.stld_nuke_query(w).valid && // query valid
810                       isAfter(s1_in.uop.robIdx, io.stld_nuke_query(w).bits.robIdx) && // older store
811                       s1_nuke_paddr_match(w) && // paddr match
812                       (s1_in.mask & io.stld_nuke_query(w).bits.mask).orR // data mask contain
813                      })).asUInt.orR && !s1_tlb_miss
814
815  s1_out                   := s1_in
816  s1_out.vaddr             := s1_vaddr
817  s1_out.paddr             := s1_paddr_dup_lsu
818  s1_out.gpaddr            := s1_gpaddr_dup_lsu
819  s1_out.tlbMiss           := s1_tlb_miss
820  s1_out.ptwBack           := io.tlb.resp.bits.ptwBack
821  s1_out.rsIdx             := s1_in.rsIdx
822  s1_out.rep_info.debug    := s1_in.uop.debugInfo
823  s1_out.rep_info.nuke     := s1_nuke && !s1_sw_prf
824  s1_out.delayedLoadError  := s1_dly_err
825
826  when (!s1_dly_err) {
827    // current ori test will cause the case of ldest == 0, below will be modifeid in the future.
828    // af & pf exception were modified
829    s1_out.uop.exceptionVec(loadPageFault)   := io.tlb.resp.bits.excp(0).pf.ld && s1_vecActive && !s1_tlb_miss
830    s1_out.uop.exceptionVec(loadGuestPageFault)   := io.tlb.resp.bits.excp(0).gpf.ld && !s1_tlb_miss
831    s1_out.uop.exceptionVec(loadAccessFault) := io.tlb.resp.bits.excp(0).af.ld && s1_vecActive && !s1_tlb_miss
832  } .otherwise {
833    s1_out.uop.exceptionVec(loadPageFault)      := false.B
834    s1_out.uop.exceptionVec(loadGuestPageFault) := false.B
835    s1_out.uop.exceptionVec(loadAddrMisaligned) := false.B
836    s1_out.uop.exceptionVec(loadAccessFault)    := s1_dly_err && s1_vecActive
837  }
838
839  // pointer chasing
840  val s1_try_ptr_chasing       = RegNext(s0_do_try_ptr_chasing, false.B)
841  val s1_ptr_chasing_vaddr     = RegEnable(s0_ptr_chasing_vaddr, s0_do_try_ptr_chasing)
842  val s1_fu_op_type_not_ld     = WireInit(false.B)
843  val s1_not_fast_match        = WireInit(false.B)
844  val s1_addr_mismatch         = WireInit(false.B)
845  val s1_addr_misaligned       = WireInit(false.B)
846  val s1_fast_mismatch         = WireInit(false.B)
847  val s1_ptr_chasing_canceled  = WireInit(false.B)
848  val s1_cancel_ptr_chasing    = WireInit(false.B)
849
850  s1_kill := s1_fast_rep_dly_kill ||
851             s1_cancel_ptr_chasing ||
852             s1_in.uop.robIdx.needFlush(io.redirect) ||
853            (s1_in.uop.robIdx.needFlush(RegNext(io.redirect)) && !RegNext(s0_try_ptr_chasing)) ||
854             RegEnable(s0_kill, false.B, io.ldin.valid || io.vecldin.valid || io.replay.valid || io.l2l_fwd_in.valid || io.fast_rep_in.valid)
855
856  if (EnableLoadToLoadForward) {
857    // Sometimes, we need to cancel the load-load forwarding.
858    // These can be put at S0 if timing is bad at S1.
859    // Case 0: CACHE_SET(base + offset) != CACHE_SET(base) (lowest 6-bit addition has an overflow)
860    s1_addr_mismatch     := s1_ptr_chasing_vaddr(6) ||
861                             RegEnable(io.ld_fast_imm(11, 6).orR, s0_do_try_ptr_chasing)
862    // Case 1: the address is not 64-bit aligned or the fuOpType is not LD
863    s1_addr_misaligned := s1_ptr_chasing_vaddr(2, 0).orR
864    s1_fu_op_type_not_ld := io.ldin.bits.uop.fuOpType =/= LSUOpType.ld
865    // Case 2: this load-load uop is cancelled
866    s1_ptr_chasing_canceled := !io.ldin.valid
867    // Case 3: fast mismatch
868    s1_fast_mismatch := RegEnable(!io.ld_fast_match, s0_do_try_ptr_chasing)
869
870    when (s1_try_ptr_chasing) {
871      s1_cancel_ptr_chasing := s1_addr_mismatch ||
872                               s1_addr_misaligned ||
873                               s1_fu_op_type_not_ld ||
874                               s1_ptr_chasing_canceled ||
875                               s1_fast_mismatch
876
877      s1_in.uop           := io.ldin.bits.uop
878      s1_in.rsIdx         := io.ldin.bits.iqIdx
879      s1_in.isFirstIssue  := io.ldin.bits.isFirstIssue
880      s1_vaddr_lo         := s1_ptr_chasing_vaddr(5, 0)
881      s1_paddr_dup_lsu    := Cat(io.tlb.resp.bits.paddr(0)(PAddrBits - 1, 6), s1_vaddr_lo)
882      s1_paddr_dup_dcache := Cat(io.tlb.resp.bits.paddr(0)(PAddrBits - 1, 6), s1_vaddr_lo)
883
884      // recored tlb time when get the data to ensure the correctness of the latency calculation (although it should not record in here, because it does not use tlb)
885      s1_in.uop.debugInfo.tlbFirstReqTime := GTimer()
886      s1_in.uop.debugInfo.tlbRespTime     := GTimer()
887    }
888    when (!s1_cancel_ptr_chasing) {
889      s0_ptr_chasing_canceled := s1_try_ptr_chasing && !io.replay.fire && !io.fast_rep_in.fire && !(s0_high_conf_prf_valid && io.canAcceptHighConfPrefetch)
890      when (s1_try_ptr_chasing) {
891        io.ldin.ready := true.B
892      }
893    }
894  }
895
896  // pre-calcuate sqIdx mask in s0, then send it to lsq in s1 for forwarding
897  val s1_sqIdx_mask = RegNext(UIntToMask(s0_out.uop.sqIdx.value, StoreQueueSize))
898  // to enable load-load, sqIdxMask must be calculated based on ldin.uop
899  // If the timing here is not OK, load-load forwarding has to be disabled.
900  // Or we calculate sqIdxMask at RS??
901  io.lsq.forward.sqIdxMask := s1_sqIdx_mask
902  if (EnableLoadToLoadForward) {
903    when (s1_try_ptr_chasing) {
904      io.lsq.forward.sqIdxMask := UIntToMask(io.ldin.bits.uop.sqIdx.value, StoreQueueSize)
905    }
906  }
907
908  io.forward_mshr.valid  := s1_valid && s1_out.forward_tlDchannel
909  io.forward_mshr.mshrid := s1_out.mshrid
910  io.forward_mshr.paddr  := s1_out.paddr
911
912  XSDebug(s1_valid,
913    p"S1: pc ${Hexadecimal(s1_out.uop.pc)}, lId ${Hexadecimal(s1_out.uop.lqIdx.asUInt)}, tlb_miss ${io.tlb.resp.bits.miss}, " +
914    p"paddr ${Hexadecimal(s1_out.paddr)}, mmio ${s1_out.mmio}\n")
915
916  // Pipeline
917  // --------------------------------------------------------------------------------
918  // stage 2
919  // --------------------------------------------------------------------------------
920  // s2: DCache resp
921  val s2_valid  = RegInit(false.B)
922  val s2_in     = Wire(new LqWriteBundle)
923  val s2_out    = Wire(new LqWriteBundle)
924  val s2_kill   = Wire(Bool())
925  val s2_can_go = s3_ready
926  val s2_fire   = s2_valid && !s2_kill && s2_can_go
927  val s2_vecActive = RegEnable(s1_out.vecActive, true.B, s1_fire)
928  val s2_isvec  = RegEnable(s1_out.isvec, false.B, s1_fire)
929
930  s2_kill := s2_in.uop.robIdx.needFlush(io.redirect)
931  s2_ready := !s2_valid || s2_kill || s3_ready
932  when (s1_fire) { s2_valid := true.B }
933  .elsewhen (s2_fire) { s2_valid := false.B }
934  .elsewhen (s2_kill) { s2_valid := false.B }
935  s2_in := RegEnable(s1_out, s1_fire)
936
937  val s2_pmp = WireInit(io.pmp)
938
939  val s2_prf    = s2_in.isPrefetch
940  val s2_hw_prf = s2_in.isHWPrefetch
941
942  // exception that may cause load addr to be invalid / illegal
943  // if such exception happen, that inst and its exception info
944  // will be force writebacked to rob
945  val s2_exception_vec = WireInit(s2_in.uop.exceptionVec)
946  when (!s2_in.delayedLoadError) {
947    s2_exception_vec(loadAccessFault) := (s2_in.uop.exceptionVec(loadAccessFault) || s2_pmp.ld ||
948                                       (io.dcache.resp.bits.tag_error && RegNext(io.csrCtrl.cache_error_enable))) && s2_vecActive
949  }
950
951  // soft prefetch will not trigger any exception (but ecc error interrupt may
952  // be triggered)
953  when (!s2_in.delayedLoadError && (s2_prf || s2_in.tlbMiss)) {
954    s2_exception_vec := 0.U.asTypeOf(s2_exception_vec.cloneType)
955  }
956  val s2_exception = ExceptionNO.selectByFu(s2_exception_vec, LduCfg).asUInt.orR && s2_vecActive
957
958  val (s2_fwd_frm_d_chan, s2_fwd_data_frm_d_chan) = io.tl_d_channel.forward(s1_valid && s1_out.forward_tlDchannel, s1_out.mshrid, s1_out.paddr)
959  val (s2_fwd_data_valid, s2_fwd_frm_mshr, s2_fwd_data_frm_mshr) = io.forward_mshr.forward()
960  val s2_fwd_frm_d_chan_or_mshr = s2_fwd_data_valid && (s2_fwd_frm_d_chan || s2_fwd_frm_mshr)
961
962  // writeback access fault caused by ecc error / bus error
963  // * ecc data error is slow to generate, so we will not use it until load stage 3
964  // * in load stage 3, an extra signal io.load_error will be used to
965  val s2_actually_mmio = s2_pmp.mmio
966  val s2_mmio          = !s2_prf &&
967                          s2_actually_mmio &&
968                         !s2_exception &&
969                         !s2_in.tlbMiss
970
971  val s2_full_fwd      = Wire(Bool())
972  val s2_mem_amb       = s2_in.uop.storeSetHit &&
973                         io.lsq.forward.addrInvalid
974
975  val s2_tlb_miss      = s2_in.tlbMiss
976  val s2_fwd_fail      = io.lsq.forward.dataInvalid
977  val s2_dcache_miss   = io.dcache.resp.bits.miss &&
978                         !s2_fwd_frm_d_chan_or_mshr &&
979                         !s2_full_fwd
980
981  val s2_mq_nack       = io.dcache.s2_mq_nack &&
982                         !s2_fwd_frm_d_chan_or_mshr &&
983                         !s2_full_fwd
984
985  val s2_bank_conflict = io.dcache.s2_bank_conflict &&
986                         !s2_fwd_frm_d_chan_or_mshr &&
987                         !s2_full_fwd
988
989  val s2_wpu_pred_fail = io.dcache.s2_wpu_pred_fail &&
990                        !s2_fwd_frm_d_chan_or_mshr &&
991                        !s2_full_fwd
992
993  val s2_rar_nack      = io.lsq.ldld_nuke_query.req.valid &&
994                         !io.lsq.ldld_nuke_query.req.ready
995
996  val s2_raw_nack      = io.lsq.stld_nuke_query.req.valid &&
997                         !io.lsq.stld_nuke_query.req.ready
998  // st-ld violation query
999  //  NeedFastRecovery Valid when
1000  //  1. Fast recovery query request Valid.
1001  //  2. Load instruction is younger than requestors(store instructions).
1002  //  3. Physical address match.
1003  //  4. Data contains.
1004  val s2_nuke_paddr_match = VecInit((0 until StorePipelineWidth).map(w => {Mux(s2_in.isvec && s2_in.is128bit,
1005    s2_in.paddr(PAddrBits-1, 4) === io.stld_nuke_query(w).bits.paddr(PAddrBits-1, 4),
1006    s2_in.paddr(PAddrBits-1, 3) === io.stld_nuke_query(w).bits.paddr(PAddrBits-1, 3))}))
1007  val s2_nuke          = VecInit((0 until StorePipelineWidth).map(w => {
1008                          io.stld_nuke_query(w).valid && // query valid
1009                          isAfter(s2_in.uop.robIdx, io.stld_nuke_query(w).bits.robIdx) && // older store
1010                          s2_nuke_paddr_match(w) && // paddr match
1011                          (s2_in.mask & io.stld_nuke_query(w).bits.mask).orR // data mask contain
1012                        })).asUInt.orR && !s2_tlb_miss || s2_in.rep_info.nuke
1013
1014  val s2_cache_handled   = io.dcache.resp.bits.handled
1015  val s2_cache_tag_error = RegNext(io.csrCtrl.cache_error_enable) &&
1016                           io.dcache.resp.bits.tag_error
1017
1018  val s2_troublem        = !s2_exception &&
1019                           !s2_mmio &&
1020                           !s2_prf &&
1021                           !s2_in.delayedLoadError
1022
1023  io.dcache.resp.ready  := true.B
1024  val s2_dcache_should_resp = !(s2_in.tlbMiss || s2_exception || s2_in.delayedLoadError || s2_mmio || s2_prf)
1025  assert(!(s2_valid && (s2_dcache_should_resp && !io.dcache.resp.valid)), "DCache response got lost")
1026
1027  // fast replay require
1028  val s2_dcache_fast_rep = (s2_mq_nack || !s2_dcache_miss && (s2_bank_conflict || s2_wpu_pred_fail))
1029  val s2_nuke_fast_rep   = !s2_mq_nack &&
1030                           !s2_dcache_miss &&
1031                           !s2_bank_conflict &&
1032                           !s2_wpu_pred_fail &&
1033                           !s2_rar_nack &&
1034                           !s2_raw_nack &&
1035                           s2_nuke
1036
1037  val s2_fast_rep = !s2_mem_amb &&
1038                    !s2_tlb_miss &&
1039                    !s2_fwd_fail &&
1040                    (s2_dcache_fast_rep || s2_nuke_fast_rep) &&
1041                    s2_troublem
1042
1043  // need allocate new entry
1044  val s2_can_query = !s2_mem_amb &&
1045                     !s2_tlb_miss &&
1046                     !s2_fwd_fail &&
1047                     s2_troublem
1048
1049  val s2_data_fwded = s2_dcache_miss && (s2_full_fwd || s2_cache_tag_error)
1050
1051  // ld-ld violation require
1052  io.lsq.ldld_nuke_query.req.valid           := s2_valid && s2_can_query
1053  io.lsq.ldld_nuke_query.req.bits.uop        := s2_in.uop
1054  io.lsq.ldld_nuke_query.req.bits.mask       := s2_in.mask
1055  io.lsq.ldld_nuke_query.req.bits.paddr      := s2_in.paddr
1056  io.lsq.ldld_nuke_query.req.bits.data_valid := Mux(s2_full_fwd || s2_fwd_data_valid, true.B, !s2_dcache_miss)
1057
1058  // st-ld violation require
1059  io.lsq.stld_nuke_query.req.valid           := s2_valid && s2_can_query
1060  io.lsq.stld_nuke_query.req.bits.uop        := s2_in.uop
1061  io.lsq.stld_nuke_query.req.bits.mask       := s2_in.mask
1062  io.lsq.stld_nuke_query.req.bits.paddr      := s2_in.paddr
1063  io.lsq.stld_nuke_query.req.bits.data_valid := Mux(s2_full_fwd || s2_fwd_data_valid, true.B, !s2_dcache_miss)
1064
1065  // merge forward result
1066  // lsq has higher priority than sbuffer
1067  val s2_fwd_mask = Wire(Vec((VLEN/8), Bool()))
1068  val s2_fwd_data = Wire(Vec((VLEN/8), UInt(8.W)))
1069  s2_full_fwd := ((~s2_fwd_mask.asUInt).asUInt & s2_in.mask) === 0.U && !io.lsq.forward.dataInvalid
1070  // generate XLEN/8 Muxs
1071  for (i <- 0 until VLEN / 8) {
1072    s2_fwd_mask(i) := io.lsq.forward.forwardMask(i) || io.sbuffer.forwardMask(i)
1073    s2_fwd_data(i) := Mux(io.lsq.forward.forwardMask(i), io.lsq.forward.forwardData(i), io.sbuffer.forwardData(i))
1074  }
1075
1076  XSDebug(s2_fire, "[FWD LOAD RESP] pc %x fwd %x(%b) + %x(%b)\n",
1077    s2_in.uop.pc,
1078    io.lsq.forward.forwardData.asUInt, io.lsq.forward.forwardMask.asUInt,
1079    s2_in.forwardData.asUInt, s2_in.forwardMask.asUInt
1080  )
1081
1082  //
1083  s2_out                     := s2_in
1084  s2_out.data                := 0.U // data will be generated in load s3
1085  s2_out.uop.fpWen           := s2_in.uop.fpWen && !s2_exception
1086  s2_out.mmio                := s2_mmio
1087  s2_out.uop.flushPipe       := false.B
1088  s2_out.uop.exceptionVec    := s2_exception_vec
1089  s2_out.forwardMask         := s2_fwd_mask
1090  s2_out.forwardData         := s2_fwd_data
1091  s2_out.handledByMSHR       := s2_cache_handled
1092  s2_out.miss                := s2_dcache_miss && s2_troublem
1093  s2_out.feedbacked          := io.feedback_fast.valid
1094
1095  // Generate replay signal caused by:
1096  // * st-ld violation check
1097  // * tlb miss
1098  // * dcache replay
1099  // * forward data invalid
1100  // * dcache miss
1101  s2_out.rep_info.mem_amb         := s2_mem_amb && s2_troublem
1102  s2_out.rep_info.tlb_miss        := s2_tlb_miss && s2_troublem
1103  s2_out.rep_info.fwd_fail        := s2_fwd_fail && s2_troublem
1104  s2_out.rep_info.dcache_rep      := s2_mq_nack && s2_troublem
1105  s2_out.rep_info.dcache_miss     := s2_dcache_miss && s2_troublem
1106  s2_out.rep_info.bank_conflict   := s2_bank_conflict && s2_troublem
1107  s2_out.rep_info.wpu_fail        := s2_wpu_pred_fail && s2_troublem
1108  s2_out.rep_info.rar_nack        := s2_rar_nack && s2_troublem
1109  s2_out.rep_info.raw_nack        := s2_raw_nack && s2_troublem
1110  s2_out.rep_info.nuke            := s2_nuke && s2_troublem
1111  s2_out.rep_info.full_fwd        := s2_data_fwded
1112  s2_out.rep_info.data_inv_sq_idx := io.lsq.forward.dataInvalidSqIdx
1113  s2_out.rep_info.addr_inv_sq_idx := io.lsq.forward.addrInvalidSqIdx
1114  s2_out.rep_info.rep_carry       := io.dcache.resp.bits.replayCarry
1115  s2_out.rep_info.mshr_id         := io.dcache.resp.bits.mshr_id
1116  s2_out.rep_info.last_beat       := s2_in.paddr(log2Up(refillBytes))
1117  s2_out.rep_info.debug           := s2_in.uop.debugInfo
1118  s2_out.rep_info.tlb_id          := io.tlb_hint.id
1119  s2_out.rep_info.tlb_full        := io.tlb_hint.full
1120
1121  // if forward fail, replay this inst from fetch
1122  val debug_fwd_fail_rep = s2_fwd_fail && !s2_troublem && !s2_in.tlbMiss
1123  // if ld-ld violation is detected, replay from this inst from fetch
1124  val debug_ldld_nuke_rep = false.B // s2_ldld_violation && !s2_mmio && !s2_is_prefetch && !s2_in.tlbMiss
1125
1126  // to be removed
1127  io.feedback_fast.valid                 := false.B
1128  io.feedback_fast.bits.hit              := false.B
1129  io.feedback_fast.bits.flushState       := s2_in.ptwBack
1130  io.feedback_fast.bits.robIdx           := s2_in.uop.robIdx
1131  io.feedback_fast.bits.sourceType       := RSFeedbackType.lrqFull
1132  io.feedback_fast.bits.dataInvalidSqIdx := DontCare
1133
1134  io.ldCancel.ld1Cancel := false.B
1135
1136  // fast wakeup
1137  io.fast_uop.valid := RegNext(
1138    !io.dcache.s1_disable_fast_wakeup &&
1139    s1_valid &&
1140    !s1_kill &&
1141    !io.tlb.resp.bits.miss &&
1142    !io.lsq.forward.dataInvalidFast
1143  ) && (s2_valid && !s2_out.rep_info.need_rep && !s2_mmio) && !s2_isvec
1144  io.fast_uop.bits := RegNext(s1_out.uop)
1145
1146  //
1147  io.s2_ptr_chasing                    := RegEnable(s1_try_ptr_chasing && !s1_cancel_ptr_chasing, false.B, s1_fire)
1148
1149  // RegNext prefetch train for better timing
1150  // ** Now, prefetch train is valid at load s3 **
1151  io.prefetch_train.valid              := RegNext(s2_valid && !s2_actually_mmio && !s2_in.tlbMiss)
1152  io.prefetch_train.bits.fromLsPipelineBundle(s2_in, latch = true)
1153  io.prefetch_train.bits.miss          := RegNext(io.dcache.resp.bits.miss) // TODO: use trace with bank conflict?
1154  io.prefetch_train.bits.meta_prefetch := RegNext(io.dcache.resp.bits.meta_prefetch)
1155  io.prefetch_train.bits.meta_access   := RegNext(io.dcache.resp.bits.meta_access)
1156
1157  io.prefetch_train_l1.valid              := RegNext(s2_valid && !s2_actually_mmio)
1158  io.prefetch_train_l1.bits.fromLsPipelineBundle(s2_in, latch = true)
1159  io.prefetch_train_l1.bits.miss          := RegNext(io.dcache.resp.bits.miss)
1160  io.prefetch_train_l1.bits.meta_prefetch := RegNext(io.dcache.resp.bits.meta_prefetch)
1161  io.prefetch_train_l1.bits.meta_access   := RegNext(io.dcache.resp.bits.meta_access)
1162  if (env.FPGAPlatform){
1163    io.dcache.s0_pc := DontCare
1164    io.dcache.s1_pc := DontCare
1165    io.dcache.s2_pc := DontCare
1166  }else{
1167    io.dcache.s0_pc := s0_out.uop.pc
1168    io.dcache.s1_pc := s1_out.uop.pc
1169    io.dcache.s2_pc := s2_out.uop.pc
1170  }
1171  io.dcache.s2_kill := s2_pmp.ld || s2_actually_mmio || s2_kill
1172
1173  val s1_ld_left_fire = s1_valid && !s1_kill && s2_ready
1174  val s2_ld_valid_dup = RegInit(0.U(6.W))
1175  s2_ld_valid_dup := 0x0.U(6.W)
1176  when (s1_ld_left_fire && !s1_out.isHWPrefetch) { s2_ld_valid_dup := 0x3f.U(6.W) }
1177  when (s1_kill || s1_out.isHWPrefetch) { s2_ld_valid_dup := 0x0.U(6.W) }
1178  assert(RegNext((s2_valid === s2_ld_valid_dup(0)) || RegNext(s1_out.isHWPrefetch)))
1179
1180  // Pipeline
1181  // --------------------------------------------------------------------------------
1182  // stage 3
1183  // --------------------------------------------------------------------------------
1184  // writeback and update load queue
1185  val s3_valid        = RegNext(s2_valid && !s2_out.isHWPrefetch && !s2_out.uop.robIdx.needFlush(io.redirect))
1186  val s3_in           = RegEnable(s2_out, s2_fire)
1187  val s3_out          = Wire(Valid(new MemExuOutput))
1188  val s3_dcache_rep   = RegEnable(s2_dcache_fast_rep && s2_troublem, false.B, s2_fire)
1189  val s3_ld_valid_dup = RegEnable(s2_ld_valid_dup, s2_fire)
1190  val s3_fast_rep     = Wire(Bool())
1191  val s3_troublem     = RegNext(s2_troublem)
1192  val s3_kill         = s3_in.uop.robIdx.needFlush(io.redirect)
1193  val s3_vecout       = Wire(new OnlyVecExuOutput)
1194  val s3_vecActive    = RegEnable(s2_out.vecActive, true.B, s2_fire)
1195  val s3_isvec        = RegEnable(s2_out.isvec, false.B, s2_fire)
1196  val s3_vec_alignedType = RegEnable(s2_out.alignedType, s2_fire)
1197  val s3_vec_mBIndex     = RegEnable(s2_out.mbIndex, s2_fire)
1198  val s3_mmio         = Wire(Valid(new MemExuOutput))
1199  // TODO: Fix vector load merge buffer nack
1200  val s3_vec_mb_nack  = Wire(Bool())
1201  s3_vec_mb_nack     := false.B
1202  XSError(s3_valid && s3_vec_mb_nack, "Merge buffer should always accept vector loads!")
1203
1204  s3_ready := !s3_valid || s3_kill || io.ldout.ready
1205  s3_mmio.valid := RegNextN(io.lsq.uncache.fire, 3, Some(false.B))
1206  s3_mmio.bits  := RegNextN(io.lsq.uncache.bits, 3)
1207
1208  // forwrad last beat
1209  val (s3_fwd_frm_d_chan, s3_fwd_data_frm_d_chan) = io.tl_d_channel.forward(s2_valid && s2_out.forward_tlDchannel, s2_out.mshrid, s2_out.paddr)
1210  val s3_fwd_data_valid = RegEnable(s2_fwd_data_valid, false.B, s2_valid)
1211  val s3_fwd_frm_d_chan_valid = (s3_fwd_frm_d_chan && s3_fwd_data_valid && s3_in.handledByMSHR)
1212  val s3_fast_rep_canceled = io.replay.valid && io.replay.bits.forward_tlDchannel || !io.dcache.req.ready
1213
1214  // s3 load fast replay
1215  io.fast_rep_out.valid := s3_valid && s3_fast_rep && !s3_in.uop.robIdx.needFlush(io.redirect)
1216  io.fast_rep_out.bits := s3_in
1217
1218  io.lsq.ldin.valid := s3_valid && (!s3_fast_rep || s3_fast_rep_canceled) && !s3_in.feedbacked
1219  // TODO: check this --by hx
1220  // io.lsq.ldin.valid := s3_valid && (!s3_fast_rep || !io.fast_rep_out.ready) && !s3_in.feedbacked && !s3_in.lateKill
1221  io.lsq.ldin.bits := s3_in
1222  io.lsq.ldin.bits.miss := s3_in.miss && !s3_fwd_frm_d_chan_valid
1223
1224  /* <------- DANGEROUS: Don't change sequence here ! -------> */
1225  io.lsq.ldin.bits.data_wen_dup := s3_ld_valid_dup.asBools
1226  io.lsq.ldin.bits.replacementUpdated := io.dcache.resp.bits.replacementUpdated
1227  io.lsq.ldin.bits.missDbUpdated := RegNext(s2_fire && s2_in.hasROBEntry && !s2_in.tlbMiss && !s2_in.missDbUpdated)
1228
1229  val s3_dly_ld_err =
1230    if (EnableAccurateLoadError) {
1231      io.dcache.resp.bits.error_delayed && RegNext(io.csrCtrl.cache_error_enable) && s3_troublem
1232    } else {
1233      WireInit(false.B)
1234    }
1235  io.s3_dly_ld_err := false.B // s3_dly_ld_err && s3_valid
1236  io.lsq.ldin.bits.dcacheRequireReplay  := s3_dcache_rep
1237  io.fast_rep_out.bits.delayedLoadError := s3_dly_ld_err
1238
1239  val s3_vp_match_fail = RegNext(io.lsq.forward.matchInvalid || io.sbuffer.matchInvalid) && s3_troublem
1240  val s3_rep_frm_fetch = s3_vp_match_fail
1241  val s3_ldld_rep_inst =
1242      io.lsq.ldld_nuke_query.resp.valid &&
1243      io.lsq.ldld_nuke_query.resp.bits.rep_frm_fetch &&
1244      RegNext(io.csrCtrl.ldld_vio_check_enable)
1245  val s3_flushPipe = s3_ldld_rep_inst
1246
1247  val s3_rep_info = WireInit(s3_in.rep_info)
1248  s3_rep_info.dcache_miss   := s3_in.rep_info.dcache_miss && !s3_fwd_frm_d_chan_valid
1249  val s3_sel_rep_cause = PriorityEncoderOH(s3_rep_info.cause.asUInt)
1250
1251  val s3_exception = ExceptionNO.selectByFu(s3_in.uop.exceptionVec, LduCfg).asUInt.orR && s3_vecActive
1252  when (s3_exception || s3_dly_ld_err || s3_rep_frm_fetch) {
1253    io.lsq.ldin.bits.rep_info.cause := 0.U.asTypeOf(s3_rep_info.cause.cloneType)
1254  } .otherwise {
1255    io.lsq.ldin.bits.rep_info.cause := VecInit(s3_sel_rep_cause.asBools)
1256  }
1257
1258  // Int load, if hit, will be writebacked at s3
1259  s3_out.valid                := s3_valid && !io.lsq.ldin.bits.rep_info.need_rep && !s3_in.mmio
1260  s3_out.bits.uop             := s3_in.uop
1261  s3_out.bits.uop.exceptionVec(loadAccessFault) := (s3_dly_ld_err || s3_in.uop.exceptionVec(loadAccessFault)) && s3_vecActive
1262  s3_out.bits.uop.flushPipe   := false.B
1263  s3_out.bits.uop.replayInst  := s3_rep_frm_fetch || s3_flushPipe
1264  s3_out.bits.data            := s3_in.data
1265  s3_out.bits.debug.isMMIO    := s3_in.mmio
1266  s3_out.bits.debug.isPerfCnt := false.B
1267  s3_out.bits.debug.paddr     := s3_in.paddr
1268  s3_out.bits.debug.vaddr     := s3_in.vaddr
1269
1270  // Vector load, writeback to merge buffer
1271  // TODO: Add assertion in merge buffer, merge buffer must accept vec load writeback
1272  s3_vecout.isvec             := s3_isvec
1273  s3_vecout.vecdata           := 0.U // Data will be assigned later
1274  s3_vecout.mask              := s3_in.mask
1275  // s3_vecout.rob_idx_valid     := s3_in.rob_idx_valid
1276  // s3_vecout.inner_idx         := s3_in.inner_idx
1277  // s3_vecout.rob_idx           := s3_in.rob_idx
1278  // s3_vecout.offset            := s3_in.offset
1279  s3_vecout.reg_offset        := s3_in.reg_offset
1280  s3_vecout.vecActive         := s3_vecActive
1281  s3_vecout.is_first_ele      := s3_in.is_first_ele
1282  // s3_vecout.uopQueuePtr       := DontCare // uopQueuePtr is already saved in flow queue
1283  // s3_vecout.flowPtr           := s3_in.flowPtr
1284  s3_vecout.elemIdx           := s3_in.elemIdx // elemIdx is already saved in flow queue // TODO:
1285  s3_vecout.elemIdxInsideVd   := s3_in.elemIdxInsideVd
1286  val s3_usSecondInv          = s3_in.usSecondInv
1287
1288  io.rollback.valid := s3_valid && (s3_rep_frm_fetch || s3_flushPipe) && !s3_exception
1289  io.rollback.bits             := DontCare
1290  io.rollback.bits.isRVC       := s3_out.bits.uop.preDecodeInfo.isRVC
1291  io.rollback.bits.robIdx      := s3_out.bits.uop.robIdx
1292  io.rollback.bits.ftqIdx      := s3_out.bits.uop.ftqPtr
1293  io.rollback.bits.ftqOffset   := s3_out.bits.uop.ftqOffset
1294  io.rollback.bits.level       := Mux(s3_rep_frm_fetch, RedirectLevel.flush, RedirectLevel.flushAfter)
1295  io.rollback.bits.cfiUpdate.target := s3_out.bits.uop.pc
1296  io.rollback.bits.debug_runahead_checkpoint_id := s3_out.bits.uop.debugInfo.runahead_checkpoint_id
1297  /* <------- DANGEROUS: Don't change sequence here ! -------> */
1298
1299  io.lsq.ldin.bits.uop := s3_out.bits.uop
1300
1301  val s3_revoke = s3_exception || io.lsq.ldin.bits.rep_info.need_rep
1302  io.lsq.ldld_nuke_query.revoke := s3_revoke
1303  io.lsq.stld_nuke_query.revoke := s3_revoke
1304
1305  // feedback slow
1306  s3_fast_rep := RegNext(s2_fast_rep)
1307
1308  val s3_fb_no_waiting = !s3_in.isLoadReplay &&
1309                        (!(s3_fast_rep && !s3_fast_rep_canceled)) &&
1310                        !s3_in.feedbacked
1311
1312  // feedback: scalar load will send feedback to RS
1313  //           vector load will send signal to VL Merge Buffer, then send feedback at granularity of uops
1314  io.feedback_slow.valid                 := s3_valid && s3_fb_no_waiting && !s3_isvec
1315  io.feedback_slow.bits.hit              := !s3_rep_info.need_rep || io.lsq.ldin.ready
1316  io.feedback_slow.bits.flushState       := s3_in.ptwBack
1317  io.feedback_slow.bits.robIdx           := s3_in.uop.robIdx
1318  io.feedback_slow.bits.sourceType       := RSFeedbackType.lrqFull
1319  io.feedback_slow.bits.dataInvalidSqIdx := DontCare
1320
1321  io.ldCancel.ld2Cancel := s3_valid && (
1322    io.lsq.ldin.bits.rep_info.need_rep ||                       // exe fail or
1323    s3_in.mmio                                                  // is mmio
1324  ) && !s3_isvec
1325
1326  val s3_ld_wb_meta = Mux(s3_valid, s3_out.bits, s3_mmio.bits)
1327
1328  // data from load queue refill
1329  val s3_ld_raw_data_frm_uncache = RegNextN(io.lsq.ld_raw_data, 3)
1330  val s3_merged_data_frm_uncache = s3_ld_raw_data_frm_uncache.mergedData()
1331  val s3_picked_data_frm_uncache = LookupTree(s3_ld_raw_data_frm_uncache.addrOffset, List(
1332    "b000".U -> s3_merged_data_frm_uncache(63,  0),
1333    "b001".U -> s3_merged_data_frm_uncache(63,  8),
1334    "b010".U -> s3_merged_data_frm_uncache(63, 16),
1335    "b011".U -> s3_merged_data_frm_uncache(63, 24),
1336    "b100".U -> s3_merged_data_frm_uncache(63, 32),
1337    "b101".U -> s3_merged_data_frm_uncache(63, 40),
1338    "b110".U -> s3_merged_data_frm_uncache(63, 48),
1339    "b111".U -> s3_merged_data_frm_uncache(63, 56)
1340  ))
1341  val s3_ld_data_frm_uncache = rdataHelper(s3_ld_raw_data_frm_uncache.uop, s3_picked_data_frm_uncache)
1342
1343  // data from dcache hit
1344  val s3_ld_raw_data_frm_cache = Wire(new LoadDataFromDcacheBundle)
1345  s3_ld_raw_data_frm_cache.respDcacheData       := io.dcache.resp.bits.data_delayed
1346  s3_ld_raw_data_frm_cache.forwardMask          := RegEnable(s2_fwd_mask, s2_valid)
1347  s3_ld_raw_data_frm_cache.forwardData          := RegEnable(s2_fwd_data, s2_valid)
1348  s3_ld_raw_data_frm_cache.uop                  := RegEnable(s2_out.uop, s2_valid)
1349  s3_ld_raw_data_frm_cache.addrOffset           := RegEnable(s2_out.paddr(3, 0), s2_valid)
1350  s3_ld_raw_data_frm_cache.forward_D            := RegEnable(s2_fwd_frm_d_chan, false.B, s2_valid) || s3_fwd_frm_d_chan_valid
1351  s3_ld_raw_data_frm_cache.forwardData_D        := Mux(s3_fwd_frm_d_chan_valid, s3_fwd_data_frm_d_chan, RegEnable(s2_fwd_data_frm_d_chan, s2_valid))
1352  s3_ld_raw_data_frm_cache.forward_mshr         := RegEnable(s2_fwd_frm_mshr, false.B, s2_valid)
1353  s3_ld_raw_data_frm_cache.forwardData_mshr     := RegEnable(s2_fwd_data_frm_mshr, s2_valid)
1354  s3_ld_raw_data_frm_cache.forward_result_valid := RegEnable(s2_fwd_data_valid, false.B, s2_valid)
1355
1356  val s3_merged_data_frm_cache = s3_ld_raw_data_frm_cache.mergedData()
1357  val s3_picked_data_frm_cache = LookupTree(s3_ld_raw_data_frm_cache.addrOffset, List(
1358    "b0000".U -> s3_merged_data_frm_cache(63,    0),
1359    "b0001".U -> s3_merged_data_frm_cache(63,    8),
1360    "b0010".U -> s3_merged_data_frm_cache(63,   16),
1361    "b0011".U -> s3_merged_data_frm_cache(63,   24),
1362    "b0100".U -> s3_merged_data_frm_cache(63,   32),
1363    "b0101".U -> s3_merged_data_frm_cache(63,   40),
1364    "b0110".U -> s3_merged_data_frm_cache(63,   48),
1365    "b0111".U -> s3_merged_data_frm_cache(63,   56),
1366    "b1000".U -> s3_merged_data_frm_cache(127,  64),
1367    "b1001".U -> s3_merged_data_frm_cache(127,  72),
1368    "b1010".U -> s3_merged_data_frm_cache(127,  80),
1369    "b1011".U -> s3_merged_data_frm_cache(127,  88),
1370    "b1100".U -> s3_merged_data_frm_cache(127,  96),
1371    "b1101".U -> s3_merged_data_frm_cache(127, 104),
1372    "b1110".U -> s3_merged_data_frm_cache(127, 112),
1373    "b1111".U -> s3_merged_data_frm_cache(127, 120)
1374  ))
1375  val s3_ld_data_frm_cache = rdataHelper(s3_ld_raw_data_frm_cache.uop, s3_picked_data_frm_cache)
1376
1377  // FIXME: add 1 cycle delay ?
1378  // io.lsq.uncache.ready := !s3_valid
1379  val s3_outexception = ExceptionNO.selectByFu(s3_out.bits.uop.exceptionVec, LduCfg).asUInt.orR && s3_vecActive
1380  io.ldout.bits        := s3_ld_wb_meta
1381  io.ldout.bits.data   := Mux(s3_valid, Mux(!s3_outexception, s3_ld_data_frm_cache, 0.U), s3_ld_data_frm_uncache)
1382  io.ldout.valid       := (s3_out.valid || (s3_mmio.valid && !s3_valid)) && !s3_vecout.isvec
1383
1384  // TODO: check this --hx
1385  // io.ldout.valid       := s3_out.valid && !s3_out.bits.uop.robIdx.needFlush(io.redirect) && !s3_vecout.isvec ||
1386  //   io.lsq.uncache.valid && !io.lsq.uncache.bits.uop.robIdx.needFlush(io.redirect) && !s3_out.valid && !io.lsq.uncache.bits.isVls
1387  //  io.ldout.bits.data   := Mux(s3_out.valid, s3_ld_data_frm_cache, s3_ld_data_frm_uncache)
1388  //  io.ldout.valid       := s3_out.valid && !s3_out.bits.uop.robIdx.needFlush(io.redirect) ||
1389  //                         s3_mmio.valid && !s3_mmio.bits.uop.robIdx.needFlush(io.redirect) && !s3_out.valid
1390
1391  // s3 load fast replay
1392  io.fast_rep_out.valid := s3_valid && s3_fast_rep
1393  io.fast_rep_out.bits := s3_in
1394  io.fast_rep_out.bits.lateKill := s3_rep_frm_fetch
1395
1396  val vecFeedback = s3_valid && s3_fb_no_waiting && s3_rep_info.need_rep && !io.lsq.ldin.ready && s3_isvec
1397
1398  // vector output
1399  io.vecldout.bits.alignedType := s3_vec_alignedType
1400  // vec feedback
1401  io.vecldout.bits.vecFeedback := vecFeedback
1402  // TODO: VLSU, uncache data logic
1403  val vecdata = rdataVecHelper(s3_vec_alignedType(1,0), s3_picked_data_frm_cache)
1404  io.vecldout.bits.vecdata.get := Mux(s3_in.is128bit, s3_merged_data_frm_cache, vecdata)
1405  io.vecldout.bits.isvec := s3_vecout.isvec
1406  io.vecldout.bits.elemIdx := s3_vecout.elemIdx
1407  io.vecldout.bits.elemIdxInsideVd.get := s3_vecout.elemIdxInsideVd
1408  io.vecldout.bits.mask := s3_vecout.mask
1409  io.vecldout.bits.reg_offset.get := s3_vecout.reg_offset
1410  io.vecldout.bits.usSecondInv := s3_usSecondInv
1411  io.vecldout.bits.mBIndex := s3_vec_mBIndex
1412  io.vecldout.bits.hit := !s3_rep_info.need_rep || io.lsq.ldin.ready
1413  io.vecldout.bits.sourceType := RSFeedbackType.lrqFull
1414  io.vecldout.bits.flushState := DontCare
1415  io.vecldout.bits.exceptionVec := s3_out.bits.uop.exceptionVec
1416  io.vecldout.bits.vaddr := s3_in.vaddr
1417  io.vecldout.bits.mmio := DontCare
1418
1419  io.vecldout.valid := s3_out.valid && !s3_out.bits.uop.robIdx.needFlush(io.redirect) && s3_vecout.isvec ||
1420  // TODO: check this, why !io.lsq.uncache.bits.isVls before?
1421    io.lsq.uncache.valid && !io.lsq.uncache.bits.uop.robIdx.needFlush(io.redirect) && !s3_out.valid && io.lsq.uncache.bits.isVls
1422    //io.lsq.uncache.valid && !io.lsq.uncache.bits.uop.robIdx.needFlush(io.redirect) && !s3_out.valid && !io.lsq.uncache.bits.isVls
1423
1424  // fast load to load forward
1425  if (EnableLoadToLoadForward) {
1426    io.l2l_fwd_out.valid      := s3_valid && !s3_in.mmio && !s3_rep_info.need_rep
1427    io.l2l_fwd_out.data       := Mux(s3_in.vaddr(3), s3_merged_data_frm_cache(127, 64), s3_merged_data_frm_cache(63, 0))
1428    io.l2l_fwd_out.dly_ld_err := s3_dly_ld_err || // ecc delayed error
1429                                 s3_ldld_rep_inst ||
1430                                 s3_rep_frm_fetch
1431  } else {
1432    io.l2l_fwd_out.valid := false.B
1433    io.l2l_fwd_out.data := DontCare
1434    io.l2l_fwd_out.dly_ld_err := DontCare
1435  }
1436
1437   // trigger
1438  val last_valid_data = RegNext(RegEnable(io.ldout.bits.data, io.ldout.fire))
1439  val hit_ld_addr_trig_hit_vec = Wire(Vec(TriggerNum, Bool()))
1440  val lq_ld_addr_trig_hit_vec = io.lsq.trigger.lqLoadAddrTriggerHitVec
1441  (0 until TriggerNum).map{i => {
1442    val tdata2    = RegNext(io.trigger(i).tdata2)
1443    val matchType = RegNext(io.trigger(i).matchType)
1444    val tEnable   = RegNext(io.trigger(i).tEnable)
1445
1446    hit_ld_addr_trig_hit_vec(i) := TriggerCmp(RegNext(s2_out.vaddr), tdata2, matchType, tEnable)
1447    io.trigger(i).addrHit       := Mux(s3_out.valid, hit_ld_addr_trig_hit_vec(i), lq_ld_addr_trig_hit_vec(i))
1448  }}
1449  io.lsq.trigger.hitLoadAddrTriggerHitVec := hit_ld_addr_trig_hit_vec
1450
1451  // s1
1452  io.debug_ls.s1_robIdx := s1_in.uop.robIdx.value
1453  io.debug_ls.s1_isLoadToLoadForward := s1_fire && s1_try_ptr_chasing && !s1_ptr_chasing_canceled
1454  io.debug_ls.s1_isTlbFirstMiss := s1_fire && s1_tlb_miss && s1_in.isFirstIssue
1455  // s2
1456  io.debug_ls.s2_robIdx := s2_in.uop.robIdx.value
1457  io.debug_ls.s2_isBankConflict := s2_fire && (!s2_kill && s2_bank_conflict)
1458  io.debug_ls.s2_isDcacheFirstMiss := s2_fire && io.dcache.resp.bits.miss && s2_in.isFirstIssue
1459  io.debug_ls.s2_isForwardFail := s2_fire && s2_fwd_fail
1460  // s3
1461  io.debug_ls.s3_robIdx := s3_in.uop.robIdx.value
1462  io.debug_ls.s3_isReplayFast := s3_valid && s3_fast_rep && !s3_fast_rep_canceled
1463  io.debug_ls.s3_isReplayRS :=  RegNext(io.feedback_fast.valid && !io.feedback_fast.bits.hit) || (io.feedback_slow.valid && !io.feedback_slow.bits.hit)
1464  io.debug_ls.s3_isReplaySlow := io.lsq.ldin.valid && io.lsq.ldin.bits.rep_info.need_rep
1465  io.debug_ls.s3_isReplay := s3_valid && s3_rep_info.need_rep // include fast+slow+rs replay
1466  io.debug_ls.replayCause := s3_rep_info.cause
1467  io.debug_ls.replayCnt := 1.U
1468
1469  // Topdown
1470  io.lsTopdownInfo.s1.robIdx          := s1_in.uop.robIdx.value
1471  io.lsTopdownInfo.s1.vaddr_valid     := s1_valid && s1_in.hasROBEntry
1472  io.lsTopdownInfo.s1.vaddr_bits      := s1_vaddr
1473  io.lsTopdownInfo.s2.robIdx          := s2_in.uop.robIdx.value
1474  io.lsTopdownInfo.s2.paddr_valid     := s2_fire && s2_in.hasROBEntry && !s2_in.tlbMiss
1475  io.lsTopdownInfo.s2.paddr_bits      := s2_in.paddr
1476  io.lsTopdownInfo.s2.first_real_miss := io.dcache.resp.bits.real_miss
1477  io.lsTopdownInfo.s2.cache_miss_en   := s2_fire && s2_in.hasROBEntry && !s2_in.tlbMiss && !s2_in.missDbUpdated
1478
1479  // perf cnt
1480  XSPerfAccumulate("s0_in_valid",                  io.ldin.valid)
1481  XSPerfAccumulate("s0_in_block",                  io.ldin.valid && !io.ldin.fire)
1482  XSPerfAccumulate("s0_vecin_valid",               io.vecldin.valid)
1483  XSPerfAccumulate("s0_vecin_block",               io.vecldin.valid && !io.vecldin.fire)
1484  XSPerfAccumulate("s0_in_fire_first_issue",       s0_valid && s0_sel_src.isFirstIssue)
1485  XSPerfAccumulate("s0_lsq_replay_issue",          io.replay.fire)
1486  XSPerfAccumulate("s0_lsq_replay_vecissue",       io.replay.fire && io.replay.bits.isvec)
1487  XSPerfAccumulate("s0_ldu_fire_first_issue",      io.ldin.fire && s0_sel_src.isFirstIssue)
1488  XSPerfAccumulate("s0_fast_replay_issue",         io.fast_rep_in.fire)
1489  XSPerfAccumulate("s0_fast_replay_vecissue",      io.fast_rep_in.fire && io.fast_rep_in.bits.isvec)
1490  XSPerfAccumulate("s0_stall_out",                 s0_valid && !s0_can_go)
1491  XSPerfAccumulate("s0_stall_dcache",              s0_valid && !io.dcache.req.ready)
1492  XSPerfAccumulate("s0_addr_spec_success",         s0_fire && s0_sel_src.vaddr(VAddrBits-1, 12) === io.ldin.bits.src(0)(VAddrBits-1, 12))
1493  XSPerfAccumulate("s0_addr_spec_failed",          s0_fire && s0_sel_src.vaddr(VAddrBits-1, 12) =/= io.ldin.bits.src(0)(VAddrBits-1, 12))
1494  XSPerfAccumulate("s0_addr_spec_success_once",    s0_fire && s0_sel_src.vaddr(VAddrBits-1, 12) === io.ldin.bits.src(0)(VAddrBits-1, 12) && s0_sel_src.isFirstIssue)
1495  XSPerfAccumulate("s0_addr_spec_failed_once",     s0_fire && s0_sel_src.vaddr(VAddrBits-1, 12) =/= io.ldin.bits.src(0)(VAddrBits-1, 12) && s0_sel_src.isFirstIssue)
1496  XSPerfAccumulate("s0_vec_addr_vlen_aligned",     s0_fire && s0_sel_src.isvec && s0_sel_src.vaddr(3, 0) === 0.U)
1497  XSPerfAccumulate("s0_vec_addr_vlen_unaligned",   s0_fire && s0_sel_src.isvec && s0_sel_src.vaddr(3, 0) =/= 0.U)
1498  XSPerfAccumulate("s0_forward_tl_d_channel",      s0_out.forward_tlDchannel)
1499  XSPerfAccumulate("s0_hardware_prefetch_fire",    s0_fire && s0_hw_prf_select)
1500  XSPerfAccumulate("s0_software_prefetch_fire",    s0_fire && s0_sel_src.prf && s0_int_iss_select)
1501  XSPerfAccumulate("s0_hardware_prefetch_blocked", io.prefetch_req.valid && !s0_hw_prf_select)
1502  XSPerfAccumulate("s0_hardware_prefetch_total",   io.prefetch_req.valid)
1503
1504  XSPerfAccumulate("s1_in_valid",                  s1_valid)
1505  XSPerfAccumulate("s1_in_fire",                   s1_fire)
1506  XSPerfAccumulate("s1_in_fire_first_issue",       s1_fire && s1_in.isFirstIssue)
1507  XSPerfAccumulate("s1_tlb_miss",                  s1_fire && s1_tlb_miss)
1508  XSPerfAccumulate("s1_tlb_miss_first_issue",      s1_fire && s1_tlb_miss && s1_in.isFirstIssue)
1509  XSPerfAccumulate("s1_stall_out",                 s1_valid && !s1_can_go)
1510  XSPerfAccumulate("s1_dly_err",                   s1_valid && s1_fast_rep_dly_err)
1511
1512  XSPerfAccumulate("s2_in_valid",                  s2_valid)
1513  XSPerfAccumulate("s2_in_fire",                   s2_fire)
1514  XSPerfAccumulate("s2_in_fire_first_issue",       s2_fire && s2_in.isFirstIssue)
1515  XSPerfAccumulate("s2_dcache_miss",               s2_fire && io.dcache.resp.bits.miss)
1516  XSPerfAccumulate("s2_dcache_miss_first_issue",   s2_fire && io.dcache.resp.bits.miss && s2_in.isFirstIssue)
1517  XSPerfAccumulate("s2_dcache_real_miss_first_issue",   s2_fire && io.dcache.resp.bits.miss && s2_in.isFirstIssue)
1518  XSPerfAccumulate("s2_full_forward",              s2_fire && s2_full_fwd)
1519  XSPerfAccumulate("s2_dcache_miss_full_forward",  s2_fire && s2_dcache_miss)
1520  XSPerfAccumulate("s2_fwd_frm_d_can",             s2_valid && s2_fwd_frm_d_chan)
1521  XSPerfAccumulate("s2_fwd_frm_d_chan_or_mshr",    s2_valid && s2_fwd_frm_d_chan_or_mshr)
1522  XSPerfAccumulate("s2_stall_out",                 s2_fire && !s2_can_go)
1523  XSPerfAccumulate("s2_prefetch",                  s2_fire && s2_prf)
1524  XSPerfAccumulate("s2_prefetch_ignored",          s2_fire && s2_prf && io.dcache.s2_mq_nack) // ignore prefetch for mshr full / miss req port conflict
1525  XSPerfAccumulate("s2_prefetch_miss",             s2_fire && s2_prf && io.dcache.resp.bits.miss) // prefetch req miss in l1
1526  XSPerfAccumulate("s2_prefetch_hit",              s2_fire && s2_prf && !io.dcache.resp.bits.miss) // prefetch req hit in l1
1527  XSPerfAccumulate("s2_prefetch_accept",           s2_fire && s2_prf && io.dcache.resp.bits.miss && !io.dcache.s2_mq_nack) // prefetch a missed line in l1, and l1 accepted it
1528  XSPerfAccumulate("s2_forward_req",               s2_fire && s2_in.forward_tlDchannel)
1529  XSPerfAccumulate("s2_successfully_forward_channel_D", s2_fire && s2_fwd_frm_d_chan && s2_fwd_data_valid)
1530  XSPerfAccumulate("s2_successfully_forward_mshr",      s2_fire && s2_fwd_frm_mshr && s2_fwd_data_valid)
1531
1532  XSPerfAccumulate("s3_fwd_frm_d_chan",            s3_valid && s3_fwd_frm_d_chan_valid)
1533
1534  XSPerfAccumulate("load_to_load_forward",                      s1_try_ptr_chasing && !s1_ptr_chasing_canceled)
1535  XSPerfAccumulate("load_to_load_forward_try",                  s1_try_ptr_chasing)
1536  XSPerfAccumulate("load_to_load_forward_fail",                 s1_cancel_ptr_chasing)
1537  XSPerfAccumulate("load_to_load_forward_fail_cancelled",       s1_cancel_ptr_chasing && s1_ptr_chasing_canceled)
1538  XSPerfAccumulate("load_to_load_forward_fail_wakeup_mismatch", s1_cancel_ptr_chasing && !s1_ptr_chasing_canceled && s1_not_fast_match)
1539  XSPerfAccumulate("load_to_load_forward_fail_op_not_ld",       s1_cancel_ptr_chasing && !s1_ptr_chasing_canceled && !s1_not_fast_match && s1_fu_op_type_not_ld)
1540  XSPerfAccumulate("load_to_load_forward_fail_addr_align",      s1_cancel_ptr_chasing && !s1_ptr_chasing_canceled && !s1_not_fast_match && !s1_fu_op_type_not_ld && s1_addr_misaligned)
1541  XSPerfAccumulate("load_to_load_forward_fail_set_mismatch",    s1_cancel_ptr_chasing && !s1_ptr_chasing_canceled && !s1_not_fast_match && !s1_fu_op_type_not_ld && !s1_addr_misaligned && s1_addr_mismatch)
1542
1543  // bug lyq: some signals in perfEvents are no longer suitable for the current MemBlock design
1544  // hardware performance counter
1545  val perfEvents = Seq(
1546    ("load_s0_in_fire         ", s0_fire                                                        ),
1547    ("load_to_load_forward    ", s1_fire && s1_try_ptr_chasing && !s1_ptr_chasing_canceled      ),
1548    ("stall_dcache            ", s0_valid && s0_can_go && !io.dcache.req.ready                  ),
1549    ("load_s1_in_fire         ", s0_fire                                                        ),
1550    ("load_s1_tlb_miss        ", s1_fire && io.tlb.resp.bits.miss                               ),
1551    ("load_s2_in_fire         ", s1_fire                                                        ),
1552    ("load_s2_dcache_miss     ", s2_fire && io.dcache.resp.bits.miss                            ),
1553  )
1554  generatePerfEvent()
1555
1556  when(io.ldout.fire){
1557    XSDebug("ldout %x\n", io.ldout.bits.uop.pc)
1558  }
1559  // end
1560}