1 files changed, 10 insertions, 6 deletions

@@ -1,8 +1,12 @@
-# GBA Link Cable Dumper
-A GC and Wii Homebrew App to get GBA BIOS, ROMs and saves via the GC GBA Link Cable.  
-Save Support based on SendSave by Chishm.  
-GBA BIOS Dumper by Dark Fader.  
+# GBA Gen3 Multiboot
+A GC and Wii homebrew app that sends a binary to the GBA using the different multiboot protocol used by the third generation of Pokémon games (Ruby, Sapphire, Emerald, FireRed, LeafGreen).
 
 # Usage
-Just have a GC Controller in Port 1 and a GBA without a game inserted or aborted game launch by holding select+start in Port 2. 
-The bin, gba and sav files dumped will be placed in a folder called "dumps" on your main device (SD Gecko on gamecube and SD/USB on Wii). Please note that dumping GBA ROMs can take a long time (32mb takes about 48 minutes) because of the cable protocol limitations, a estimation will be displayed on screen before you dump it as a reference.
+Have a GC Controller in Port 1 and a GBA with Gen3 game in Port 2.
+Put your payload code to do some interesting stuff with the Pokémon game you have in `gba` dir. Example code that changes first character of player name to 'z' on Pokémon Ruby English (v1.0-1.2) provided.
+Recompile, send to Wii or GC, turn on your GBA, hope that your code runs after the initial copyright screen of the game.
+(Code execution rate is for some reason not 100% reliable, PR to fix would be greatly appreciated. Sometimes KeyC derivation fails, sometimes GBA ignores the sent multiboot image, could be due to failure of a few different sends)
+
+# Acknowledgements
+Thanks to FIX94 for your multiboot game dumper, which the multiboot code is loosely based on (differences in crypto & protocol...)
+Without it, this would have taken longer to do than the 2 days or so that it took.
\ No newline at end of file