RustBoyAdvance-NG
RustBoyAdvance-NG is a comprehensive Nintendo GameBoy Advance™ emulator and debugger developed in Rust. This emulator aims to faithfully recreate the experience of using the original GameBoy Advance hardware, while also providing advanced debugging capabilities for developers and enthusiasts.
RustBoyAdvance-NG Logo
Project Structure
RustBoyAdvance-NG is organized into several main components:
- core/: The primary emulator crate that integrates all components.
- arm7tdmi/: Emulates the Arm7tdmi processor.
- platform/: Contains various executables and applications built with rustboyadvance-core.
- rustbodyadvance-wasm: A web emulator powered by WebAssembly.
- rustbodyadvance-sdl2: A desktop application built with SDL2.
- rustbodyadvance-minifb: A desktop application built with minifb (not maintained).
- rustbodyadvance-jni: Java JNI bindings for the emulator.
- android/: A proof of concept Android application.
Key Features
RustBoyAdvance-NG is packed with features that ensure an authentic emulation experience:
- Accurate Emulation: Emulates the ARM7TDMI processor, including support for various GameBoy Advance peripherals.
- Debugger Support: Includes a custom debugger and experimental GDB server support.
- WebAssembly Demo: A functional demo is available online at RustBoyAdvance-NG Web Demo.
- Multi-platform Support: Runs on desktop platforms via SDL2 and WebAssembly for browser-based emulation.
- Java and Android Integration: Provides JNI bindings and an Android application proof of concept.
Progress
The emulator is continuously being developed with significant progress in emulating popular GameBoy Advance titles. Features under development include complete CGB audio support, which will add all four wave generator channels.
Pokemon Emerald Screenshot
Key Bindings
GBA Key Bindings
| Keyboard | GBA |
|---|---|
| Up | Up |
| Down | Down |
| Left | Left |
| Right | Right |
| Z | B Button |
| X | A Button |
| Return | Start |
| Backspace | Select |
| A | L |
| S | R |
Special Key Bindings
| Key | Function |
|---|---|
| Space (hold) | Disable 60fps cap |
| F1 | Custom debugger (requires --features debugger) |
| F2 | Spawn gdbserver (experimental, requires --features gdb) |
| F5 | Save snapshot file |
| F9 | Load snapshot file |
Screenshots
Kirby - Nightmare in Dreamland
Dragon Ball - Legacy of Goku 2
Links and Attribution
- ARM7TDMI Technical Reference Manual: Technical reference for the ARM7TDMI processor.
- GBATEK: Comprehensive resource by Martin Korth, the developer of no$gba.
- TONC: A thorough GBA development guide with useful demo ROMs.
- NanoboyAdvance: A C++17 GBA emulator used for debugging.
- Eggvance gba-suite: An excellent test suite for the arm7tdmi interpreter by Julian Smolka.