devraza/rustboyadvance-ng
Archived
1
Fork 0
Code Issues Pull requests Projects Releases 1 Packages Wiki Activity
Nintendo™ Game Boy Advance emulator and debugger. [Fork]
This repository has been archived on 2024-12-14. You can view files and clone it, but you cannot make any changes to its state, such as pushing and creating new issues, pull requests or comments.
598 commits 1 branch 1 tag 4 MiB
Find a file
Exact
Muhammad Nauman Raza c7916e9fae
 flake: update and add SDL2 and SDL2_image as runtime dependencies
2024-12-14 12:19:34 +00:00
.cargo cargo: remove mold and clang linkers 2024-03-22 23:30:17 +00:00
app ux: do not have a default BIOS file 2024-03-23 20:58:46 +00:00
arm7tdmi chore: remove extra platforms 2024-03-23 20:13:27 +00:00
core chore: remove core/BENCHMARK.md 2024-03-23 20:59:03 +00:00
external chore: bump external/gamecontrollerdb.txt 2024-03-23 20:48:34 +00:00
utils chore: remove extra platforms 2024-03-23 20:13:27 +00:00
.gitignore Ignore .logs dir 2020-04-13 00:24:06 +03:00
.gitmodules Implement controller support for the SDL2 frontend 2020-05-11 20:26:11 +03:00
Cargo.lock hotfix: references to directories 2024-03-23 20:29:33 +00:00
Cargo.toml hotfix: change default member to account for restructure 2024-03-23 20:18:31 +00:00
flake.lock flake: update and add SDL2 and SDL2_image as runtime dependencies 2024-12-14 12:19:34 +00:00
flake.nix flake: update and add SDL2 and SDL2_image as runtime dependencies 2024-12-14 12:19:34 +00:00
LICENSE Create LICENSE 2019-06-24 16:36:20 +03:00
README.md docs: add full stop. 2024-03-23 21:05:09 +00:00

README.md

rustboyadvance-ng

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

This repository is a fork of rustboyadvance-ng, with minimal non-feature changes.

Project structure

  • core/ - Main emulator crate that ties everything together
  • arm7tdmi/ - Emulation of the Arm7tdmi processor
  • app/ - Contains the desktop application built with sdl2

External content

The file at external/gamecontrollerdb.txt is not my work - it is sourced from this GitHub repository and covered by the appropriate license present in said repository.

Usage

You will need to specify the BIOS file to run with, using the --bios command-line argument. Note that there is such a BIOS ROM present in this directory at ./external/gba_bios.bin.

Key bindings

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