Difference between revisions of "RGBDS"

From GbdevWiki
Jump to: navigation, search
m (Bugs)
 
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 ==
Line 12: Line 12:
  
  
Anthony J. Bentley's fork that aims to make RGBDS more friendly towards Linux users:
+
Currently maintained version (it works on Windows and UNIX systems):
  
https://github.com/bentley/rgbds
+
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.
 
* 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.
 
* The \" (double quote) escape sequence can only be used in pairs.
Line 25: Line 24:
 
* Line numbers are often off by one (actual line numbers are one less than reported).
 
* 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.
 
* 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.
 

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.