User Tools

Site Tools


project:homebrew:wsbootfriend:witchos

BootFriend Installation (WonderWitch OS upgrade)

This method is no longer recommended, but has been preserved for historical reasons.

  1. Create a BootFriend splash screen on https://wonderful.asie.pl/ws/bootfriend/. When done configuring, select Download bootfriend-inst-wwsystem.bin (WonderWitch OS upgrade)
    • It is not necessary to change any configuration details; the default blank splash screen is sufficient.
  2. Turn on the console and start the WonderWitch cartridge in Freya Monitor mode. To do this, hold B while the console is turning on.
  3. Use TransMagic (or XMODEM transfer) to back up FreyaOS.
    • Select the Send System option.
    • If you forget to do this, you can find a copy of FreyaOS 1.2.0 on Qute's website (⇒ ダウンロード).
  4. Use TransMagic (or XMODEM transfer) to write bootfriend-inst-wwsystem.bin.
    • Select the Recv System option.
  5. Turn the console off, then on, to start the BootFriend installer program. Make sure the status bar at the top says EEP unlocked.
  6. Optional: If you have a custom splash screen installed, you may use the Backup IEEPROM options to copy the existing splash screen to cartridge SRAM or through XMODEM serial transfer to a file on your PC.
  7. Select Install BootFriend and follow the on-screen instructions.
  8. If successful, the right-hand side of the status bar at the top should now display BF v.??, with ?? being the version number.
  9. Turn off the console. BootFriend should now be installed - you can verify this by turning the console on with a different cartridge while holding Y3.
  10. To restore, use TransMagic (or XMODEM transfer) to write the FreyaOS copy created in step 3.
    • Select the Recv System option.

Troubleshooting

  • To uninstall BootFriend, use the Disable BootFriend option.
  • The console will not turn on at all if no cartridge is present in the cartridge slot.
  • The Test BootFriend option may be used to test loading .bfb programs without installing BootFriend - naturally, these programs won't have access to console functionality only available during boot ROM execution.
project/homebrew/wsbootfriend/witchos.txt · Last modified: 2024/03/29 18:20 by asie