feat: enhance SoC topology and user extensions with APB targets and validation scripts

- Added APB target definitions in soc_topology.json for various peripherals.
- Introduced user_extensions.json to define user core and IP targets.
- Updated generate_filelist.py to include SVA paths.
- Refactored ip_apb_wrapper.sv to utilize generated APB interfaces and bridges.
- Simplified user_core_top.sv and user_ip_top.sv by including generated bindings.
- Implemented check_clock_reset_domains.py to validate clock/reset domains and CDC crossings.
- Updated regress.py to include SVA support in simulation commands.
- Added tests for clock/reset domain validation and user extensions generation.
- Enhanced test coverage for topology generation and APB target ownership validation.

scripts/check_clock_reset_domains.py

@@ -0,0 +1,110 @@
+#!/usr/bin/env python3
+"""Validate the declared Mini SoC root clock/reset domains and CDC crossings."""
+
+from __future__ import annotations
+
+import argparse
+import json
+import re
+from pathlib import Path
+from typing import Any
+
+
+RESET_PRIMITIVES = {"rst_sync"}
+CDC_PRIMITIVES = {"async_fifo", "cdc_2phase", "cdc_sync"}
+IDENTIFIER_RE = re.compile(r"[A-Za-z_][A-Za-z0-9_]*$")
+
+
+def require_object(value: Any, field: str) -> dict[str, Any]:
+    if not isinstance(value, dict):
+        raise ValueError(f"{field} must be an object")
+    return value
+
+
+def require_string(value: Any, field: str) -> str:
+    if not isinstance(value, str) or not value:
+        raise ValueError(f"{field} must be a non-empty string")
+    return value
+
+
+def require_identifier(value: Any, field: str) -> str:
+    identifier = require_string(value, field)
+    if IDENTIFIER_RE.fullmatch(identifier) is None:
+        raise ValueError(f"{field} must be a SystemVerilog identifier")
+    return identifier
+
+
+def require_instance(path: Path, primitive: str, instance: str, field: str) -> None:
+    if not path.is_file():
+        raise ValueError(f"{field}.path does not exist: {path}")
+    source = path.read_text(encoding="utf-8")
+    expression = re.compile(rf"\b{re.escape(primitive)}\b[\s\S]*?\b{re.escape(instance)}\b")
+    if expression.search(source) is None:
+        raise ValueError(f"{field} does not declare {primitive} instance {instance}")
+
+
+def validate(document_path: Path, root: Path) -> None:
+    document = require_object(json.loads(document_path.read_text(encoding="utf-8")), "domain map")
+    if document.get("schema_version") != 1:
+        raise ValueError("schema_version must be 1")
+
+    raw_domains = document.get("domains")
+    if not isinstance(raw_domains, list) or not raw_domains:
+        raise ValueError("domains must be a non-empty list")
+    names: set[str] = set()
+    for index, value in enumerate(raw_domains):
+        field = f"domains[{index}]"
+        domain = require_object(value, field)
+        name = require_identifier(domain.get("name"), f"{field}.name")
+        if name in names:
+            raise ValueError(f"domain {name} is duplicated")
+        names.add(name)
+        require_identifier(domain.get("clock"), f"{field}.clock")
+        require_identifier(domain.get("reset"), f"{field}.reset")
+        require_identifier(domain.get("reset_source"), f"{field}.reset_source")
+        primitive = require_string(domain.get("reset_primitive"), f"{field}.reset_primitive")
+        if primitive not in RESET_PRIMITIVES:
+            raise ValueError(f"{field}.reset_primitive is not supported")
+        path = root / require_string(domain.get("path"), f"{field}.path")
+        instance = require_identifier(domain.get("instance"), f"{field}.instance")
+        require_instance(path, primitive, instance, field)
+
+    raw_crossings = document.get("crossings")
+    if not isinstance(raw_crossings, list):
+        raise ValueError("crossings must be a list")
+    crossing_names: set[str] = set()
+    for index, value in enumerate(raw_crossings):
+        field = f"crossings[{index}]"
+        crossing = require_object(value, field)
+        name = require_identifier(crossing.get("name"), f"{field}.name")
+        if name in crossing_names:
+            raise ValueError(f"crossing {name} is duplicated")
+        crossing_names.add(name)
+        source = require_identifier(crossing.get("source"), f"{field}.source")
+        destination = require_identifier(crossing.get("destination"), f"{field}.destination")
+        if source not in names or destination not in names:
+            raise ValueError(f"{field} references an unknown domain")
+        if source == destination:
+            raise ValueError(f"{field} must cross between distinct domains")
+        primitive = require_string(crossing.get("primitive"), f"{field}.primitive")
+        if primitive not in CDC_PRIMITIVES:
+            raise ValueError(f"{field}.primitive is not an approved CDC primitive")
+        path = root / require_string(crossing.get("path"), f"{field}.path")
+        instance = require_identifier(crossing.get("instance"), f"{field}.instance")
+        require_instance(path, primitive, instance, field)
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("--map", required=True, type=Path)
+    parser.add_argument("--root", required=True, type=Path)
+    arguments = parser.parse_args()
+    try:
+        validate(arguments.map, arguments.root)
+    except (OSError, ValueError, json.JSONDecodeError) as error:
+        parser.error(str(error))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

scripts/regress.py

@@ -21,13 +21,13 @@ PR_COMMANDS = (
     ("configs/ci/hazard3-rv32im-ihp130-ip-mdd-shell.mk", ("firmware",)),
     (
         "configs/ci/hazard3-rv32im-ihp130-ip-mdd.mk",
-        ("SIMU=VERILATOR", "firmware", "sim"),
+        ("SIMU=VERILATOR", "HAVE_SVA=YES", "firmware", "sim"),
     ),
     (
         "configs/ci/mdd-rv32im-ihp130.mk",
-        ("SIMU=VERILATOR", "firmware", "sim"),
+        ("SIMU=VERILATOR", "HAVE_SVA=YES", "firmware", "sim"),
     ),
-    ("configs/ci/hazard3-rv32im-ihp130.mk", ("SIMU=VERILATOR", "sim")),
+    ("configs/ci/hazard3-rv32im-ihp130.mk", ("SIMU=VERILATOR", "HAVE_SVA=YES", "sim")),
     (
         "configs/ci/hazard3-rv32im-ihp130.mk",
         ("SIMU=IVERILOG", "RTL_SIM_TIMEOUT=5200000", "sim-asm"),
@@ -46,7 +46,10 @@ PR_COMMANDS = (
     ("configs/ci/hazard3-rv32im-ihp130.mk", ("STA=OPENSTA", "sta")),
 )
 NIGHTLY_COMMANDS = PR_COMMANDS + (
-    ("configs/nightly/picorv32-rv32im-ihp130.mk", ("SIMU=VERILATOR", "firmware", "sim")),
+    (
+        "configs/nightly/picorv32-rv32im-ihp130.mk",
+        ("SIMU=VERILATOR", "HAVE_SVA=YES", "firmware", "sim"),
+    ),
     (
         "configs/nightly/picorv32-rv32im-ihp130.mk",
         ("SIMU=IVERILOG", "RTL_SIM_TIMEOUT=5200000", "sim-asm"),