Wonderful Toolchain Wiki

User Tools

Site Tools

Trace: • index
wswan:index

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
wswan:index [2024/10/17 19:36] – [Subtargets] asiewswan: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: 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 ===== ===== Packages =====
Line 17: Line 15:
   * ''target-wswan'' - basic support metapackage   * ''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, stack and static data stored in IRAM; +  * [[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, stack and static data stored in IRAM; +  * [[https://wonderful.asie.pl/doc/libwsx/|libwsx]] - high-level utilities 
-  * ''wswan/medium-sram'' (experimental) - create a ROM with multiple code segments, stack stored in IRAM, static data stored in SRAM; +  * [[https://wonderful.asie.pl/doc/libww/|libww]] - WonderWitch API wrapper, for the ''wwitch'' subtarget
-  * ''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:wwitch|experimental subtarget]] ''wwitch'' for targeting the Freya abstraction layer used by the WonderWitch platform.+==== Toolchain documentation ====
  
-===== Libraries ===== +  * [[https://wonderful.asie.pl/doc/binutils-ia16/|binutils-ia16]] 
- +    * [[https://wonderful.asie.pl/doc/binutils-ia16/as.html|as Assembler]] 
-  * [[https://wonderful.asie.pl/doc/libws/|libws]] - low-level hardware library +    * [[https://wonderful.asie.pl/doc/binutils-ia16/ld.html|ld Linker]] 
-  * [[https://wonderful.asie.pl/doc/libwsx/|libwsx]] - high-level utility library +  * [[https://wonderful.asie.pl/doc/gcc-ia16/gcc-6.3.0/gcc/|gcc-ia16 6.3.0]] - C compiler 
-  * [[https://wonderful.asie.pl/doc/libww/|libww]] - WonderWitch API library +    * [[https://wonderful.asie.pl/doc/gcc-ia16/gcc-6.3.0/gcc/IA_002d16-Options.html|IA-16 Options]] 
-  * [[https://wonderful.asie.pl/doc/libwwcl/|libwwcl]] - WonderWitch compatibility layer +    * [[https://wonderful.asie.pl/doc/gcc-ia16/gcc-6.3.0/gcc/Named-Address-Spaces.html#IA_002d16-Named-Address-Spaces-1|IA-16 Named Address Spaces]] 
- +    * [[https://wonderful.asie.pl/doc/gcc-ia16/gcc-6.3.0/gcc/IA_002d16-Function-Attributes.html|IA-16 Function Attributes]] 
-===== Guides ===== +    * [[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) 
-  * These might become a tutorial one day (very work-in-progress): +  * [[https://wonderful.asie.pl/doc/gcc-ia16/gcc-6.3.0/cpp/|gcc-ia16 cpp 6.3.0]] - C preprocessor
-    * [[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+
  
 +==== Various notes ====
  
   * [[wswan:guide:memory_management|Memory management]] - working with banks and segmentation, controlling memory locations   * [[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:wfconfig|Project configuration]] - configuring the ROM header and others
   * [[wswan:guide:interrupt_handlers|Writing interrupt handlers]]   * [[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 
  
 +==== Design notes ====
  
   * [[wswan:guide:elf_quirks|ELF quirks]]   * [[wswan:guide:elf_quirks|ELF quirks]]
  
-===== Other documentation =====+===== Subtargets ===== 
 + 
 +The wswan target features multiple subtargets:
  
-  * [[https://wonderful.asie.pl/doc/binutils-ia16/|binutils-ia16]] +  * ''wswan/medium'' (default) - create a ROM with multiple code segments, the default, stack and static data stored in IRAM; 
-    * [[https://wonderful.asie.pl/doc/binutils-ia16/as.html|as Assembler]] +  * ''wswan/small'' - create a ROM with one code segment, slightly faster code but 64KB maximum code limit, stack and static data stored in IRAM; 
-    * [[https://wonderful.asie.pl/doc/binutils-ia16/ld.html|ld Linker]] +  * ''wswan/medium-sram'' (experimental) - create a ROM with multiple code segments, stack stored in IRAM, static data stored in SRAM; 
-  * [[https://wonderful.asie.pl/doc/gcc-ia16/gcc-6.3.0/gcc/|gcc-ia16 6.3.0]] - C compiler +  * ''wswan/small-sram'' (experimental) - create a ROM with one code segment, stack stored in IRAM, static data stored in SRAM; 
-    * [[https://wonderful.asie.pl/doc/gcc-ia16/gcc-6.3.0/gcc/IA_002d16-Options.html|IA-16 Options]] +  * ''wswan/bootfriend'' - special subtarget for creating [[https://wonderful.asie.pl/ws/bootfriend/|BootFriend]] executables which execute from RAM. 
-    * [[https://wonderful.asie.pl/doc/gcc-ia16/gcc-6.3.0/gcc/Named-Address-Spaces.html#IA_002d16-Named-Address-Spaces-1|IA-16 Named Address Spaces]] + 
-    * [[https://wonderful.asie.pl/doc/gcc-ia16/gcc-6.3.0/gcc/IA_002d16-Function-Attributes.html|IA-16 Function Attributes]] +In addition, there exists an [[wswan:guide:wwitch|experimental subtarget]] ''wwitch'' for targeting the Freya abstraction layer used by the WonderWitch platform.
-    * [[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)+
  
-===== Other sources =====+===== Additional links =====
  
   * [[https://ws.nesdev.org/wiki/Main_Page|WSdev Wiki]] - hardware documentation   * [[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
  
wswan/index.1729193791.txt.gz · Last modified: by asie