User Tools

Site Tools


project:homebrew:wsbootfriend:flashcart

BootFriend Installation (Cartridge)

  1. Create a BootFriend splash screen on https://wonderful.asie.pl/ws/bootfriend/. When done configuring, select Download bootfriend-inst.wsc (Cartridge).
    • It is not necessary to change any configuration details; the default blank splash screen is sufficient.
  2. Flash the downloaded .wsc file onto your cartridge.
  3. Turn on the handheld with the cartridge inserted. Make sure the status bar at the top says EEP unlocked.
  4. 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.
  5. Select Install BootFriend and follow the on-screen instructions.
  6. If successful, the right-hand side of the status bar at the top should now display BF v.??, with ?? being the version number.
  7. 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.

Troubleshooting

  • To uninstall BootFriend, use the Disable BootFriend option.
  • Certain cartridges can disable splash screen display. This is why BootFriend's splash screen will not be loaded if using a cartridge with the BootFriend installer on it.
  • 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.
  • If the status bar does not say “EEP unlocked”, but instead “EEP locked”, that means writing to the splash screen area has been disabled by the boot ROM.
    • Launching the BootFriend installer through a “menu” program will not work. It must be installed directly to the flash cartridge.
project/homebrew/wsbootfriend/flashcart.txt · Last modified: 2024/03/29 18:15 by asie