wswan (WonderSwan/WonderWitch)

The wswan target provides support for targetting the Bandai WonderSwan console. In addition, experimental support is provided for targetting the WonderWitch OS via the wwitch target.

• Platform overview
• Known issues

Currently supported languages include:

• assembly - via binutils-ia16's GNU assembler, using Intel-style opcodes and syntax;
• C - via gcc-ia16, supporting up to the C11 standard with GNU extensions.

• target-wswan - basic support metapackage

This is very incomplete and only covers the absolute basics.

• Development environment
• Hello, Display!

• libws - low-level hardware definitions and functions
• libwsx - high-level utilities
• libww - WonderWitch API wrapper, for the wwitch subtarget

• Memory management - working with banks and segmentation, controlling memory locations
• Optimizing for the NEC V30MZ CPU
• Project configuration - configuring the ROM header and others
• Writing interrupt handlers
• Writing assembly - using the GNU assembler
  • C calling convention
  • Writing inline C assembly
• Pocket Challenge V2/pinstrap support

• binutils-ia16
  • as Assembler
  • ld Linker
• gcc-ia16 6.3.0 - C compiler
  • IA-16 Options
  • IA-16 Named Address Spaces
  • IA-16 Function Attributes
  • IA-16 Built-in Functions
  • IA-16 Machine Constraints (inline assembly)
• gcc-ia16 cpp 6.3.0 - C preprocessor

• ELF quirks

The wswan target features multiple subtargets:

• wswan/medium - create a ROM with multiple code segments, the default, stack and static data stored in IRAM;
• wswan/small - create a ROM with one code segment, slightly faster code but 64KB maximum code limit, stack and static data stored in IRAM;
• wswan/medium-sram (experimental) - create a ROM with multiple code segments, stack stored in IRAM, static data stored in SRAM;
• wswan/small-sram (experimental) - create a ROM with one code segment, stack stored in IRAM, static data stored in SRAM;
• wswan/bootfriend - special subtarget for creating BootFriend executables which execute from RAM.

In addition, there exists an experimental subtarget wwitch for targeting the Freya abstraction layer used by the WonderWitch platform.

• WSdev Wiki - hardware documentation
• awesome-wsdev - link hub for WonderSwan-related homebrew projects