add basic support for rgbds assembly

This adds basic support for assembling and linking Game Boy and Game Boy
Color games with RGBDS's `rgbasm` and `rgblink`. This also adds
knowledge of the Sharp SM83 CPU family, the 8080/Z80-like CPU used on
the device's SoC.

Author: terinjokes

ci/ciimage/arch/install.sh

@@ -15,6 +15,7 @@ pkgs=(
   doxygen vulkan-validation-layers openssh mercurial gtk-sharp-2 qt5-tools
   libwmf cmake netcdf-fortran openmpi nasm gnustep-base gettext
   python-lxml hotdoc rust-bindgen qt6-base qt6-tools wayland wayland-protocols
+  rgbds
   # cuda
 )
 

docs/markdown/Reference-tables.md

@@ -49,6 +49,7 @@ These are return values of the `get_id` (Compiler family) and
 | armasm    | Microsoft Macro Assembler for ARM and AARCH64 (Since 0.64.0) | |
 | mwasmarm        | Metrowerks Assembler for Embedded ARM | |
 | mwasmeppc       | Metrowerks Assembler for Embedded PowerPC | |
+| rgbds           | Rednex GameBoy Development System | |
 
 ## Linker ids
 
@@ -80,6 +81,7 @@ These are return values of the `get_linker_id` method in a compiler object.
 | ccomp      | CompCert used as the linker driver          |
 | mwldarm    | The Metrowerks Linker with the ARM interface, used with mwccarm only |
 | mwldeppc   | The Metrowerks Linker with the PowerPC interface, used with mwcceppc only |
+| rgbds      | Rednex GameBoy Development System           |
 
 For languages that don't have separate dynamic linkers such as C# and Java, the
 `get_linker_id` will return the compiler name.
@@ -132,6 +134,7 @@ set in the cross file.
 | s390                | IBM zSystem s390         |
 | s390x               | IBM zSystem s390x        |
 | sh4                 | SuperH SH-4              |
+| sm83                | Sharp SM83 (GB/GBC)      |
 | sparc               | 32 bit SPARC             |
 | sparc64             | SPARC v9 processor       |
 | sw_64               | 64 bit sunway processor  |

docs/markdown/snippets/rgbds_language_support.md

@@ -0,0 +1,9 @@
+## Basic support for RGBDS assembly
+
+Meson now provides basic support for the assembly
+and linking of Game Boy and Game Boy Color games
+with RGBDS.
+
+Most projects will still need to call `rgbfix` as
+a `custom_target` as this time, unless they have
+correct header values in assembly source.

mesonbuild/compilers/asm.py

@@ -310,3 +310,44 @@ def get_instruction_set_args(self, instruction_set: str) -> T.Optional[T.List[st
     def sanity_check(self, work_dir: str, environment: 'Environment') -> None:
         if self.info.cpu_family not in {'ppc'}:
             raise EnvironmentException(f'ASM compiler {self.id!r} does not support {self.info.cpu_family} CPU family')
+
+class RgbdsCompiler(Compiler):
+    language = 'rgbds'
+
+    def __init__(self, exelist: T.List[str], version: str, for_machine: MachineChoice, info: MachineInfo,
+                 linker: DynamicLinker, exe_wrapper: T.Optional[ExternalProgram] = None,
+                 is_cross: bool = True):
+        super().__init__([], exelist, version, for_machine, info, linker, is_cross=is_cross)
+        self.id = 'rgbds'
+        self.exe_wrapper = exe_wrapper
+
+    def needs_static_linker(self) -> bool:
+        return True
+
+    def get_optimization_args(self, optimization_level: str) -> T.List[str]:
+        return []
+
+    def get_output_args(self, outputname: str) -> T.List[str]:
+        return ['-o', outputname]
+
+    def get_depfile_suffix(self) -> str:
+        return 'd'
+
+    def get_include_args(self, path: str, is_system: bool) -> T.List[str]:
+        if not path:
+            path = '.'
+        return ['-I' + path]
+
+    def get_dependency_gen_args(self, outtarget: str, outfile: str) -> T.List[str]:
+        return ['-M', outfile, '-MQ', outtarget]
+
+    def sanity_check(self, work_dir: str, environment: 'Environment') -> None:
+        if self.info.cpu_family != 'sm83':
+            raise EnvironmentException(f'ASM compiler {self.id!r} does not support {self.info.cpu_family} CPU family')
+
+    def compute_parameters_with_absolute_paths(self, parameter_list: T.List[str],
+                                               build_dir: str) -> T.List[str]:
+        for idx, i in enumerate(parameter_list):
+            if i[:2] == '-I':
+                parameter_list[idx] = i[:2] + os.path.normpath(os.path.join(build_dir, i[2:]))
+        return parameter_list

mesonbuild/compilers/compilers.py

@@ -69,6 +69,7 @@
     'cython': ('pyx', ),
     'nasm': ('asm', 'nasm',),
     'masm': ('masm',),
+    'rgbds': ('asm',),
 }
 all_languages = lang_suffixes.keys()
 c_cpp_suffixes = {'h'}

mesonbuild/compilers/detect.py

@@ -79,6 +79,8 @@
 defaults['gcc_static_linker'] = ['gcc-ar']
 defaults['clang_static_linker'] = ['llvm-ar']
 defaults['nasm'] = ['nasm', 'yasm']
+defaults['rgbasm'] = ['rgbasm']
+defaults['rgblink'] = ['rgblink']
 
 
 def compiler_from_language(env: 'Environment', lang: str, for_machine: MachineChoice) -> T.Optional[Compiler]:
@@ -98,6 +100,7 @@ def compiler_from_language(env: 'Environment', lang: str, for_machine: MachineCh
         'cython': detect_cython_compiler,
         'nasm': detect_nasm_compiler,
         'masm': detect_masm_compiler,
+        'rgbds': detect_rgbds_compiler,
     }
     return lang_map[lang](env, for_machine) if lang in lang_map else None
 
@@ -1353,6 +1356,40 @@ def detect_masm_compiler(env: 'Environment', for_machine: MachineChoice) -> Comp
     _handle_exceptions(popen_exceptions, [comp])
     raise EnvironmentException('Unreachable code (exception to make mypy happy)')
 
+def detect_rgbds_compiler(env: Environment, for_machine: MachineChoice) -> Compiler:
+    from .asm import RgbdsCompiler
+    exelist = env.lookup_binary_entry(for_machine, 'rgbasm')
+    is_cross = env.is_cross_build(for_machine) # true, until Meson is ported to GB
+    info = env.machines[for_machine]
+    if exelist is None:
+        exelist = defaults['rgbasm']
+
+    try:
+        output = Popen_safe([exelist[0], '--version'])[1]
+    except OSError:
+        raise EnvironmentalException('Could not execute RGBDS assembler "{}"'.format(''.join(exelist)))
+
+    version = search_version(output)
+    linker = _detect_rgblink(env, for_machine)
+    comp = RgbdsCompiler(exelist, version, for_machine, info, linker, env.exe_wrapper, is_cross)
+    env.coredata.add_lang_args(comp.language, RgbdsCompiler, for_machine, env)
+
+    return comp
+
+def _detect_rgblink(env: Environment, for_machine: MachineChoice) -> DynamicLinker:
+    from ..linkers.linkers import RgbdsLinker
+    exelist = env.lookup_binary_entry(for_machine, 'rgblink')
+    if exelist is None:
+        exelist = defaults['rgblink']
+
+    try:
+        output = Popen_safe([exelist[0], '--version'])[1]
+    except OSError:
+        raise EnvironmentalException('Could not execute RGBDS linker"{}"'.format(''.join(exelist)))
+
+    version = search_version(output)
+    return RgbdsLinker(exelist, for_machine, '', [], version=version)
+
 # GNU/Clang defines and version
 # =============================
 

mesonbuild/envconfig.py

@@ -57,6 +57,7 @@
     's390',
     's390x',
     'sh4',
+    'sm83',
     'sparc',
     'sparc64',
     'sw_64',

mesonbuild/linkers/linkers.py

@@ -1660,3 +1660,16 @@ class MetrowerksLinkerARM(MetrowerksLinker):
 
 class MetrowerksLinkerEmbeddedPowerPC(MetrowerksLinker):
     id = 'mwldeppc'
+
+
+class RgbdsLinker(DynamicLinker):
+    id = 'rgblink'
+
+    def get_allow_undefined_args(self) -> T.List[str]:
+        return []
+
+    def get_output_args(self, outputname: str) -> T.List[str]:
+        return ['-o', outputname]
+
+    def get_search_args(self, dirname: str) -> T.List[str]:
+        return []

run_project_tests.py

@@ -79,7 +79,7 @@ class ArgumentType(CompilerArgumentType):
              'keyval', 'platform-osx', 'platform-windows', 'platform-linux',
              'java', 'C#', 'vala', 'cython', 'rust', 'd', 'objective c', 'objective c++',
              'fortran', 'swift', 'cuda', 'python3', 'python', 'fpga', 'frameworks', 'nasm', 'wasm', 'wayland',
-             'format',
+             'format', 'rgbds'
              ]
 
 
@@ -1136,6 +1136,7 @@ def __init__(self, category: str, subdir: str, skip: bool = False, stdout_mandat
         TestCategory('wasm', 'wasm', shutil.which('emcc') is None or backend is not Backend.ninja),
         TestCategory('wayland', 'wayland', should_skip_wayland()),
         TestCategory('format', 'format'),
+        TestCategory('rgbds', 'rgbds', shutil.which('rgbasm') is None)
     ]
 
     categories = [t.category for t in all_tests]

test cases/rgbds/1 basic/crossfile.ini

@@ -0,0 +1,9 @@
+[binaries]
+c = 'gcc'
+strip = 'false'
+
+[host_machine]
+system = 'dmg'
+cpu_family = 'sm83'
+cpu = 'sm8320'
+endian = 'little'