Differences

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

--- project:homebrew:wsbootfriend [2024/03/29 18:23] – [Installation] asie
+++ project:homebrew:wsbootfriend [2024/03/31 09:10] (current) – [Other features] asie
@@ Line 5: / Line 5: @@
   * Launch Pocket Challenge V2 cartridges on WonderSwan consoles in "pin-strap mode".
   * Use the installer to "unbrick" consoles with corrupted internal EEPROMs.
+If you're new to BootFriend, you most likely want to follow the //Installation// section, followed by the //List of available// .bfb //programs//.
 ====== Installation ======
@@ Line 30: / Line 32: @@
   * [[https://www.retroonyx.com/product-page/wonderswan-usb-link-cable|RetroOnyx USB Link Cable]] - $85 as of writing, high quality.
-To load a .bfb program, first initiate a 38400 bps XMODEM file transfer on the PC side, then turn on the console with BootFriend installed. Some guides are available to help:
+To load a .bfb program, first initiate a 38400 bps XMODEM file transfer on the PC side, then turn on the console with BootFriend installed.
-  * [[https://twitter.com/peca_port0/status/1631583554621820928|Using Tera Term and ExtFriend on Windows (Japanese)]]
-  * [[project:homebrew:wsbootfriend:lrzsz|Using lrzsz on Linux]]
 ===== List of available programs =====
   * [[project:homebrew:wsbackuptool|WS Backup Tool]] - backup/restore boot ROM, game data and save data
   * [[https://wonderful.asie.pl/ws/bootfriend/wsmonitor.bfb|WSMonitor]] - rudimentary debugger, allows examining the state of memory and I/O ports //before// boot ROM lockout. Documentation and source code is available [[https://bitbucket.org/trap15/wsmonitor|here]].
+===== XMODEM file transfer guides =====
+  * [[https://twitter.com/peca_port0/status/1631583554621820928|Using Tera Term and ExtFriend on Windows (Japanese)]]
+  * [[project:homebrew:wsbootfriend:lrzsz|Using lrzsz on Linux]]
+  * [[project:homebrew:wsbootfriend:minicom|Using minicom on Linux]]
 ===== Troubleshooting =====
@@ Line 49: / Line 54: @@
   * C - transfer cancelled by sending side,
   * D - received file has invalid format,
-  * R - the received file's requested RAM area is out of permitted range.
+  * R - the received .bfb program's requested RAM area is out of permitted range.
 ====== Other features ======
@@ Line 55: / Line 60: @@
   * To verify BootFriend's installation status and version, hold Y3 on boot. If BootFriend is installed, the version of the firmware will be displayed on screen.
   * To launch cartridges in Pocket Challenge V2/"pin-strapped" mode, hold Y1 on boot.
+  * The BootFriend installer can be repurposed to [[project:homebrew:wsbootfriend:customsplash|write any custom splash/internal EEPROM backup]] to the console.
 ====== Unbricking ======
@@ Line 62: / Line 68: @@
   * Corrupt splash screen data - manifests by glitched graphics or sound in the splash screen (with the console otherwise functioning correctly) or the console failing to load a game cartridge (but executing the splash screen code). This can be fixed by using the BootFriend installer to ''Disable Custom Splash'', or by installing BootFriend in place of the custom splash.
   * Corrupt TFT panel configuration (SwanCrystal only) - manifests by panel malfunction (part of the screen not being visible, LCD segments not working, etc.) throughout operation (including outside the splash screen). A fix can be attempted by using the BootFriend installer's ''SwanCrystal TFT recovery'' option. **Note that warranty is not provided! There is no guarantee this fix will work correctly.**
+====== Creating .bfb programs ======
+The [[https://wonderful.asie.pl/wiki/doku.php?id=wswan:index|Wonderful toolchain]] supports building .bfb programs out of the box:
+    $ wf-wswantool project new -t bootfriend my_bfb_program/
+You can also create .bfb programs with any 80186-compatible assembler. The file format is documented [[https://github.com/WonderfulToolchain/ws-bootfriend/blob/main/README.md|here]].
+====== Links ======
+* [[https://github.com/WonderfulToolchain/ws-bootfriend|Source code]]