mirror of
https://github.com/retroSoC/retroSoC.git
synced 2026-11-06 14:55:14 +00:00
- Updated axi4_interconnect_tb to include an additional master and issue high-priority access tests. - Introduced hp_mailbox_tb for testing the HP mailbox functionality, including register and doorbell operations. - Added plic_tb to validate PLIC priority, claim, and completion mechanisms. - Enhanced pll_ctrl_tb to initialize additional system control signals. - Updated soc_irq_topology_tb to account for new IRQ sources and validate IRQ signal behavior. - Improved sysctrl_tb to include tests for HP lifecycle control and status registers. - Added tests for HP boot bundle layout, CRC, and payload validation. - Introduced test_hp_mailbox.py for RTL regression testing of the HP mailbox. - Added test_hp_platform.py to validate HP platform configuration and generated-source boundaries. - Enhanced test_librelane_flow.py to ensure correct signal placement in chip configuration. - Added performance log tests to validate LP and HP coremark ratios. - Updated test_soc_topology.py to reflect changes in IRQ and peripheral mappings.
108 lines
3.6 KiB
Python
108 lines
3.6 KiB
Python
"""HP flash bundle and handwritten mailbox ABI tests."""
|
|
|
|
from __future__ import annotations
|
|
|
|
import argparse
|
|
import importlib.util
|
|
import re
|
|
import struct
|
|
import zlib
|
|
from pathlib import Path
|
|
|
|
|
|
ROOT = Path(__file__).resolve().parents[1]
|
|
PACKAGER = ROOT / "scripts/package_hp_boot.py"
|
|
MAILBOX_RTL = ROOT / "rtl/ip/peripheral/hp_mailbox_define.svh"
|
|
MAILBOX_C = ROOT / "crt/src/hal/hp_mailbox.c"
|
|
|
|
|
|
def load_packager():
|
|
spec = importlib.util.spec_from_file_location("package_hp_boot", PACKAGER)
|
|
assert spec is not None and spec.loader is not None
|
|
module = importlib.util.module_from_spec(spec)
|
|
spec.loader.exec_module(module)
|
|
return module
|
|
|
|
|
|
def test_hp_boot_bundle_layout_crc_and_payloads(tmp_path: Path) -> None:
|
|
module = load_packager()
|
|
firmware = tmp_path / "lp.bin"
|
|
firmware.write_bytes(b"LP" * 32)
|
|
images = tmp_path / "images"
|
|
images.mkdir()
|
|
expected: dict[str, bytes] = {}
|
|
for index, (_, name, _, _) in enumerate(module.ARTIFACTS, start=1):
|
|
expected[name] = bytes([index]) * (31 + index)
|
|
(images / name).write_bytes(expected[name])
|
|
|
|
output = tmp_path / "boot.bin"
|
|
manifest = tmp_path / "boot.json"
|
|
module.package(
|
|
argparse.Namespace(
|
|
firmware=firmware,
|
|
images=images,
|
|
output=output,
|
|
manifest=manifest,
|
|
)
|
|
)
|
|
|
|
image = output.read_bytes()
|
|
header_values = module.HEADER.unpack_from(image, module.BUNDLE_OFFSET)
|
|
magic, version, header_size, entry_count, total_size, header_crc, flags, reserved = (
|
|
header_values
|
|
)
|
|
assert magic == module.MAGIC
|
|
assert version == module.VERSION
|
|
assert header_size == module.HEADER_SIZE == 128
|
|
assert entry_count == len(module.ARTIFACTS) == 4
|
|
assert total_size == len(image) - module.BUNDLE_OFFSET
|
|
assert flags == module.REQUIRED
|
|
assert reserved == 0
|
|
|
|
header = bytearray(image[module.BUNDLE_OFFSET : module.BUNDLE_OFFSET + header_size])
|
|
struct.pack_into("<I", header, 20, 0)
|
|
assert zlib.crc32(header) & 0xFFFFFFFF == header_crc
|
|
for index, (_, name, load_address, _) in enumerate(module.ARTIFACTS):
|
|
entry_offset = module.BUNDLE_OFFSET + module.HEADER.size + index * module.ENTRY.size
|
|
kind, flash_offset, entry_address, size, crc32, entry_flags = module.ENTRY.unpack_from(
|
|
image, entry_offset
|
|
)
|
|
assert kind == index + 1
|
|
assert entry_address == load_address
|
|
assert image[flash_offset : flash_offset + size] == expected[name]
|
|
assert zlib.crc32(expected[name]) & 0xFFFFFFFF == crc32
|
|
assert entry_flags == module.REQUIRED
|
|
|
|
|
|
def test_mailbox_c_offsets_match_handwritten_rtl() -> None:
|
|
rtl_pattern = re.compile(r"^`define\s+APB4_HP_MAILBOX__(\w+)\s+12'h([0-9A-Fa-f]+)$")
|
|
c_pattern = re.compile(
|
|
r"^#define\s+RS_HP_MAILBOX_(\w+)_OFFSET\s+UINT32_C\(0x([0-9A-Fa-f]+)\)$"
|
|
)
|
|
rtl = {
|
|
match.group(1): int(match.group(2), 16)
|
|
for line in MAILBOX_RTL.read_text(encoding="utf-8").splitlines()
|
|
if (match := rtl_pattern.match(line)) is not None
|
|
}
|
|
c = {
|
|
match.group(1): int(match.group(2), 16)
|
|
for line in MAILBOX_C.read_text(encoding="utf-8").splitlines()
|
|
if (match := c_pattern.match(line)) is not None
|
|
}
|
|
assert c == {
|
|
name: rtl[name]
|
|
for name in (
|
|
"IP_VERSION",
|
|
"CAPABILITY",
|
|
"LP_COMMAND",
|
|
"LP_ARG0",
|
|
"LP_SEQUENCE",
|
|
"LP_DOORBELL",
|
|
"HP_EVENT",
|
|
"HP_ARG0",
|
|
"HP_SEQUENCE",
|
|
"LP_INTR_STATE",
|
|
"LP_INTR_ENABLE",
|
|
)
|
|
}
|