Differences

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

--- project:homebrew:wsbootfriend [2024/03/31 08:27] – [Troubleshooting] 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 31: / Line 33: @@
 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.
-===== 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]]
 ===== List of available programs =====
@@ Line 41: / Line 38: @@
   * [[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 57: / 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 64: / 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]]