u1f408 / rust-gba

Rust GBA

Gameboy Advanced support for rust based on the embedonomicon.

Check out ryankurte/rust-gba-example for a working example.

Status

At the moment this pretty much just boots. In the future, it'd be neat to have drivers for the GBA peripherals included. If you implement anything, please do open a PR!

Usage

1. Create a new #[no_std] binary project with cargo new --bin
2. Add gba = { git = "https://github.com/ryankurte/rust-gba" } as a dependency
3. Copy arm7tdmi.json, .cargo/config, Xargo.toml and optionally makefile from this into your project root
4. Build with cargo xbuild --target arm7tdmi.json --release

Alternately, you can clone or copy ryankurte/rust-gba-example and start work from there.

For more useful commands, check out the makefile

Resources

Hardware

• Wikipedia GBA Overview
• GBA Hardware Overview

Processor

• Wikipedia ARM7TDMI
• ARM7TDMI Reference Manual

Software

• @exoticorn's gba-rust series
• @exoticorn's gba-rust code
• DevKitPro gbafix rom fixer
• DevKitPro cartrige linker script
• DevKitPro crt0 startup script