0xrsydn/gameboy-rust
1
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

test(timing): compare prefetch cancellation with published observations

Browse source
This commit is contained in:
0xrsydn 2026-10-06 21:04:47 +07:00
commit 8930ea93b4
14 changed files with 487 additions and 8 deletions
Download patch file Download diff file Expand all files Collapse all files

12
docs/demos.md
View file

@ -3,6 +3,18 @@
Every demo runs original test content through the `gameboy-rust` desktop executable. None of them load games.
Keyboard mapping to GBA buttons lives in `crates/desktop/src/desktop.rs`.
## Diagnose prefetch cancellation timing
```sh
direnv exec . cargo run --locked -p gba-demos --example prefetch_cancellation > /tmp/prefetch-cancellation.csv
```
This headless original ARM probe compares published read-cancellation observations with two separate emulator measurements.
Instruction-boundary totals match, but actual timer samples currently fail. The example therefore exits with status 1.
Do not treat the matching totals as a hardware-timing pass.
See [the protocol, source hashes, and timer sampling gap](research/prefetch-cancellation.md).
The probe needs no downloaded ROM, assets, window, or external assembler.
## Open the affine raster demo
From a logged-in macOS desktop session: