project:homebrew:wsbootfriend:flashcart
BootFriend Installation (Cartridge)
- 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.
- Flash the downloaded
.wsc
file onto your cartridge. - Turn on the handheld with the cartridge inserted. Make sure the status bar at the top says
EEP unlocked
. - 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. - Select
Install BootFriend
and follow the on-screen instructions. - If successful, the right-hand side of the status bar at the top should now display
BF v.??
, with??
being the version number. - 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