Differences

This shows you the differences between two versions of the page.

--- wswan:index [2024/09/22 09:07] – [Guides] asie
+++ wswan:index [2026/01/08 15:57] (current) – asie
@@ Line 1: / Line 1: @@
-====== wswan (WonderSwan/WonderWitch) ======
+====== wswan ======
-The wswan target provides support for targetting the Bandai WonderSwan console. In addition, experimental support is provided for targetting the WonderWitch abstraction layer.
+The wswan target provides support for targetting the **Bandai WonderSwan** console. In addition, experimental support is provided for targetting the **WonderWitch** environment via the ''wwitch'' target.
+  * [[wswan:platform_overview|Platform overview]]
+  * [[wswan:bugs|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,
-  * **C** - via gcc-ia16, supporting up to the C11 standard with GNU extensions.
+  * **assembly** - via binutils-ia16's GNU assembler.
-===== Overview =====
-  * [[wswan:platform_overview|Platform overview]]
-  * [[wswan:bugs|Known issues]]
 ===== Packages =====
@@ Line 17: / Line 15: @@
   * ''target-wswan'' - basic support metapackage
-===== Subtargets =====
+===== Additional documentation =====
-The wswan target features multiple subtargets:
+==== Library references ====
-  * ''wswan/medium'' - create a ROM with multiple code segments, the default;
+  * [[https://wonderful.asie.pl/doc/libws/|libws]] - low-level hardware definitions and functions
-  * ''wswan/small'' - create a ROM with one code segment, slightly faster code but 64KB maximum code limit;
+  * [[https://wonderful.asie.pl/doc/libwsx/|libwsx]] - high-level utilities
-  * ''wswan/bootfriend'' - special subtarget for creating [[https://wonderful.asie.pl/ws/bootfriend/|BootFriend]] executables which execute from RAM.
+  * [[https://wonderful.asie.pl/doc/libww/|libww]] - WonderWitch API wrapper, for the ''wwitch'' subtarget
-In addition, there exists an [[wswan:wwitch|experimental subtarget]] ''wwitch'' for targeting the Freya abstraction layer used by the WonderWitch platform.
+==== Toolchain documentation ====
-===== Libraries =====
-  * [[https://wonderful.asie.pl/doc/libws/|libws]] - low-level hardware library
-  * [[https://wonderful.asie.pl/doc/libwsx/|libwsx]] - high-level utility library
-  * [[https://wonderful.asie.pl/doc/libww/|libww]] - WonderWitch API library
-  * [[https://wonderful.asie.pl/doc/libwwcl/|libwwcl]] - WonderWitch compatibility layer
-===== Guides =====
-  * These might become a tutorial one day (very work-in-progress):
-    * [[wswan:tutorial:development_environment|Development environment]]
-    * [[wswan:tutorial:hello_display|Hello, Display!]]
-  * [[wswan:guide:porting_wwitch|Porting WonderWitch applications to standalone programs]] - the ''libwwcl'' WonderWitch compatibility layer
-  * [[wswan:guide:memory_management|Memory management]] - working with banks and segmentation, controlling memory locations
-  * [[wswan:guide:optimization_v30mz|Optimizing for the NEC V30MZ CPU]]
-  * [[wswan:guide:interrupt_handlers|Writing interrupt handlers]]
-  * [[wswan:guide:c_assembly|Writing assembly]] - using the GNU assembler
-    * [[wswan:guide:c_calling_convention|C calling convention]]
-    * [[wswan:guide:c_inline_assembly|Writing inline C assembly]]
-  * [[wswan:guide:wfconfig|wfconfig.toml]] - configuring the ROM header
-  * [[wswan:guide:elf_quirks|WonderSwan ELF quirks]]
-===== Other documentation =====
   * [[https://wonderful.asie.pl/doc/binutils-ia16/|binutils-ia16]]
@@ Line 64: / Line 34: @@
     * [[https://wonderful.asie.pl/doc/gcc-ia16/gcc-6.3.0/gcc/IA_002d16-Built_002din-Functions.html|IA-16 Built-in Functions]]
     * [[https://wonderful.asie.pl/doc/gcc-ia16/gcc-6.3.0/gcc/Machine-Constraints.html|IA-16 Machine Constraints]] (inline assembly)
+  * [[https://wonderful.asie.pl/doc/gcc-ia16/gcc-6.3.0/cpp/|gcc-ia16 cpp 6.3.0]] - C preprocessor
+==== Various notes ====
+  * [[wswan:guide:memory_management|Memory management]] - working with banks and segmentation, controlling memory locations
+  * [[wswan:guide:wfconfig|Project configuration]] - configuring the ROM header and others
+  * [[wswan:guide:interrupt_handlers|Writing interrupt handlers]]
+==== Design notes ====
+  * [[wswan:guide:elf_quirks|ELF quirks]]
+===== Subtargets =====
+The wswan target features multiple subtargets:
+  * ''wswan/medium'' (default) - 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 [[https://wonderful.asie.pl/ws/bootfriend/|BootFriend]] executables which execute from RAM.
+In addition, there exists an [[wswan:guide:wwitch|experimental subtarget]] ''wwitch'' for targeting the Freya abstraction layer used by the WonderWitch platform.
-===== Other sources =====
+===== Additional links =====
   * [[https://ws.nesdev.org/wiki/Main_Page|WSdev Wiki]] - hardware documentation
-  * [[https://github.com/WonderfulToolchain/awesome-wsdev|awesome-wsdev]] - link hub for WonderSwan-related homebrew projects
+  * [[https://codeberg.org/WonderfulToolchain/awesome-wsdev|awesome-wsdev]] - link hub for WonderSwan-related homebrew projects