140 lines
4.6 KiB
Python
140 lines
4.6 KiB
Python
"""Test handling of external nested addressable components."""
|
|
|
|
from collections.abc import Callable
|
|
from pathlib import Path
|
|
from tempfile import TemporaryDirectory
|
|
|
|
from systemrdl.node import AddrmapNode
|
|
|
|
from peakrdl_busdecoder import BusDecoderExporter
|
|
from peakrdl_busdecoder.cpuif.apb4 import APB4Cpuif
|
|
|
|
|
|
def test_external_nested_components_generate_correct_decoder(external_nested_rdl: AddrmapNode) -> None:
|
|
"""Test that external nested components generate correct decoder logic.
|
|
|
|
The decoder should:
|
|
- Generate select signals for multicast and port[16]
|
|
- NOT generate select signals for multicast.common[] or multicast.response
|
|
- NOT generate invalid paths like multicast.common[i0]
|
|
"""
|
|
with TemporaryDirectory() as tmpdir:
|
|
exporter = BusDecoderExporter()
|
|
exporter.export(
|
|
external_nested_rdl,
|
|
tmpdir,
|
|
cpuif_cls=APB4Cpuif,
|
|
)
|
|
|
|
# Read the generated module
|
|
module_file = Path(tmpdir) / "buffer_t.sv"
|
|
content = module_file.read_text()
|
|
|
|
# Should have correct select signals
|
|
assert "cpuif_wr_sel.multicast = 1'b1;" in content
|
|
assert "cpuif_wr_sel.port[i0] = 1'b1;" in content
|
|
|
|
# Should NOT have invalid nested paths
|
|
assert "cpuif_wr_sel.multicast.common" not in content
|
|
assert "cpuif_wr_sel.multicast.response" not in content
|
|
assert "cpuif_rd_sel.multicast.common" not in content
|
|
assert "cpuif_rd_sel.multicast.response" not in content
|
|
|
|
# Verify struct is flat (no nested structs for external children)
|
|
assert "typedef struct packed" in content
|
|
assert "logic multicast;" in content
|
|
assert "logic [15:0]port;" in content
|
|
|
|
|
|
def test_external_nested_components_generate_correct_interfaces(external_nested_rdl: AddrmapNode) -> None:
|
|
"""Test that external nested components generate correct interface ports.
|
|
|
|
The module should have:
|
|
- One master interface for multicast
|
|
- Array of 16 master interfaces for port[]
|
|
- NO interfaces for internal components like common[] or response
|
|
"""
|
|
with TemporaryDirectory() as tmpdir:
|
|
exporter = BusDecoderExporter()
|
|
exporter.export(
|
|
external_nested_rdl,
|
|
tmpdir,
|
|
cpuif_cls=APB4Cpuif,
|
|
)
|
|
|
|
# Read the generated module
|
|
module_file = Path(tmpdir) / "buffer_t.sv"
|
|
content = module_file.read_text()
|
|
|
|
# Should have master interfaces for top-level external children
|
|
assert "m_apb_multicast" in content
|
|
assert "m_apb_port [16]" in content or "m_apb_port[16]" in content
|
|
|
|
# Should NOT have interfaces for nested external children
|
|
assert "m_apb_multicast_common" not in content
|
|
assert "m_apb_multicast_response" not in content
|
|
assert "m_apb_common" not in content
|
|
assert "m_apb_response" not in content
|
|
|
|
|
|
def test_non_external_nested_components_are_descended(compile_rdl: Callable[..., AddrmapNode]) -> None:
|
|
"""Test that non-external nested components are still descended into.
|
|
|
|
This is a regression test to ensure we didn't break normal nested
|
|
component handling.
|
|
"""
|
|
rdl_source = """
|
|
addrmap inner_block {
|
|
reg {
|
|
field {
|
|
sw=rw;
|
|
hw=r;
|
|
} data[31:0];
|
|
} inner_reg @ 0x0;
|
|
};
|
|
|
|
addrmap outer_block {
|
|
inner_block inner @ 0x0;
|
|
};
|
|
"""
|
|
top = compile_rdl(rdl_source, top="outer_block")
|
|
|
|
with TemporaryDirectory() as tmpdir:
|
|
exporter = BusDecoderExporter()
|
|
exporter.export(top, tmpdir, cpuif_cls=APB4Cpuif)
|
|
|
|
# Read the generated module
|
|
module_file = Path(tmpdir) / "outer_block.sv"
|
|
content = module_file.read_text()
|
|
|
|
# Should descend into inner and reference inner_reg
|
|
assert "inner" in content
|
|
assert "inner_reg" in content
|
|
|
|
|
|
def test_max_decode_depth_parameter_exists(compile_rdl: Callable[..., AddrmapNode]) -> None:
|
|
"""Test that max_decode_depth parameter can be set."""
|
|
rdl_source = """
|
|
addrmap simple {
|
|
reg {
|
|
field { sw=rw; hw=r; } data[31:0];
|
|
} my_reg @ 0x0;
|
|
};
|
|
"""
|
|
top = compile_rdl(rdl_source, top="simple")
|
|
|
|
with TemporaryDirectory() as tmpdir:
|
|
exporter = BusDecoderExporter()
|
|
# Should not raise an exception
|
|
exporter.export(
|
|
top,
|
|
tmpdir,
|
|
cpuif_cls=APB4Cpuif,
|
|
max_decode_depth=2,
|
|
)
|
|
|
|
# Verify output was generated
|
|
module_file = Path(tmpdir) / "simple.sv"
|
|
assert module_file.exists()
|
|
|