gameboy-rust/docs/hardware
0xrsydn 652ea397f2 feat(cartridge): add 512-byte and 8 KiB serial EEPROM saves
Select them with --save-type eeprom512 or eeprom8k. The part follows GBATEK's
protocol on Game Pak data bit 0: DMA3 sends one bit per halfword, '11' +
address + '0' requests a 64-bit block that reads back after four dummy bits,
and '10' + address + data + '0' writes one. A write reports busy for a nominal
108,368 cycles before the block is stored. 8 KiB parts decode the low 10
address bits. ROMs above 16 MiB map EEPROM only at 0x0dffff00..0x0dffffff.

Bits shift out only inside machine steps, so failed steps roll back. CPU
stores, byte/word accesses, CPU reads during a read-out, and malformed or
overlapping requests are diagnostics. Blocks are stored first-bit-as-MSB,
matching common .sav layouts, and work with save files and save states.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HhfHfHEuzv2AUTd6erW1gU
2026-10-14 14:28:41 +07:00
..
audio.md feat(desktop): add muted accelerated ROM playback 2026-10-07 08:52:40 +07:00
bios.md fix(bios): return cleanly for empty LZ77 streams 2026-10-07 09:06:00 +07:00
cartridge-gpio.md fix(memory): ignore CPU and DMA writes to the Game Pak ROM windows 2026-10-14 14:28:41 +07:00
cartridge.md feat(cartridge): add 512-byte and 8 KiB serial EEPROM saves 2026-10-14 14:28:41 +07:00
cpu.md fix(cpu): accept ARM multiplies whose destination equals Rm 2026-10-14 14:28:41 +07:00
display-timing.md feat(desktop): run ROM files in a window with keypad input 2026-10-05 19:22:13 +07:00
dma.md feat(cartridge): add 512-byte and 8 KiB serial EEPROM saves 2026-10-14 14:28:41 +07:00
save-states.md feat(core): add whole-machine save states with F5/F9 window slots 2026-10-14 14:28:41 +07:00
saves.md feat(cartridge): add 512-byte and 8 KiB serial EEPROM saves 2026-10-14 14:28:41 +07:00
serial.md feat(serial): support disconnected Joybus configuration and local registers 2026-10-07 06:38:04 +07:00
timers-irq.md feat(cartridge): implement RTC calendar transfers and clock updates 2026-10-07 05:59:29 +07:00
video.md fix(video): ignore enable bits for backgrounds a mode lacks 2026-10-14 14:28:41 +07:00