from nmigen import Module, Signal
from nmigen.back.pysim import Simulator, Delay, Settle
-from nmutil.formaltest import FHDLTestCase
from nmigen.cli import rtlil
import unittest
from soc.decoder.isa.caller import ISACaller, special_sprs
from soc.regfile.regfiles import FastRegs
from soc.config.endian import bigendian
-from soc.fu.test.common import TestCase, ALUHelpers
+from soc.fu.test.common import TestAccumulatorBase, TestCase, ALUHelpers
from soc.fu.branch.pipeline import BranchBasePipe
from soc.fu.branch.pipe_data import BranchPipeSpec
import random
return recwidth
-# This test bench is a bit different than is usual. Initially when I
-# was writing it, I had all of the tests call a function to create a
-# device under test and simulator, initialize the dut, run the
-# simulation for ~2 cycles, and assert that the dut output what it
-# should have. However, this was really slow, since it needed to
-# create and tear down the dut and simulator for every test case.
-
-# Now, instead of doing that, every test case in ALUTestCase puts some
-# data into the test_data list below, describing the instructions to
-# be tested and the initial state. Once all the tests have been run,
-# test_data gets passed to TestRunner which then sets up the DUT and
-# simulator once, runs all the data through it, and asserts that the
-# results match the pseudocode sim at every cycle.
-
-# By doing this, I've reduced the time it takes to run the test suite
-# massively. Before, it took around 1 minute on my computer, now it
-# takes around 3 seconds
-
-
def get_cu_inputs(dec2, sim):
"""naming (res) must conform to BranchFunctionUnit input regspec
"""
return res
-class BranchTestCase(FHDLTestCase):
- test_data = []
-
- def __init__(self, name):
- super().__init__(name)
- self.test_name = name
-
- def run_tst_program(self, prog, initial_regs=None,
- initial_sprs=None, initial_cr=0):
- tc = TestCase(prog, self.test_name,
- initial_regs, initial_sprs, initial_cr)
- self.test_data.append(tc)
+class BranchTestCase(TestAccumulatorBase):
- def test_0_regression_unconditional(self):
+ def case_0_regression_unconditional(self):
for i in range(2):
imm = random.randrange(-1 << 23, (1 << 23)-1) * 4
lst = [f"bl {imm}"]
initial_regs = [0] * 32
- self.run_tst_program(Program(lst, bigendian), initial_regs)
+ self.add_case(Program(lst, bigendian), initial_regs)
- def test_unconditional(self):
+ def case_unconditional(self):
choices = ["b", "ba", "bl", "bla"]
for i in range(20):
choice = random.choice(choices)
imm = random.randrange(-1 << 23, (1 << 23)-1) * 4
lst = [f"{choice} {imm}"]
initial_regs = [0] * 32
- self.run_tst_program(Program(lst, bigendian), initial_regs)
+ self.add_case(Program(lst, bigendian), initial_regs)
- def test_bc_cr(self):
+ def case_bc_cr(self):
for i in range(20):
bc = random.randrange(-1 << 13, (1 << 13)-1) * 4
bo = random.choice([0b01100, 0b00100, 0b10100])
cr = random.randrange(0, (1 << 32)-1)
lst = [f"bc {bo}, {bi}, {bc}"]
initial_regs = [0] * 32
- self.run_tst_program(Program(lst, bigendian), initial_cr=cr)
+ self.add_case(Program(lst, bigendian), initial_cr=cr)
- def test_bc_ctr(self):
+ def case_bc_ctr(self):
for i in range(20):
bc = random.randrange(-1 << 13, (1 << 13)-1) * 4
bo = random.choice([0, 2, 8, 10, 16, 18])
ctr = random.randint(0, (1 << 32)-1)
lst = [f"bc {bo}, {bi}, {bc}"]
initial_sprs = {9: SelectableInt(ctr, 64)}
- self.run_tst_program(Program(lst, bigendian),
- initial_sprs=initial_sprs,
- initial_cr=cr)
+ self.add_case(Program(lst, bigendian),
+ initial_sprs=initial_sprs,
+ initial_cr=cr)
- def test_bc_reg(self):
+ def case_bc_reg(self):
# XXX: bcctr and bcctrl time out (irony: they're counters)
choices = ["bclr", "bclrl", "bcctr", "bcctrl", "bctar", "bctarl"]
for insn in choices:
initial_sprs = {9: SelectableInt(ctr, 64),
8: SelectableInt(lr, 64),
815: SelectableInt(tar, 64)}
- self.run_tst_program(Program(lst, bigendian),
- initial_sprs=initial_sprs,
- initial_cr=cr)
-
- def test_ilang(self):
+ self.add_case(Program(lst, bigendian),
+ initial_sprs=initial_sprs,
+ initial_cr=cr)
+
+ def case_bc_microwatt_1_regression(self):
+ """bc found to be testing ctr rather than (ctr-1)
+ 11fb4: 08 00 49 40 bc 2,4*cr2+gt,0x11fbc
+ cr_file.vhdl:83:13:@136835ns:(report note): Reading CR 33209703
+ """
+ lst = ["bc 2, 9, 8"]
+ initial_regs = [0] * 32
+ cr = 0x33209703
+ self.add_case(Program(lst, bigendian), initial_regs,
+ initial_cr=cr)
+
+ def case_bc_microwatt_2_regression(self):
+ """modified version, set CTR=1 so that it hits zero in BC
+ """
+ lst = ["bc 2, 9, 8"]
+ initial_regs = [0] * 32
+ cr = 0x33209703
+ ctr = 1
+ initial_sprs = {9: SelectableInt(ctr, 64),
+ }
+ self.add_case(Program(lst, bigendian), initial_regs,
+ initial_sprs=initial_sprs,
+ initial_cr=cr)
+
+ def case_ilang(self):
pspec = BranchPipeSpec(id_wid=2)
alu = BranchBasePipe(pspec)
vl = rtlil.convert(alu, ports=alu.ports())
f.write(vl)
-class TestRunner(FHDLTestCase):
- def __init__(self, test_data):
- super().__init__("run_all")
- self.test_data = test_data
-
- def run_all(self):
+class TestRunner(unittest.TestCase):
+ def test_it(self):
+ test_data = BranchTestCase().test_data
m = Module()
comb = m.d.comb
instruction = Signal(32)
- pdecode = create_pdecode()
+ fn_name = "BRANCH"
+ opkls = BranchPipeSpec.opsubsetkls
- m.submodules.pdecode2 = pdecode2 = PowerDecode2(pdecode)
+ m.submodules.pdecode2 = pdecode2 = PowerDecode2(None, opkls, fn_name)
+ pdecode = pdecode2.dec
pspec = BranchPipeSpec(id_wid=2)
m.submodules.branch = branch = BranchBasePipe(pspec)
sim.add_clock(1e-6)
def process():
- for test in self.test_data:
+ for test in test_data:
print(test.name)
program = test.program
- self.subTest(test.name)
- simulator = ISA(pdecode2, test.regs, test.sprs, test.cr,
- test.mem, test.msr,
- bigendian=bigendian)
- initial_cia = 0x2000
- simulator.set_pc(initial_cia)
- gen = program.generate_instructions()
- instructions = list(zip(gen, program.assembly.splitlines()))
-
- pc = simulator.pc.CIA.value
- msr = simulator.msr.value
- index = (pc - initial_cia)//4
- while index < len(instructions) and index >= 0:
- print(index)
- ins, code = instructions[index]
-
- print("0x{:X}".format(ins & 0xffffffff))
- print(code)
-
- # ask the decoder to decode this binary data (endian'd)
- yield pdecode2.dec.bigendian.eq(bigendian) # little / big?
- yield pdecode2.msr.eq(msr) # set MSR in pdecode2
- yield pdecode2.cia.eq(pc) # set PC in pdecode2
- yield instruction.eq(ins) # raw binary instr.
- # note, here, the op will need further decoding in order
- # to set the correct SPRs on SPR1/2/3. op_bc* require
- # spr1 to be set to CTR, op_bctar require spr2 to be
- # set to TAR, op_bclr* require spr2 to be set to LR.
- # if op_sc*, op_rf* and op_hrfid are to be added here
- # then additional op-decoding is required, accordingly
- yield Settle()
- lk = yield pdecode2.e.do.lk
- print("lk:", lk)
- yield from self.set_inputs(branch, pdecode2, simulator)
- fn_unit = yield pdecode2.e.do.fn_unit
- self.assertEqual(fn_unit, Function.BRANCH.value, code)
- yield
- yield
- opname = code.split(' ')[0]
- prev_nia = simulator.pc.NIA.value
- yield from simulator.call(opname)
+ with self.subTest(test.name):
+ simulator = ISA(pdecode2, test.regs, test.sprs, test.cr,
+ test.mem, test.msr,
+ bigendian=bigendian)
+ initial_cia = 0x2000
+ simulator.set_pc(initial_cia)
+ gen = program.generate_instructions()
+ instructions = list(
+ zip(gen, program.assembly.splitlines()))
+
pc = simulator.pc.CIA.value
msr = simulator.msr.value
index = (pc - initial_cia)//4
-
- yield from self.assert_outputs(branch, pdecode2,
- simulator, prev_nia, code)
+ while index < len(instructions) and index >= 0:
+ print(index)
+ ins, code = instructions[index]
+
+ print("0x{:X}".format(ins & 0xffffffff))
+ print(code)
+
+ # ask the decoder to decode this binary data (endian'd)
+ # little / big?
+ yield pdecode2.dec.bigendian.eq(bigendian)
+ yield pdecode2.state.msr.eq(msr) # set MSR in pdecode2
+ yield pdecode2.state.pc.eq(pc) # set PC in pdecode2
+ yield instruction.eq(ins) # raw binary instr.
+ # note, here, the op will need further decoding in order
+ # to set the correct SPRs on SPR1/2/3. op_bc* require
+ # spr1 to be set to CTR, op_bctar require spr2 to be
+ # set to TAR, op_bclr* require spr2 to be set to LR.
+ # if op_sc*, op_rf* and op_hrfid are to be added here
+ # then additional op-decoding is required, accordingly
+ yield Settle()
+ lk = yield pdecode2.e.do.lk
+ print("lk:", lk)
+ yield from self.set_inputs(branch, pdecode2, simulator)
+ fn_unit = yield pdecode2.e.do.fn_unit
+ self.assertEqual(fn_unit, Function.BRANCH.value, code)
+ yield
+ yield
+ opname = code.split(' ')[0]
+ prev_nia = simulator.pc.NIA.value
+ yield from simulator.call(opname)
+ pc = simulator.pc.CIA.value
+ msr = simulator.msr.value
+ index = (pc - initial_cia)//4
+
+ yield from self.assert_outputs(branch, pdecode2,
+ simulator, prev_nia,
+ code)
sim.add_sync_process(process)
with sim.write_vcd("branch_simulator.vcd"):
if __name__ == "__main__":
- unittest.main(exit=False)
- suite = unittest.TestSuite()
- suite.addTest(TestRunner(BranchTestCase.test_data))
-
- runner = unittest.TextTestRunner()
- runner.run(suite)
+ unittest.main()