DMG emulator

Personal attempt at creating a simple DMG GameBoy emulator from scratch.

Features

• Support MBC1 or no MBC games
• Use A/Z for A/B, arrows keys to move, space for start and return for select
• Sound
• Display
• Rich debugging features
• Save states: F3 to save, F5 to load, F4 to change slots (5 slots available)
• F1 to show debugger
• F2 to activate breakpoints
• F9 to toggle execution/suspended mode
• F10 to load another game

Documentation

• The Ultimate Game Boy talk at 33c3
• Why did I spend 1.5 months creating a Gameboy emulator?
• Z80 Family CPU User Manual
• Dooskington wiki about emulators
• Pan Docs
• Game Boy DMG original Boot ROM
• Game Boy Opcodes
• Game Boy Opcodes (other version)

Compilation

Tested on Linux. Does not seem to compile as it is for Windows. Not tested at all for other OS. Should only require SDL2.

Contains submodules so clone with something like --recurse-submodules

make clean; make

Test with ./test

Tests

Blarggs

#	name	state
04	halt_bug	❌
05	instr_timing	✔️
07	mem_timing-2	❔
08	mem_timing	❌
09	oam_bug	❔

Blarggs Cpu Instruction

#	name	state
01	special	✔️
02	interrupts	✔️
03	op sp,hl	✔️
04	op r,imm	✔️
05	op rp	✔️
06	ld r,r	✔️
07	jr,jp,call,ret,rst	✔️
08	misc instrs	✔️
09	op r,r	✔️
10	bit ops	✔️
11	op a,(hl)	✔️

Blarggs Sound Instruction

#	name	state
01	registers	✔️
02	len ctr	✔️
03	trigger	✔️
04	sweep	✔️
05	sweep details	✔️
06	overflow on trigger	✔️
07	len sweep period sync	✔️
08	len ctr during power	✔️
09	wave read while on	❌
10	wave trigger while on	❌
11	regs after power	✔️
12	wave write while on	❌

TODO

• Implement Z80 instruction set
• [-] Implement interupts
  • V-Blank
  • LCD Stat
  • Timer
  • Serial
  • Joypad
• Implement MMU
• Implement PPU
• Implement inputs
• Sound!
• Support all MBC
  • MBC1
  • Others

Screenshots