NoobBoy - GameBoy Emulator

NoobBoy is a simple gameboy emulator that I'm writing to learn more about the world of emulation. This emulator has nothing special and has no extra features compared to other DMG emulators.

Usage

To build the project, cmake, SDL2 and SDL2 ttf are required. The SDL2 cmake files are already included, as in some systems cmake can't find the packages. The emulator was tested on Linux and MacOS.

Building

$ cmake .
$ make

Running

usage: ./NoobBoy --rom <rom_file> [--bootrom <bootrom_file>] [--load-save <save_file>] [--debug] [--sound]

arguments:
  --rom                     Standard GameBoy rom
  --bootrom                 Official DMG bootrom
  --debug                   Enable the debugger
  --load-save               Save file to load
  --sound                   Enable experimental sound

Input

Gameplay

Debug

Action	Key
UP	`↑`
DOWN	`↓`
LEFT	`←`
RIGHT	`→`
B	`x`
A	`z`
START	`Space`
SELECT	`Enter`

Action	Key
Save game	`s`
Toggle color palette	`c`
Pause/Resume	`p`
CPU step	`n`
Toggle sound	`m`
Exit	`Escape`

Features

Sound (WIP)
Correct instructions and PPU timings
Correct scanline timing
Sprites with correct row limitations
Correct sprite, window and background pixel priority
VRAM rendering with X/Y scroll overlay
Memory Bank Controller (MBC)
Debug mode
Save states (dump of external RAM banks)

Currently, the main missing feature is sound, which I refuse to touch. Additionally, the halt bug is missing because of the incorrect interrupt timings.