WonderWitch applications compiled using the official Qute SDK require a copy of FreyaOS (and FreyaBIOS) to run. Unfortunately, nowadays a loose WonderWitch cartridge required to run such programs costing $100+ on the second-hand market, with the full SDK fetching prices above $200.

(If you're an employee of Qute Corporation reading this, I would be very happy to volunteer and help resolving this situation.)

However, there already exists a large base of tutorials and software, including open source software, written for the API provided by Freya. One way to facilitate interoperability between the Wonderful toolchain (and, by extension, alternate execution environments) and such WonderSwan software would be to reimplement the required parts of the Freya API. Other projects like WSSim and WWWLib have been developed in the past to achieve this, while the Wonderful toolchain provides the libwwcl (WWitch Compatibility Layer) library for this purpose.

  $ wf-wswantool project new -t wwcl new_project_name
  

• While a Freya application uses the Makefile to configure the default memory layout (ASCII1, ASCII2, JAPANESE1, JAPANESE2), libwwcl relies on WWCL_INIT_MODE macros and the wwcl_init() function for this.
  • These macros and functions are provided in <wwcl.h>, which is a new header that can be used instead of <sys/bios.h>.
  • The macros are entirely optional. If you want to declare the memory layout yourself using the Wonderful toolchain's memory management, that is supported - use wwcl_init_custom() in this situation.
• gcc-ia16 requires a __far modifier for all constant arrays stores in ROM. See Addressing RAM and ROM for more information.

The implementation is incomplete; you can help by expanding it.

• The following headers should be fully implemented:
  • Display (disp.h)
  • Color (libwwc.h)
  • Sound (sound.h)
• Bank (bank.h) is not implemented.
• Comm (comm.h) implements everything except comm_xmodem.
• Key (key.h) is missing key repeat support.
• Text (text.h) is not implemented.
• Timer (timer.h) is missing RTC (real time clock) support.
• The implementation of System (system.h) is very limited. However, many of its functions are not useful when not running on top of Freya.