gba:guide:wfconfig
Table of Contents
Project configuration
wfconfig.toml
wfconfig.toml serves as a project-wide configuration file.
[cartridge]
This section describes the cartridge header of the output .gba
file.
The following fields can affect execution, and thus should be configured correctly:
- logo - The filename of the binary logo data used by the cartridge header. The official boot ROM will not accept cartridges without the correct logo data. The value
"official"
refers to the default logo data and shouldn't typically be changed.
The following fields have no effect on execution and exist solely as metadata:
- title - Game title, up to 12 characters.
- code - Game code, 4 characters.
- maker - Game publisher, 2 characters.
The following fields are meant for advanced users only. Don't touch these unless you're building custom hardware.
- debug - Enables the GBA BIOS debug handler. The value
0
= handler at address0x09FFC000
,1
= handler at address0x09FE2000
.
[multiboot]
This section configures the multiboot image packer.
- compress - Set to
false
to disable compression, ortrue
to enable compression. Compression allows both making executables smaller (and thus faster to load over the link cable) and fitting more data into the 256 KiB binary size limit. - vram_compression_algorithm - Used for data placed into VRAM by the linker. Can be set to
lzss
oraplib
.
gba/guide/wfconfig.txt · Last modified: by asie