269
edits
Changes
Jump to navigation
Jump to search
GameCube Memory Manager (view source)
Revision as of 08:05, 23 September 2017
, 08:05, 23 September 2017Some formatting cleanup
Line 12:
Line 12:
A GameCube Memory Card manager.+Gcmm is a project started by dsbomb and justb, which is based on Askot's modification to add SD support to the mcbackup libogc example.+I (suloku) have updated the code to newest libraries to port it to the Wii system, and what I find more important: restoring savegames now works properly.+
−== FEATURES ==
+[What's New 1.4f - april 05, 2017 - By suloku]+[What's New 1.4e - february 27, 2016 - By suloku]+[What's New 1.4d - august 08, 2015 - By suloku]+[What's New 1.4c - january 05, 2014 - By suloku]+[What's New 1.4b - september 03, 2013 - By suloku]+[What's New 1.4a - october 18, 2012 - By suloku] - note: this is the date when the changes were made, official binary release was on February 15, 2013+[What's New 1.4 - october 08, 2012 - By suloku]+Lots of thanks to bm123456 and themanuel for beta testing and support!+
−[What's New 1.3 - september 14, 2012 - By suloku]
−
Lot's of thanks to Ralf at gscentral.org forums+http://board.gscentral.org/retro-hacking/53093.htm#post188949
−
−[What's New 1.2d - september 08, 2012 - By suloku]
−
[What's New 1.2c - september 06, 2012 - By suloku]+
[What's New 1.2b - september 06, 2012 - By suloku]+
[What's New 1.2a - september 06, 2012 - By suloku]+
[What's New 1.2 - september 06, 2012 - By suloku]+
[What's New 1.1 - august 29, 2012 - By suloku]+
Accepted PlabloACZ and Picachu025 modifications, with the following changes:+* Tweaked mount function
−* Filenames are no longer prefixed with a number for current sesion. Instead, savegames are suffixed with a number. When backing up a savegame if the same file exists on SD it will be prefixed with a growing number (if savegame_00.gci exists, then it will try savegame_01.gci, savegame_02.gci... and so on)
−* Infinite loop can't happen when backupping a savegame as in r11 MOD 2.
−
−[What's New r11 MOD 2 - September 11, 2011 - By Pikachu025]
[What's New r11 MOD - September 09, 2011 - By PabloACZ]+[What's New 1.0 - December 31, 2008]+
== CREDITS ==
+ +
}}
}}
−GCMM is a GameCube Memory Card Manager.
GameCube/Wii Memory Manager is an application to backup Nintendo GameCube savegames.
GameCube/Wii Memory Manager is an application to backup Nintendo GameCube savegames.
−GCMM is a project started by dsbomb and justb, which is based on Askot's modification to add SD support to the mcbackup libogc example.
−Suloku has updated the code to newest libraries to port it to the Wii system, and what I find more important: restoring savegames now works properly.
−== Features ==
* Backups and restores savegames into GCI format
* Backups and restores savegames into GCI format
* Restores savegames in GCS/SAV format
* Restores savegames in GCS/SAV format
Line 35:
Line 34:
* Open Source!
* Open Source!
−== UPDATE HISTORY ==
+== Changelog ==
−1.4f - April 5, 2017
* dragonbane0 made a mod of version 1.4c with folder selection and alphabetical sorting. Zephiles pointed this out and the changes have been merged with some little extra tweaks. Thanks you both!
* dragonbane0 made a mod of version 1.4c with folder selection and alphabetical sorting. Zephiles pointed this out and the changes have been merged with some little extra tweaks. Thanks you both!
−1.4e - February 27, 2016
* Fixed bug in card.c that prevented correct backup/write of saves with same filename but different case. Bug affected Timesplitters 2, probably Timesplitters 3 too. Thanks to DakuTree for reporting and Antidote for fixing.
* Fixed bug in card.c that prevented correct backup/write of saves with same filename but different case. Bug affected Timesplitters 2, probably Timesplitters 3 too. Thanks to DakuTree for reporting and Antidote for fixing.
−1.4d - August 8, 2015
* Fixed bug in card.c that prevented writing to the last block of the memory card, preventing restoring a savegame that would fill the memory card (thanks to undergroundmonorail)
* Fixed bug in card.c that prevented writing to the last block of the memory card, preventing restoring a savegame that would fill the memory card (thanks to undergroundmonorail)
* Fixed bug in card.c that prevented correct block freeing when deleting a file and only was fixed by using the memory card on official software (the wii/gamecube save manager or probably also games)
* Fixed bug in card.c that prevented correct block freeing when deleting a file and only was fixed by using the memory card on official software (the wii/gamecube save manager or probably also games)
Line 48:
Line 47:
* Changed button presses for single savegame delete to prevent unvoluntary savegame deleting
* Changed button presses for single savegame delete to prevent unvoluntary savegame deleting
−1.4c - January 5, 2014
* Disabled __sector_erase() check when raw restoring as some unofficial cards seem to have problems with it.
* Disabled __sector_erase() check when raw restoring as some unofficial cards seem to have problems with it.
−1.4b - September 3, 2013
* Card initialization was wrong all the way, wich lead to savegames of the same game of different region or those that shared similar filenames (Twilight Princess and WindWaker) to not work properly. Thanks to antidote.crk for noticing. (read considerations sections for more info)
* Card initialization was wrong all the way, wich lead to savegames of the same game of different region or those that shared similar filenames (Twilight Princess and WindWaker) to not work properly. Thanks to antidote.crk for noticing. (read considerations sections for more info)
* Added version display
* Added version display
−1.4a - February 15, 2013
* Fixed SD Gecko when inserted/swapped at slot selection screen in GameCube mode.
* Fixed SD Gecko when inserted/swapped at slot selection screen in GameCube mode.
* FLash ID display was missing a byte
* FLash ID display was missing a byte
Line 61:
Line 60:
* Made font sizes more coherent
* Made font sizes more coherent
−1.4 - October 8, 2012
* Animated icon alongside several (minor) graphical improvements
* Animated icon alongside several (minor) graphical improvements
* Ability to select SD Gecko slot in GameCube mode (just like Wii mode SD/USB prompt)
* Ability to select SD Gecko slot in GameCube mode (just like Wii mode SD/USB prompt)
Line 75:
Line 74:
* Added some special characters to the font (needed for savegame comments)
* Added some special characters to the font (needed for savegame comments)
* Minor code tweaks
* Minor code tweaks
+* Lots of thanks to bm123456 and themanuel for beta testing and support!
−1.3 - September 14, 2012
−* Shows card/image serial number in Raw Restore Mode
* Shows card/image serial number in Raw Restore Mode
* F-zero and Phantasy Star Online Ep I&II and Phantasy Star Online III savegames are patched uppon restoring so they will work on target card (by Ralf)
* F-zero and Phantasy Star Online Ep I&II and Phantasy Star Online III savegames are patched uppon restoring so they will work on target card (by Ralf)
+*Lot's of thanks to Ralf at [http://board.gscentral.org/retro-hacking/53093.htm#post188949 gscentral.org forums]
−1.2d - September 8, 2012
−* Previous version couldn't raw backup if backup folder didn't exist in sd/usb
* Previous version couldn't raw backup if backup folder didn't exist in sd/usb
* Added (double)overwrite prompt when restoring a savefile to memory card (Nano/Excelsiior's idea)
* Added (double)overwrite prompt when restoring a savefile to memory card (Nano/Excelsiior's idea)
Line 93:
Line 87:
* Use DejavuSans as font (much better readability) from GCMM+ by Nano/Excelsiior
* Use DejavuSans as font (much better readability) from GCMM+ by Nano/Excelsiior
−1.2c - September 6, 2012
−* Raw backups are now named with the number of blocks: insted of Backup_*timestamp*.raw now it is 0059b_*timestamp.raw, 2043b_*timestamp.raw...
* Raw backups are now named with the number of blocks: insted of Backup_*timestamp*.raw now it is 0059b_*timestamp.raw, 2043b_*timestamp.raw...
* Minor code changes (just for safety)
* Minor code changes (just for safety)
−1.2b - September 6, 2012
−* Solved a potential bug, 1.2 and 1.2a seemed unaffected by it.
* Solved a potential bug, 1.2 and 1.2a seemed unaffected by it.
−1.2a - September 06, 2012
−* 1.2 wasn't correctly freeing memory and eventually raw backup and restore would hang the app (a 2043 block card would make it hang at the second attempt to raw backup the card)
* 1.2 wasn't correctly freeing memory and eventually raw backup and restore would hang the app (a 2043 block card would make it hang at the second attempt to raw backup the card)
−1.2 - September 06, 2012
−* Added raw backup mode (in .raw format, compatible with dolphin and devolution)
* Added raw backup mode (in .raw format, compatible with dolphin and devolution)
* Added RAW/GCP/MCI support for raw restore mode
* Added RAW/GCP/MCI support for raw restore mode
Line 115:
Line 105:
* Raw mode works with official and unofficial cards, as well as gci mode (thanks to tueidj for pointing me in the right path!)
* Raw mode works with official and unofficial cards, as well as gci mode (thanks to tueidj for pointing me in the right path!)
−1.1 - August 29, 2012
−* Icon and banner by dronesplitter!
* Icon and banner by dronesplitter!
* Added USB-SD selection in wiimode (only at boot)
* Added USB-SD selection in wiimode (only at boot)
Line 123:
Line 112:
* Correctly displaying savegame Date information
* Correctly displaying savegame Date information
* Savegame information rearranged.
* Savegame information rearranged.
+*Accepted PlabloACZ and Picachu025 modifications, with the following changes:
+** Tweaked mount function
+** Filenames are no longer prefixed with a number for current sesion. Instead, savegames are suffixed with a number. When backing up a savegame if the same file exists on SD it will be prefixed with a growing number (if savegame_00.gci exists, then it will try savegame_01.gci, savegame_02.gci... and so on)
+** Infinite loop can't happen when backupping a savegame as in r11 MOD 2.
−r11 MOD 2 (Pikachu025) - September 11, 2011
−* R (GC-Pad) / 1 (Wiimote) now launches a "backup all" mode, where all saves on the memory card are written to the SD card without any user prompts in the meantime.
* R (GC-Pad) / 1 (Wiimote) now launches a "backup all" mode, where all saves on the memory card are written to the SD card without any user prompts in the meantime.
* I came across a couple saves that had ridiculous filenames that refused to write to SD, so if the program comes across one of those, it'll now write them out as "illegal_name" instead of the actual filename.
* I came across a couple saves that had ridiculous filenames that refused to write to SD, so if the program comes across one of those, it'll now write them out as "illegal_name" instead of the actual filename.
Line 136:
Line 124:
* I also (quite shoddily) edited the image listing all the options to add the new option, it's ugly but does its job. Feel free to fix, I don't have Photoshop or anything here.
* I also (quite shoddily) edited the image listing all the options to add the new option, it's ugly but does its job. Feel free to fix, I don't have Photoshop or anything here.
−r11 MOD (PabloACZ) - September 09, 2011
* SDGetFileList() function in sdsupp.c updated to reflect the changes in DevKitPPC/libogc from the last three years (diropen, dirnext and dirclose commands were replaced with opendir, readdir and closedir, respectively).
* SDGetFileList() function in sdsupp.c updated to reflect the changes in DevKitPPC/libogc from the last three years (diropen, dirnext and dirclose commands were replaced with opendir, readdir and closedir, respectively).
* Modified the MountCard() function in mcard.c to perform a probe on the GC Memory Card slot, to make sure it was mounted properly.
* Modified the MountCard() function in mcard.c to perform a probe on the GC Memory Card slot, to make sure it was mounted properly.
−* Improved the compatibility with GCS/SAV files with the patch posted by jcwitzel in December 2009 (http://code.google.com/p/gcmm/issues/detail?id=1#c25).
+* Improved the compatibility with GCS/SAV files with the [http://code.google.com/p/gcmm/issues/detail?id=1#c25 patch posted by jcwitzel in December 2009].
* The Makefiles were modified to include the zlib in the libraries section. It seems that the latest libFreeType PPC port needs it to work.
* The Makefiles were modified to include the zlib in the libraries section. It seems that the latest libFreeType PPC port needs it to work.
−* **Hopefully** Added compatibility with Official GameCube Memory Cards (see this: http://devkitpro.svn.sourceforge.net/viewvc/devkitpro?view=revision&revision=4049). According to a friend of mine, it works with a 256 blocks Memory Card.
+* **Hopefully** Added compatibility with Official GameCube Memory Cards ([http://devkitpro.svn.sourceforge.net/viewvc/devkitpro?view=revision&revision=4049 see this]). According to a friend of mine, it works with a 256 blocks Memory Card.
* Compiled with DevKitPPC r24, libogc 1.8.8, libfat 1.0.10 and libFreetype 2.4.2.
* Compiled with DevKitPPC r24, libogc 1.8.8, libfat 1.0.10 and libFreetype 2.4.2.
−1.0 - December 31, 2008
* Updated to libfat
* Updated to libfat
* Added Wii support
* Added Wii support
Line 154:
Line 142:
* Many other fixes/modifications for the user
* Many other fixes/modifications for the user
−== TO DO ==
+== To Do ==
* Add hotswapping (memory cards can be swapped, SD Gecko/SD/USB can't be swapped)
* Add hotswapping (memory cards can be swapped, SD Gecko/SD/USB can't be swapped)
−== ABOUT SAVEGAMES AND RAW IMAGES ==
+== About Savegames and Raw Images ==
−=== Raw Images ===
=== Raw Images ===
−A raw image is a 1:1 copy of the memory card. It can only be restored to the card it was made from.
A raw image is a 1:1 copy of the memory card. It can only be restored to the card it was made from.
Note that unofficial cards share the same Flash ID, which allows restoring raw images between unofficial cards (as long as they have the same size).
Note that unofficial cards share the same Flash ID, which allows restoring raw images between unofficial cards (as long as they have the same size).
−These limitations can be solved with Raw Tools: http://code.google.com/p/gcmm/wiki/Raw_Tools
+These limitations can be solved with [http://code.google.com/p/gcmm/wiki/Raw_Tools Raw Tools].
For example:
For example:
Line 172:
Line 158:
=== Protected Savegames ===
=== Protected Savegames ===
−This is just for information, as since GCMM 1.3 even serial protected savegames (F-Zero and Phantasy Star Online) can be restored to any memory card.
This is just for information, as since GCMM 1.3 even serial protected savegames (F-Zero and Phantasy Star Online) can be restored to any memory card.
Line 189:
Line 174:
As of 1.1 restored savegames mantain the savegame's original permisions (they are reseted when game is saved again anyways)
As of 1.1 restored savegames mantain the savegame's original permisions (they are reseted when game is saved again anyways)
−=== Other savegame formats ===
+=== Other Savegame Formats ===
−There are computer programs that can transform other savegame formats into GCI (currently GCMM supports SAV and GCS restoring).
There are computer programs that can transform other savegame formats into GCI (currently GCMM supports SAV and GCS restoring).
Line 197:
Line 181:
MCI format (createad by softdev's sdmc) is a raw image of the card (as GCP/RAW), preceded by a 64 byte header.
MCI format (createad by softdev's sdmc) is a raw image of the card (as GCP/RAW), preceded by a 64 byte header.
−== CONSIDERATIONS ==
+== Considerations ==
−Users:
Users:
* If you extract a device (USB, internal SD, USB gecko), it won't work againt. If you did so, reboot the GCMM. On the contrary
* If you extract a device (USB, internal SD, USB gecko), it won't work againt. If you did so, reboot the GCMM. On the contrary
Line 204:
Line 187:
* Dolphin (wii/gc computer emulator) has a nice memory card manager, check it out!
* Dolphin (wii/gc computer emulator) has a nice memory card manager, check it out!
−About usb devices:
+About USB devices:
−* Two of my usb devices won't work with GCMM, but those same devices make The Homebrew Channel crash. If you have problems try another usb device or an SD card.
+* Two of my USB devices won't work with GCMM, but those same devices make The Homebrew Channel crash. If you have problems try another usb device or an SD card.
Developers:
Developers:
Line 213:
Line 196:
* Very good sources of documentation are libogc and dolphin's source code.
* Very good sources of documentation are libogc and dolphin's source code.
−== SETUP & INSTALLATION ==
+== Setup and Installation ==
Unzip the archive. You will find the following folders inside:
Unzip the archive. You will find the following folders inside:
Line 222:
Line 205:
The savegames are read and stored to the following dir: sd:/MCBACKUP/
The savegames are read and stored to the following dir: sd:/MCBACKUP/
+
=== Wii ===
=== Wii ===
−On the Wii, the savegames will be read from and written to the front SD slot or FAT32 USB device.
On the Wii, the savegames will be read from and written to the front SD slot or FAT32 USB device.
The user will be prompted at startup for which device to use.
The user will be prompted at startup for which device to use.
Line 233:
Line 216:
== Loading/Running the app ==
== Loading/Running the app ==
−=== Wii - Via HBC ===
=== Wii - Via HBC ===
−The most popular method of running homebrew on the Wii is through the HBC. If you already have the channel installed, just copy over the apps folder included in the archive into the root of your SD card.
The most popular method of running homebrew on the Wii is through the HBC. If you already have the channel installed, just copy over the apps folder included in the archive into the root of your SD card.
Line 241:
Line 222:
=== Gamecube ===
=== Gamecube ===
−You can load gcmm via sdload and an SD card in slot A, or by streaming it to your Gamecube, or by booting a bootable DVD with gcmm on it.
You can load gcmm via sdload and an SD card in slot A, or by streaming it to your Gamecube, or by booting a bootable DVD with gcmm on it.
A good source for information on these topics is at http://www.gc-forever.com/wiki/index.php?title=Booting_Homebrew
A good source for information on these topics is at http://www.gc-forever.com/wiki/index.php?title=Booting_Homebrew
−== CONTROLS ==
+== Controls ==
−They are shown at the screen.
They are shown at the screen.
−====Raw mode controls:====
+====Raw Mode Controls====
Hold L (gamecube pad) or B (wiimote) then press the corresponding button
Hold L (gamecube pad) or B (wiimote) then press the corresponding button
* Raw Backup Mode: GC_pad L+Y , Wiimote B+Minus
* Raw Backup Mode: GC_pad L+Y , Wiimote B+Minus
Line 255:
Line 234:
* Format Card Mode: GC_pad L+Z , Wiimote B+2
* Format Card Mode: GC_pad L+Z , Wiimote B+2
−== COMPILING ==
+== Compiling From Source ==
−Currently gcmm uses:
Currently gcmm uses:
−* [http://sourceforge.net/projects/devkitpro/files/devkitPPC/ DevkitPPC r26]
−* DevkitPPC r26: http://sourceforge.net/projects/devkitpro/files/devkitPPC/
+* [http://sourceforge.net/projects/devkitpro/files/libogc libOGC 1.8.11 git (2012-07-25)]
−* libOGC 1.8.11 git (2012-07-25): http://sourceforge.net/projects/devkitpro/files/libogc
note: it compiles and runs fine with 1.8.11 release
note: it compiles and runs fine with 1.8.11 release
−* libfat 1.0.11: http://sourceforge.net/projects/devkitpro/files/libfat/
+* [http://sourceforge.net/projects/devkitpro/files/libfat/ libfat 1.0.11]
−* libFreeType 2.4.2 port: http://sourceforge.net/projects/devkitpro/files/portlibs/ppc/
+* [http://sourceforge.net/projects/devkitpro/files/portlibs/ppc/ libFreeType 2.4.2 port]
−== Credits ==
* SoftDev for his contributions to the GC/WII scene
* SoftDev for his contributions to the GC/WII scene
* Costis for helping with some doubts, he's allways there
* Costis for helping with some doubts, he's allways there
Line 279:
Line 255:
* Ralf at gscentral.org forums, for F-Zero and PSO savegame support.
* Ralf at gscentral.org forums, for F-Zero and PSO savegame support.
* bm123456 and themanuel for beta testing and support
* bm123456 and themanuel for beta testing and support
−* Lots of thanks thanks to everyone!
−Lots of thanks thanks to everyone!