Skip to content
RaviTrivPublic

About

DMG-01 GameBoy Emulator

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

261 Commits

Folders and files

Repository files navigation

GameBoy

DMG-01 Game Boy Emulator

Tetris

Zelda Link's Awakening

Pokemon Red

Building and Running

Requirements

Build

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j

Run

./build/gameboy <rom_path> [--loadSave] [--fastForward] [--trace]
Argument Required Description
<rom_path> Yes Path to the Game Boy ROM file
--loadSave No Resume from the save state for this ROM
--fastForward No Start with fast forward enabled
--trace No Log a CPU instruction trace

Controls

Keyboard Key GameBoy Button Function
Z B B button
X A A button
Enter/Return Start Start button
Tab Select Select button
↑ (Up) D-pad Up Move up
↓ (Down) D-pad Down Move down
← (Left) D-pad Left Move left
→ (Right) D-pad Right Move right
S N/A Save state
F N/A Toggle fast forward

Testing

Tested against various DMG rom test suites

Suite Tests Passing
GBMicrotest 480 480
Mooneye Test Suite 95 95
Mooneye (Wilbert Pol) 94 94
Blargg 42 42
Mealybug Tearoom 24 24
AGE 14 14
Scribbltests 5 5
MBC3 Tester and rtc3test 4 4
TurtleTests 2 2
Save state round trips 2 2
dmg-acid2 1 1
Strikethrough 1 1
little-things-gb 1 1

Running the tests

cmake -S . -B build-test -DBUILD_APP=OFF -DBUILD_TESTS=ON -DCMAKE_BUILD_TYPE=Release
cmake --build build-test -j
ctest --test-dir build-test -j8
ctest --test-dir build-test -L '^mooneye$'      # test suite
ctest --test-dir build-test -L ppu              # component
ctest --test-dir build-test -R mooneye.timer    # by test name

About

DMG-01 GameBoy Emulator

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages