2aa59bb341
* Add IntelliJ workspace files to the .gitignore. * Add a simple make_example script for Linux. * Create a `sync` module with many GBA-specific sync utilties. * Fix overflow error in debug mode in the hello_world crate. * Fixes to DMA. * Code cleanup for the sync module. * Run rustfmt on new sync code. * Fix up some names and documentation in the sync module. * Add a few changes suggested by thomcc for the locks. * Added needed compiler fences to `InitOnce::try_get`. * Change the error in `RawMutex::raw_unlock` to better reflect the cause. * Add a proper issue link to the __sync_synchronize hack. * Disable interrupts during `InitOnce::try_get`. * Fix some bad wording in the comments for `InitOnce::try_get` * Use the new target in `cfg` checks to see if we're on GBA. * Change registers used for transfer_align4_arm for the different target. * Cleanup on sync_api changes for the target change. |
||
|---|---|---|
| .cargo | ||
| .github/workflows | ||
| book | ||
| examples | ||
| examples-bak | ||
| src | ||
| .gitignore | ||
| build.rs | ||
| Cargo.toml | ||
| init.sh | ||
| LICENSE-APACHE2.txt | ||
| linker.ld | ||
| make_example.sh | ||
| Makefile.toml | ||
| README.md | ||
| rustfmt.toml | ||
| todo_check.bat | ||
gba
Eventually there will be a full Tutorial Book that goes along with this crate. However, currently the development focus is leaning towards having minimal coverage of all the parts of the GBA. Until that's done, unfortunately the book will be in a rather messy state.
What's Missing
The following major GBA features are still missing from the crate:
- Affine Graphics
- Interrupt Handling
- Serial Communication
Build Dependencies
Install required cargo packages
rustup install nightly
rustup +nightly component add rust-src
cargo install cargo-make
cargo install gbafix
Install arm build tools
- Ubuntu
sudo apt-get install binutils-arm-none-eabi - OSX
brew install --cask gcc-arm-embedded - Windows
- Download the GNU Arm Embedded Toolchain
- Install the toolchain, make sure to select "Add path to environment variable" during install
First Time Setup
Writing a Rust program for the GBA requires a fair amount of special setup. All of the steps are detailed for you in the Development Setup part at the start of the book.
If you've done the described global setup once before and just want to get a new project started quickly we got you covered:
curl https://raw.githubusercontent.com/rust-console/gba/master/init.sh -sSf | bash -s APP_NAME
Contribution
This crate is Apache2 licensed and any contributions you submit must also be Apache2 licensed.