-from nmigen import Module, Signal
+from nmigen import Module, Signal, Mux
from nmigen.compat.sim import run_simulation
-from example_buf_pipe import BufPipe
+from example_buf_pipe import ExampleBufPipe, ExampleBufPipeAdd
+from example_buf_pipe import ExampleCombPipe, CombPipe
+from example_buf_pipe import IOAckIn, IOAckOut
from random import randint
o_n_valid = yield dut.o.n_valid
assert o_n_valid == val
-def check_o_n_valid2(dut, val):
- o_n_valid = yield dut.o_n_valid
- assert o_n_valid == val
-
def testbench(dut):
#yield dut.i_p_rst.eq(1)
- yield dut.i.n_busy.eq(1)
- yield dut.o.p_busy.eq(1)
+ yield dut.i.n_ready.eq(0)
+ yield dut.o.p_ready.eq(0)
yield
yield
#yield dut.i_p_rst.eq(0)
- yield dut.i.n_busy.eq(0)
- yield dut.stage.i_data.eq(5)
+ yield dut.i.n_ready.eq(1)
+ yield dut.i.data.eq(5)
yield dut.i.p_valid.eq(1)
yield
- yield dut.stage.i_data.eq(7)
+ yield dut.i.data.eq(7)
yield from check_o_n_valid(dut, 0) # effects of i_p_valid delayed
yield
yield from check_o_n_valid(dut, 1) # ok *now* i_p_valid effect is felt
- yield dut.stage.i_data.eq(2)
+ yield dut.i.data.eq(2)
yield
- yield dut.i.n_busy.eq(1) # begin going into "stall" (next stage says busy)
- yield dut.stage.i_data.eq(9)
+ yield dut.i.n_ready.eq(0) # begin going into "stall" (next stage says ready)
+ yield dut.i.data.eq(9)
yield
yield dut.i.p_valid.eq(0)
- yield dut.stage.i_data.eq(12)
+ yield dut.i.data.eq(12)
yield
- yield dut.stage.i_data.eq(32)
- yield dut.i.n_busy.eq(0)
+ yield dut.i.data.eq(32)
+ yield dut.i.n_ready.eq(1)
yield
yield from check_o_n_valid(dut, 1) # buffer still needs to output
yield
def testbench2(dut):
#yield dut.i.p_rst.eq(1)
- yield dut.i_n_busy.eq(1)
- #yield dut.o.p_busy.eq(1)
+ yield dut.i.n_ready.eq(0)
+ #yield dut.o.p_ready.eq(0)
yield
yield
#yield dut.i.p_rst.eq(0)
- yield dut.i_n_busy.eq(0)
- yield dut.i_data.eq(5)
- yield dut.i_p_valid.eq(1)
+ yield dut.i.n_ready.eq(1)
+ yield dut.i.data.eq(5)
+ yield dut.i.p_valid.eq(1)
yield
- yield dut.i_data.eq(7)
- yield from check_o_n_valid2(dut, 0) # effects of i_p_valid delayed 2 clocks
+ yield dut.i.data.eq(7)
+ yield from check_o_n_valid(dut, 0) # effects of i_p_valid delayed 2 clocks
yield
- yield from check_o_n_valid2(dut, 0) # effects of i_p_valid delayed 2 clocks
+ yield from check_o_n_valid(dut, 0) # effects of i_p_valid delayed 2 clocks
- yield dut.i_data.eq(2)
+ yield dut.i.data.eq(2)
yield
- yield from check_o_n_valid2(dut, 1) # ok *now* i_p_valid effect is felt
- yield dut.i_n_busy.eq(1) # begin going into "stall" (next stage says busy)
- yield dut.i_data.eq(9)
+ yield from check_o_n_valid(dut, 1) # ok *now* i_p_valid effect is felt
+ yield dut.i.n_ready.eq(0) # begin going into "stall" (next stage says ready)
+ yield dut.i.data.eq(9)
yield
- yield dut.i_p_valid.eq(0)
- yield dut.i_data.eq(12)
+ yield dut.i.p_valid.eq(0)
+ yield dut.i.data.eq(12)
yield
- yield dut.i_data.eq(32)
- yield dut.i_n_busy.eq(0)
+ yield dut.i.data.eq(32)
+ yield dut.i.n_ready.eq(1)
yield
- yield from check_o_n_valid2(dut, 1) # buffer still needs to output
+ yield from check_o_n_valid(dut, 1) # buffer still needs to output
yield
- yield from check_o_n_valid2(dut, 1) # buffer still needs to output
+ yield from check_o_n_valid(dut, 1) # buffer still needs to output
yield
- yield from check_o_n_valid2(dut, 1) # buffer still needs to output
+ yield from check_o_n_valid(dut, 1) # buffer still needs to output
yield
- yield from check_o_n_valid2(dut, 0) # buffer outputted, *now* we're done.
+ yield from check_o_n_valid(dut, 0) # buffer outputted, *now* we're done.
yield
yield
yield
class Test3:
- def __init__(self, dut):
+ def __init__(self, dut, resultfn):
self.dut = dut
+ self.resultfn = resultfn
self.data = []
- for i in range(10000):
+ for i in range(num_tests):
#data.append(randint(0, 1<<16-1))
self.data.append(i+1)
self.i = 0
send = True
else:
send = randint(0, send_range) != 0
- o_p_busy = yield self.dut.o.p_busy
- if o_p_busy:
+ o_p_ready = yield self.dut.o.p_ready
+ if not o_p_ready:
+ yield
+ continue
+ if send and self.i != len(self.data):
+ yield self.dut.i.p_valid.eq(1)
+ yield self.dut.i.data.eq(self.data[self.i])
+ self.i += 1
+ else:
+ yield self.dut.i.p_valid.eq(0)
+ yield
+
+ def rcv(self):
+ while self.o != len(self.data):
+ stall_range = randint(0, 3)
+ for j in range(randint(1,10)):
+ stall = randint(0, stall_range) != 0
+ yield self.dut.i.n_ready.eq(stall)
+ yield
+ o_n_valid = yield self.dut.o.n_valid
+ i_n_ready = yield self.dut.i.n_ready
+ if not o_n_valid or not i_n_ready:
+ continue
+ o_data = yield self.dut.o.data
+ self.resultfn(o_data, self.data[self.o], self.i, self.o)
+ self.o += 1
+ if self.o == len(self.data):
+ break
+
+def test3_resultfn(o_data, expected, i, o):
+ assert o_data == expected + 1, \
+ "%d-%d data %x not match %x\n" \
+ % (i, o, o_data, expected)
+
+class Test5:
+ def __init__(self, dut, resultfn):
+ self.dut = dut
+ self.resultfn = resultfn
+ self.data = []
+ for i in range(num_tests):
+ self.data.append((randint(0, 1<<16-1), randint(0, 1<<16-1)))
+ self.i = 0
+ self.o = 0
+
+ def send(self):
+ while self.o != len(self.data):
+ send_range = randint(0, 3)
+ for j in range(randint(1,10)):
+ if send_range == 0:
+ send = True
+ else:
+ send = randint(0, send_range) != 0
+ o_p_ready = yield self.dut.o.p_ready
+ if not o_p_ready:
yield
continue
if send and self.i != len(self.data):
yield self.dut.i.p_valid.eq(1)
- yield self.dut.stage.i_data.eq(self.data[self.i])
+ for v in self.dut.set_input(self.data[self.i]):
+ yield v
self.i += 1
else:
yield self.dut.i.p_valid.eq(0)
while self.o != len(self.data):
stall_range = randint(0, 3)
for j in range(randint(1,10)):
- stall = randint(0, stall_range) == 0
- yield self.dut.i.n_busy.eq(stall)
+ stall = randint(0, stall_range) != 0
+ yield self.dut.i.n_ready.eq(stall)
yield
o_n_valid = yield self.dut.o.n_valid
- i_n_busy = yield self.dut.i.n_busy
- if not o_n_valid or i_n_busy:
+ i_n_ready = yield self.dut.i.n_ready
+ if not o_n_valid or not i_n_ready:
continue
- o_data = yield self.dut.stage.o_data
- assert o_data == self.data[self.o] + 1, \
- "%d-%d data %x not match %x\n" \
- % (self.i, self.o, o_data, self.data[self.o])
+ o_data = yield self.dut.o.data
+ self.resultfn(o_data, self.data[self.o], self.i, self.o)
self.o += 1
if self.o == len(self.data):
break
+def test5_resultfn(o_data, expected, i, o):
+ res = expected[0] + expected[1]
+ assert o_data == res, \
+ "%d-%d data %x not match %s\n" \
+ % (i, o, o_data, repr(expected))
def testbench4(dut):
data = []
- for i in range(10000):
+ for i in range(num_tests):
#data.append(randint(0, 1<<16-1))
data.append(i+1)
i = 0
o = 0
while True:
- stall = randint(0, 3) == 0
+ stall = randint(0, 3) != 0
send = randint(0, 5) != 0
- yield dut.i_n_busy.eq(stall)
- o_p_busy = yield dut.o_p_busy
- if not o_p_busy:
+ yield dut.i.n_ready.eq(stall)
+ o_p_ready = yield dut.o.p_ready
+ if o_p_ready:
if send and i != len(data):
- yield dut.i_p_valid.eq(1)
- yield dut.i_data.eq(data[i])
+ yield dut.i.p_valid.eq(1)
+ yield dut.i.data.eq(data[i])
i += 1
else:
- yield dut.i_p_valid.eq(0)
+ yield dut.i.p_valid.eq(0)
yield
- o_n_valid = yield dut.o_n_valid
- i_n_busy = yield dut.i_n_busy
- if o_n_valid and not i_n_busy:
- o_data = yield dut.o_data
+ o_n_valid = yield dut.o.n_valid
+ i_n_ready = yield dut.i.n_ready
+ if o_n_valid and i_n_ready:
+ o_data = yield dut.o.data
assert o_data == data[o] + 2, "%d-%d data %x not match %x\n" \
% (i, o, o_data, data[o])
o += 1
break
-class BufPipe2:
+class ExampleBufPipe2:
"""
connect these: ------|---------------|
v v
- i_p_valid >>in pipe1 o_n_valid out>> i_p_valid >>in pipe2
- o_p_busy <<out pipe1 i_n_busy <<in o_p_busy <<out pipe2
- stage.i_data >>in pipe1 o_data out>> stage.i_data >>in pipe2
+ i_p_valid >>in pipe1 o_n_valid out>> i_p_valid >>in pipe2
+ o_p_ready <<out pipe1 i_n_ready <<in o_p_ready <<out pipe2
+ i_data >>in pipe1 o_data out>> i_data >>in pipe2
"""
def __init__(self):
- self.pipe1 = BufPipe()
- self.pipe2 = BufPipe()
+ self.pipe1 = ExampleBufPipe()
+ self.pipe2 = ExampleBufPipe()
# input
- self.i_p_valid = Signal() # >>in - comes in from PREVIOUS stage
- self.i_n_busy = Signal() # in<< - comes in from the NEXT stage
- self.i_data = Signal(32) # >>in - comes in from the PREVIOUS stage
+ self.i = IOAckIn()
+ self.i.data = Signal(32) # >>in - comes in from the PREVIOUS stage
# output
- self.o_n_valid = Signal() # out>> - goes out to the NEXT stage
- self.o_p_busy = Signal() # <<out - goes out to the PREVIOUS stage
- self.o_data = Signal(32) # out>> - goes out to the NEXT stage
+ self.o = IOAckOut()
+ self.o.data = Signal(32) # out>> - goes out to the NEXT stage
def elaborate(self, platform):
m = Module()
m.submodules.pipe1 = self.pipe1
m.submodules.pipe2 = self.pipe2
- # connect inter-pipe input/output valid/busy/data
- m.d.comb += self.pipe2.i.p_valid.eq(self.pipe1.o.n_valid)
- m.d.comb += self.pipe1.i.n_busy.eq(self.pipe2.o.p_busy)
- m.d.comb += self.pipe2.stage.i_data.eq(self.pipe1.stage.o_data)
+ # connect inter-pipe input/output valid/ready/data
+ m.d.comb += self.pipe1.connect_next(self.pipe2)
# inputs/outputs to the module: pipe1 connections here (LHS)
- m.d.comb += self.pipe1.i.p_valid.eq(self.i_p_valid)
- m.d.comb += self.o_p_busy.eq(self.pipe1.o.p_busy)
- m.d.comb += self.pipe1.stage.i_data.eq(self.i_data)
+ m.d.comb += self.pipe1.connect_in(self)
# now pipe2 connections (RHS)
- m.d.comb += self.o_n_valid.eq(self.pipe2.o.n_valid)
- m.d.comb += self.pipe2.i.n_busy.eq(self.i_n_busy)
- m.d.comb += self.o_data.eq(self.pipe2.stage.o_data)
+ m.d.comb += self.pipe2.connect_out(self)
return m
+class SetLessThan:
+ def __init__(self, width, signed):
+ self.src1 = Signal((width, signed))
+ self.src2 = Signal((width, signed))
+ self.output = Signal(width)
+
+ def elaborate(self, platform):
+ m = Module()
+ m.d.comb += self.output.eq(Mux(self.src1 < self.src2, 1, 0))
+ return m
+
+
+class LTStage:
+ def __init__(self):
+ self.slt = SetLessThan(16, True)
+
+ def ispec(self):
+ return (Signal(16), Signal(16))
+
+ def ospec(self):
+ return Signal(16)
+
+ def setup(self, m, i):
+ self.o = Signal(16)
+ m.submodules.slt = self.slt
+ m.d.comb += self.slt.src1.eq(i[0])
+ m.d.comb += self.slt.src2.eq(i[1])
+ m.d.comb += self.o.eq(self.slt.output)
+
+ def process(self, i):
+ return self.o
+
+
+class ExampleLTCombPipe(CombPipe):
+ """ an example of how to use the combinatorial pipeline.
+ """
+
+ def __init__(self):
+ stage = LTStage()
+ CombPipe.__init__(self, stage)
+
+
+def test6_resultfn(o_data, expected, i, o):
+ res = 1 if expected[0] < expected[1] else 0
+ assert o_data == res, \
+ "%d-%d data %x not match %s\n" \
+ % (i, o, o_data, repr(expected))
+
+
+num_tests = 1000
+
if __name__ == '__main__':
print ("test 1")
- dut = BufPipe()
+ dut = ExampleBufPipe()
run_simulation(dut, testbench(dut), vcd_name="test_bufpipe.vcd")
print ("test 2")
- dut = BufPipe2()
+ dut = ExampleBufPipe2()
run_simulation(dut, testbench2(dut), vcd_name="test_bufpipe2.vcd")
print ("test 3")
- dut = BufPipe()
- test = Test3(dut)
+ dut = ExampleBufPipe()
+ test = Test3(dut, test3_resultfn)
run_simulation(dut, [test.send, test.rcv], vcd_name="test_bufpipe3.vcd")
+ print ("test 3.5")
+ dut = ExampleCombPipe()
+ test = Test3(dut, test3_resultfn)
+ run_simulation(dut, [test.send, test.rcv], vcd_name="test_combpipe3.vcd")
+
print ("test 4")
- dut = BufPipe2()
+ dut = ExampleBufPipe2()
run_simulation(dut, testbench4(dut), vcd_name="test_bufpipe4.vcd")
+
+ print ("test 5")
+ dut = ExampleBufPipeAdd()
+ test = Test5(dut, test5_resultfn)
+ run_simulation(dut, [test.send, test.rcv], vcd_name="test_bufpipe5.vcd")
+
+ print ("test 6")
+ dut = ExampleLTCombPipe()
+ test = Test5(dut, test6_resultfn)
+ run_simulation(dut, [test.send, test.rcv], vcd_name="test_ltcomb6.vcd")
+