Files
maksyuki 2b6819449c feat: enhance test coverage and update system control interfaces
- Added  interface to  and implemented error handling for register writes.
- Introduced a new test for AXI4 address gate functionality in .
- Updated clock and reset domain assertions in  to reflect new domain names.
- Modified expected outputs in  to include new clock domains.
- Adjusted chip configuration assertions in  to account for additional power pads.
- Enhanced memory map tests in  with new definitions and includes.
- Updated pin mapping tests in  to include new reference clock pads.
- Improved script tools tests in  to ensure correct validation of extension bindings.
- Refined system control tests in  to include new clock control interface.
- Updated USB2 packet RAM tests in  to include new SRAM definitions.
- Enhanced user extensions tests in  to validate new product extension configurations.
- Adjusted user IP register parity tests to use legacy extensions.
- Updated Yosys synthesis recipe tests to reflect changes in STA period calculations.
2026-08-30 08:10:59 +08:00
..

FPGA Integration

This directory contains FPGA-facing top-level integration for the Mini SoC. mini/retrosoc_top.sv is the FPGA top wrapper and mini/starrysky_v2.xdc contains board timing and pin constraints.

The wrapper consumes the generated retrosoc_asic_fpga_mini_bindings.svh include. Before invoking an FPGA tool, generate the selected profile with make CONFIG=configs/ci/hazard3-rv32im-ihp130.mk pin-map and add build/<variant>/generated/pin_map/rtl to the tool include path. Logical pad names and wrapper bindings are owned by rtl/mini/pin_map/pin_map.json; package locations remain in the board .xdc file. The dedicated SDIO1 pads are intentionally left unbound by the FPGA profile until a board package location and 3.3 V I/O-bank assignment are approved; the existing LVCMOS18 constraints do not establish SDIO electrical support. The new UART1 HP-console ports are likewise left unbound until two StarrySky package pins and their I/O voltage are reviewed. The ASIC profile still owns dedicated UART1 pads; this FPGA constraint gap is intentional and must be resolved before generating an HP board bitstream.

FPGA constraints are board-specific implementation inputs, not generic ASIC RTL. Validate changes with the relevant FPGA tool flow and hardware target; do not reuse them as ASIC timing constraints. Follow the RTL and hardware-facing validation requirements in AGENTS.md.