RGE - Rui's Gameboy Emulator

A Gameboy Color emulator, under development. Includes a full TUI debugger.

Graphics are not yet implemented but I will be using SDL2 for game graphics and sound.

Check the progress on tests.

Table of contents

1. Using
2. Key controls
3. Documentation
4. Screenshots
5. References

Using

Only tested in a Linux system with the terminal emulator Konsole. To test, clone the repository and run

make

Find a ROM and run it with

./gameboy PATH_TO_ROM

Key controls

Keys	Behaviour
CTRL+X	Close the program
SPACEBAR	Perform one step on the CPU
N	Perform one step on the CPU and jump over CALL
CTRL+R	Refresh the code representation from memory
:	Enter command entering mode / ESC to exit
ARROW_UP	Go back one memory page on the display
ARROW_DOWN	Go to the next memory page on the display

Documentation

To build the documentation

make doc

Then, open doc/html/index.html with your prefered internet browser.

Open with the Firefox Browser

./docs.sh

Screenshots

References

F14_GameboyColor.pdf

Game Boy Programming Manual.pdf

gbctr.pdf

https://github.com/rockytriton/LLD_gbemu

https://www.pastraiser.com/cpu/gameboy/gameboy_opcodes.html

https://gbdev.io/pandocs/