Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
20 commits
Select commit Hold shift + click to select a range
c284e90
Add optional HLE boot path and BIOS handoff instrumentation
AloysHF Nov 7, 2026
0931215
Implement native firmware-resident services for the HLE boot path
AloysHF Nov 7, 2026
7494c6d
Add per-title diagnostics and remaining-service documentation
AloysHF Nov 7, 2026
8bba714
Gate native interrupt delivery and fix frame leak
AloysHF Nov 7, 2026
d8106c9
Implement blocking delay service and fix delivery pending handling
AloysHF Nov 7, 2026
19c6c7d
Zero-fill CD reads past the image end and add a minimal SD controller
AloysHF Nov 7, 2026
8592502
Print PPU layer/sprite state in the run summary
AloysHF Nov 7, 2026
6e3444c
Replicate the firmware sprite manager in the VBlank continuation
AloysHF Nov 7, 2026
684f553
Add video-buffer and device-state diff probes
AloysHF Nov 7, 2026
449ece5
Implement the firmware sprite-list transfer in the VBlank continuation
AloysHF Nov 8, 2026
d4b0084
Set 2x streaming speed at HLE boot and shim the tick-read pair
AloysHF Nov 8, 2026
21ce6f8
Add layer-buffer write probe and fix the layer-buffer register print
AloysHF Nov 8, 2026
6dceb0f
Fix ISO9660 truncated directory records, add USB model and services
AloysHF Nov 8, 2026
a6a6934
Document the dual sprite-list architecture in the sprite transfer
AloysHF Nov 8, 2026
ca1ce34
Add playback-tracing probes for the game's codec investigation
AloysHF Nov 8, 2026
86bf832
Add software-timer read probe; settle the sprite-list writer map
AloysHF Nov 8, 2026
e18b73f
Trace the game codec's .mov consumption pacing
AloysHF Nov 8, 2026
b99ee2a
Uncap the PPU-window write capture; the game uploads palettes and spr…
AloysHF Nov 8, 2026
a46ea38
Add sprite-pattern buffer write probe
AloysHF Nov 8, 2026
893b7a5
Serve the full firmware trampoline surface generically
AloysHF Nov 8, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 13 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,6 +59,12 @@ system/hyperscanemu/spg290.bin 32768 bytes
system/hyperscanemu/hyperscan.bin 1048576 bytes
```

Firmware is optional: when the files are missing, or `--hle-boot` is passed,
the emulator boots the game directly through the HLE boot path (see
[Architecture](docs/Architecture.md)). Retail games additionally call
firmware-resident services in DRAM, so the dumped firmware remains the
recommended way to play.

See the [Standalone Emulator](docs/Standalone-Emulator.md) guide for options,
keyboard controls, headless capture, and diagnostic CLI workflows.

Expand All @@ -73,7 +79,8 @@ legally dumped firmware in the frontend system directory:
```

The folder and file names are case-sensitive and the loader never searches
other locations.
other locations. The firmware is optional: without it the core boots through
the HLE path, though retail games may still need firmware-resident services.

See the [RetroArch Core](docs/RetroArch-Core.md) guide for installation,
loading content, and current limitations. Mobile and TV targets:
Expand All @@ -97,8 +104,13 @@ cargo run -p hyperscanemu -- <media> --system-dir system \
--headless --frames <N> --output frame.ppm
cargo run -p hyperscanemu -- <media> --system-dir system \
-S startup.png --screenshot-frames 300
cargo run -p hyperscanemu -- <media> --hle-boot
```

`HYPERSCANEMU_TRACE_BIOS_FETCH=1` additionally prints a BIOS-to-game handoff
snapshot and a firmware-activity summary (see
[Architecture](docs/Architecture.md)).

## Building

Requires [Rust](https://www.rust-lang.org/tools/install) (stable).
Expand Down
Loading
Loading