RGBASM(1) General Reference Manual RGBASM(1)

NAME

rgbasmGame Boy assembler

SYNOPSIS

rgbasm [-b chars] [-g chars] [-i path] [-o outfile] [-p pad_value] file

DESCRIPTION

The rgbasm program creates an object file from an assembly source file. Its arguments are as follows:
-b chars
Change the two characters used for binary constants. The defaults are 01.
-g chars
Change the four characters used for binary constants. The defaults are 0123.
-i path
Add an include path.
-o outfile
Write an object file to the given filename.
-p pad_value
When padding an image, pad with this value. The default is 0x00.

EXAMPLES

Assembling a basic source file is simple:

$ rgbasm -o bar.o foo.asm

The resulting object file is not yet a usable ROM image — it must first be run through rgblink(1) and rgbfix(1).

SEE ALSO

rgbds(7), rgbfix(1), rgblib(1), rgblink(1), gbz80(7)

HISTORY

rgbasm was originally written by Carsten Sørensen as part of the ASMotor package, and was later packaged in RGBDS by Justin Lloyd.
April 11, 2013 RGBDS Manual