Skip to content

ryankurte/rust-gba

Repository files navigation

Rust GBA

Gameboy Advanced support for rust based on the embedonomicon.

Check out examples/gba-example-rainbow/ 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-core = { git = "https://github.com/ryankurte/rust-gba" } as a dependency
  3. Copy arm7tdmi.json, gba_cart.ld, and Makefile from this repository into your project root
  4. Edit Makefile, changing the APP variable to the name of your binary
  5. Run make clean all to build the ROM image

Alternately, you can copy the example from examples/gba-example-rainbow/ and work from there. The Makefile in the example is pretty bare-bones, but it's enough to get a working ROM image.

Helpers

This repo contains some (potentially) helpful utilities for GBA development. The source of these can be found in the src/bin/ directory.

gbafix

A Rust reimplementation of the gbafix tool, which you can use instead of the DevkitPro version when building GBA ROM images, is included as the gbafix binary.

Resources

Hardware

Processor

Software

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published