Changes

Jump to: navigation, search

GCMM

53 bytes added, 08:05, 23 September 2017
Some formatting cleanup
{{cleanup|article|Needs cleanup and linked ZIP is 1.4d instead of 1.4e}}
{{Infobox homebrew
| title = GCMM
| type = system tool
| author = suloku
| version = 1.4d4f| download = https://github.com/suloku/gcmm/releases/download/1.4d/gcmm_1.4d.zip
| source = https://github.com/suloku/gcmm
| peripherals = {{Wiimote1}} {{GCNController}} {{FrontSDHC}} {{USBMSD}} {{SDGecko}} {{GCNMemoryCard}}
}}
A GCMM is a GameCube Memory Card managerManager.
GameCube/Wii Memory Manager is an application to backup Nintendo GameCube savegames.
Gcmm 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 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 ==
== Features ==
* Backups and restores savegames into GCI format
* Restores savegames in GCS/SAV format
* 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! 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.
[What's New 1.4d - august 08August 8, 2015 - By suloku]
* 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)
* Changed button presses for single savegame delete to prevent unvoluntary savegame deleting
[What's New 1.4c - january 05January 5, 2014 - By suloku]
* Disabled __sector_erase() check when raw restoring as some unofficial cards seem to have problems with it.
[What's New 1.4b - september 03September 3, 2013 - By suloku]
* 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
[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
* Fixed SD Gecko when inserted/swapped at slot selection screen in GameCube mode.
* FLash ID display was missing a byte
* Made font sizes more coherent
[What's New 1.4 - october 08October 8, 2012 - By suloku]
* Animated icon alongside several (minor) graphical improvements
* Ability to select SD Gecko slot in GameCube mode (just like Wii mode SD/USB prompt)
* Added some special characters to the font (needed for savegame comments)
* Minor code tweaks
* Lots of thanks to bm123456 and themanuel for beta testing and support!
Lots of thanks to bm123456 and themanuel for beta testing and support! [What's New 1.3 - september September 14, 2012 - By suloku] 
* 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)
*Lot's of thanks to Ralf at [http://board.gscentral.org/retro-hacking/53093.htm#post188949 gscentral.org forums]
Lot's of thanks to Ralf at gscentral.org forumshttp://board.gscentral.org/retro-hacking/53093.htm#post188949 [What's New 1.2d - september 08September 8, 2012 - By suloku] 
* 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)
* Use DejavuSans as font (much better readability) from GCMM+ by Nano/Excelsiior
[What's New 1.2c - september 06September 6, 2012 - By suloku] 
* 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)
[What's New 1.2b - september 06September 6, 2012 - By suloku] 
* Solved a potential bug, 1.2 and 1.2a seemed unaffected by it.
[What's New 1.2a - september September 06, 2012 - By suloku] 
* 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)
[What's New 1.2 - september September 06, 2012 - By suloku] 
* Added raw backup mode (in .raw format, compatible with dolphin and devolution)
* Added RAW/GCP/MCI support for raw restore mode
* Raw mode works with official and unofficial cards, as well as gci mode (thanks to tueidj for pointing me in the right path!)
[What's New 1.1 - august August 29, 2012 - By suloku] 
* Icon and banner by dronesplitter!
* Added USB-SD selection in wiimode (only at boot)
* Correctly displaying savegame Date information
* 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.
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 (Pikachu025) - September 11, 2011 - By Pikachu025]
* 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 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.
[What's New r11 MOD (PabloACZ) - September 09, 2011 - By PabloACZ]
* 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.
* 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)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.
* **Hopefully** Added compatibility with Official GameCube Memory Cards (see this: [http://devkitpro.svn.sourceforge.net/viewvc/devkitpro?view=revision&revision=4049see 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.
[What's New 1.0 - December 31, 2008]
* Updated to libfat
* Added Wii support
* 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)
== ABOUT SAVEGAMES AND RAW IMAGES About Savegames and 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.
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_ToolsRaw Tools].
For example:
=== 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.
As of 1.1 restored savegames mantain the savegame's original permisions (they are reseted when game is saved again anyways)
=== Other savegame formats Savegame Formats === 
There are computer programs that can transform other savegame formats into GCI (currently GCMM supports SAV and GCS restoring).
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:
* 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
* Dolphin (wii/gc computer emulator) has a nice memory card manager, check it out!
About usb USB devices:* Two of my usb 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:
* 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:
The savegames are read and stored to the following dir: sd:/MCBACKUP/
 
=== Wii ===
 
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.
== Loading/Running the app ==
 
=== 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.
=== 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.
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.
====Raw mode controls:Mode Controls====
Hold L (gamecube pad) or B (wiimote) then press the corresponding button
* Raw Backup Mode: GC_pad L+Y , Wiimote B+Minus
* Format Card Mode: GC_pad L+Z , Wiimote B+2
== COMPILING Compiling From Source == 
Currently gcmm uses:
 * DevkitPPC r26: [http://sourceforge.net/projects/devkitpro/files/devkitPPC/DevkitPPC r26]* libOGC 1.8.11 git (2012-07-25): [http://sourceforge.net/projects/devkitpro/files/libogclibOGC 1.8.11 git (2012-07-25)]
note: it compiles and runs fine with 1.8.11 release
* libfat 1.0.11: [http://sourceforge.net/projects/devkitpro/files/libfat/libfat 1.0.11]* libFreeType 2.4.2 port: [http://sourceforge.net/projects/devkitpro/files/portlibs/ppc/ == CREDITS ==libFreeType 2.4.2 port]
== Credits ==
* SoftDev for his contributions to the GC/WII scene
* Costis for helping with some doubts, he's allways there
* Ralf at gscentral.org forums, for F-Zero and PSO savegame support.
* bm123456 and themanuel for beta testing and support
 * Lots of thanks thanks to everyone!
269
edits

Navigation menu