Awesome
<div align="center"> <h1><img src="./browser/assets/images/feather.svg" height="20" /> FeatherGB</h1> Just another GameBoy emulator written in Rust 🦀 <p align="center"> <img alt="GameBoy" src="./browser/assets/images/screen-gb.png" /> </p> <p align="center"> <img alt="Debugger" src="./browser/assets/images/screen-debugger.png" /> </p> </div>Info
This is my first project in Rust, so many patterns might not be ideal. I also wanted to try WebAssembly a little bit.
Status
The emulator is somehow accurate - the CPU is cycle-accurate and the emulator passes many tests, although the PPU's accuracy needs to be improved a lot. For more info see tests results below.
Test results
The emulator is tested against popular test suites such as blargg's test, mooneye test suite etc.
These test suites are linked as git submodules (see .gitmodules file for details).
Generated test report is here
Modes
The emulator can be run in 2 modes - the normal mode (shows just GameBoy's display) and the debugger mode (using egui). Both are available for the desktop and the browser.
Desktop
- Standard - rendered by SDL2 (should be cross platform, but I've tested only MacOS)
- Debugger - rendered by egui (using glium as backend)
Browser
Based on React & TypeScript in general
- Standard - WebAssembly with some stylesheets
- Debugger - WebAssembly with egui (using webgl as backend)
TODOs
No specific priority here
- standard (play) mode
- support for custom controls + gamepad
- APU
- audio + video synchronization
- channel 4 implementation
- FIFO & Fetcher for sprites
- save & load
- make PPU more accurate
- pass all wilbertpol's tests
- pass some mealybug-tearoom-tests
- memory bus conflicts
- GameBoy Color support
- implement HDMA & GDMA
Project structure
/gb- GB emulator core (Rust)/debugger- debugger core with egui (Rust)/desktop- desktop version of debugger using glium (Rust)/debugger-web- browser version of debugger using wasm (Rust)/browser- frontend SPA/integration-tests- ROM tests
Development requirements
- wasm-pack -
cargo install wasm-pack
Resources
Links
- General GB documentation https://gbdev.io/pandocs/
- PPU details https://hacktixme.ga/GBEDG/
- opcode table https://izik1.github.io/gbops/
- Memory banks https://github.com/Gekkio/gb-ctr
- PPU interrupts timing https://github.com/AntonioND/giibiiadvance/blob/master/docs/TCAGBD.pdf
- Audio + video sync tips https://near.sh/articles/audio/dynamic-rate-control
- Audio basics https://nightshade256.github.io/2021/03/27/gb-sound-emulation.html
- Audio overview https://gbdev.gg8.se/wiki/articles/Gameboy_sound_hardware
- PPU fetcher timing http://blog.kevtris.org/blogfiles/Nitty%20Gritty%20Gameboy%20VRAM%20Timing.txt
Test Roms
- The famous Mooneye test suite https://github.com/Gekkio/mooneye-test-suite
- Wilbertpol's tests https://github.com/Amjad50/mooneye-gb
- Mealybug Tearoom Tests (aka PPU torture tests) https://github.com/mattcurrie/mealybug-tearoom-tests
- DMG ACID2 test https://github.com/mattcurrie/dmg-acid2
- various tests from Optix https://github.com/Hacktix/scribbltests
- various window tests from Expo https://github.com/Powerlated/TurtleTests/
Note
All external tests require rgbds@0.4.2 to be installed. The only exception is age-test-roms which requires rgbds0.5.1. The versions can be switched using https://github.com/gbdev/rgbenv
Fonts
- Nintendo - Pretendo - https://fontmeme.com/fonts/pretendo-font/
- GameBoy - Gill Sans - https://www.myfonts.com/fonts/mti/gill-sans/
- DMG Buttons - NES Controller - https://www.deviantart.com/mrshrike/art/NES-Console-Controller-Font-141383845