RGBDS

From GbdevWiki
Revision as of 02:56, 15 November 2012 by Shiny (Talk | contribs) (Bugs)

Jump to: navigation, search

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/


Anthony J. Bentley's fork that aims to make RGBDS more friendly towards Linux users:

https://github.com/bentley/rgbds

Bugs

(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.
  • Though listed in the documentation, the predeclared symbols '__LINE__', '_PI', and '_NARG' do not seem to exist.
  • Nested sections do not have their own label scope. This can create situations where a nested section 'steals' any local labels that come after it.