Skip to content

S2: the Clock tree, Memory and Devices views, and the golden test - #11

Merged
teo1747 merged 3 commits into
mainfrom
app/s2-views
Nov 12, 2026
Merged

teo1747 merged 3 commits into
mainfrom
app/s2-views

Conversation

@teo1747

@teo1747 teo1747 commented Nov 12, 2026

Copy link
Copy Markdown
Member

The first drawn views of S2, and S2's golden test.

The views (tabs beside Board; every value is the generator's)

  • Clock tree: the path from the oscillator to the buses. NUCLEO-F446RE: 8 MHz (hse, bypass) ÷ 8 → 1 MHz PLL input × 360 → 360 MHz VCO ÷ 2 → 180 MHz system clock, plus the Q output (÷ 7 = 51.4286 MHz), then AHB1 180 MHz, APB1 ÷ 4 = 45 MHz and APB2 ÷ 2 = 90 MHz, each with its limit and a bar showing how close it runs. The Pico 2 W shows its two post-dividers (÷ 5 ÷ 2). Boards without a PLL go straight from the source to the system clock. The flash wait states, the regulator and the tick timer are listed below.
  • Memory: the chip's regions (base, size, attributes), the flash partitions as a strip in proportion with their sectors or pages, and the linker's image layout.
  • Devices: the devices in initialization order (class, compatible, level, dependencies), and the chosen device's binding fields, with addresses in hex and frequencies in Hz units.

The golden test (tst_golden, spec §8 S2): for nucleo_f446re and pico2_w, it opens the board through the real core and renders the Board, Clock tree, Memory and Devices views. Every value shown must equal the board's hw.json and the tables and lines of its board.md and build_report.md. CI checks the RTOS out at the pinned commit for it. On its first run it caught a real difference: the Board view showed a chip-select pin by its signal name where the generator says output. The view now writes pin modes exactly as the generator does.

Also

  • Frequencies and sizes drop the group separator (1500 MHz, 4032 KB), as datasheets do.
  • --view <id> brings a view to the front.
  • All 34 new texts are in French and Simplified Chinese.

Still to come in S2: the Pin map (it needs each pin's position on its package, which hw.json doesn't hold yet) and the RTOS view (it needs system.yaml, the RTOS's phase E3).

8 of 8 suites pass locally with the RTOS, and clang-format 18 is clean.

The first drawn views of stage S2, each the generator's model, written as the
generator's own reports write it.

- Clock tree draws the path from the oscillator to the buses: the PLL's input
  after M, the VCO after N, its Q output, the system clock after P (or the
  RP2350's two post-dividers), and each bus with its divider and its limit,
  with a bar for how close it runs. Boards without a PLL go straight from the
  source. The flash wait states, the regulator and the tick timer below.
- Memory lists the chip's regions, the flash partitions as a strip in
  proportion, with their sectors or pages, and the linker's image layout.
- Devices lists the devices in initialization order, with their class,
  compatible, level and dependencies, and the chosen device's binding fields.
- The Board view writes each pin's mode as board.md does (af7 (usart2_tx),
  output); the golden test found a chip select shown by its signal.
- Frequencies and sizes drop the group separator: 1500 MHz, 4032 KB.
- --view <id> brings a view to the front, for progress pictures.
- Every new text is in French and Simplified Chinese.

tst_golden opens the RTOS's nucleo_f446re and pico2_w through the real core and
finds every value of the four views equal to hw.json, board.md and
build_report.md; CI checks the RTOS out at the pinned commit for it.

Signed-off-by: teo1747 <148846371+teo1747@users.noreply.github.com>
Signed-off-by: teo1747 <148846371+teo1747@users.noreply.github.com>
…its is a dash

At the pinned RTOS revision the Pico 2 W's partitions give no erase units, and
board.md writes '-'; the Memory view now writes a dash too. A Windows checkout
has CRLF line ends, so the test reads the reports with them normalized. The
verbose rerun of failed tests now has the RTOS too, so it reruns, not skips.

Signed-off-by: teo1747 <148846371+teo1747@users.noreply.github.com>
@teo1747
teo1747 merged commit 8e6a9e8 into main Nov 12, 2026
11 checks passed
@teo1747
teo1747 deleted the app/s2-views branch November 12, 2026 23:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant