piuio-pico (brokeIO edition)

This is a Pump it Up IO board (PIUIO) clone based on the RP2040 microcontroller.

This has been adapted for the RP2040 variant of the brokeIO, Bedrock's replacement for obsolete Korean hardware IO.

brokeIO Features

• Drop-in PIUIO replacement
• Multiple USB modes: PIUIO, Gamepad (DInput), LXIO, Keyboard, XInput, Nintendo Switch
• Built-in debouncing
• 1000Hz polling rate (in theory)
• Updatable through USB, no separate tool required

Firmware Setup

Steps tested on WSL and thus should work on Linux also:

• Add the SDK via your method of choice (see the pico-sdk repo, though by default the below steps should download the SDK)
• (If downloading the SDK separately from a Git repository) Run git submodule update --init inside the SDK directory to set up the other required libraries (namely tinyusb)
• Create the "build" folder inside the "piuio-pico" folder.
• Inside the build folder, run cmake .., then run make -j`nproc`. You'll get a .UF2 file in the build folder that you can upload!
• With the brokeIO unplugged from the PC, hold the "BOOT" button on the brokeIO, then plug in the brokeIO (or while plugged in, press the "RESET" button).
• The brokeIO will now show up as a removable drive in your OS (RPI-RP2). Copy the .UF2 file onto the drive, and the code will be uploaded!

The last two steps can be done to upload new firmware to a brokeIO on most devices that can read and write to USB flash drives.

PIU Online Notice

Using a hand controller with games connected to the official Pump it Up online service is considered cheating by Andamiro and may lead to actions being taken against your account. As such, this use case is not officially endorsed by piuio-pico.

Credits

This project is based off of the tinyusb device USB examples (specifically webusb_serial and hid_generic_input). To support different device modes, a large amount of code was repurposed from the tinyusb drivers, HID code and descriptors found in GP2040-CE. In addition, the st7789_lcd example from Raspberry Pi's pico-examples repository were used for software SPI.

Protocol information from the PIUIO_Arduino and piuio_clone repositories. A few short snippets of code were also derived from piuio_clone, which is under the GPLv3 license but express permission has been granted by racerxdl to relicense these snippets under MIT. Thank you to DinsFire64 for your reverse engineering work on the LXIO!

License Notice

All code is licensed under the MIT License unless otherwise indicated, such as the .pio files, which are under the BSD-3 license. usb_hid_keys.h is under public domain.