Skip to content

Commit

Permalink
add buttons to bluebomb.md
Browse files Browse the repository at this point in the history
  • Loading branch information
@playerjmr
playerjmr authored Sep 12, 2024
1 parent c61577e commit d78a024
Showing 1 changed file with 86 additions and 55 deletions.
141 changes: 86 additions & 55 deletions _pages/en_US/bluebomb.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -4,11 +4,13 @@ title: "BlueBomb"

{% include toc title="Table of Contents" %}

## BlueBomb Micro
{% capture bluebomb-classic %}

## BlueBomb Classic

{% capture technical_info %}
<summary><em>Technical Details (optional)</em></summary>
BlueBomb Micro is a port of Fullmetal5's BlueBomb exploit for the Rasperry Pi Pico W or ESP32, thus bypassing the need for a Linux system. It takes advantage of a flaw in the Wii and Wii mini's Bluetooth libraries. This port was made possible by [GaryOderNichts](https://github.com/GaryOderNichts)
BlueBomb is an exploit that takes advantage of a flaw in the Wii and Wii mini's Bluetooth libraries. Although it is the only exploit that works for the Wii mini, BlueBomb can run on the original Wii as well.

This exploit also enables recovery from certain bricks, such as banner bricks and (some) theme bricks.

Expand All @@ -29,12 +31,21 @@ Make sure that the console is close to the computer running the exploit, ideally
{: .notice--info}

### Requirements
* A Rasperry Pi Pico W or an ESP32 with BR/EDR (Classic) support.
* A USB flash drive formatted as FAT32.
* [The HackMii Installer](https://bootmii.org/download/)

A normal Rasperry Pi Pico will not work. It MUST to be the wireless model. Additionally, an ESP32 with a BLE only controller will not work.
{: .notice--info}
* A Linux machine
* A Virtual Machine may work, but it is not recommended due to its complexity in getting Bluetooth passthrough working. If possible, please use a LiveUSB as described below.
* If you have a Raspberry Pi, you can use that instead as it most likely has Linux installed already.
* Windows Subsystem for Linux or a Chromebook running Linux mode will *not work* as they don't have direct access to the Bluetooth adapter or USB ports.
* If you do not have Linux, [Ubuntu](https://ubuntu.com/download/desktop) is the most user-friendly option and can be ran on computers running Windows or Mac.
* 32-bit devices will require [Ubuntu 16.04](http://releases.ubuntu.com/16.04/).
* For 64-bit devices it is recommended to use the LTS edition due to its stability, but the latest release works as well.
* You can [flash a Linux Live environment to a USB flash drive](https://ubuntu.com/tutorials/tutorial-create-a-usb-stick-on-windows#1-overview) instead of installing it to your computer.
* A Bluetooth adapter.
* An internal Bluetooth adapter will work.
* If you do not have one, make sure to get one compatible with Linux.
* A USB flash drive formatted as FAT32.
* This cannot be the same flash drive used for your Linux Machine.
* [HackMii Installer v1.2](https://bootmii.org/download/)

### Instructions

Expand All @@ -52,41 +63,41 @@ A normal Rasperry Pi Pico will not work. It MUST to be the wireless model. Addit
![](/images/wii/SystemMenuVersion.png)

1. Power off your console.
1. Start your Linux distro, and ensure you are connected to the internet.
1. Open the Terminal
1. Run the following commands:

#### Rasperry Pi Pico W

1. Download [The latest Pre-Compiled Binaries](https://github.com/GaryOderNichts/bluebomb_micro/releases) from the releases page, and extract it to your PC.
1. Plug in your Pico W to your PC while holding down the `BOOTSEL` button. Your Pico should now show up as a drive on your PC.
1. Unzip the downloaded file and copy the file which matches your Wii or Wii mini to the drive. For example, if you have a European Wii running version 4.3, you would copy bluebomb_WII_SM4_3E.uf2, or if you have a European Wii Mini, you would copy bluebomb_MINI_SM_PAL.uf2, etc...
1. The drive should disconnect and your Pico is ready. You may unplug the device from your PC.

#### ESP32

1. Set up the latest [ESP IDF](https://docs.espressif.com/projects/esp-idf/en/stable/esp32/get-started/index.html).
1. Build the binary [from source](https://github.com/GaryOderNichts/bluebomb_micro/tree/main/ports/esp32#building-from-source).
1. [Flash the binary](https://github.com/GaryOderNichts/bluebomb_micro/tree/main/ports/esp32#flashing) to your ESP32.
1. Your device is now ready. You may unplug the device from your PC.

### Performing the Exploit
```bash
wget https://wii.hacks.guide/assets/files/bluebomb-helper.sh
chmod +x bluebomb-helper.sh
./bluebomb-helper.sh
```

1. Plug your flashed device back into your PC.
1. The helper will then download the required files, and ask for information about your console.
+ If you have selected a Wii mini you will be asked to provide your region. This can be determined by the last letter of the Wii Menu version (`U` for **USA** and `E` for **PAL** models).
+ If you have selected a Wii you will be asked to provide your Wii Menu Version (What you determined in step 4)
1. Power on your console.
+ **Do not** connect any Wii Remotes.
1. Press the Sync button repeatedly until the bluebomb screen shows up.
+ **Do not** connect any Wii Remotes.
1. Press the Sync button repeatedly until the terminal shows `got connection handle`.
+ This could take numerous attempts.
1. If the exploit was successful, your device will have loaded the HackMii Installer.
+ If you are not planning to use it later, you can now shut down your Linux distro.

If using a Wii: [Continue to Homebrew Channel and BootMii Installation](hbc)<br>
{: .notice--info}

If using a Wii mini: [Continue to Homebrew Channel installation](hbc-mini)
{: .notice--info}

## BlueBomb Classic
{% endcapture %}

{% capture bluebomb-micro %}

## BlueBomb Micro

{% capture technical_info %}
<summary><em>Technical Details (optional)</em></summary>
BlueBomb is an exploit that takes advantage of a flaw in the Wii and Wii mini's Bluetooth libraries. Although it is the only exploit that works for the Wii mini, BlueBomb can run on the original Wii as well.
BlueBomb Micro is a port of Fullmetal5's BlueBomb exploit for the Rasperry Pi Pico W or ESP32, thus bypassing the need for a Linux system. It takes advantage of a flaw in the Wii and Wii mini's Bluetooth libraries. This port was made possible by [GaryOderNichts](https://github.com/GaryOderNichts)

This exploit also enables recovery from certain bricks, such as banner bricks and (some) theme bricks.

Expand All @@ -107,21 +118,12 @@ Make sure that the console is close to the computer running the exploit, ideally
{: .notice--info}

### Requirements

* A Linux machine
* A Virtual Machine may work, but it is not recommended due to its complexity in getting Bluetooth passthrough working. If possible, please use a LiveUSB as described below.
* If you have a Raspberry Pi, you can use that instead as it most likely has Linux installed already.
* Windows Subsystem for Linux or a Chromebook running Linux mode will *not work* as they don't have direct access to the Bluetooth adapter or USB ports.
* If you do not have Linux, [Ubuntu](https://ubuntu.com/download/desktop) is the most user-friendly option and can be ran on computers running Windows or Mac.
* 32-bit devices will require [Ubuntu 16.04](http://releases.ubuntu.com/16.04/).
* For 64-bit devices it is recommended to use the LTS edition due to its stability, but the latest release works as well.
* You can [flash a Linux Live environment to a USB flash drive](https://ubuntu.com/tutorials/tutorial-create-a-usb-stick-on-windows#1-overview) instead of installing it to your computer.
* A Bluetooth adapter.
* An internal Bluetooth adapter will work.
* If you do not have one, make sure to get one compatible with Linux.
* A Rasperry Pi Pico W or an ESP32 with BR/EDR (Classic) support.
* A USB flash drive formatted as FAT32.
* This cannot be the same flash drive used for your Linux Machine.
* [HackMii Installer v1.2](https://bootmii.org/download/)
* [The HackMii Installer](https://bootmii.org/download/)

A normal Rasperry Pi Pico will not work. It MUST to be the wireless model. Additionally, an ESP32 with a BLE only controller will not work.
{: .notice--info}

### Instructions

Expand All @@ -139,28 +141,57 @@ Make sure that the console is close to the computer running the exploit, ideally
![](/images/wii/SystemMenuVersion.png)
1. Power off your console.
1. Start your Linux distro, and ensure you are connected to the internet.
1. Open the Terminal
1. Run the following commands:
```bash
wget https://wii.hacks.guide/assets/files/bluebomb-helper.sh
chmod +x bluebomb-helper.sh
./bluebomb-helper.sh
```
#### Rasperry Pi Pico W
1. The helper will then download the required files, and ask for information about your console.
+ If you have selected a Wii mini you will be asked to provide your region. This can be determined by the last letter of the Wii Menu version (`U` for **USA** and `E` for **PAL** models).
+ If you have selected a Wii you will be asked to provide your Wii Menu Version (What you determined in step 4)
1. Download [The latest Pre-Compiled Binaries](https://github.com/GaryOderNichts/bluebomb_micro/releases) from the releases page, and extract it to your PC.
1. Plug in your Pico W to your PC while holding down the `BOOTSEL` button. Your Pico should now show up as a drive on your PC.
1. Unzip the downloaded file and copy the file which matches your Wii or Wii mini to the drive. For example, if you have a European Wii running version 4.3, you would copy bluebomb_WII_SM4_3E.uf2, or if you have a European Wii Mini, you would copy bluebomb_MINI_SM_PAL.uf2, etc...
1. The drive should disconnect and your Pico is ready. You may unplug the device from your PC.
#### ESP32
1. Set up the latest [ESP IDF](https://docs.espressif.com/projects/esp-idf/en/stable/esp32/get-started/index.html).
1. Build the binary [from source](https://github.com/GaryOderNichts/bluebomb_micro/tree/main/ports/esp32#building-from-source).
1. [Flash the binary](https://github.com/GaryOderNichts/bluebomb_micro/tree/main/ports/esp32#flashing) to your ESP32.
1. Your device is now ready. You may unplug the device from your PC.
### Performing the Exploit
1. Plug your flashed device back into your PC.
1. Power on your console.
+ **Do not** connect any Wii Remotes.
1. Press the Sync button repeatedly until the terminal shows `got connection handle`.
+ **Do not** connect any Wii Remotes.
1. Press the Sync button repeatedly until the bluebomb screen shows up.
+ This could take numerous attempts.
1. If the exploit was successful, your device will have loaded the HackMii Installer.
+ If you are not planning to use it later, you can now shut down your Linux distro.
If using a Wii: [Continue to Homebrew Channel and BootMii Installation](hbc)<br>
{: .notice--info}
If using a Wii mini: [Continue to Homebrew Channel installation](hbc-mini)
{: .notice--info}
{% endcapture %}
<button class="btn btn--large btn--primary tabLink" onClick="select_tab(event, 'bluebomb-classic')"> BlueBomb Classic </button>
<button class="btn btn--large btn--info tabLink" onClick="select_tab(event, 'bluebomb-micro')"> BlueBomb Micro </button>
<div class="tabContent tabDefualt" id="bluebomb-classic" markdown="1"> {{ bluebomb-classic }} </div>
<div class="tabContent" id="bluebomb-micro" markdown="1"> {{ bluebomb-micro }} </div>
<script>
const tabContents = document.getElementsByClassName('tabContent');
const tabLinks = document.getElementsByClassName('tabLink');
for (tab of tabContents) { tab.style.display = 'none'; }
document.getElementsByClassName('tabDefault')[0].style.display = 'block';
function select_tab(event, tab_id)
{
for (tab of tabContents) { tab.style.display = 'none'; }
for (btn of tabLinks) { btn.className = btn.className.replace('btn--primary', 'btn--info'); }
document.getElementById(tab_id).style.display = 'block';
event.currentTarget.className = event.currentTarget.className.replace('btn--info', 'btn--primary');
}
</script>

0 comments on commit d78a024

Please sign in to comment.