SkillAgentSearch skills...

BlueCubeMod

ESP32 GameCube Controller Bluetooth conversion for Nintendo Switch

Install / Use

/learn @NathanReeves/BlueCubeMod
About this skill

Quality Score

0/100

Supported Platforms

Universal

README

BlueCubeMod

ESP32 based GameCube Controller Bluetooth conversion for Nintendo Switch

v1: Mac/PC/PS4 supported (tested using Dolphin Emulator on Mac, for Switch/RaspberryPi, use an 8Bitdo USB adapter)

v2: Switch support only - no adapter required

Wiring:

  • Connect pins 23 and 18 to GameCube controller's data pin (Red)

  • Connect GND to controller's ground pin (Black)

alt text

alt text

Build instructions(v2):

  • Use this esp-idf fork here: https://github.com/NathanReeves/esp-idf

  • Set up the esp-idf environment: https://docs.espressif.com/projects/esp-idf/en/latest/get-started/

  • Get the BlueCubeModv2 firmware

  • If you haven’t flashed an ESP32 project before, you need the port name of ESP32 for the config file. If using unix system, to get the port name of a USB device run:

ls /dev

  • Find your device on the list and copy it. It should look something like: /dev/cu.usbserial-DO01EXOV or /dev/cu.SLAB_USBtoUART

  • cd into project folder and run:

make menuconfig

  • Paste your port name into Serial Flasher Config -> Default Serial Port

  • Compile and flash the program, run:

make flash monitor

Resources used:

http://www.int03.co.uk/crema/hardware/gamecube/gc-control.htm

https://github.com/dekuNukem/Nintendo_Switch_Reverse_Engineering

https://github.com/timmeh87/switchnotes

Thank you to @Molorius for implementing the bluedroid Classic stack for esp

View on GitHub
GitHub Stars155
CategoryDevelopment
Updated15d ago
Forks18

Languages

C

Security Score

95/100

Audited on Mar 22, 2026

No findings