https://github.com/antoniond/gba-bootstrap
Templates to start a GBA project with the bare minimum number of files
https://github.com/antoniond/gba-bootstrap
Last synced: 16 days ago
JSON representation
Templates to start a GBA project with the bare minimum number of files
- Host: GitHub
- URL: https://github.com/antoniond/gba-bootstrap
- Owner: AntonioND
- Created: 2022-01-21T18:50:20.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2023-02-14T01:17:41.000Z (about 2 years ago)
- Last Synced: 2025-04-12T21:44:06.085Z (23 days ago)
- Language: C
- Size: 17.6 KB
- Stars: 46
- Watchers: 5
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: readme.rst
- License: licenses/cc0-1.0.txt
Awesome Lists containing this project
README
GBA Bootstrap
=============
This is an example of a minimal project for GBA that can be built with a
vanilla ``gcc-arm-none-eabi`` toolchain. This repository contains all the source
you need to get started.
There is an example of the codebase using just C and an example of using C and
C++. Feel free to modify anything as you wish to suit your needs. This is meant
to be a relatively simple to understand template for anyone to use as base.
The license of the files in this repository is CC0 1.0 Universal, so you can
treat all the files as if they were in the public domain.
For an up-to-date version of this repository, check the GitHub repository:
https://github.com/AntonioND/gba-bootstrap
Instructions
------------
You need the ``gcc-arm-none-eabi`` toolchain. If you're on Linux you can just
use your package manager. For example, in Ubuntu:
.. code:: bash
sudo apt install gcc-arm-none-eabi
This will add the compiler to your ``PATH`` as well.
You can also download prebuilt binaries from `Arm's GNU toolchain downloads
website`_. In this case, you will need to manually add this toolchain to your
``PATH``.
Then, from the folder of either of the samples, type:
.. code:: bash
make
That's all!
Organization
------------
For both samples the organization is the same:
- ``Makefile``: Global makefile.
- ``gbafix``: Tool used to fill the checksums and other required fields of the
ROM header.
- ``source``: All the source code of the game goes here, including yours.
- ``source/sys``: Files required by the C/C++ runtime.
- ``source/sys/gba_cart.ld``: Linker script that describes how code and data
sections are placed in the ROM and at runtime on the GBA.
- ``source/sys/gba_crt0.s``: Initialization code that loads each section into
the right location in RAM.
- ``source/sys/syscalls.c``: Implementation of system calls. They are all
stubbed, so you can't use things like ``printf()`` or ``fopen()`` unless you
implement them, which isn't usually worth the effort on GBA. For more
information, check: https://sourceware.org/newlib/libc.html#Syscalls
.. _Arm's GNU toolchain downloads website: https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/gnu-rm/downloads