User Tools

Site Tools


project:homebrew:wsbackuptool

WS Backup Tool

This utility allows you to:

  • Backup the console IPL / boot ROM,
  • Backup and restore cartridge data,
  • Backup, restore and erase cartridge save data (SRAM and EEPROM supported),
  • Reflash self-reflashable cartridges, like the WonderWitch (experimental).

Downloads

Instructions

If loading the .bfb program was successful, you should be greeted with the following option screen:

You shouldn't need to change the serial port speed from the 38400 bps default, but if you experience connection stability issues, feel free to change it to 9600 bps.

Console IPL / boot ROM backup

To create a console IPL / boot ROM backup:

  1. Initiate an XMODEM download on your PC.
  2. Select the Transfer IPL… option.
  3. Wait for the XMODEM download to finish.

Cartridge backup

To create a cartridge backup:

  1. Select the Cart Backup… option.
  2. Ensure that the cartridge configuration (ROM, SRAM, EEPROM size; ROM access width, speed) is correct.
    • The tool will try to auto-detect cartridge configuration based on its header. Most of the time, you should not need to change any option.
  3. Initiate an XMODEM download on your PC.
  4. To back up cartridge data, select Backup ROM…. To backup up save data, select the Backup SRAM…, or Backup EEPROM… option, depending on cartridge.
    • Most cartridges will only have SRAM or EEPROM, but not both.
  5. Wait for the XMODEM download to finish.

Cartridge restore

To restore cartridge save data from a backup:

  1. Select the Cart Restore… option.
  2. Ensure that the cartridge configuration (SRAM, EEPROM size; ROM access width, speed) is correct.
    • The tool will try to auto-detect cartridge configuration based on its header. Most of the time, you should not need to change any option.
  3. Select the Restore SRAM…, or Restore EEPROM… option, depending on cartridge.
    • Most cartridges will only have SRAM or EEPROM, but not both.
  4. Initiate an XMODEM upload on your PC.
  5. Wait for the XMODEM upload to finish.

Cartridge erase

To erase cartridge save data:

  1. Select the Cart Erase… option.
  2. Ensure that the cartridge configuration (SRAM, EEPROM size; ROM access width, speed) is correct.
    • The tool will try to auto-detect cartridge configuration based on its header. Most of the time, you should not need to change any option.
  3. Select the Erase SRAM…, or Erase EEPROM… option, depending on cartridge.
  4. Wait for the erase process to finish.

Cartridge reflash

TODO.

project/homebrew/wsbackuptool.txt · Last modified: 2024/04/09 14:03 by asie