Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Change the pathing of Wii mini #114

Draft
wants to merge 4 commits into
base: master
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
215 changes: 202 additions & 13 deletions docs/cios.md
Original file line number Diff line number Diff line change
@@ -1,26 +1,36 @@
---
outline: false
---

# cIOS

::::: tabs

:::: tab cIOS for Wii/Family Edition

::: details Technical Details (optional)

cIOS (Custom IOS) are IOS that are patched to allow custom functionality. While [cIOS](https://wiibrew.org/wiki/Custom_IOS) has largely been supplanted by AHBPROT, which gives complete hardware access, it still has useful applications. For example, this enables the functionality of USB loaders like USB Loader GX and WiiFlow, alongside other pieces of homebrew like SaveGame Manager GX. You can skip this process if you want, but generally it extends your Wii with little to no downsides.

:::

## Requirements

::: warning

This guide is only intended for Wii users.

If you have a Wii U (vWii), follow [this guide](cios-vwii) instead.

If you have a Wii mini, follow [this guide](cios-mini) instead.
Do not attempt to install a vWii/Wii mini IOS or System Menu on the Wii. Doing so will likely [brick](bricks#ios-brick) your console.

:::

* A Wii
## Requirements

* A Wii with the Homebrew Channel installed
* An SD card or USB drive
* [d2x cIOS Installer](/assets/files/d2x-cios-installer.zip)
* The [d2x cIOS Installer](/assets/files/d2x-cios-installer.zip)

::: warning

Ensure that if you are using an SD card, the lock switch is in the unlocked position, otherwise you will not be able to select the correct options in the installer.

:::

## Instructions

Expand Down Expand Up @@ -86,7 +96,7 @@ The WAD files should be on your SD card like this:
:::

::: info

The warning "`(c)IOS detected in slot ### will be overwritten`" can be safely ignored.

:::
Expand All @@ -113,12 +123,12 @@ The WAD files should be on your SD card like this:

::: info

If the slot is highlighted red, try install the cIOS again.
If the slot is highlighted red, try to install the cIOS again.

If you are getting an error before/during the downloading stages (eg. `tcp_connect timeout`, `net_gethostbyname failed: ...`), press B to exit and continue from [Section I](#section-i---downloading).

:::

1. Press `A`. This will return you to the configuration screen.
1. Repeat the previous 5 steps with the following configurations:

Expand Down Expand Up @@ -154,7 +164,7 @@ The WAD files should be on your SD card like this:
```

![](/images/cios/d2x_v11_251.png)

1. Once you have finished with all 4 cIOSes, press B to return to the Homebrew Channel.

::: info
Expand All @@ -170,3 +180,182 @@ Continue to [Open Shop Channel Installation](osc)
Now that your Wii has adequate brick protection, you can install the Open Shop Channel, a trusted repository for homebrew that can be accessed both on and off the Wii.

:::

::::

:::: tab cIOS for vWii (Wii U)


::: details Technical Details (optional)

cIOS (Custom IOS) are IOS that are patched to allow custom functionality. While [cIOS](https://wiibrew.org/wiki/Custom_IOS) has largely been supplanted by AHBPROT, which gives complete hardware access, it still has useful applications. For example, this enables the functionality of USB loaders like USB Loader GX and WiiFlow, alongside other pieces of homebrew like SaveGame Manager GX. You can skip this process if you want, but generally it extends your Wii with little to no downsides.

:::

::: warning

Do not attempt to install a Wii/Wii mini IOS or System Menu on the vWii. Doing so will likely [brick](bricks#ios-brick) your console.

:::

## Requirements

* A Wii U with the Homebrew Channel installed on the vWii
* An SD card
* The [d2x cIOS Installer](/assets/files/d2x_cIOS_Installer-vWii.zip).

::: warning

Ensure that if you are using an SD card, the lock switch is in the unlocked position, otherwise you will not be able to select the correct options in the installer.

:::

### Section I - Installing

1. Copy the `apps` folder in the d2x-cios-installer-vwii `.zip` to the root of your SD card or USB drive.
1. Reinsert your SD card or USB drive into your console.
1. Power on your console.
1. Launch the Homebrew Channel.
1. Launch d2x cIOS Installer from the list of homebrew.
1. Set everything to match the following:

```
Select cIOS <d2x-v11-beta1-vWii>
Select cIOS base <56>
Select cIOS slot <249>
```

<!-- ![](/images/cios/d2x_v11_249_vwii.png) -->

::: info

If you do not see `d2x-v11-beta1-vWii`, exit the installer with B, and make sure your SD card is unlocked.

:::

::: info

If you are seeing "`Slot ### already used in batch settings`" or "`cIOS already added in batch with revision ##### and slot ###`", press `-` to disable batch mode.

(If you are trying to exit the installer, the button is B, not Home.)

:::

1. Press `A`. This will bring you to the slot map:

![](/images/cios/d2x_summary.png)

1. Press `A` again.

![](/images/cios/d2x_installation.png)

1. After the installation has finished, you will be brought back to the slot map. Ensure that the slot that was just installed is highlighted green.

![](/images/cios/d2x_log.png)

::: info

If the slot is highlighted red, try to install the cIOS again.

:::

1. Press `A`. This will return you to the configuration screen.
1. Repeat the previous 5 steps with the following configurations:

+ cIOS 250 Installation

```
Select cIOS <d2x-v11-beta1>
Select cIOS base <57>
Select cIOS slot <250>
```

<!-- ![](/images/cios/d2x_v11_250_vwii.png) -->

+ cIOS 251 Installation

```
Select cIOS <d2x-v11-beta1>
Select cIOS base <58>
Select cIOS slot <251>
```

<!-- ![](/images/cios/d2x_v11_251_vwii.png) -->

1. Once you have finished with all 3 cIOSes, press B to return to the Homebrew Channel.

::: tip

Continue to [Finalizing Setup](vwii-finalizing-setup)

:::

::::

:::: tab cIOS for Wii mini

::: info

If you need help with anything regarding this tutorial, please join [the Wii mini Hacking Discord server](https://discord.gg/6ryxnkS) (recommended)

:::

::: details Technical Details (optional)

cIOS (Custom IOS) are IOS that are patched to allow custom functionality. While [cIOS](https://wiibrew.org/wiki/Custom_IOS) has largely been supplanted by AHBPROT, which gives complete hardware access, it still has useful applications. For example, this enables the functionality of USB loaders like USB Loader GX and WiiFlow, alongside other pieces of homebrew like SaveGame Manager GX. You can skip this process if you want, but generally it extends your Wii with little to no downsides.

This d2x cIOS installer was originally developed for the Wii U's vWii by DaveBaol and custom cIOS was created by Leseratte for the Wii mini. The original download page can be found [here](https://wii.leseratte10.de/d2xl-cIOS/). Leseratte's GitHub page can be found [here](https://github.com/Leseratte10/d2xl-cios). Please note that this cIOS is still experimental, though no problem with functionality has been reported.

:::

::: warning

Do not attempt to install a Wii/vWii IOS or System Menu on the Wii mini. Doing so will likely [brick](bricks#ios-brick) your console.

:::

## Requirements

* A Wii mini with the Homebrew Channel installed
* A USB drive
* The [d2xl cIOS Installer](/assets/files/d2xl_wii_mini_cIOS_installer_v1_beta2.zip)

## Instructions

### Section I - Downloading

1. Power off your console.
1. Insert your USB drive into your computer.
1. Create a folder named `apps` on the root of your USB drive if it does not already exist.
1. Copy the `d2x-cios-installer-mini` folder from the d2xl-cios-installer-mini `.zip` to the `apps` folder on your USB drive.
1. Reinsert your USB drive into your console.
1. Power on your console.
1. Launch the Homebrew Channel.
1. Launch d2xl cIOS Installer from the list of homebrew.

### Section II - Installing

1. Select `Continue`.
1. Set the options to the following:
```
Select cIOS <d2xl-v1-beta2>
Select cIOS base <57>
Select cIOS slot <249>
```

<!-- ![](/images/cios/d2x_v1_249_mini.png) -->

+ Take a note of the version number under notes (`IOS57-64-` ending in either `v31776` or `v31775`)
1. Press A to install.
+ If the install fails with a `TMD version mismatch` error, press left or right on the +Control Pad over the `Select cIOS base` option until the version number is different than the one you tried before. The number 57 will not change.
1. When the process is complete, exit the installer.

::: tip

[Continue to making a NAND Backup using RealWnd](wnd-mini)

:::

::::

:::::
22 changes: 21 additions & 1 deletion docs/hbc.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,8 @@ BootMii can be installed in two ways: directly to a part of the Wii bootloader c

::: warning

If you do not have an SD card, you cannot install nor use BootMii, regardless of whether you install it as IOS or boot2.
If you do not have an SD card, you cannot install nor use BootMii, regardless of whether you install it as IOS or boot2. This also means you cannot install bootmii on the Wii mini unless you have soldered an SD slot onto it.

You can always [install it later](hackmii).

:::
Expand All @@ -35,6 +36,12 @@ You can always [install it later](hackmii).

![](/images/hackmii/hbc_install_ok.png)

::: info

If you are on Wii mini, skip to step 10.

:::

1. Select `Back`, then select `BootMii`.

![](/images/hackmii/bootmii_install.png)
Expand Down Expand Up @@ -80,6 +87,8 @@ Note: When installing homebrew applications on your SD Card or USB drive, your f

`AppName1` and `AppName2` are placeholder names. Do not nest multiple `apps` folders inside the `apps` folder itself.

### Wii: Next Steps

::: tip

[Continue to making a NAND Backup using BootMii](bootmii)
Expand All @@ -93,3 +102,14 @@ Making a NAND backup at this point is highly recommended, as they can be used to
Tip: If a Wii has BootMii installed as boot2, your disc drive will flash very briefly after the immediate flash that happens when you press the POWER Button.

:::


### Wii mini: Next Steps

::: tip

[Continue to making a NAND Backup using RealWnd](wnd-mini)

Making a NAND backup at this point is highly recommended, as they can be used to recover from bricks.

:::
35 changes: 35 additions & 0 deletions docs/mini-finalizing-setup.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
# Finalizing Setup

Now that the Homebrew Channel, Priiloader, and cIOS are installed, we are going to finalize the setup.

### Additional Homebrew Apps

::: info

All homebrew apps are loaded from the Homebrew Channel.

:::

- Ethernet Enabler enables the use of a USB ethernet adapter on the Wii mini. Only adapters with the ASIX AX88772 chipset are supported on the Wii mini. Additionally, homebrew apps that need internet will require the use of a USB hub, preferrably one that can be externally powered.
- System Channel Restorer is a homebrew app that allows some channels usually only available on Wii to be easily installed on the Wii mini.
- Settings Editor GUI is an app that allows access to system settings without booting the Wii menu. On the Wii mini it can access settings that don't normally appear in the Wii mini system menu.

### Additional Homebrew Apps - What You Need

* [Ethernet Enabler](https://oscwii.org/library/app/Wii_Mini_Ethernet_Enable)
* [system-channel-restorer](https://oscwii.org/library/app/system-channel-restorer)
* [Settings Editor GUI](https://oscwii.org/library/app/Settings-Editor-GUI)

### Additional Homebrew Apps - Extracting Files to the SD Card

1. Copy the contents of the Ethernet Enabler to the root of the SD.
1. Copy the contents of the system-channel-restorer to the root of the SD.
1. Copy the contents of the Settings Editor GUI to the root of the SD.

::: tip

Continue to [Open Shop Channel Installation](osc)

Now that your Wii mini setup is complete, you can install the Open Shop Channel, a trusted repository for homebrew that can be accessed both on and off the Wii mini.

:::
4 changes: 1 addition & 3 deletions docs/wnd-mini.md
Original file line number Diff line number Diff line change
Expand Up @@ -88,9 +88,7 @@ If you would like to play Wii games online inside of dolphin with your Wii mini

::: tip

Continue to [Open Shop Channel Installation](osc)

Now that your Wii has adequate brick protection, you can install the Open Shop Channel, a trusted repository for homebrew that can be accessed both on and off the Wii.
Continue to [Finalizing Setup](mini-finalizing-setup)

:::

Expand Down