How darkwingtori/xbox-series-wiiu-relay works
This ESP32 firmware relays Xbox Series X|S input to a Wii U running Bloopair by bridging BLE HID-over-GATT to Classic Bluetooth HID, impersonating an Xbox One S controller. At startup, it connects to the Xbox before advertising to the Wii U; input reports travel toward the console, while rumble reports return to the controller. The report layout and advertised HID descriptor support the bridge. The README documents the end-to-end workflow; source excerpts show callback wiring and protocol handling, though some hardware-specific behavior remains an acknowledged assumption.
Main entry points: main.c Relay startup and callbacks · ble_central.c BLE central · hid_peripheral.c Classic HID peripheral · relay_report.h Shared report layout
Components 7
Relay orchestration
- Relay startup and callbacks
main/main.c
Xbox BLE link
- BLE central
main/ble_central.c
HID report formats
- Shared report layout
main/relay_report.h - HID descriptor
main/hid_descriptor.h
Wii U Classic HID
- Classic HID peripheral
main/hid_peripheral.c
Other components
- Xbox controller
- Wii U / Bloopair
Connections 13
- Relay startup and callbacks → BLE central: starts connection
main/main.c - BLE central → Xbox controller: scans and connects
README.md - Xbox controller → BLE central: notifies input
main/ble_central.c - BLE central → Relay startup and callbacks: calls input callback
main/ble_central.c - Relay startup and callbacks → Classic HID peripheral: forwards input
main/main.c - Classic HID peripheral → Wii U / Bloopair: advertises and sends HID
README.md - Wii U / Bloopair → Classic HID peripheral: sends rumble report
main/hid_peripheral.c - Classic HID peripheral → Relay startup and callbacks: calls output callback
main/hid_peripheral.c - Relay startup and callbacks → BLE central: forwards rumble
main/main.c - BLE central → Xbox controller: writes output report
main/ble_central.c - Relay startup and callbacks → Shared report layout: checks report IDs
main/main.c - Classic HID peripheral → HID descriptor: registers descriptor
main/hid_peripheral.c - Shared report layout → Wii U / Bloopair: matches Bloopair layout
README.md