Gameboy Advance - Revision history

PoroCYon at 16:44, 23 April 2025

2025-04-23T16:44:32Z

PoroCYon: oops, fix link

2025-04-23T16:43:09Z

oops, fix link

PoroCYon: /* Additional Resources */

2025-04-23T16:41:28Z

‎Additional Resources

PoroCYon at 16:39, 23 April 2025

2025-04-23T16:39:10Z

PoroCYon at 16:37, 23 April 2025

2025-04-23T16:37:22Z

DevEd: /* Sound */ missed a spot

2024-05-01T02:25:39Z

‎Sound: missed a spot

DevEd: Add some emulator info

2024-05-01T02:25:17Z

Add some emulator info

Superogue: Created page with "== Gameboy Advance == The Gameboy Advance uses an ARM7TDMI Processor running at 16.7 MHz, 384kb of memory and a 240x160 pixel resolution. === Setting up === Setting up your d..."

2022-03-10T12:54:53Z

Created page with "== Gameboy Advance == The Gameboy Advance uses an ARM7TDMI Processor running at 16.7 MHz, 384kb of memory and a 240x160 pixel resolution. === Setting up === Setting up your d..."

New page

== Gameboy Advance ==
The Gameboy Advance uses an ARM7TDMI Processor running at 16.7 MHz, 384kb of memory and a 240x160 pixel resolution.

=== Setting up ===
Setting up your development platform for the Gameboy Advance:

* Assembler: -
* Emulator(s): -

=== Video display ===
The Gameboy Advance has many graphics modes to play in both 256 colors as well as 15-bit direct RGB access, as well as support for tilemaps and 128 hardware sprites with a max 64x64 resolution.

==== Getting something on screen ====
To be added soon.

=== Sound ===
The Gameboy Advance has 4 channel sound + 2 x DMA for digital audio.

==== Make some noise ====
To be added soon.

=== ROM Header ===
The Gameboy Advance ROM header is 192 bytes in size, where 156 bytes are reserved for the Nintendo logo. The first 4 bytes in the ROM header is a ARM-branch instruction to the actual code. The following 156 bytes are the mandatory Nintendo Logo. At offset 0x00A0 the header expects a game title in maximum 12 bytes. These 12 bytes can be reused by inserting instructions instead of a game title. Following the game title, the next 4 bytes are the game code, which can also be used for instructions. After the game code, 2 bytes for the maker code are reserved, which can be used, when already changed into THUMB-Mode. The next byte is fixed and has to be always 0x96. The next byte is free, but hardly to make usage of. One could try to create a useful instruction using the byte before or in general here could be stored some value. After this, another 8 bytes can be used for instructions from offset 0x00B4. At offset 0x00BD a complementary check for the header has to be calculated. If the calculated checksum is different than the stored value, the ROM won't boot. Since some values in the header are fixed, which normaly should be jumped over, one can analyse the resulting instructions created by that fixed bytes and decide whether just slide through it.

=== Additional Resources ===
* [https://problemkaputt.de/gbatek.htm GBATEK]
* [https://www.pouet.net/prodlist.php?type%5B%5D=256b&platform%5B%5D=Gameboy+Advance Pouet: 256 byte productions for the GBA]

@@ Line 1: / Line 1: @@
 == Game Boy Advance ==
-The Game Boy Advance uses an ARM7TDMI Processor running at 16.7 MHz, 384kb of memory and a 240x160 pixel resolution.
+The Game Boy Advance uses an ARM7TDMI Processor running at 16.7 MHz, 384kb of memory and a 240x160 pixel resolution. The ARM7TDMI supports both the 32-bit ARM instruction set (where every instruction is 32 bits wide) and the original Thumb 1 instruction set (16 bits wide except for jumps, and does not support every instruction in 32-bit ARM). Registers are always still 32-bit. The CPU also has a fast multiplier.
 While the CPU is 32-bit, most of the system buses are only 16 bits wide. All IO is memory-mapped, and the instruction set is a load-store architecture.

@@ Line 37: / Line 37: @@
 === Additional Resources ===
 * [https://problemkaputt.de/gbatek-contents.htm GBATEK]
-* [https://www.pouet.net/prodlist.php?type[]=32b&type[]=64b&type[]=128b&type[]=256b&type[]=512b&type[]=1k&platform[]=Gameboy+Advance&page=1 Pouet: tiny intros for the GBA]
+* [https://www.pouet.net/prodlist.php?type%5b%5d=32b&type%5b%5d=64b&type%5b%5d=128b&type%5b%5d=256b&type%5b%5d=512b&type%5b%5d=1k&platform%5b%5d=Gameboy+Advance&page=1 Pouet: tiny intros for the GBA]

@@ Line 37: / Line 37: @@
 === Additional Resources ===
 * [https://problemkaputt.de/gbatek-contents.htm GBATEK]
-* [https://www.pouet.net/prodlist.php?type%5B%5D=256b&platform%5B%5D=Gameboy+Advance Pouet: 256 byte productions for the GBA]
+* [https://www.pouet.net/prodlist.php?type[]=32b&type[]=64b&type[]=128b&type[]=256b&type[]=512b&type[]=1k&platform[]=Gameboy+Advance&page=1 Pouet: tiny intros for the GBA]

@@ Line 28: / Line 28: @@
 === Compression ===
-The GBA bootROM/BIOS contains RLE, LZ77, Huffman and "bit unpack" [https://problemkaputt.de/gbatek-bios-decompression-functions.htm decompression routines]. These can be called using the <code>swi 0xXX</code> instruction (where XX is the SWI number, see GBATEK). If your code is large enough, it can benefit from this. devkitARM contains tools to compress your data in the correct format, and vl4d has written a small decompression stub. [https://www.pouet.net/prod.php?which=86319 This prod] can be used as an example.
+The GBA bootROM/BIOS contains RLE, LZ77, Huffman and "bit unpack" [https://problemkaputt.de/gbatek-bios-decompression-functions.htm decompression routines]. These can be called using the <code>swi 0xXX</code> instruction (where XX is the SWI number, see GBATEK). If your code is large enough, it can benefit from this. It is best to load the decompressed code into (fast) IWRAM at <code>0x03000000</code>, as it has a very fast access time and is one of the few memories with a 32-bit-wide bus. devkitARM contains tools to compress your data in the correct format, and vl4d has written a small decompression stub. [https://www.pouet.net/prod.php?which=86319 This prod] can be used as an example.
 === ROM Header ===

@@ Line 1: / Line 1: @@
 == Game Boy Advance ==
 The Game Boy Advance uses an ARM7TDMI Processor running at 16.7 MHz, 384kb of memory and a 240x160 pixel resolution.
 === Setting up ===
 Setting up your development platform for the Gameboy Advance:
-* Assembler: -
+* Assembler: GNU Assembler (easiest is to use the devkitARM toolchain), VASM
 * Emulator(s):  mGBA, NanoBoyAdvance, NO$GBA
@@ Line 12: / Line 14: @@
 ==== Getting something on screen ====
-To be added soon.
+Easiest way to get something on-screen is to use the "direct" bitmap RGB mode. This can be done by writing <code>0x0403</code> (mode 3, enable BG2 only) to the <code>DISPCNT</code> register (at <code>0x04000000</code>). The bitmap memory can then be written to in VRAM (<code>0x06000000</code>). '''Note that VRAM must be written to using 16-bit writes, 8-bit writes will be ignored!'''
 === Sound ===
@@ Line 20: / Line 25: @@
 ==== Make some noise ====
 To be added soon.
 === ROM Header ===
 The Game Boy Advance ROM header is 192 bytes in size, where 156 bytes are reserved for the Nintendo logo. The first 4 bytes in the ROM header is a ARM-branch instruction to the actual code. The following 156 bytes are the mandatory Nintendo Logo. At offset 0x00A0 the header expects a game title in maximum 12 bytes. These 12 bytes can be reused by inserting instructions instead of a game title. Following the game title, the next 4 bytes are the game code, which can also be used for instructions. After the game code, 2 bytes for the maker code are reserved, which can be used, when already changed into THUMB-Mode. The next byte is fixed and has to be always 0x96. The next byte is free, but hardly to make usage of. One could try to create a useful instruction using the byte before or in general here could be stored some value. After this, another 8 bytes can be used for instructions from offset 0x00B4. At offset 0x00BD a complementary check for the header has to be calculated. If the calculated checksum is different than the stored value, the ROM won't boot. Since some values in the header are fixed, which normaly should be jumped over, one can analyse the resulting instructions created by that fixed bytes and decide whether just slide through it.
 === Additional Resources ===
-* [https://problemkaputt.de/gbatek.htm GBATEK]
+* [https://problemkaputt.de/gbatek-contents.htm GBATEK]
 * [https://www.pouet.net/prodlist.php?type%5B%5D=256b&platform%5B%5D=Gameboy+Advance Pouet: 256 byte productions for the GBA]

@@ Line 16: / Line 16: @@
 === Sound ===
-The Gameboy Advance has 4 channel sound + 2 x DMA for digital audio.
+The Game Boy Advance has 4 channel sound + 2 x DMA for digital audio.
 ==== Make some noise ====