https://wonderful.asie.pl/wiki/ 2026-04-27T14:50:59+00:00 https://wonderful.asie.pl/wiki/ https://wonderful.asie.pl/wiki/lib/exe/fetch.php?media=wiki:logo.png text/html 2025-12-31T12:59:52+00:00 Anonymous (anonymous@undisclosed.example.com) https://wonderful.asie.pl/wiki/doku.php?id=wswan:guide:c_assembly&rev=1767185992&do=diff Writing assembly In the Wonderful toolchain, assembly files use the .s extension. They are compiled using the GNU assembler and the C preprocessor. Creating an assembly file It is recommended to start with a preamble similar to the following: * text/html 2024-02-17T10:54:44+00:00 Anonymous (anonymous@undisclosed.example.com) https://wonderful.asie.pl/wiki/doku.php?id=wswan:guide:c_calling_convention&rev=1708167284&do=diff C calling convention A C compiler typically defines a calling convention - a set of rules used for mapping C function arguments and return values to the CPU's registers and stack, allowing the caller (the function making the call) and the callee (the function being called) to put and retrieve data from the same locations. text/html 2024-02-17T10:51:34+00:00 Anonymous (anonymous@undisclosed.example.com) https://wonderful.asie.pl/wiki/doku.php?id=wswan:guide:c_inline_assembly&rev=1708167094&do=diff Writing C inline assembly The gcc-ia16 compiler supports inline assembly written with the AT&T syntax using the __asm keyword. Most standalone source code in the Wonderful toolchain uses the Intel syntax instead. For example, to enable CPU interrupts, we could write the following function: text/html 2024-09-22T11:58:21+00:00 Anonymous (anonymous@undisclosed.example.com) https://wonderful.asie.pl/wiki/doku.php?id=wswan:guide:elf_quirks&rev=1727006301&do=diff wswan toolchain ELF quirks The ELF format created by Wonderful has some quirks, owing both to the non-upstream binutils fork used and to the specifics of the ROM format itself. In general, gcc-ia16 ELF files follow the 32-bit x86 ELF format. Segment relocations text/html 2025-11-07T15:14:05+00:00 Anonymous (anonymous@undisclosed.example.com) https://wonderful.asie.pl/wiki/doku.php?id=wswan:guide:interrupt_handlers&rev=1762528445&do=diff Writing interrupt handlers C interrupt handlers For less performance-sensitive interrupts (such as the vertical blank interrupt), it is possible to write the relevant handlers using only C. This is done by marking the interrupt function with special attributes: text/html 2025-08-15T10:33:03+00:00 Anonymous (anonymous@undisclosed.example.com) https://wonderful.asie.pl/wiki/doku.php?id=wswan:guide:memory_management&rev=1755253983&do=diff Memory management The WonderSwan poses unique challenges for implementing a robust memory management system: * The unified memory architecture places display and audio data in shared RAM with the CPU, however its restrictions lead to harsh alignment requirements, and thus the need for non-contiguous memory allocation in RAM. text/html 2026-02-11T18:53:17+00:00 Anonymous (anonymous@undisclosed.example.com) https://wonderful.asie.pl/wiki/doku.php?id=wswan:guide:optimization&rev=1770835997&do=diff Optimizing programs This page serves as a loose list of advice for getting the most out of the WonderSwan. Optimizing C code Optimizing for code speed To optimize for speed, compile your code with -O2. Optimizing for code size To optimize for size, compile your code with text/html 2025-12-31T13:10:20+00:00 Anonymous (anonymous@undisclosed.example.com) https://wonderful.asie.pl/wiki/doku.php?id=wswan:guide:pcv2_support&rev=1767186620&do=diff Pocket Challenge V2 Pocket Challenge V2 differs from the mono WonderSwan in two ways: * Most boot ROM execution is skipped and the code entry point is different. This is referred to as using the “pinstrap” entry point. * The input button layout is different. text/html 2026-01-08T15:57:38+00:00 Anonymous (anonymous@undisclosed.example.com) https://wonderful.asie.pl/wiki/doku.php?id=wswan:guide:porting_wwitch&rev=1767887858&do=diff Porting WonderWitch applications 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 can go for as much as $100 on the second-hand market, with the full SDK fetching prices above $200 - much more than the console itself. This makes not just creating, but even running WonderWitch applications inaccessible to most hobbyists. text/html 2025-08-31T19:28:04+00:00 Anonymous (anonymous@undisclosed.example.com) https://wonderful.asie.pl/wiki/doku.php?id=wswan:guide:wfconfig&rev=1756668484&do=diff Project configuration wfconfig.toml wfconfig.toml serves as a project-wide configuration file. [cartridge] This section describes the cartridge header of the output .ws/.wsc file. The following fields can affect cartridge loaders and/or the boot ROM, and thus should be configured correctly: text/html 2026-01-08T15:57:54+00:00 Anonymous (anonymous@undisclosed.example.com) https://wonderful.asie.pl/wiki/doku.php?id=wswan:guide:wwitch&rev=1767887874&do=diff Developing for WonderWitch The WonderWitch is an official homebrew development environment provided by Qute Corporation. As the official toolchain is proprietary, Wonderful provides its own toolchain for the platform, allowing use of both BIOS system calls and direct hardware access.