devraza/rustboyadvance-ng
Archived
1
Fork 0
Code Issues Pull requests Packages Projects Releases 1 Wiki Activity
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.
306 commits 1 branch 1 tag 4 MiB
Rust 99.8%
Nix 0.2%
Find a file
Michel Heily 32a20d2cbb ptimize: CPU Pipeline optimization part 3 
Move reload_pipeline calls inside instructions.
This commit yeilds yet another 5% performance improvment.

The next step is to move `advance_pc` into the instructions themselves
and save the `match result` per executed instruction


Former-commit-id: 42193ffc48fda9943665e6a74e873186627a0b4a
2020-02-11 02:26:17 +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 Bump gba-suite git submodule 2020-02-07 17:36:32 +02:00
media docs: update README.md 2020-01-12 02:04:44 +02:00
src ptimize: CPU Pipeline optimization part 3 2020-02-11 02:26:17 +02:00
.gitignore Initial commit 2019-06-24 16:36:20 +03:00
.gitmodules Bump gba-suite git submodule 2020-02-07 17:36:32 +02:00
.travis.yml build: Update .travis.yml with apt dependencies 2020-01-17 12:54:30 +02:00
Cargo.lock build(deps): bump ansi_term from 0.11.0 to 0.12.1 2020-02-07 17:10:21 +02:00
Cargo.toml build(deps): bump ansi_term from 0.11.0 to 0.12.1 2020-02-07 17:10:21 +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

README.md

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.