gba-dev-playground

A development playground for Game Boy Advance development using TONC as a guide.

Table of Contents

• gba-dev-playground
• Table of Contents
• Dependencies
• Getting Started
  • Setting Up the Environment
  • Running the Examples

Dependencies

• DevKitPro
• tonclib

Getting Started

The following instructions will help the user set up an environment to develop, compile, and clean Gameboy Advance games for a Windows PC.

Setting Up the Environment

1. Go to the DevKitPro Getting Started page.
2. Install the latest graphical installer.
3. Follow the prompts, making sure to select the GBA Development checkbox, to install DevKitPro and necessary tools.
4. Download the current version of the TONC code.
5. Extract it, and take the tonclib folder and copy it into a /libs folder at the root of this project.

NOTE: I know the library is packaged with the DevKitPro. I personally have not tested it, nor do I know if it's the most up-to-date version of the library. Try at your own risk, ensuring you rename the folder as necessary to match the LIBDIRS in the Makefiles.

6. Add C:\devkitPro\tools\bin to your PATH to grant access to some of DevKitPro's tools (like gbafix and grit).
7. Close your terminal or editor to let PATH changes take effect.
8. At this point, your environment should be ready.

Running the Examples

1. Open any folder within /src.
2. Execute make in the terminal to compile your .gba file.
3. Execute make clean to remove the executables and /build folder.