diff --git a/docs/.vitepress/i18n/en_US.js b/docs/.vitepress/i18n/en_US.js index 07352e9b1..e69b13a37 100644 --- a/docs/.vitepress/i18n/en_US.js +++ b/docs/.vitepress/i18n/en_US.js @@ -14,6 +14,7 @@ const sidebar_extras = { { text: localeData.pages["block-updates"], link: `/block-updates` }, { text: localeData.pages["unblock-updates"], link: `/unblock-updates` }, { text: localeData.pages["dump-games"], link: `/dump-games` }, + { text: localeData.pages["installing-isfshax"], link: `/installing-isfshax` }, { text: localeData.pages["uninstall-cbhc"], link: `/uninstall-cbhc` }, { text: localeData.pages["uninstall-indexiine"], link: `/uninstall-indexiine` }, { text: localeData.pages["uninstall-payloadloader"], link: `/uninstall-payloadloader` } diff --git a/docs/.vitepress/i18n/strings/en_US.json b/docs/.vitepress/i18n/strings/en_US.json index 24296eb07..e71a8d291 100644 --- a/docs/.vitepress/i18n/strings/en_US.json +++ b/docs/.vitepress/i18n/strings/en_US.json @@ -32,6 +32,7 @@ "unblock-updates": "Unblocking Updates", "uninstall-cbhc": "Uninstall CBHC", "uninstall-indexiine": "Uninstall Indexiine", - "uninstall-payloadloader": "Uninstall PayloadLoader" + "uninstall-payloadloader": "Uninstall PayloadLoader", + "installing-isfshax": "Installing ISFSHax" } } diff --git a/docs/aroma/finalizing-setup.md b/docs/aroma/finalizing-setup.md index 59f526b3d..265237e98 100644 --- a/docs/aroma/finalizing-setup.md +++ b/docs/aroma/finalizing-setup.md @@ -67,3 +67,5 @@ However, if you find the need to boot into Tiramisu, for example, to use a legac 1. Launch the Wii U Menu by pressing A. - To make the console autoboot the Wii U Menu when loading the Tiramisu environment, press Y. 1. Homebrew Launcher can be loaded by launching the Mii Maker app. +

+# [Installing ISFShax (optional/advanced)](/installing-isfshax.html) diff --git a/docs/aroma/sd-preparation.md b/docs/aroma/sd-preparation.md index 56493b776..08ea84e1b 100644 --- a/docs/aroma/sd-preparation.md +++ b/docs/aroma/sd-preparation.md @@ -9,7 +9,7 @@ We will now place the required Aroma files on the SD Card. ::: warning -Your SD Card will need to be formatted as FAT32. If your SD Card is not formatted to FAT32, use [GUIFormat](http://ridgecrop.co.uk/index.htm?guiformat.htm) with 32k (32768) allocation unit size to format it. +Your SD Card will need to be formatted as FAT32. If your SD Card is not formatted to FAT32, use [Rufus on Windows](https://github.com/pbatard/rufus/releases/latest). **Do not** label the SD Card as `wiiu` or it will cause issues with homebrew. ::: diff --git a/docs/installing-isfshax.md b/docs/installing-isfshax.md new file mode 100644 index 000000000..02a42a934 --- /dev/null +++ b/docs/installing-isfshax.md @@ -0,0 +1,271 @@ +# Installing ISFShax (optional) +This page will guide you through installing ISFShax with Stroopwafel. + +::: warning +Although ISFShax is safe, even reliable once installed and can even protect you from bricks, it can be dangerous as it uses the ISFS superblocks to install itself. **You are on your own and you are installing this to your own risk.** To protect yourself against **boot1 updates** (which are long gone and could cause a brick), ISFShax disables them. General updates can still be installed, just not boot1 updates to prevent bricks. +::: + +## What is it for and how does it works? +ISFShax exploits the boot1 sector by replacing an ISFS (the filesystem that the SLC chip of your Wii U uses) which serves as a brick protection because, as you can guess, it installs itself in the first boot stage of a Wii U, giving you a "menu" (the minute menu) to troubleshoot stuff. What it **WON'T** do is fix an already existing brick. + +ISFShax can be used to: + +- Rebuilding / upgrading the MLC +- Removing 64GB MLC limit and disabling SCFM +- Brick protection (e.g. before doing region change) +- Cold booting redNAND (useful when when the eMMC is failing) +- It gives a minimal CFW, which can launch old homebrew using the homebrew launcher (not sure how useful since we have Aroma and Tiramisu) +- Stop the Wii U from turning the Tablet on during boot (using a stroopwafel plugin) +- Use partitioned HDDs / SD cards + +::: danger + +ISFShax will **NOT** protect you from bricks caused by: +- breaking boot1 +- seeprom bricks +- installing a bad ISFShax. + +::: + +There are multiple ways to install ISFShax (exploits), follow the appropriate guide. + +- If you use any CFW such as Tiramisu or Aroma, follow **Aroma**. +- If you have Haxchi or CBHC installed, follow **Haxchi** (although you should probably uninstall CBHC and/or Haxchi before doing this). +- If your browser still works and you can launch the browser exploit of u.wiidb.de, follow **Browser**. +- If you can't use the browser but Settings still work, follow **DNSpresso**. +- If your Wii U crashes in the initial setup on Mii creation, follow **DNSpresso**. +- If your Wii U can't launch the Browser at all or can't connect to the Internet, follow **UDPIH**. +- If none of the above works, use **Paid The Beak (PTB)**. + +## Prepairing the SD Card + +Windows hides file name extension by default. I highly recommend turning this feature off to avoid confusion.
+Make sure the SD card is formatted to FAT32 (already the case if you are using it for Homebrew).
+Cards up to 32GB come already with FAT32 from the factory. If you need to reformat them, I recommend using the offical formatter: Windows / Mac or Linux
+For cards above 32GB you can't use the official formatter: On Linux you can use gparted, on mac the built in DiskUtility.
On Windows, you have to use a third party tool like Rufus or if you have the latest Windows 11 you can use the command prompt (launch as Admin):
`format /FS:FAT32 X: (replace X with the letter of the SD card!)` + +A .zip archive is available on https://isfsh.ax, download it and extract everything inside of the "sd" folder to the root of your SD Card. Delete any unnecessary files using the tree of files right below. + +Your SD Card should look like this: + +```shell +boot1now.img (UDPIH Only) +recovery_menu (UDPIH Only) +launch.rpx (DNSpresso Only) +fw.img +ios.img +superblock.img +superblock.img.sha +wiiu + payload.elf (Browser, DNSpresso, and Aroma Only) + payloads (Browser, DNSpresso, and Aroma Only) + fw_img_loader + payload.elf + ios_plugins + 00core.ipx + 5isfshax.ipx + apps + fw_img_loader (Haxchi Only) + fw_img_loader.elf + icon.png + meta.xml +``` + +## Launching into minute + +::::: tabs + +:::: tab default Aroma + +**This tab is only for Aroma and Tiramisu CFW users! Please use the correct exploit unless you are on Aroma and/or Tiramisu!** + +1. Hold B on the GamePad if you have coldboot enabled, or go to the Health & Safety app and hold B there. +2. A black and white menu should show up asking you to choose a payload. +3. Choose `fw_img_loader` + +:::: + +:::: tab Haxchi + +**This tab is only for Haxchi and/or CBHC users! Please use the correct exploit unless you are on Haxchi or CBHC!** + +1. Load the Homebrew Launcher. +2. Launch the fw.img loader app. + +:::: + +:::: tab Browser + +**This tab is only for people that needs to go through the Browser exploit! Please use the correct exploit unless you use the Browser!** + +1. Open the Browser and browse to u.wiidb.de +2. Click on "HAXX" +3. Immediately hold B until you see the payload menu +4. Select the fw_img_loader + +:::: + +:::: tab DNSpresso +**This tab is only for people that needs to use the DNSpresso exploit! Please use the correct exploit unless you need to use the DNSpresso exploit!** + +If you can access the settings: + +1. On your Wii U head over to System Settings -> Internet -> Connect to the Internet and setup a new connection (Recommended!). +2. Go to (X) Connection List and select your newly created connection. +3. Select Change Settings -> DNS -> Do not auto-obtain. +4. Enter 85.215.57.182 as the Primary DNS and select Confirm. +5. Press (B) Back and select Connection Test. +6. Immediately hold B after starting the test until you see the payload menu +7. Select the fw_img_loader + +If you are stuck on the Mii creation in the Inital setup: + +1. If you already connected your Wii U to your AP / Router, turn the AP / Router or the Wifi on it off. +2. When the setup asks you if you already have a NNID, say yes (even if you don't have one) +3. Now it tries to connect to the Internet, but will fail and ask you to take you back to the Wifi settings, follow back to thge settings. +4. Turn your Router / AP on again and give it time to start. +5. If you don't already have your Wifi configured there, connect to it now, but enter a wrong password. +6. Edit your wifi connection and configure 85.215.57.182 as Primary DNS, if you entered a wrong password before set the right one now. +7. Press (B) Back and select Connection Test. +8. Immediately hold B after starting the test until you see the payload menu +9. Select the fw_img_loader + +:::: + +:::: tab UDPIH + +1. Load the recovery using UDPIH: https://gbatemp.net/threads/udpih-usb-host-stack-exploit-recovery-menu.613369/ (don't replace the recovery_menu) +2. The LED should turn purple and a countdown timer for loading boot1now.img should appear, wait the 5 seconds +3. Unplug your device +**Note:** If the LED turned purple, the UDPIH exploit worked, even if you don't see anything on the screen + +:::: + +:::: tab Paid The Beak (PTB) +Follow this: https://gbatemp.net/threads/how-to-use-paid-the-beak-wii-u-unbricking-without-soldering.673686/ + +:::: + +::::: + +Now you should see the minute main menu. If not, something went wrong. Make sure you have the correct fw.img file on the SD.
+In minute you move the cursor with the power button and enter with the eject button (swapped compared to the recovery menu).
+ +::: danger +ISFShax isn't installed yet! minute is just loaded temporarily and gone after a reboot. +::: + +Note: minute only outputs 1080p through HDMI, no picture on the gamepad, and nothing on the analog outputs.
+Some people reported that the screen output is not working for them when minute was loaded from the recovery_menu. If you made sure nothing else is the problem (right fw.img, TV supports 1080p HDMI), you can try following along blindly by pressing the appropriate buttons. Make sure to wait long enough between the presses, so the system has time to load. Without display output skip the first backup and go directly to Installing ISFShax. + +## Back up +If you already have an SLC backup or it is inconvenient for you to do one (no screen output), then you can skip this. + +1. Navigate to Backup and Restore +2. `Dump SEEPROM & OTP` (This will be needed for redNAND / region changing) +3. `Dump SLC.RAW` +4. Return to Main Menu + +## Installing ISFShax + +1. Choose `Boot 'ios.img'` (6x Power, 1x Eject) +2. Now the ISFShax installer should launch (this takes a few seconds) +3. Follow the Instructions on the screen, the buttons are the same as in minute. (3x Eject, 1x Power, 3x Eject) +4. The console should now turn off. +5. If the install was successful the Wii U should directly start into minute and the power LED on the console will be purple, once you turn it on. + +[Image of a successful ISFShax install](/docs/public/assets/img/guide/isfshaxsuccess.png) + +6. Press Eject to continue. + +## Backing up ISFShax (optional) +Dump the SLC.RAW again. This will overwrite the previous SLC.RAW file on the SD. This is required if you need to restore the SLC for unbricking, without loosing ISFShax. Keep that backup in a safe place.
+If you skipped the first Backup also backup OTP and SEEPROM now. + +## Booting +::: warning +**If you came here from the redNAND, the MLC rebuild or the Region Change guide continue with that tutorial now.** +::: + +For now your Wii U loads minute (fw.img), which then applies the required patches from SD card. (IOSU needs to be patched, so it doesn't fall over the ISFShax superblock).
+To boot into the Wii U OS select Patch (sd) and boot IOS (slc) <-- **This is the third option, not the first!**

+ +If your console just bootloops through minute over and over again, you are probably coldbooting Aroma and replaced the `wiiu/payload.elf` with the fw_img loader. Just replace the `wiiu/payload.elf` again with the Aroma one (applies to Tiramisu too). + +To make the Wii U booting automatically, without you having to press any buttons in the minute menu, you have to complete the "Autobooting with SD" section further down. + +## Autobooting with SD + +To make the Wii U autoboot with an SD card inserted you need to create the filesd:/minute/minute.ini (you might need to create the minute folder) with the following content: + +```ini +[boot] +autoboot=3 +autoboot_timeout=0 +``` + +The attached isfshax.zip file contains a few example minute.ini files for autobooting slc, sd or rednand. You can copy and rename the appropriate one. The files in the zip already have the .ini file name extension. if you don't see it, then DO NOT add it, as Windows is hiding it. + +You can adjust the timeout (in seconds) to your liking. The autoboot option specifies which entry from the minute menu will be loaded. 1 corresponds to Patch (slc) and boot IOS (slc), which loads the ios_plugins from the SLC (see below for how to setup the files on SLC). If you haven't installed them to the SLC or want to load them from the sd for another reason you can change that value to 3 which corresponds to Patch (sd) and boot IOS (slc) +

+As an Alternative check out the Fastboot option below. + +## Installing Aroma and/or Tiramisu if you didn't already + +To install Aroma or Tiramisu put the corresponding files on the SD.
+Tiramisu: https://tiramisu.foryour.cafe/
+Aroma: https://aroma.foryour.cafe/ (You don't need to have install Tiramisu to have Aroma, also the FTPiiU plugin will become handy later)
+Put the `5payldr.ipx` in the `ios_plugins` folder https://github.com/jan-hofmeier/wafel_payloader/releases (if you used the downloader, the plugin is already installed)
+ +## Optional: Installing Plugins to SLC (instead of SD) + +::::: tabs +:::: tab default haxcopy + +::: danger +If you are using haxcopy to update an existing install, make sure that the plugins have the same file name as before, else you might get duplicates, which can cause problems +::: + +::: warning +If you are redNAND user, remove the hax folder and creare a new one and copy the fw.img from the root of the SD into there, before running haxcopy. +::: + +The hax folder form the download contains the fastboot fw.img, which doesn't work with redNAND. By installing the normal minute and not having the ios_plugins folder on the menu, the Wii U will display the minute menu. + + +If you downloaded the files from isfsh.ax or used the download script, all the files where already put in the hax folder, so you can skip 1-5. Note that the download uses the fastboot minute (explained below). +1. Create a folder hax on the SD card (this will be copied to the slc) +2. Copy the fw.img to the hax folder +3. Create a subfolder ios_plugins in the hax folder +3. copy 00core.ipx it to the hax/ios_plugins folder +4. copy 5isfshax.ipx to the hax/ios_plugins folder +5. if you want to coldboot aroma or tiramisu, copy the 5payldr.ipx to hax/ios_plugins folder +6. If you need any other plugins like the wafel_unlimit.ipx, you have to rename and copy it to the hax/ios_plugins folder +7. Copy the [haxcopy app](https://github.com/isfshax/haxcopy/releases) to the wiiu/apps folder (like you usually install homebrew) +8. Put the SD in the Wii U and run haxcopy to copy the hax folder to the slc. + +:::: +:::: tab FTP + +On Aroma you have to make sure access to system files is enabled: +1. Open the Aroma Plugin Configuration Menu using L + Down + SELECT (-) on the GamePad or Pro Controller (or B + Down + Minus (-) for WiiMotes) +2. Open the FTPiiU option, then settings and set ‘Allow access to system files’ to ‘true’ by pressing A + +::: danger +If you are redNAND user only upload the fw.img and skip the ios_plugins. Also make sure to use the full minute and not the fastboot minute. +::: + +Uploading files: + +1. (Tiramisu only) Make sure that you're running FTPiiU Everywhere +2. Using a FTP client on your PC browse to /storage_slc/ +3. If you see a scfm.img file and sys folder go into the sys folder. If you see a bunch of folders (config import logs proc rights security title tmp) just go to the next step. +4. Create a subfolder hax and enter it +5. Make sure your FTP client is in binary mode (not ASCII mode) +6. upload the minute fw.img to the /storage_slc/sys/hax folder +7. create another subfolder ios_plugins in /storage_slc/sys/hax +8. enter that /storage_slc/sys/hax/ios_plugins folder +9. upload 00core.ipx +10. upload 5isfshax.ipx +11. upload 5payldr.ipx +12. If you need other plugins like the wafel_unlimit.ipx, you have to rename and upload them too \ No newline at end of file diff --git a/docs/public/assets/img/guide/isfshaxsuccess.png b/docs/public/assets/img/guide/isfshaxsuccess.png new file mode 100644 index 000000000..6f14e8c25 Binary files /dev/null and b/docs/public/assets/img/guide/isfshaxsuccess.png differ