Differences

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

--- project:homebrew:wsbackuptool [2024/03/31 08:26] – [Cartridge erase] asie
+++ project:homebrew:wsbackuptool [2025/04/08 20:08] (current) – [Changelog] asie
@@ Line 10: / Line 10: @@
 ===== Downloads =====
-  * [[https://wonderful.asie.pl/ws/bootfriend/ws-backup-tool-v0.1.9.bfb|WS Backup Tool v0.1.9]] (20th February 2024)
+  * **[[https://wonderful.asie.pl/ws/bootfriend/ws-backup-tool-v0.2.2.bfb|WS Backup Tool v0.2.2]]** (8th April 2025)
+  * [[https://wonderful.asie.pl/ws/bootfriend/ws-backup-tool-v0.2.1.bfb|WS Backup Tool v0.2.1]] (11th June 2024)
   * [[https://github.com/asiekierka/ws-backup-tool|Source code]]
+  * [[https://github.com/asiekierka/ws-backup-tool/blob/main/COPYING|License]] (GPLv3+)
 ===== Instructions =====
@@ Line 67: / Line 69: @@
   - Wait for the erase process to finish.
-==== Cartridge reflash ====
+==== Cartridge flashing ====
+To flash cartridge data:
+  - Make sure your cartridge is //self-flashable// (supports the 2003 mapper's flashing protocol - port 0xCE), and that its flash chip is supported (see below).
+  - Select the ''Cart Flash (Expert)'' option.
+  - Set the ''Size'' to the size of the data you want to flash to the cartridge.
+    * Only data padded to a multiple of 64 kilobytes is supported.
+  - Set the ''Mode'' based on the flash chip used (see below)
+  - Select the ''Write Flash...'' option.
+  - Initiate an [[project:homebrew:wsbootfriend#xmodem_file_transfer_guides|XMODEM upload]] on your PC.
+  - Wait for the XMODEM upload to finish.
+  - Check the status message at the bottom.
+    - If it says ''Header bootable'', the cartridge will boot a WSC/SC correctly.
+    - If it says ''Header not bootable'', the cartridge will **not** boot a WSC/SC correctly. As the 2003 mapper does not support hot swapping, you **must** either reflash the cartridge without turning off the console, or risk having to use an external device to reflash it.
+Supported flash chips:
+  * generic flash chips using AAh/55h/A0h ("Regular" mode)
+  * Fujitsu MBM29DL400/MBM29DL800 ("WonderWitch" mode)
+  * Micron JS28Fxxx29EWx ("WSFM" mode)
+  * MX29L3211 ("MX29L3211" mode)
+Note that many "bootleg" cartridges do NOT properly implement port 0xCE, making flashing them impossible without using external hardware!
+===== Changelog =====
+=== v0.2.2 (8th April 2025) ===
+  * Added support for the 192000 baud UART transfer speed.
+  * Improved XMODEM transfer reliability.
+=== v0.2.1 (11th June 2024) ===
+  * Added support for flashing MX29L3211 chips.
+  * Fixed accelerated writing of MBM29DLx00 and JS28Fxx29EWx chips.
+  * Added "Header bootable"/"Header not bootable" warning.
+=== v0.2.0 (9th April 2024) ===
+  * Improve SRAM chip detection.
+  * Allow zeroing SRAM/EEPROM size values.
+=== v0.1.9 (20th February 2024) ===
+  * Allow pressing ''B'' to move to the end of the menu.
+  * Improve flashing code.
+  * Update toolchain.
-TODO.