awesome-wsdev
A curated list of WonderSwan development resources.
https://github.com/WonderfulToolchain/awesome-wsdev
Last synced: 9 days ago
JSON representation
Accuracy test ROMs
Peripherals
- rtctest - "2003 mapper + S-3511" RTC protocol and behaviour
- WSCPUTest - V30MZ CPU behaviour
- WSHWTest - SoC interrupt/PPU timer handling
- WSTimingTest - V30MZ CPU timing
- ws-test-suite - asie's assorted hardware tests and testing tools
- Robert Peip's test ROMs - sprite priority/window testing tool
Documentation
Datasheets
- NEC V30MZ Preliminary User's Manual
- Seiko S-3511A - cartridge RTC.
- Fujitsu MBM29DL400TC - WonderWitch NOR flash.
- Seiko S-3511A - cartridge RTC.
- NEC V30MZ Preliminary User's Manual
Getting started
Other documentation
- splashbuilder readme - WonderSwan Color custom boot splash format.
WonderSwan hardware
- STSWS - contains some information not yet on the WSdev wiki.
- ws.nesdev.org wiki - the most recent and actively developed documentation source, the WSdev wiki!
- WSMan - older documentation source.
- Retail cartridges - cartridge logic analyzer and requirement documentation.
Emulators
Console
- ares
- Mednafen - 2.0) - supports WonderWitch and serial port emulation.
- WonderDroid Ultra - 2.0) - Mednafen wrapper for Android phones.
- NitroSwan - WonderSwan emulator for Nintendo DSi.
- StoicGoose - C#-based WonderSwan emulator.
Other documentation
- BizHawk - WonderSwan core based on Mednafen, features Lua scripting and rewind/movie support.
- wf-mednafen - fork of Mednafen with emulation fixes and debugger UI/UX improvements, based on mednafenPceDev's work.
- SwanGBA - GBA version of the above, does not run at full speed.
Peripherals
- WonderFence - MobileWonderGate internet adapter emulator.
Hardware development
Cartridges
- mbc-unlock - VHDL boot handshake implementation.
- Bandai2003 - Verilog "2003" mapper implementation.
- nileswan - Open-source flash cartridge.
- USB WonderSwan Cartridge Utility - cartridge dumper and programmer.
Other hardware development
- WonderSwan for MiSTer - 2.0)
- wsheadphone - BY-NC-SA-4.0) - Headphone DAC adapter.
- WSMtool - BY-NC-SA-4.0) - A multitool adapter for the WonderSwan. Headphone, serial and link cable adapter in one.
Screen capture
- nisetro_wsc - FPGA-based screen capture solution.
- swancolorHD - FPGA-based screen capture solution.
Historical
Other hardware development
- WSTech 2.4 - outdated document, incorrect in places.
Introduction
Getting started
- Wonderful Toolchain Wiki - documentation for the open-source WonderSwan/WonderWitch homebrew toolchain,
- ConsoleMods Wiki
Open source hardware
Peripherals
- WS-LinkC - BY-NC-SA-4.0) - cheap, DIY-friendly link cable alternative.
Screen capture
- swantroller - 3.0) - WonderSwan Color-based controller PCB for the swancolorHD.
Software development
Libraries
- libws - hardware abstraction functions
- libwsx - decompressors and other useful functions
- WonderSwan Total Sound Driver
- Cygnals - partially Furnace compatible audio driver.
Peripheral emulators
- Wonderful - gcc-ia16 based C/ASM toolchain for WonderSwan and WonderWitch.
Peripherals
- Wonderful - gcc-ia16 based C/ASM toolchain for WonderSwan and WonderWitch.
- Kyoui - (mirror) tools for compiling WonderSwan binaries using OpenWatcom.
- WSLink - NASM linker outputting WonderSwan and WonderWitch compatible binaries.
- owswan - OpenWatcom-based WonderSwan toolchain.
Tools
- bmp2swan - simple bitmap converter.
- Dekadence WonderSwan Tools - assorted Python scripts.
- splashbuilder - 3-Clause) - toolchain for creating custom WonderSwan Color boot splashes.
- SuperFamiconv - tile/map converter with flexible palette/optimization options and mostly-complete WS/WSC support.
- bmp2swan - simple bitmap converter.
- bmp2swan - simple bitmap converter.
Source code
Boilerplate
- Wonderful template - GCC/GAS-based template.
- wonder/template - NASM-based template.
Demos
Games
- Inufuto's games - written using a custom C-like toolchain.
- SwanDriving - driving-bw.html)) - tech demo written with NASM.
- WonderSnake - 3.0) - Snake game written with Borland TASM.
- Inufuto's games - written using a custom C-like toolchain.
- SwanDriving - driving-bw.html)) - tech demo written with NASM.
- WonderBreakanoid - Breakanoid-style game written with Wonderful.
Miscellaneous
- vgmswan - .VGM playback and conversion tools.
Other programs
- BootFriend - 3.0) - WonderSwan custom "firmware"/splash screen patch - XMODEM software load to RAM and more!
- wsmonitor - 80186 debug monitor.
- 144p Test Suite for WS - 3.0) - 240p Test Suite-inspired user-side testing tool
- Chips1 - CHIP-8/SuperCHIP emulator.
- ieepview - internal EEPROM viewer/editor.
- ws-backup-tool - 3.0) - cartridge backup/restore/flash tool and IPL dumper for BootFriend.
- ELKS - 2.0 + others) - Embedded Linux Kernel Subset kernel/operating system.
Test ROMs
Peripheral emulators
- KarnakTest - PCv2 KARNAK timer/ADPCM mapper testing
WonderWitch
Miscellaneous
- romwitch - 2.0) - utility to replace executables on "static" WonderWitch software images.
- MiracleMage - 2.0) - limited high-level WonderWitch emulator.
- wonderwitchvc15 - example on using Visual C++ 1.5 for compiling WonderWitch binaries.
- AthenaOS - FreyaBIOS/FreyaOS re-implementation project.
- ow-libs - WonderWitch standard library re-implementation project.
Open source WW programs
- FallingTower mini - 2-Clause)
- Nametry - 2-Clause)
- Noiz - 2.0-or-later)
- PutiPati - 2-Clause)
- Soari-san - 2-Clause)
- SpeedMac - 2-Clause)
- 米七note - 2-Clause)
- FallingTower mini - 2-Clause)
- Soari-san - 2-Clause)
- 米七note - 2-Clause)
WW documentation
- Don Walizer Jr's tutorials
- wonder/doc/freya - initial Freya internals documentation.
- Don Walizer Jr's tutorials
- Wonder Witch Technical Manual
- Wonder Witch Technical Manual
WW open-source homebrew
- dumpipl - WS/WSC initial program loader dumping tool (as "Soft" image).
- HummingCat - work-in-progress sound driver.
- vgmwitch - SN76489 music player.
- WWTerm - 2.0) - terminal emulator.
- yoppa - 3-Clause) - WWGP 2001 game.
WW tools
- exe2fbin - reconstruction of the official exe2fbin binary.