Difference between revisions of "RGBDS"

From GbdevWiki
Jump to: navigation, search
 
(10 intermediate revisions by one other user not shown)
Line 1: Line 1:
RGBDS (RedneX Game Boy Development System) aka ASMotor is a package consisting of the assembler xAsm, the linker xLink and the ROm image validation tool RGBFix.  
+
RGBDS (RedneX Game Boy Development System) aka ASMotor is a package consisting of the assembler xAsm, the linker xLink and the ROM image validation tool RGBFix.  
  
 
== Distribution ==
 
== Distribution ==
 +
Carsten Sørensen's version (author of RGBDS):
 +
 
http://www.rift.dk/download.php?list.6
 
http://www.rift.dk/download.php?list.6
 +
 +
 +
Otaku No Zoku's fork with a few additional fixes and features:
 +
 +
http://www.otakunozoku.com/rednex-gameboy-development-system/
 +
 +
 +
Currently maintained version (it works on Windows and UNIX systems):
 +
 +
https://github.com/rednex/rgbds
  
 
== Bugs ==
 
== Bugs ==
 
'''(Please add any bugs you might encounter to the list below)'''
 
'''(Please add any bugs you might encounter to the list below)'''
* The "DW `01230123" notation for defining tiles only works with the numerals 0 and 1.
+
* Trying to pass a string literal that contains an escape sequence to a macro results in an "Unterminated string" error.
 +
* The \" (double quote) escape sequence can only be used in pairs.
 +
* xLink's "link file" parser cannot handle spaces.
 +
* Subtracting a numeric constant from a data structure symbol (rb, rw, ...) produces a parse error. It's still possible, however, to add a negative number.
 +
* Line numbers are often off by one (actual line numbers are one less than reported).
 +
* RGBAsm crashes under unknown circumstances‐ often when working with macros. Sometimes, this can be fixed temporarily by altering the length of the offending source file. Other times, not using the '-q' command-line option works.

Latest revision as of 16:56, 18 February 2018

RGBDS (RedneX Game Boy Development System) aka ASMotor is a package consisting of the assembler xAsm, the linker xLink and the ROM image validation tool RGBFix.

Distribution

Carsten Sørensen's version (author of RGBDS):

http://www.rift.dk/download.php?list.6


Otaku No Zoku's fork with a few additional fixes and features:

http://www.otakunozoku.com/rednex-gameboy-development-system/


Currently maintained version (it works on Windows and UNIX systems):

https://github.com/rednex/rgbds

Bugs

(Please add any bugs you might encounter to the list below)

  • Trying to pass a string literal that contains an escape sequence to a macro results in an "Unterminated string" error.
  • The \" (double quote) escape sequence can only be used in pairs.
  • xLink's "link file" parser cannot handle spaces.
  • Subtracting a numeric constant from a data structure symbol (rb, rw, ...) produces a parse error. It's still possible, however, to add a negative number.
  • Line numbers are often off by one (actual line numbers are one less than reported).
  • RGBAsm crashes under unknown circumstances‐ often when working with macros. Sometimes, this can be fixed temporarily by altering the length of the offending source file. Other times, not using the '-q' command-line option works.