Nintendo™ Game Boy Advance emulator and debugger.
This repository has been archived on 2024-06-01. You can view files and clone it, but cannot push or open issues or pull requests.
Find a file
Michel Heily 4cb7abee52 cartridge: Refactor to deal with out of bounds read
Former-commit-id: ab0a4368f7e5120cf7059fb34687a5a9c1ea21cd
2020-01-17 01:39:25 +02:00
.vscode Add tasks.json 2019-11-12 18:22:00 +02:00
assets Update new icon 2020-01-13 00:45:58 +02:00
external tests: Wrap gba-suite by jsmolka 2020-01-17 01:33:21 +02:00
media docs: update README.md 2020-01-12 02:04:44 +02:00
src cartridge: Refactor to deal with out of bounds read 2020-01-17 01:39:25 +02:00
.gitignore Initial commit 2019-06-24 16:36:20 +03:00
.gitmodules tests: Wrap gba-suite by jsmolka 2020-01-17 01:33:21 +02:00
.travis.yml Fix typo in .travis.yml 2019-06-27 13:16:00 +03:00
Cargo.lock refactor: Make debugger into a cargo feature 2020-01-13 01:11:58 +02:00
Cargo.toml feat/savestates: Implement savestates for plat/sdl2 2020-01-16 20:18:32 +02:00
LICENSE Create LICENSE 2019-06-24 16:36:20 +03:00
README.md tests: Wrap gba-suite by jsmolka 2020-01-17 01:33:21 +02:00

RustBoyAdvance-NG

license Build Status

icon

Nintendo GameBoy Advance ™ emulator and debugger, written in rust.

Build and usage

  1. set-up rust nightly

  2. Obtain a gba bios binary. you can get an open source GBA bios

  3. Place the bios file in the repository root and name it gba_bios.bin

  4. Build and run in release mode (performance is terrible in the dev profile)

    $ cargo run --release -- path/to/rom
    

Why is this project needed ?

It's actually not. There are quite a lot of GBA emulators, and even some written in rust. Actually, I couldn't find any game capable emulators written in rust.

I'm only doing this as a side project intended for learning rust.

This is my third take on this project. My first go at this was about 3 years ago, but I didn't like rust much at the time so it got abandoned. I tried to resurrect it a year ago but didn't have the time to get invested in a side-project, let alone learning rust.

I've grown to like rust a lot since then, so here we go again. You know what they say, third time's a charm.

Progress

Supported features:

  • Display modes 0,4,5
  • PCM Audio channels

Todo:

  • Display modes 2,3 (affine backgrounds)
  • Flash(backup) support
  • CGB audio (4 wave generator channels)
  • web.asm frontend
  • color correction

Tested games status

Kirby - Nightmare in Dreamland*

No issues so far

Pokemon - Emerald

Won't boot unless binary patched to remove a loop querying the flash chip

Dragon Ball - Legacy of Goku 2

crashes when entering in-game menu, other than that works fine.

Screenshots

Pokemon Emerald Kirby - Nightmare in Dreamland Dragon Ball - Legacy of Goku 2

Links and attribution

  • ARM7TDMI Technical Reference Manual Technical Reference Manuals are fun.
  • GBATEK A single webpage written by no$gba developer Martin Korth. This page has pretty much everything. Seriously, it's the best.
  • TONC A comprehensive GBA dev guide that I used a-lot in order to understand the GBA system. Comes with neat demo roms that really helped me during development and debugging.
  • NanoboyAdvance A GameBoy Advance emulator written in C++17 by a nice person called fleroviux. I've used this for debugging.
  • Eggvance gba-suite Incredible test suite for the arm7tdmi interpreter that I'm using, written by Julian Smolka.