
This is necessary for consistency, since for transparent read ports, we currently do not support .en at all (it is fixed at 1) due to YosysHQ/yosys#760. Before this commit, changing port transparency would require adding or removing an assignment to .en, which is confusing and error-prone. Also, most read ports are always enabled, so this behavior is also convenient.
132 lines
5.1 KiB
Python
132 lines
5.1 KiB
Python
from ..hdl.ast import *
|
|
from ..hdl.mem import *
|
|
from .tools import *
|
|
|
|
|
|
class MemoryTestCase(FHDLTestCase):
|
|
def test_name(self):
|
|
m1 = Memory(width=8, depth=4)
|
|
self.assertEqual(m1.name, "m1")
|
|
m2 = [Memory(width=8, depth=4)][0]
|
|
self.assertEqual(m2.name, "$memory")
|
|
m3 = Memory(width=8, depth=4, name="foo")
|
|
self.assertEqual(m3.name, "foo")
|
|
|
|
def test_geometry(self):
|
|
m = Memory(width=8, depth=4)
|
|
self.assertEqual(m.width, 8)
|
|
self.assertEqual(m.depth, 4)
|
|
|
|
def test_geometry_wrong(self):
|
|
with self.assertRaises(TypeError,
|
|
msg="Memory width must be a non-negative integer, not '-1'"):
|
|
m = Memory(width=-1, depth=4)
|
|
with self.assertRaises(TypeError,
|
|
msg="Memory depth must be a non-negative integer, not '-1'"):
|
|
m = Memory(width=8, depth=-1)
|
|
|
|
def test_init(self):
|
|
m = Memory(width=8, depth=4, init=range(4))
|
|
self.assertEqual(m.init, [0, 1, 2, 3])
|
|
|
|
def test_init_wrong_count(self):
|
|
with self.assertRaises(ValueError,
|
|
msg="Memory initialization value count exceed memory depth (8 > 4)"):
|
|
m = Memory(width=8, depth=4, init=range(8))
|
|
|
|
def test_init_wrong_type(self):
|
|
with self.assertRaises(TypeError,
|
|
msg="Memory initialization value at address 1: "
|
|
"'str' object cannot be interpreted as an integer"):
|
|
m = Memory(width=8, depth=4, init=[1, "0"])
|
|
|
|
def test_read_port_transparent(self):
|
|
mem = Memory(width=8, depth=4)
|
|
rdport = mem.read_port()
|
|
self.assertEqual(rdport.memory, mem)
|
|
self.assertEqual(rdport.domain, "sync")
|
|
self.assertEqual(rdport.transparent, True)
|
|
self.assertEqual(len(rdport.addr), 2)
|
|
self.assertEqual(len(rdport.data), 8)
|
|
self.assertEqual(len(rdport.en), 1)
|
|
self.assertIsInstance(rdport.en, Const)
|
|
self.assertEqual(rdport.en.value, 1)
|
|
|
|
def test_read_port_non_transparent(self):
|
|
mem = Memory(width=8, depth=4)
|
|
rdport = mem.read_port(transparent=False)
|
|
self.assertEqual(rdport.memory, mem)
|
|
self.assertEqual(rdport.domain, "sync")
|
|
self.assertEqual(rdport.transparent, False)
|
|
self.assertEqual(len(rdport.en), 1)
|
|
self.assertIsInstance(rdport.en, Signal)
|
|
self.assertEqual(rdport.en.reset, 1)
|
|
|
|
def test_read_port_asynchronous(self):
|
|
mem = Memory(width=8, depth=4)
|
|
rdport = mem.read_port(domain="comb")
|
|
self.assertEqual(rdport.memory, mem)
|
|
self.assertEqual(rdport.domain, "comb")
|
|
self.assertEqual(rdport.transparent, True)
|
|
self.assertEqual(len(rdport.en), 1)
|
|
self.assertIsInstance(rdport.en, Const)
|
|
self.assertEqual(rdport.en.value, 1)
|
|
|
|
def test_read_port_wrong(self):
|
|
mem = Memory(width=8, depth=4)
|
|
with self.assertRaises(ValueError,
|
|
msg="Read port cannot be simultaneously asynchronous and non-transparent"):
|
|
mem.read_port(domain="comb", transparent=False)
|
|
|
|
def test_write_port(self):
|
|
mem = Memory(width=8, depth=4)
|
|
wrport = mem.write_port()
|
|
self.assertEqual(wrport.memory, mem)
|
|
self.assertEqual(wrport.domain, "sync")
|
|
self.assertEqual(wrport.priority, 0)
|
|
self.assertEqual(wrport.granularity, 8)
|
|
self.assertEqual(len(wrport.addr), 2)
|
|
self.assertEqual(len(wrport.data), 8)
|
|
self.assertEqual(len(wrport.en), 1)
|
|
|
|
def test_write_port_granularity(self):
|
|
mem = Memory(width=8, depth=4)
|
|
wrport = mem.write_port(granularity=2)
|
|
self.assertEqual(wrport.memory, mem)
|
|
self.assertEqual(wrport.domain, "sync")
|
|
self.assertEqual(wrport.priority, 0)
|
|
self.assertEqual(wrport.granularity, 2)
|
|
self.assertEqual(len(wrport.addr), 2)
|
|
self.assertEqual(len(wrport.data), 8)
|
|
self.assertEqual(len(wrport.en), 4)
|
|
|
|
def test_write_port_granularity_wrong(self):
|
|
mem = Memory(width=8, depth=4)
|
|
with self.assertRaises(TypeError,
|
|
msg="Write port granularity must be a non-negative integer, not '-1'"):
|
|
mem.write_port(granularity=-1)
|
|
with self.assertRaises(ValueError,
|
|
msg="Write port granularity must not be greater than memory width (10 > 8)"):
|
|
mem.write_port(granularity=10)
|
|
with self.assertRaises(ValueError,
|
|
msg="Write port granularity must divide memory width evenly"):
|
|
mem.write_port(granularity=3)
|
|
|
|
|
|
class DummyPortTestCase(FHDLTestCase):
|
|
def test_name(self):
|
|
p1 = DummyPort(width=8, addr_bits=2)
|
|
self.assertEqual(p1.addr.name, "p1_addr")
|
|
p2 = [DummyPort(width=8, addr_bits=2)][0]
|
|
self.assertEqual(p2.addr.name, "dummy_addr")
|
|
p3 = DummyPort(width=8, addr_bits=2, name="foo")
|
|
self.assertEqual(p3.addr.name, "foo_addr")
|
|
|
|
def test_sizes(self):
|
|
p1 = DummyPort(width=8, addr_bits=2)
|
|
self.assertEqual(p1.addr.width, 2)
|
|
self.assertEqual(p1.data.width, 8)
|
|
self.assertEqual(p1.en.width, 1)
|
|
p2 = DummyPort(width=8, addr_bits=2, granularity=2)
|
|
self.assertEqual(p2.en.width, 4)
|