2123e646c8f89d439bee725ef355d98c897f6f1f
Preserve the Ch441 timing/renderer board-validation evidence and the Codex-directed follow-up: - FB reconciliation: the Ch437 A/B dump's 8-word first-beat delta was a non-reproducible one-time transient; 3x render+dump and 8x pure-probe re-reads all return golden d0047677 (words 0-7 correct). Memory integrity confirmed deterministic. (fb_reconciliation.md) - Structural audit + A-D diagnostic proposal for LPDDR_STATUS[5]: bit5 ORs sticky CDC-synced underflow with AXI read-errors; dump path (arid=1) is separate from scanout/HDMI (arid=3). Instrumentation proposal only, not implemented. (scanout_status_bit5_proposal.md) - Raw board logs, status samples, RBF hashes, A/B FB dump, board PNG. No RTL edits, no compile, no builds. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
retroDE_ps2 Planning Docs
This directory is the working design scaffold for the PS2 core.
Purpose:
- define the intended repository shape before RTL lands,
- define subsystem boundaries before implementation choices harden,
- document what each block owns, what crosses the boundary, and how we will validate it.
Recommended reading order:
- repo_layout.md
- phase0_checklist.md
- contracts/README.md
- stub_module_plan.md
- wave2_dma_gif_plan.md
- wave25_memory_backed_dma_plan.md
- wave26_multi_beat_dma_plan.md
Relationship to references/:
references/is the research library.docs/is the project-definition layer.
Rule of thumb:
- If a file explains PS2 hardware as it exists, it belongs under
references/. - If a file explains how
retroDE_ps2intends to model, partition, or validate that hardware, it belongs underdocs/.
Description
Languages
SystemVerilog
75.5%
Verilog
15.4%
Tcl
4.7%
HTML
1.1%
Python
1%
Other
2.3%