import os
import sys
from pathlib import Path
import logging
import random
from dataclasses import dataclass
import cocotb
import cocotb.handle
from cocotb.queue import Queue
from cocotb.clock import Clock
from cocotb.triggers import Trigger, First, Event, Timer, RisingEdge, Edge, FallingEdge
from cocotb_tools.runner import get_runner
if cocotb.simulator.is_running():
from spi_models import SpiInterface, SpiConfig, SpiSlave
ADDR_CTRL = 0
ADDR_INTMASK = 1
ADDR_STATUS = 2
ADDR_DATA = 3
INTMASK_RX_BUFFER_FULL = 0
INTMASK_TX_BUFFER_EMPTY = 1
INTMASK_LOST_RX_DATA = 3
STATUS_RX_BUFFER_FULL = 0
STATUS_TX_BUFFER_EMPTY = 1
STATUS_BUSY = 2
STATUS_LOST_RX_DATA = 3
CTRL_EN = 0
CTRL_MASTER = 1
CTRL_TX_EN = 2
CTRL_RX_EN = 3
CTRL_CLOCK_POLARITY = 4
CTRL_CLOCK_PHASE = 5
CTRL_PULSE_CSN = 6
CTRL_LSBFIRST = 7
CTRL_SIZE_SEL = 10
CTRL_DIV_SEL = 20
async def init(dut, master: int = 1, tx_en: int = 1):
dut._log.info("Init started!")
dut.waddress_i.value = 0
dut.raddress_i.value = 0
dut.wdata_i.value = 0
dut.write_i.value = 0
dut.read_i.value = 0
dut.rst_in.value = 0
await FallingEdge(dut.clk_i)
await FallingEdge(dut.clk_i)
# Release reset
dut.rst_in.value = 1
await FallingEdge(dut.clk_i)
await FallingEdge(dut.clk_i)
dut._log.info("Init done!")
class DutDriver:
def __init__(self, dut):
self.dut = dut
self.irq_handlers = []
async def clear_lost_rx_data(self):
await self.write(ADDR_INTMASK, INTMASK_LOST_RX_DATA)
async def configure_intmask(self, rx_buffer_full, tx_buffer_full, lost_rx_data):
await self.write(ADDR_INTMASK,
(rx_buffer_full << INTMASK_RX_BUFFER_FULL) |
(tx_buffer_full << INTMASK_TX_BUFFER_FULL) |
(lost_rx_data << INTMASK_LOST_RX_DATA))
async def configure(self, en, master, tx_en, rx_en, clock_polarity, clock_phase, pulse_csn, lsbfirst, size_sel, div_sel):
await self.write(ADDR_CTRL,
(en << CTRL_EN) |
(master << CTRL_MASTER) |
(tx_en << CTRL_TX_EN) |
(rx_en << CTRL_RX_EN) |
(clock_polarity << CTRL_CLOCK_POLARITY) |
(clock_phase << CTRL_CLOCK_PHASE) |
(lsbfirst << CTRL_LSBFIRST) |
(size_sel << CTRL_SIZE_SEL) |
(div_sel << CTRL_DIV_SEL))
async def read(self, address):
await FallingEdge(self.dut.clk_i)
self.dut.raddress_i.value = address
self.dut.read_i.value = 1
await FallingEdge(self.dut.clk_i)
self.dut.read_i.value = 0
return self.dut.rdata_o.value
async def write(self, address, data):
await FallingEdge(self.dut.clk_i)
self.dut.waddress_i.value = address
self.dut.wdata_i.value = data
self.dut.write_i.value = 1
await FallingEdge(self.dut.clk_i)
self.dut.write_i.value = 0
def register_interrupt_handler(self, handler):
self.irq_handlers.push(handler)
async def coroutine(self):
await RisingEdge(self.dut.interrupt_o)
if self.irq_handlers.len() == 0:
raise Exception("Got interrupt but there is no irq handler. This would be a dead loop.")
# The handlers are called until interrupt goes down!
while self.dut.interrupt_o.value == 1:
for irq_handler in irq_handlers:
irq_handler(self)
@cocotb.test()
async def single_transission(dut):
clk = Clock(dut.clk_i, 5, "ns")
interface = SpiInterface(dut.csn_o, dut.sck_o, dut.miso_i, dut.mosi_o)
config = SpiConfig(16, RisingEdge, FallingEdge, 40, "ns")
slave = SpiSlave(interface, config)
driver = DutDriver(dut)
await cocotb.start(clk.start())
await init(dut)
await cocotb.start(slave.coroutine())
await cocotb.start(driver.coroutine())
await driver.configure(
en = 1,
master = 1,
tx_en = 1,
rx_en = 1,
clock_polarity = 1,
clock_phase = 1,
pulse_csn = 0,
lsbfirst = 0,
size_sel = 1,
div_sel = 2)
# From slave point of view
rx = random.randint(0, 255)
tx = random.randint(0, 255)
await slave.send_data(tx, 16)
await slave.expect_transaction_in(100, "ns")
await driver.write(ADDR_DATA, rx)
await slave.wait_all()
await FallingEdge(dut.clk_i)
dut_received = await driver.read(ADDR_DATA)
assert (int(dut_received) & 0xFF) == tx
received = await slave.received_data()
assert int(received) & 0xFF == rx
await Timer(100, "ns")
def spi_peripheral_tests_runner():
hdl_toplevel_lang = "vhdl"
sim = os.getenv("SIM", "questa")
proj_path = Path(__file__).resolve().parent.parent
# equivalent to setting the PYTHONPATH environment variable
sys.path.append(str(proj_path / "models"))
sources = [
proj_path / "src" / "spi_pkg.vhd",
proj_path / "src" / "rs_latch.vhd",
proj_path / "src" / "register.vhd",
proj_path / "src" / "shift_register.vhd",
proj_path / "src" / "spi_clkgen.vhd",
proj_path / "src" / "spi_clkmon.vhd",
proj_path / "src" / "spi_slave_ctrl.vhd",
proj_path / "src" / "spi_master_ctrl.vhd",
proj_path / "src" / "spi_master.vhd",
proj_path / "src" / "spi_masterslave.vhd",
proj_path / "src" / "spi_peripheral.vhd"
]
build_args = []
extra_args = []
if sim == "ghdl":
extra_args = ["--std=08"]
elif sim == "questa" or sim == "modelsim":
build_args = ["-2008"]
# equivalent to setting the PYTHONPATH environment variable
sys.path.append(str(proj_path / "tests"))
runner = get_runner(sim)
runner.build(
sources=sources,
hdl_toplevel="spi_peripheral",
always=True,
build_args=build_args + extra_args,
)
runner.test(
hdl_toplevel="spi_peripheral", hdl_toplevel_lang=hdl_toplevel_lang,
test_module="test_spi_peripheral", test_args = extra_args,
gui = True
)
if __name__ == "__main__":
spi_peripheral_tests_runner()