User Tools

Site Tools


gba:guide:wfconfig

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 address 0x09FFC000, 1 = handler at address 0x09FE2000.

[multiboot]

This section configures the multiboot image packer.

  • compress - Set to false to disable compression, or true 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 or aplib.
gba/guide/wfconfig.txt · Last modified: by asie