alex/agb
1
0
Fork 0
mirror of https://github.com/italicsjenga/agb.git synced 2024-10-17 07:31:39 +11:00
Code Issues Packages Projects Releases Wiki Activity
119 commits 1 branch 0 tags 31 MiB
Rust 95.3%
Assembly 3.1%
Just 0.7%
C 0.7%
Shell 0.2%
Go to file
Gwilym Kuiper f92daa3fc3 Improve debug output
2021-04-20 00:57:47 +01:00
.github/workflows Run the rust workflow in the correct directory 2021-04-19 22:47:43 +01:00
agb Move everything to the agb directory 2021-04-19 22:47:43 +01:00
agb-image-converter Improve debug output 2021-04-20 00:57:47 +01:00
mgba-test-runner Import the mgba-test-runner 2021-04-19 22:47:43 +01:00
.gitignore Want to exclude every target directory 2021-04-20 00:40:14 +01:00
README.md Update README.md instructions for installing the test runner 2021-04-19 22:47:43 +01:00

README.md

Rust for the Game Boy Advance

This is my in development library for rust on the Game Boy Advance. It uses information from GbaTek, Tonc, and the existing rust-console/gba.

Note that this currently contains no documentation of any kind, unless you count examples as documentation.

Build Requirements

  • Nightly rust, probably quite a recent version.
  • arm eabi binutils
    • Debian and derivatives: sudo apt install binutils-arm-none-eabi
    • Arch Linux and derivatives: pacman -S arm-none-eabi-binutils

Test Requirements

  • mgba 0.9.0
  • mgba-test-runner
    • Run cargo install --path mgba-test-runner inside this directory

Real Hardware Build

  • Need gbafix, rust implementation can be installed with cargo install gbafix.
  • On compiled elf file, additionally need to
arm-none-eabi-objcopy -O binary {input-elf} {output-gba}
gbafix {output-gba}

Stability

0% stable, I have no problems making drastic changes in the API in order to make something nice to work with.