gb-emu

Game Boy emulator written in Rust.

This uses boot rom of https://github.com/LIJI32/SameBoy.

References

• Abstruct
  • https://gbdev.io/pandocs/
  • https://github.com/pokemium/gb-docs-ja (for japanese)
• MBC
  • https://gbdev.io/pandocs/MBCs.html
  • https://github.com/Hacktix/GBEDG/blob/master/mbcs/index.md
• CPU
  • http://marc.rawer.de/Gameboy/Docs/GBCPUman.pdf
  • https://github.com/AntonioND/giibiiadvance/blob/master/docs/TCAGBD.pdf
  • https://gekkio.fi/files/gb-docs/gbctr.pdf
  • https://izik1.github.io/gbops/index.html
• PPU
  • https://gbdev.io/pandocs/Rendering.html
  • https://github.com/Hacktix/GBEDG/blob/master/ppu/index.md
• APU
  • https://gbdev.io/pandocs/Audio.html
  • https://nightshade256.github.io/2021/03/27/gb-sound-emulation.html
• Timer
  • https://github.com/Hacktix/GBEDG/blob/master/timers/index.md
• Joypad
  • https://gbdev.io/pandocs/Joypad_Input.html
• OAM DMA transfer
  • https://gbdev.io/pandocs/OAM_DMA_Transfer.html
  • https://github.com/Hacktix/GBEDG/blob/master/dma/index.md

Test suite

Blargg's tests

Test	gb-emu
cpu instrs	👍
instr timing	👍
mem timing	👍
mem timing 2	👍
halt bug	👍
oam bug	❌
dmg sound	❌
cgb sound	❌

Status

• Catridge
  • Catridge loading
  • MBC1
  • MBC3
  • MBC5
  • Others
• CPU
  • Instructions
  • Interrupt handling
• PPU
  • Background
  • Window
  • Sprite
  • V-blank interrupt
  • LCDC STAT interrupt
  • Sprite and background priority
• APU
  • Channel1
    • Envelope
    • Sweep
  • Channel2
    • Envelope
  • Channel3
  • Channel4
    • Envelope
• Timer
  • Timer registers
  • Timer overflow interrupt
• Joypad
  • Joypad input
  • Joypad interrupt
• OAM DMA transfer
• Saving game data

gb-emu-web

wasm-pack build --target web --out-dir www/wasm