thejayman77
ec82764bef
RTL (GS rasterizer, EE core stub, platform bridge, LPDDR4B path), sim regression (272 TBs), docs, and tooling. Copyrighted PS2 content (BIOS, game code, GS dumps, and all dump-derived textures/traces) is excluded via .gitignore and stays local. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
54 lines
1.2 KiB
Markdown
54 lines
1.2 KiB
Markdown
# Platform Contract
|
|
|
|
Status: `Draft`
|
|
|
|
## Purpose
|
|
|
|
Define the boundary between retroDE platform integration and PS2-specific
|
|
subsystems.
|
|
|
|
## Owns
|
|
|
|
- top-level clock/reset entry,
|
|
- reset sequencing policy,
|
|
- bridge into retroDE HPS/peripheral shell,
|
|
- HDMI/audio adaptation boundary,
|
|
- top-level debug/trace export path,
|
|
- manifest/backend-visible identity plumbing.
|
|
|
|
## Inputs
|
|
|
|
- board clocks and resets,
|
|
- HPS bridge traffic,
|
|
- retroDE platform services,
|
|
- user input events from the shared shell.
|
|
|
|
## Outputs
|
|
|
|
- clean subsystem clocks/resets,
|
|
- adapted video stream,
|
|
- adapted audio stream,
|
|
- debug visibility path,
|
|
- PS2-facing controller/media service inputs.
|
|
|
|
## Key questions
|
|
|
|
- Which subsystem clocks are generated locally?
|
|
- Which debug signals are exported at the top level by default?
|
|
- How much platform assistance is acceptable before the design stops being a
|
|
PS2 core and becomes a hybrid?
|
|
|
|
## Allowed early stubs
|
|
|
|
- fixed clock plan placeholders,
|
|
- static backend identity values,
|
|
- synthetic input injection for tests,
|
|
- simple framebuffer-style output adapter.
|
|
|
|
## Not owned here
|
|
|
|
- EE memory map semantics,
|
|
- GS packet semantics,
|
|
- SIF semantics,
|
|
- PS2-specific peripheral register behavior.
|