Skip to content

GaryOderNichts/udpih

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

USB Descriptor Parsing Is Hard (UDPIH)

Exploits the Wii U's USB Host Stack descriptor parsing. Pronounced like "mud pie" without the M.

The write-up can be found here!

Requirements

  • A Wii U

  • One of the devices listed below

    Note: Any other linux device capable of USB device emulation should work as well.
    Prebuilt releases and instructions are only available for tested devices. I will add more devices below which are confirmed to work.

Supported devices:

  • Raspberry Pi Pico
  • Raspberry Pi Zero (W) / A / A+ / Zero 2 W / 4 / 5
  • Steam Deck
  • Nintendo Switch capable of running udpih_nxpayload

Instructions

Device Setup

Follow the setup guide for the device you want to use below:

Booting the recovery_menu

⚠️ Important notes for this to work:

  • Make sure no other USB devices are attached to the console.
  • Only use USB ports on the front of the console, the back ports will not work.
  • If your console has standby mode enabled, pull the power plug and turn it on from a full coldboot state.
  • Copy the latest release of the recovery_menu to the root of your FAT32 formatted SD Card.
  • Insert the SD Card into the console and power it on.
  • As soon as you see the "Wii U" logo on the TV or Gamepad plug in your prepared UDPIH device.
    This timing is important. If you're already in the menu, the exploit won't work.
    Depending on the device, you might have to plug it in sooner or later. This might take several attempts.
    If you get no video output or a distorted screen, your timing was most likely wrong.
  • After a few seconds you should be in the recovery menu.

Check out the recovery_menu README for more information about this menu.

Building

# build the docker container
docker build -t udpihbuilder .

# build the pico code
docker run -it --rm -v ${PWD}:/project udpihbuilder make pico

# to only build the arm kernel code
docker run -it --rm -v ${PWD}:/project udpihbuilder make arm_kernel

Special thanks to Maschell, rw-r-r-0644, QuarkTheAwesome, vgmoose, exjam, dimok789, and everyone else who contributed to the Wii U scene!