Iron Boy

A GameBoy/GameBoy Color emulator, written in Rust.

Features

• MBC1, MBC2, MBC3 (with RTC), MBC5 (no rumble)
• Sound
• DMG Support
• CGB Support
• Desktop Support

Getting Started

Make sure you have the latest version of Rust installed

Mac OS with homebrew

brew install sdl2

Ubuntu

sudo apt update && sudo apt install -y libsdl2

Running

cargo run <rom file path>

• You can also build a release and run the executable as well

Keymappings

Joypad	Keyboard
A	X
B	Z
Start	Space
Select	Enter
Up	Up Arrow
Down	Down Arrow
Left	Left Arrow
Right	Right Arrow

Tests

• Blargg's tests

  • cpu_instrs
  • instr_timing
  • interrupt_time
  • mem_timing
  • mem_timing-2
  • oam_bug
  • halt_bug
  • cgb_sound
  • dmg_sound

• Single Step Tests

• DMG Acid test

• CGB Acid test

Acknowledgements and Sources

• Pan Docs
• Game Boy Opcodes
• gbz80(7) — CPU opcode reference
• Ultimate Game Boy Talk
• A journey into GameBoy emulation
• GBEDG
• GhostSonic Reddit Post on Sound
• Game Boy Sound Emulation

Awesome Emulators

These are some awesome emulators by some really smart people that helped me get to this point.

• LLG_gbemu
• gb-rs
• rboy
• gaemboi