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 99cf07c391 chore: Replace trace exception with trace!
Former-commit-id: 0b6f2126a6861b8f31f5231b5e0cfda3df30d5d5
2020-02-01 12:21:42 +02:00
.vscode chore: Update launch.json 2020-02-01 11:28:56 +02:00
assets Update new icon 2020-01-13 00:45:58 +02:00
external tests: Add test for the bug fixed in cca16c52fd838b34c759913a41ff28c4e04735d0 [formerly 453e7c03ab48f1bcf72cd9d4b1aae012eb08c697] 2020-01-19 00:45:46 +02:00
media docs: update README.md 2020-01-12 02:04:44 +02:00
src chore: Replace trace exception with trace! 2020-02-01 12:21:42 +02:00
.gitignore Initial commit 2019-06-24 16:36:20 +03:00
.gitmodules tests: Add test for the bug fixed in cca16c52fd838b34c759913a41ff28c4e04735d0 [formerly 453e7c03ab48f1bcf72cd9d4b1aae012eb08c697] 2020-01-19 00:45:46 +02:00
.travis.yml build: Update .travis.yml with apt dependencies 2020-01-17 12:54:30 +02:00
Cargo.lock chore: Update Cargo.lock 2020-01-17 16:11:43 +02:00
Cargo.toml feat(logger): Add a logger to the project 2020-01-31 16:15:29 +02:00
LICENSE Create LICENSE 2019-06-24 16:36:20 +03:00
README.md feat(flash): Implement Flash save type 2020-01-26 02:18:27 +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.