|RGBLINK(1)||General Commands Manual||RGBLINK(1)|
rgblink— Game Boy linker
rgblinkprogram links RGB object files, typically created by rgbasm(1), into a single Game Boy ROM file. The format is documented in rgbds(5).
ROM0 sections are placed in the first 16 KiB of the output ROM,
and ROMX sections are placed in any 16 KiB “bank” except the
first. If your ROM will only be 32 KiB, you can use the
-t option to change this.
Similarly, WRAM0 sections are placed in the first 4 KiB of WRAM
(“bank 0”), and WRAMX sections are placed in any bank of the
last 4 KiB. If your ROM doesn't use banked WRAM, you can use the
-w option to change this.
Also, if your ROM is designed for a monochrome Game Boy, you can
make sure that you don't use any incompatible section by using the
-d option, which implies
but also prohibits the use of banked VRAM.
Note that options can be abbreviated as long as the abbreviation
--ver is invalid because it
could also be
arguments are as follows:
-Ois specified. The default is 0.
-t. You can use this when not not making a ROM. When making a ROM, be careful that not using this is not a replacement for rgbfix(1)'s
The resulting bar.gb will not have correct checksums (unless you put them in the assembly source). You should use rgbfix(1) to fix these so that the program will actually run in a Game Boy:
$ rgbfix -v bar.gb
Here is a more complete example:
$ rgblink -o bin/game.gb -n bin/game.sym -p 0xFF obj/title.o obj/engine.o
rgblinkwas originally written by Carsten Sørensen as part of the ASMotor package, and was later packaged in RGBDS by Justin Lloyd. It is now maintained by a number of contributors at https://github.com/rednex/rgbds.
|November 26, 2019||General|