cIOSX rev21d2x: Yet Another Hot Fix!!!!

cIOSX d2x

Quote

WARNING:

This post is outdated. To download the latest d2x release refer to the d2x google project.
Also see our tutorial how to install d2x.
However feel free to post your questions in this thread if you need support.

What is d2x?

This is the 6th version of our modified cIOSX rev21.
The modules EHCI, FAT, FFSP, ESP, DIP have been fixed to improve usb devices compatibility and nand emulation support, but they have been also extended to add some new cool features like IOS Reload block for DVD/USB/SD and fraglist support.
The new cIOS, obtained by replacing the original modules with these ones, is known as cIOSX d2x where d2x stands for davebaol, xabby666, and XFlak.
Davebaol and xabby666 are the authors of the 1st fix and also moderators of the HackWii community.
XFlak is a famous member of the GBAtemp community and the creator of the fabulous ModMii which is, among other things, also the official d2x wad builder. He had the original idea of replacing the EHCI module from rev21 with the one from rev19 (the last version known not to have the controller lag) and the lag disappeared.

We like to interpret d2x like a sort of chemical formula (like H2O) which is a nice metaphor where the 3 authors are the atoms that gave birth to this little project, the d2x molecule.
Yeah we know that literally in chemistry d2x means D--X--D just like h2o means H--O--H, so it's not the same as the acronym dxx.
But dudes, that's just a metaphor. So who cares. style_emoticons/default/happy.gif

Since d2x v2 davebaol takes care of the cios, XFlak (how would I do without you? style_emoticons/default/smile.gif ) follows the install tools and xabby666 is vanished into thin air. style_emoticons/default/sad.gif
However since d2x v5 new people are heavily contributing to d2x development, i.e. WiiPower and oggzee. style_emoticons/default/grog.gif Thanks guys, I'm glad to work with you!!!

Changelog:

Warning! Spoiler inside. 

• d2x v6: IOS Reload Block: The Ultimate Solution
  
  • DIP - Added fraglist to support potentially any file system (tnx oggzee).
    
  • DIP - Added support in fraglist for sector size greater than 512B (typically needed for HDD > 2TB).
    
  • DIP - Module moved forward in memory and ram section resized.
    
  • ESP - Module moved forward in memory.
    
  • FFSP - Module moved forward in memory.
    
  • EHCI - Fixed an annoying compatibility issue affecting many usb loaders.
    
  • Code clean up and other minor changes.

• d2x v5: IOS Reload Block for WBFS devices
  
  • DIP - Added USB/SD support for games affected by ios reload (WBFS only).
    
  • DIP - Added ioctl command to save module config from the ESP module before ios reload.
    
  • DIP - Added syscall 0x46 (check_di_reset)
    
  • DIP - Fixed dual layer detection for games like Sakura Wars.
    
  • DIP - Fixed GameCube audio streaming command for retail discs.
    
  • DIP - Added fatal error whether the base ios is unknown and can't be patched.
    
  • ESP - DIP config saved before an ios reload request coming from a disc-based game.
    
  • ESP - Added missing patches for base ios 53 and 55.
    
  • ESP - Added fatal error whether the base ios is unknown and can't be patched.
    
  • FFSP - Added fatal error whether the base ios is unknown and can't be patched.

• d2x v4: A mix of fix
  
  • ESP - Added "return to channel" feature compatible with all games out there, included problematic ones like PoP.
    
  • ESP - Fixed error 002 in method 2 for blocking ios reload.
    
  • ESP - Repeated ios reload are now supported by method 2.
    
  • ESP - Added support to reload any ios, not only 249.
    
  • FAT - Removed file logging code since has proved harmful to games like LostWinds and LostWinds WotM.
    
  • FAT - Added support for sector size up to 4KB (typically needed for HDD greater than 2TB).
    
  • FAT - Fixed a bug in FAT_GetStats. Now games like Max & the Magic Marker, FFCC My Life as a King and FFCC My Life as a Darklord are working properly.
    
  • FAT - Fixed the error code returned by FAT_Readdir when the requested folder is an existing file.
    
    Now all Strong Bad episodes are working properly.
    
  • FAT - Fixed a bug in FAT_Seek to prevent from increasing the file size when seeking out of the file.
    
  • FAT - Changed timing logic
    
  • FAT - Updated FatFs from 0.8 to 0.8b
    
  • FAT - Fixed a potential buffer overflow while reading a directory
    
  • FAT - Changes due to the fix for huge HDD made in EHCI module
    
  • FFSP - Removed workaround on file renaming since the issue has been fixed by updating FatFs into the FAT module
    
  • FFSP - Fixed the buffer length in FAT_ReadDir to avoid potential problems
    
  • EHCI - Fixed a bug to support HDD greater than 1TB
    
  • Other minor changes.

• d2x v3: Nand emulation improved
  
  • FFSP - Implemented logging system to make debugging easier (enabled in beta releases only).
    
  • FAT - Fixed a bug causing the error message "corrupted data" in The Tower of Druaga.
    
  • FAT - Fixed a bug causing stall in LIT.
    
  • FAT - Enabled multiple partition support in FatFs.
    
  • FFSP - Extended ioctlv commands for mounting the desired USB/SD partition on nand emulation start up.
    
    Default partition is 0 for backward compatibility with rev21.
    
  • FFSP - Fixed a bug on file renaming causing the failure on the 2nd save in games like The Will of Dr.Frankenstein.
    
  • FFSP - Fixed the deletion of folder /tmp on nand emulation start up.
    
  • FFSP - Fixed a bug in nand usage causing save file failure in games like Tetris Party and FFCC My Life as a King.
    
  • FAT & FFSP - Code clean up and other minor changes.

• d2x v2: No more lag on usb port 1
  
  • EHCI - Fixed secondary USB port lag (further information here)

• d2x v1: Goodbye controller lag
  
  • EHCI - Fixed controller lag (furher information here).
    
  • EHCI - Fixed wiimote synch delay on WiiFlow start up.
    
  • EHCI - Fixed os_restart_timer syscall invocation with the correct number of arguments.

New features and improvements

• IOS Reload Block: The Ultimate Solution
  
  With the IOS Reload Block feature and the new fraglist support games compatibility is now about 100%.
  It means you can now play through USB/SD all problematic games like CSI series, Call of Duty 3, Spliter Cell Double Agent and others that previously were not supported.
  Also, other less problematic games like Metroid Prime Trilogy are now fully playable without any restrictions.
  Finally alt.dol method is now useless and when resetting a game you'll get the expected behavior.
  Further information inside the spoiler.
  
  Warning! Spoiler inside. 

  
  IOS reload block with fraglist is always used for file systems other than WBFS (note that some usb loaders could use it for WBFS too) and requires a number of free nand blocks strictly proportional to the fragmentation level of the game on the device.
  In the worst case it can require up to 15 blocks, i.e. 240KB.
  However usually less than 1 block, i.e. 16KB, should be required.
  
  On the other hand, IOS reload block with pure WBFS (no fraglist) always requires 8 bytes.
  
  Of course the nand is written just before ios reload, so this doesn't affect games that never reload the ios, even if that feature is enabled.
  
  After ios reload has been performed all reload info are deleted from the nand.
  
  
• Return to Channel: The Universal method
  
  This feature is available since d2x v4beta4 and allows the user to return to a certain channel, instead of the system menu, when quitting a game.
  It's a clean solution and is compatible with all games out there, included problematic ones like Prince of Persia The Forgotten Sands.
  
  Warning! Spoiler inside. 

  You're too curious!!! style_emoticons/default/tongue.gif
  
  
• Nand emulation improvements
  
  VC/WiiWare NAND emulation compatibility has been improved a lot and now should be the same as rev17 or even better.
  To use multiple partitions support and emulated nand in any folder (not just the root) download Mighty Channels v11.1.
  Here is a short list of games that now work properly. Anyway I expect many others not working before now work too.
  
  Warning! Spoiler inside. 

  
  
  CODE
  WiiWare......................rev17...rev21.....d2x v1/v2.....d2x v3.....d2x v4
  
  ------------------------------------------------------------------------------
  Tetris Party..................OK.....ERR1........ERR1..........OK.........OK
  Brain Challenge...............OK.....ERR2........ERR2..........OK.........OK
  FFCC: My Life as a King.......OK.....ERR6........ERR6..........OK*1.......OK
  FFCC: My Life as a Darklord...OK.....ERR6........ERR6..........OK*1.......OK
  The Island of Dr.Frankenstein.OK.....ERR3........ERR3..........OK.........OK
  The Tower of Druaga...........OK.....ERR4........ERR4..........OK.........OK
  LIT...........................OK.....ERR5........ERR5..........OK.........OK
  LostWinds.....................ERR....ERR.........ERR...........ERR........OK*2
  LostWinds WotM................ERR....ERR.........ERR...........ERR........OK*2
  Max & the Magic Marker........OK.....ERR6........ERR6..........OK*1.......OK
  Strong Bad (all 5 episodes)...ERR6...ERR6........ERR6..........ERR6.......OK
  Swords and Soldiers...........ERR6...ERR6........ERR6..........OK*1.......OK*1
  
  Notes:
  ERR1 = Cannot save the game after each level
  ERR2 = Black screen soon after the logo if the save doesn't exist already
  ERR3 = Cannot save the game after the 1s time
  ERR4 = Error message "corrupted data" after the healthy screen
  ERR5 = Save file cannot be created and game stalls on main menu
  ERR6 = Black screen soon after the initial logo
  OK*1 = It works poperly for most of the nands but not for all.
  OK*2 = It works but sometimes still freezes while playing.
  
  
• Secondary usb port lag issue
  
  The secondary usb port lag issue, fixed by d2x v2, exists since rev19.
  You can easily replicate that issue through Rock Band 3 by following x4mer's instructions reported in the spoiler below:
  
  Warning! Spoiler inside. 

  
  QUOTE(x4mer @ Jan 30 2011, 05:35 PM)
  Could some people please try the microphone test I mentioned earlier, with RB3?
  
  
  You can just hum a long note, and keep it held till the drive blinks.
  
  
  QUOTE(x4mer @ Jan 29 2011, 11:58 PM)
  My wife was complaining that the mic kept cutting out, and thought there was something wrong with the mic. I tested it by starting a song in singer only mode, and then pausing it after the song started. By doing this, the mic stays active, and you should be able to hear everything you say coming out the speakers, without being drown out by the music. While doing this, the mic would cut out every time the HDD blinked, making it impossible to get 100% on singing as well. This convinced me that the EHCI is still causing havoc, although to a much lesser degree than it did before (Wario Shake It works now for instance).
  
  
  
  
• Controller lag issue
  
  The controller lag issue has been fixed by d2x v1 and it appeared the first time in cIOSX rev20 and it's still there in rev21, while it didn't exist in rev19.
  The problem occurs only with certain hard drives affected by slow spin up.
  For further details see the great thread by netspy about controller lag issue.

How to install d2x cIOSs

You can choose between 2 different methods to install d2x cIOSs.
Both are valid and achieve the same results. Just choose the one you prefer.

• Method 1: ModMii + Multi-Mod Manager
  
  This is the original method used to install d2x cIOSs since its birth.
  Personally it's my preferred one, but Windows is required.
  
  Warning! Spoiler inside. 

  
  

  

  
  

  • Download and install the last version of ModMii
    
    
  • Launch ModMii
    
    
  • Enter "I Agree"
    
    
  • Enter "4" to navigate to Download Page 4
    
    
  • If you can't see the last version of the cIOS d2x then download it from the link in the download section below and unpack the content of the folder "modules" inside ModMii's folder named "modules/d2x-beta". This way ModMii will use these modules in place of the ones distributed with ModMii itself.
    
    
  • Add to the download queue all the cIOSX rev21d2x wads you need, for example "249d2x56" and "250d2x57"
    
    
  • Enter "2" to navigate to Download Page 2
    
    
  • Enter "MMM" to add Multi-Mod Manager to the download queue
    
    
  • Enter "D" to download your chosen files
    
    
  • Enter "Y" to start downloading
    
    
  • Check that all the files are "valid" then enter "E" to exit ModMii.
    
    
  • Copy the files from the COPY_TO_SD folder to the root of your SD card and insert it into your Wii
    
    
  • Launch Multi-Mod Manager via the HomeBrew Channel.
    
    
  • Select "Load another IOS", then select IOS236 or any other patched IOS, typically IOS36 or a cIOS.
    
    
  • In Multi-Mod Manager's main menu, go down to select "WAD Manager".
    
    
  • Hold + for 2 seconds to select all the WADs in the folder. Then Press A twice to install them all.
    
    If any files fail to install properly, they will remain marked for installation, so just retry installing those files.
    NOTE: Be careful not to install any additional wads that may have been previously saved in this folder (they may be safe, but I cannot say for sure).
    
    
  • You're done. Enjoy d2x! style_emoticons/default/cool.gif

• Method 2: Homebrew Installer
  
  This is the official d2x cIOS Installer created by Dragbe and NutNut.and was made with the full support of the d2x team.
  This homebrew runs on the Wii and is an alternative to the ModMii method to install the d2x cIOSs.
  It's especially helpful for people without Windows and are therefore unable to run ModMii.
  Since v2.0 it can also install future beta versions of d2x cIOS by simply adding modules & ciosmaps.xml in the same folder of the boot.dol !
  
  Warning! Spoiler inside. 

  
  

  d2x cIOS Installer v2.1

  
  
  
  
  
  

  

  
  
  
  
  
  Features :
  

  • Allows to install the cIOS d2x v3 (rev21003), v4 (rev21004), v5 (rev21005), v6 (rev21006).
    
  • Allows to install additional beta versions or "hybrids" cIOS, without updating the Installer, by putting some files (modules .app + ciosmaps.xml) next to boot.dol.
    
  • Supported IOS bases: IOS37v5662, IOS38v4123, IOS53v5662, IOS55v5662, IOS56v5661, IOS57v5918, IOS58v6175.
    
  • Ability to choose the installation slot (200 to 255).
    
  • Ability to perform online and offline installations.
    
  • Support for SD/USB devices.
    
  • Support for Classic Controller, Wiimotes and GameCube controllers.
    
  • Support for <arg>--ios=XXX</arg> argument in meta.xml to set which IOS to use during installation process.

  Changelog :

  • Installer v2.1:
    
    - New icon (thx WiiD)
    - Added support of .wad files on SD/USB root for offline installation.
    - The Google Code project is now open.
    
  • Installer v2.0:
    
    - A new super cool GUI. style_emoticons/default/happy.gif
    - Code completely rewritten.
    - Some minors bugfixes in new code.
    - Added support for USB devices.
    - Correction of the warning text when a slot is already use by a cIOS.
    - Now update the used slot list after a successful installation of cIOS without restarting the Installer.
    - Come back to "Working IOS menu" in case of non-critical error.
    - Support for <arg>--ios=XXX</arg> argument in meta.xml to set which IOS to use during installation process.
    - Now allows you to add cIOS in the Installer without update it. You just have to put some files (modules .app + ciosmaps.xml) next to boot.dol of d2x cIOS Installer to support them. Like that, you can easily build d2x beta versions or "hybrids" cIOS with specifics modules you want (DIPP, EHCI, ES, FAT, FFSP, MLOAD, SDHC, USB).
    
  • Installer v1.3:
    
    - Replacement of cIOS d2x v6 beta1 by cIOS d2x v6 final.
    - Added support of Korean Common Key on cIOS d2x v6 for all bases (except IOS38) (Thx Damysteryman).
    - Extended support of Korean Common Key to previous version of d2x cIOS (v3 v4 & v5).
    
  • Installer v1.2:
    
    - Added d2x cIOS v5 final and v6 beta1.
    - Implementation of the new cIOS identification method (on the v4, v5 and v6beta1)
    
  • Installer v1.1:
    
    - Replacement of cIOS v4 beta4 by cIOS v4 final.
    - Small corrections
    
  • Installer v1.0:
    
    - Initial release

  To Do List & Known Issues :

  • To Do List:
    
    - Improve speed performance of d2x cIOS installer.
    - Add new argument in the meta.xml file to delete cache folder at the d2x cIOS installer exit.
    - Write a d2x cIOS installer documentation.
    
  • Known Issues:
    
    - It's impossible to downgrade revision of IOS/cIOS already installed if you use a cIOS without ES_Version patch (i.e: like cIOS Hermes) for the installation process.
    - If you haven't set the <arg>--ios=XXX</arg> argument in meta.xml and you are using USB device, as soon as you will do a IOS Reload on the "Working IOS menu", the cIOS Installer will ignore the USB device !

  How to add a new cIOS in the Installer :
  Since d2x cIOS Installer v2.0, it is possible to add cIOS without having to compile sources !
  This new functionality can be very useful for installing beta versions of cIOS or even create "hybrid" cIOS such as the cIOS d2x vX but with the EHCI and ES module vY style_emoticons/default/happy.gif
  
  To do this, you do not really need any programming skills apart from reading a .xml file and rename things. style_emoticons/default/tongue.gif
  So, to add a cIOS to the list, in addition to those already present, you have to grab the modules (file format .app) of the cIOS you want to build (look at ModMii's sources), place them in the right place on the SD/USB device and edit CIOSMAPS.xml file.
  
  In binaries, you will see a file named sampleCIOSMAPS.xml which is actually the "map" of the cIOS v6 d2x (a kind of installation guide for d2x cIOS Installer).
  Once opened with an XML editor, it's scary but there are only a few lines we are interested in:
  - <ciosgroup name="D2X v6" version="21006" basescount="7"> Here the tag name indicates the name that appears on the d2x cIOS Installer and version the final revision of cIOS (max = 65535). You can edit these two tags as you wish.
  - Then enter the spoiler of the IOS Base you want to install, for example IOS Base 37, I open the spoiler <ios base="37" version="5662" contentscount="22" modulescount="7">
  - Inside, the only lines that interest us are those that contain the tags module example: <content id="0x26" module="EHCI21006" tmdmoduleid="3"/>. If I want to change the EHCI module, I can simply change its name.
  If you put multiples new cIOS, dont forget to change the line <ciosmaps ciosgroupscount="1"> on the top !
  - Once the changes are done, save and rename the file sampleCIOSMAPS.xml in CIOSMAPS.xml
  
  - So now, let us see what to do with modules (.app files). The directory tree to use for storing modules mainly depends on the attribute name of the tag ciosgroup involved in the CIOSMAPS.xml. As an example, for a cIOS whith :
  
  CODE
  <ciosgroup name = "D2X vX beta1" ...
  

  I have to put its modules (.app files) in the directory :

  
  
  
  CODE
  <directory of d2x cIOS installer> D2X vX beta1
  
  

  style_emoticons/default/excl.gif Putting a space in the attribute name necessarily gives rise to a new directory style_emoticons/default/excl.gif
  
  If name="D2XvXbeta1" then the directory will be <directory of d2x cIOS installer> D2XvXbeta1

  
  
  
  
  - Verify that the modules' names match with those that you put in the CIOSMAPS.xml
  - It's over, the d2x cIOS Installer should see your new cIOS and if the modules are misplaced, he will tell you style_emoticons/default/wink.gif
  
  Download :
  
  d2x cIOS Installer v2.1: binary and source
  
  d2x cIOS Installer v2.0: binary and source
  
  d2x cIOS Installer v1.3: binary and source
  
  d2x cIOS Installer v1.2: binary and source
  
  d2x cIOS Installer v1.1: binary (source included)
  
  
  Dragbe's release page
  
  
  

  Enjoy everybody !!! style_emoticons/default/yaywii.gif

  
  
  
  
  

• The "return to channel" feature
  
  
  Warning! Spoiler inside. 

  To enable this feature the loader should call a custom es ioctlv specifying the title id to be launched in place of the system menu.
  Usb loader developers can easily integrate this feature with few lines of code inside the apploader process.
  Here is a code snippet:
  
  CODE
  static u64 sm_title_id ATTRIBUTE_ALIGN(32);
  
  
  sm_title_id = ..... // title id to be launched in place of the system menu
  vector[0].data = &sm_title_id;
  vector[0].len = 8;
  
  int ret = IOS_Ioctlv(es_fd, 0xA1, 1, 0, vector);
  if (ret==-101) {
  // feature not supported by the current cios
  // apply here the old "return to channel" method
  }
  
  Note that the command 0xA1 is unknown by all other cios that would return -101, namely EINVAL.
  In this case you should apply the old "return to channel" method.
  

• The "IOS reload block" feature
  
  This feature was already available in the last versions of Waninkoko's cios.
  However in d2x v4beta3 the method 2 used to block ios reload has been fixed to bypass error 002.
  Also it has been improved to block ios reloading multiple times. Finally the method 2 has been extended to support any slot, not only 249.
  NOTES:
  
  • d2x v4: this feature is only relevant to disc loading!!!
    
  • d2x v5: USB/SD are now supported as long as the device is wbfs formatted.
    
  • d2x v6: native fraglist allows support for non wbfs partitions.
  Warning! Spoiler inside. 

  
  To enable this feature the loader should call a custom es ioctlv possibly specifying the ios to be launched in place of the requested one.
  Usb loader developers can easily integrate this feature with few lines of code inside the apploader process.
  NOTE:
  Only use method 2 to enable ios reload block, i.e. pass mode=2 as first argument.
  Use method 0 to disable ios reload block.
  Method 1 never worked, so just ignore it.
  Here is a code snippet:
  
  CODE
  void block_ios_reload(bool enable)
  
  {
  int inlen = 1;
  int es_fd = IOS_Open("/dev/es", 0);
  
  if (es_fd < 0)
  return;
  
  static ioctlv vector[0x08] ATTRIBUTE_ALIGN(32);
  
  static int mode ATTRIBUTE_ALIGN(32);
  static int ios ATTRIBUTE_ALIGN(32);
  
  /* Set mode */
  mode = enable ? 2 : 0;
  vector[0].data = &mode;
  vector[0].len = 4;
  
  /* Set ios for mode 2 */
  if (enable) {
  inlen++;
  // NOTE:
  // The IOS to be launched in place of the requested one
  // is typically the cIOS already running on ARM processor.
  ios = IOS_GetVersion();
  vector[1].data = &ios;
  vector[1].len = 4;
  }
  
  IOS_Ioctlv(es_fd, 0xA0, inlen, 0, vector);
  
  IOS_Close(es_fd);
  }
  
  Note that Waninkoko's cios and d2x cios lower than v4beta3 ignore the second argument.
  On the other hand to preserve backward compatibility the second argument is optional for cios d2x v4beta3 or higher (249 is the default value).
  
  Further technical reading about error 002 and ios reloading:

  • http://gbatemp.net/t...ader-developers
    
  • http://gbatemp.net/i...howtopic=204045
    
  • http://gbatemp.net/t219243-neogamma-r9-bet...t&p=3604819

  During development and test I used NeoGamma R9 beta47.
  
  Here are a few games affected by ios reload:
  
  
  CODE
  Title Error 002
  
  ------------------------------------------------------------------------
  Call of duty 3 No
  CSI: Deadly Intent ?
  CSI: Hard Evidence No
  CSI: Fatal Conspiracy Yes
  Metroid Prime Trilogy Yes
  Sam & Max: Season One No
  Sam & Max: Season Two: Beyond Time and Space Yes
  
  

• Last d2x stable release
  
  • d2x v6 final mirror 1 and mirror 2

• Newer d2x betas
  
  • Currently not available.

• Older versions
  
  • d2x v6beta1
    
  • d2x v5 final mirror 1 and mirror 2
    
  • d2x v5beta1
    
  • d2x v5alpha1
    
  • d2x v4 final mirror 1 and mirror 2
    
  • d2x v4beta4
    
  • d2x v4beta3
    
  • d2x v4beta2
    
  • d2x v4beta1
    
  • d2x v3beta6
    
  • d2x v3beta5
    
  • d2x v3beta4
    
  • d2x v3beta3
    
  • d2x v3beta2
    
  • d2x v3beta1

• Waninkoko for the original source
  
• WiiPower and oggzee for their great ideas and contributions
  
• tueidj for the technical suggestions
  
• the HackWii and GBAtemp communities for all the beta tests and support provided
  
• dragbe for the homebrew installer
  
• Totoro for the official d2x logo, simply spectacular!
  
• and last but not least Actar, a bit spastic friend of mine, which has kindly created an alternative d2x logo.
  
  Open the spoiler at your own risk. style_emoticons/default/laugh.gif
  
  Warning! Spoiler inside. 

  

Edited by davebaol, 06 February 2012 - 10:37 AM.