1
1
Fork
You've already forked gb_emulator
0
A Gameboy Emulator written in Rust
  • Rust 100%
2026年01月15日 12:57:01 +01:00
.github/workflows Add GitHub Actions workflow for repo synchronization 2026年01月15日 12:55:27 +01:00
assets/buttons Add button images 2024年05月19日 18:20:04 +02:00
bin Support Bootrom 2024年05月19日 14:04:08 +02:00
diagrams Create initial instructions layout 2024年05月05日 14:48:23 +02:00
src MBC1: Fix incorrect bank swapping (Oops) 2025年02月17日 11:51:48 +01:00
test_data Add joypad test 2024年06月13日 17:29:49 +02:00
test_files Remove Obsolete Test file 2024年05月19日 18:19:44 +02:00
.gitignore Fix timer 2024年06月14日 13:22:20 +02:00
Cargo.lock Improve MBC detection output 2024年08月05日 14:24:07 +02:00
Cargo.toml Improve MBC detection output 2024年08月05日 14:24:07 +02:00
LICENSE License under EUPL 2024年08月05日 14:05:42 +02:00
README.md Remove Dead URL 2026年01月15日 12:57:01 +01:00

Gameboy Rust SoSE 24 Project

Demo Screenshot

This is a Gameboy emulator written in Rust for the Rust WP SoSE 24 project at the HAW Hamburg. The original project can be found here.

Running

cargo run

Using Gameboy Doctor

Gameboy Doctor is a tool that can be used to debug the emulator. It can be found here, it's extremely useful.

How to install

  1. git clone the repository (Preferably not in the same directory as the emulator) 2. For example projects/gameboy-doctor and projects/gb_emulator
  2. Make sure you have python installed

How to use

  1. Pick a test suite from test_data/individual
  2. Put it at ./game.gb
  3. Run the emulator cargo run
    1. Make sure that DUMP_GAMEBOY_DOCTOR_LOG is set to true in main.rs
  4. Run the gameboy doctor (from the gameboy-doctor directory)
    1. python gameboy-doctor ../gb_emulator/gameboy_doctor_log.txt cpu_instrs NUMBER_OF_ROM
      1. The number of the rom is the number in front of the rom, e.g. 9 for 09-op r,r.gb
      2. This expects you to have a similar directory structure as mentioned above, otherwise you need to adjust the path
  5. The gameboy doctor will output a log file with the results, e.g.:
Mismatch in CPU state at line 16520:
MINE: A:00 F:-H-Z B:01 C:00 D:D0 E:00 H:CE L:46 SP:DFFB PC:CA0E PCMEM:3E,20,CD,37
YOURS: A:00 F:-H-Z B:01 C:00 D:D0 E:00 H:CE L:46 SP:DFFB PC:CA0B PCMEM:C4,45,CA,3E
The CPU state before this (at line 16519) was:
 A:00 F:A0 B:01 C:00 D:D0 E:00 H:CE L:46 SP:DFFB PC:CA0B PCMEM:C4,45,CA,3E
The last operation executed (in between lines 16519 and 16520) was:
 0xC4 CALL NZ a16

Credits and Resoures Used

Authors

  • Vincent Adamczyk
  • Laurin Zacharias
  • Michael Vogt
  • Tom Hert