Files
retroSoC/rtl/tiny/README.md
T
maksyuki 2805ea9183 docs: add Tiny Gen1 support and related publications
- Introduced new Tiny Gen1 datasheet with waveform rendering capabilities.
- Implemented example functions for various peripherals including archinfo, clint, dma, gpio, i2c, pwm, rtc, sram, sysctrl, timer, uart, wdg, and xpi.
- Enhanced register reference parsing to accommodate Tiny-specific memory maps.
- Created a dedicated Tiny reference module to isolate Tiny publications from Mini inputs.
- Developed comprehensive tests to validate Tiny publication configurations, register inventories, and evidence claims.
- Updated RTL documentation to reflect the separation of Tiny and Mini product lines.
2026-09-25 18:09:49 +08:00

1.8 KiB

Tiny MCU Integration

Tiny is the independent single-Hazard3 wired MCU product. Its frozen contract is Tiny MCU. Use make CONFIG=configs/ci/ihp130-tiny.mk setup followed by make CONFIG=configs/ci/ihp130-tiny.mk firmware sim.

top owns product integration, address_map, pin_map and integration own canonical address, pad, IRQ and clock/reset inputs, filelist selects sources, dv owns product verification, and mk owns product configuration. Reusable RTL lives in rtl/ip; Common and Hazard3 remain locked managed inputs. No Tiny source list includes RIB/RIBP or Mini product RTL. Build rules invoke shared helpers in scripts/rtl directly; generated files belong only under the selected build variant.

The initial IHP130 profile has 128 KiB SRAM, 24 MHz AXI32/APB4, four DMA channels, and RV32IMC without atomics. Wireless, external RAM, HP cores and accelerators are outside this release. Run both Icarus and Verilator, the Tiny directed tests, and the IHP130 regression before claiming qualification. Synthesis and STA use the Tiny top and clock inventory, not Mini constraints.

make CONFIG=configs/ci/ihp130-tiny.mk regress-pr runs only Tiny's IHP130 matrix. The regression runner also accepts --soc TINY; leaving it unset retains the combined Mini/Tiny IHP130 matrix. netsim-boot uses the compact assembly SRAM/pad test, while netsim uses the full SDK acceptance image. See the verification record for qualification boundaries and the observed reset-distribution timing deficit.

The Tiny Gen1 datasheet provides the source-bound product/register/software reference. Its publication build is separate from RTL acceptance and does not promote historical test or timing records into new qualification results.