https://github.com/esp32beans/usbnunchuck_mouse
Convert Wii Nunchuck to USB mouse without soldering using CircuitPython
https://github.com/esp32beans/usbnunchuck_mouse
assistive-technology circuitpython joy2mouse mouse nunchuck nunchuk usb usb-hid wii
Last synced: 2 months ago
JSON representation
Convert Wii Nunchuck to USB mouse without soldering using CircuitPython
- Host: GitHub
- URL: https://github.com/esp32beans/usbnunchuck_mouse
- Owner: esp32beans
- License: mit
- Created: 2022-11-09T21:19:47.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2022-11-26T23:17:05.000Z (over 2 years ago)
- Last Synced: 2025-01-11T16:35:40.942Z (4 months ago)
- Topics: assistive-technology, circuitpython, joy2mouse, mouse, nunchuck, nunchuk, usb, usb-hid, wii
- Language: Python
- Homepage:
- Size: 488 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Convert Wii Nunchunk to USB Mouse without soldering
## Hardware
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
```
## Tutorials
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](https://learn.adafruit.com/adafruit-qt-py-esp32-s3)
* [Adafruit QT Py RP2040](https://learn.adafruit.com/adafruit-trinkey-qt2040)
* [Adafruit Trinkey QT2040](https://learn.adafruit.com/adafruit-qt-py-2040)
* [Adafruit Feather RP2040](https://learn.adafruit.com/adafruit-feather-rp2040-pico)
* [Customizing USB Devices in CircuitPython](https://learn.adafruit.com/customizing-usb-devices-in-circuitpython/hid-devices)
* [Adafruit Wii Nunchuck Breakout Adapter](https://learn.adafruit.com/adafruit-wii-nunchuck-breakout-adapter)
## CircuitPython files
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
```
## Testing
Verified to work on: MacBook M1, IPad M1, Ubuntu Linux 22.04, Android, Win 10