src/scoreboard/fu_fu_matrix.py

   1 from nmigen.compat.sim import run_simulation
   2 from nmigen.cli import verilog, rtlil
   3 from nmigen import Module, Signal, Elaboratable, Array, Cat
   4
   5 #from nmutil.latch import SRLatch
   6 from .fu_dep_cell import FUDependenceCell
   7 from .fu_picker_vec import FU_Pick_Vec
   8
   9 """
  10
  11  6600 Function Unit Dependency Table Matrix inputs / outputs
  12  -----------------------------------------------------------
  13
  14 """
  15
  16 class FUFUDepMatrix(Elaboratable):
  17     """ implements 11.4.7 mitch alsup FU-to-Reg Dependency Matrix, p26
  18     """
  19     def __init__(self, n_fu_row, n_fu_col):
  20         self.n_fu_row = n_fu_row                  # Y (FU row#)   ^v
  21         self.n_fu_col = n_fu_col                # X (FU col #)  <>
  22         self.rd_pend_i = Signal(n_fu_row, reset_less=True) # Rd pending (left)
  23         self.wr_pend_i = Signal(n_fu_row, reset_less=True) # Wr pending (left)
  24         self.issue_i = Signal(n_fu_col, reset_less=True)    # Issue in (top)
  25
  26         self.go_wr_i = Signal(n_fu_row, reset_less=True) # Go Write in (left)
  27         self.go_rd_i = Signal(n_fu_row, reset_less=True)  # Go Read in (left)
  28
  29         # for Function Unit Readable/Writable (horizontal)
  30         self.readable_o = Signal(n_fu_col, reset_less=True) # readable (bot)
  31         self.writable_o = Signal(n_fu_col, reset_less=True) # writable (bot)
  32
  33     def elaborate(self, platform):
  34         m = Module()
  35
  36         # ---
  37         # matrix of dependency cells
  38         # ---
  39         dm = Array(Array(FUDependenceCell() for r in range(self.n_fu_row)) \
  40                                             for f in range(self.n_fu_col))
  41         for x in range(self.n_fu_col):
  42             for y in range(self.n_fu_row):
  43                 setattr(m.submodules, "dm_fx%d_fy%d" % (x, y), dm[x][y])
  44
  45         # ---
  46         # array of Function Unit Readable/Writable: row-length, horizontal
  47         # ---
  48         fur = Array(FU_Pick_Vec(self.n_fu_row) for r in range(self.n_fu_col))
  49         for x in range(self.n_fu_col):
  50             setattr(m.submodules, "fur_x%d" % (x), fur[x])
  51
  52         # ---
  53         # connect FU Readable/Writable vector
  54         # ---
  55         readable = []
  56         writable = []
  57         for x in range(self.n_fu_col):
  58             fu = fur[x]
  59             # accumulate Readable/Writable Vector outputs
  60             readable.append(fu.readable_o)
  61             writable.append(fu.writable_o)
  62
  63         # ... and output them from this module (horizontal, width=REGs)
  64         m.d.comb += self.readable_o.eq(Cat(*readable))
  65         m.d.comb += self.writable_o.eq(Cat(*writable))
  66
  67         # ---
  68         # connect FU Pending
  69         # ---
  70         for x in range(self.n_fu_col):
  71             fu = fur[x]
  72             rd_wait_o = []
  73             wr_wait_o = []
  74             for y in range(self.n_fu_row):
  75                 dc = dm[x][y]
  76                 # accumulate cell outputs rd/wr-pending
  77                 rd_wait_o.append(dc.rd_wait_o)
  78                 wr_wait_o.append(dc.wr_wait_o)
  79             # connect cell reg-select outputs to Reg Vector In
  80             m.d.comb += [fu.rd_pend_i.eq(Cat(*rd_wait_o)),
  81                          fu.wr_pend_i.eq(Cat(*wr_wait_o)),
  82                         ]
  83         # ---
  84         # connect Dependency Matrix dest/src1/src2/issue to module d/s/s/i
  85         # ---
  86         for y in range(self.n_fu_row):
  87             issue_i = []
  88             for x in range(self.n_fu_col):
  89                 dc = dm[x][y]
  90                 # accumulate cell inputs issue
  91                 issue_i.append(dc.issue_i)
  92             # wire up inputs from module to row cell inputs (Cat is gooood)
  93             m.d.comb += Cat(*issue_i).eq(self.issue_i)
  94
  95         # ---
  96         # connect Matrix go_rd_i/go_wr_i to module readable/writable
  97         # ---
  98         for x in range(self.n_fu_col):
  99             go_rd_i = []
 100             go_wr_i = []
 101             rd_pend_i = []
 102             wr_pend_i = []
 103             for y in range(self.n_fu_row):
 104                 dc = dm[x][y]
 105                 # accumulate cell rd_pend/wr_pend/go_rd/go_wr
 106                 rd_pend_i.append(dc.rd_pend_i)
 107                 wr_pend_i.append(dc.wr_pend_i)
 108                 go_rd_i.append(dc.go_rd_i)
 109                 go_wr_i.append(dc.go_wr_i)
 110             # wire up inputs from module to row cell inputs (Cat is gooood)
 111             m.d.comb += [Cat(*go_rd_i).eq(self.go_rd_i),
 112                          Cat(*go_wr_i).eq(self.go_wr_i),
 113                          Cat(*rd_pend_i).eq(self.rd_pend_i),
 114                          Cat(*wr_pend_i).eq(self.wr_pend_i),
 115                         ]
 116
 117         return m
 118
 119     def __iter__(self):
 120         yield self.rd_pend_i
 121         yield self.wr_pend_i
 122         yield self.issue_i
 123         yield self.go_wr_i
 124         yield self.go_rd_i
 125         yield self.readable_o
 126         yield self.writable_o
 127
 128     def ports(self):
 129         return list(self)
 130
 131 def d_matrix_sim(dut):
 132     """ XXX TODO
 133     """
 134     yield dut.dest_i.eq(1)
 135     yield dut.issue_i.eq(1)
 136     yield
 137     yield dut.issue_i.eq(0)
 138     yield
 139     yield dut.src1_i.eq(1)
 140     yield dut.issue_i.eq(1)
 141     yield
 142     yield dut.issue_i.eq(0)
 143     yield
 144     yield dut.go_rd_i.eq(1)
 145     yield
 146     yield dut.go_rd_i.eq(0)
 147     yield
 148     yield dut.go_wr_i.eq(1)
 149     yield
 150     yield dut.go_wr_i.eq(0)
 151     yield
 152
 153 def test_fu_fu_matrix():
 154     dut = FUFUDepMatrix(n_fu_row=3, n_fu_col=4)
 155     vl = rtlil.convert(dut, ports=dut.ports())
 156     with open("test_fu_fu_matrix.il", "w") as f:
 157         f.write(vl)
 158
 159     run_simulation(dut, d_matrix_sim(dut), vcd_name='test_fu_fu_matrix.vcd')
 160
 161 if __name__ == '__main__':
 162     test_fu_fu_matrix()