asie's personal wiki

User Tools

Site Tools

Trace: • wsbootfriend
project:homebrew:wsbootfriend

This is an old revision of the document!

Table of Contents

BootFriend is a custom “firmware” solution compatible with the WonderSwan Color and SwanCrystal handheld consoles. It provides a custom splash screen with the following features:

  • Customize the logo through a web editor (including setting a faster boot time),
  • Load .bfb programs to RAM via serial port - this is similar to the GBA's “Multiboot” functionality,
  • Launch Pocket Challenge V2 cartridges on WonderSwan consoles in “pin-strap mode”.
  • Use the installer to “unbrick” consoles with corrupted internal EEPROMs.

Installation

The installation process depends on what devices you own.

Loading .bfb programs

Loading .bfb programs requires a serial port adapter. Multiple solutions exist:

  • The official RS-232 adapter bundled with the WonderWitch.
  • ExtFriend - DIY, based on the RP2040/Raspberry Pi Pico, can be built at home for about $10-$15.
  • RetroOnyx USB Link Cable - $85 as of writing, high quality.

List of available programs

  • WS Backup Tool - backup/restore boot ROM, game data and save data
  • WSMonitor - rudimentary debugger, allows examining the state of memory and I/O ports before boot ROM lockout. Documentation and source code is available here.
project/homebrew/wsbootfriend.1711722130.txt.gz · Last modified: 2024/03/29 14:22 by asie