Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/michelhe/rustboyadvance-ng

RustBoyAdvance-NG is a Nintendo™ Game Boy Advance emulator and debugger, written in the rust programming language.
https://github.com/michelhe/rustboyadvance-ng

arm7-tdmi emulator-programming gameboy-advance-emulator rust

Last synced: 24 days ago
JSON representation

RustBoyAdvance-NG is a Nintendo™ Game Boy Advance emulator and debugger, written in the rust programming language.

Host: GitHub
URL: https://github.com/michelhe/rustboyadvance-ng
Owner: michelhe
License: mit
Created: 2019-06-21T10:05:18.000Z (almost 5 years ago)
Default Branch: master
Last Pushed: 2024-02-11T14:22:17.000Z (3 months ago)
Last Synced: 2024-04-25T05:26:52.297Z (28 days ago)
Topics: arm7-tdmi, emulator-programming, gameboy-advance-emulator, rust
Language: Rust
Homepage:
Size: 15.7 MB
Stars: 576
Watchers: 10
Forks: 24
Open Issues: 16
Metadata Files:
- Readme: README.md
- License: LICENSE

Lists

awesome-rust - michelhe/rustboyadvance-ng - RustboyAdvance-ng is a Gameboy Advance emulator with desktop, android and [WebAssembly](https://michelhe.github.io/rustboyadvance-ng/) support. [![build badge](https://github.com/michelhe/rustboyadvance-ng/workflows/Deploy/badge.svg?branch=master)](https://github.com/michelhe/rustboyadvance-ng/actions?query=workflow%3ADeploy) (Applications / Emulators)
awesome-rust - michelhe/rustboyadvance-ng - RustboyAdvance-ng is a Gameboy Advance emulator with desktop, android and [WebAssembly](https://michelhe.github.io/rustboyadvance-ng/) support. [![build badge](https://github.com/michelhe/rustboyadvance-ng/workflows/Deploy/badge.svg?branch=master)](https://github.com/michelhe/rustboyadvance-ng/actions?query=workflow%3ADeploy) (Applications / Emulators)
awesome-rust-cn - michelhe/rustboyadvance-ng - RustboyAdvance-ng是一个Gameboy (应用程序 Applications / 模拟器 Emulators)
awesome-rust - michelhe/rustboyadvance-ng - RustboyAdvance-ng is a Gameboy Advance emulator with desktop, android and [WebAssembly](https://michelhe.github.io/rustboyadvance-ng/) support. [![build badge](https://github.com/michelhe/rustboyadvance-ng/workflows/Deploy/badge.svg?branch=master)](https://github.com/michelhe/rustboyadvance-ng/actions?query=workflow%3ADeploy) (Applications / Emulators)

README

        # RustBoyAdvance-NG

![license](https://img.shields.io/github/license/michelhe/rustboyadvance-ng) ![Build](https://github.com/michelhe/rustboyadvance-ng/workflows/Build/badge.svg?branch=master) 

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







WebAssembly Demo: https://michelhe.github.io/rustboyadvance-ng/ ![Deploy](https://github.com/michelhe/rustboyadvance-ng/workflows/Deploy/badge.svg?branch=master)

# Project Structure

* `core/` - Main emulator crate that ties everything together 

* `arm7tdmi/` - Emulation of the Arm7tdmi processor.

* `platform/` - Constains executables & application built with `rustboyadvance-core`

    * `platform/rustbodyadvance-wasm` - Web emulator powered by WebAssembly

    * `platform/rustbodyadvance-sdl2` - Desktop application built with sdl2

    * `platform/rustbodyadvance-minifb` - Desktop application built with minifb, *not maintained*.

    * `platform/rustbodyadvance-jni` - Java JNI binidngs for the emulator.

    * `platform/android` - A PoC Android application.

# Progress

![Pokemon Emerald](media/screenshot1.png)

## Emulation Todo:

* CGB audio (4 wave generator channels)

# Build and usage (Desktop Application)

To get started, you need to get a [stable rust toolchain](https://rustup.rs) of version Rust 1.51 or later,

## Linux build dependencies

Install SDL2 dependencies

```bash

sudo apt-get -y install libsdl2-dev libsdl2-image-dev

```

## Windows build dependencies

SDL2 runtime binaries are included in this repository, no extra setup needed.

## Build & Usage

You need to obtain a gba bios binary.

An [open source GBA bios](https://github.com/Nebuleon/ReGBA/blob/master/bios/gba_bios.bin) is also available and supported.

Place the bios file in the repository root and name it `gba_bios.bin` (or alternatively use the `-b` command line option)

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

```bash

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

```

You can also drag&drop rom files or any zip files containing `.gba` files inside into the emulator window and a new rom will be loaded.

## Key bindings

> Currently the key bindings are not configureable.

GBA key bindings:

| Keyboard  	| GBA      	|

|-----------	|----------	|

| Up        	| Up       	|

| Down      	| Down     	|

| Left      	| Right    	|

| 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 (experimetnal, requires --features gdb) |

| F5           	| Save snapshot file 	|

| F9           	| Load snapshot file 	|

# Android Application

The android project is placed inside `platform/android`.

To build it, open it with Android Studio.

You also need to set up rust to build android targets with NDK.

TODO - instructions

# More Screenshots

 ![Kirby - Nightmare in Dreamland](media/screenshot2.png) ![Dragon Ball - Legacy of Goku 2](media/screenshot3.png)

# Links and attribution

- [ARM7TDMI Technical Reference Manual](http://infocenter.arm.com/help/topic/com.arm.doc.ddi0210c/DDI0210B.pdf)

    Technical Reference Manuals are **fun**.

- [GBATEK](http://problemkaputt.de/gbatek.htm)

    A single webpage written by *no$gba* developer Martin Korth.

    This page has pretty much everything. Seriously, it's the best.

- [TONC](https://www.coranac.com/tonc/text/)

    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](https://github.com/fleroviux/NanoboyAdvance)

    A GameBoy Advance emulator written in C++17 by a nice person called fleroviux.

    I've used this for debugging.

- [Eggvance gba-suite](https://github.com/jsmolka/gba-suite)

    Incredible test suite for the arm7tdmi interpreter that I'm using, written by Julian Smolka.