This project uses the same hardware as https://github.com/esp32beans/USBnunchuck.
- Adafruit QT Py ESP32-S3 with STEMMA QT, no PSRAM
- Adafruit QT Py RP2040
- Adafruit Trinkey QT2040 - RP2040 USB Key with Stemma QT
- Adafruit Feather RP2040
- Adafruit STEMMA QT/Qwiic JST SH 4-pin cable
- Adafruit Wii Nunchuck Breakout Adapter - Qwiic/STEMMA QT
- Adafruit Wii controller (Nunchuck/Wiichuck)
- USB cable with Type C connector for the ESP32-S3 and the appropriate connector for your computer.
Plug the boards together as shown below. No soldering is needed.
Only one of the QT Py, Trinkey, and Feather boards is needed. The Trinkey is the cheapest. The ESP32-S3 includes WiFi and Bluetooth Low Energy which are not currently used but might be in the future. The RP2040 boards do not have WiFi or Bluetooth so are cheaper and use much less power.
ESP32-S3 --STEMMA-- Nunchuck adapter -- Nunchuck controller
QT Py RP2040 --STEMMA-- Nunchuck adapter -- Nunchuck controller
Trinkey QT2040 --STEMMA-- Nunchuck adapter -- Nunchuck controller
Feather RP2040 --STEMMA-- Nunchuck adapter -- Nunchuck controller
Recommended only if you want to change the Python code. Or if you are new to CircuitPython. The first four guides include instructions on how to install CircuitPython on the respective boards.
- Adafruit QT Py ESP32-S3
- Adafruit QT Py RP2040
- Adafruit Trinkey QT2040
- Adafruit Feather RP2040
- Customizing USB Devices in CircuitPython
- Adafruit Wii Nunchuck Breakout Adapter
code.py is a renamed copy of nunchuk_mouse.py.
CircuitPython files and directories
└── CIRCUITPY
├── boot_out.txt
├── boot.py
├── code.py
└── lib
├── adafruit_bus_device
│ ├── i2c_device.mpy
│ ├── __init__.py
│ └── spi_device.mpy
├── adafruit_hid
│ ├── consumer_control_code.mpy
│ ├── consumer_control.mpy
│ ├── __init__.mpy
│ ├── keyboard_layout_base.mpy
│ ├── keyboard_layout_us.mpy
│ ├── keyboard.mpy
│ ├── keycode.mpy
│ └── mouse.mpy
└── adafruit_nunchuk.mpy
Verified to work on: MacBook M1, IPad M1, Ubuntu Linux 22.04, Android, Win 10