Skip to content

Get help

Note

If someone directed you to this page, your question or bug report lacks required information. Read this entire page before you post.

To get help or report a bug, use these channels:

Include the following information in your report:

  • Bluepad32 platform and version
  • DevKit board model and product link
  • Controller model, firmware version, and product link
  • Minimal sketch that reproduces the issue
  • Host operating system and version
  • Serial debug log

Platforms

Bluepad32 supports several platforms:

  • Arduino IDE for ESP32 modules
  • Arduino + ESP-IDF
  • ESP-IDF
  • Pico SDK
  • Unijoysticle

Specify your platform, platform version, and Bluepad32 version.

Example: Arduino IDE v2.0.9 with Bluepad32 v3.7.3.

DevKit module

Specify the exact DevKit board and provide a link to the hardware page.

Example: SparkFun Thing Plus - ESP32 WROOM: https://www.sparkfun.com/products/17381.

Controllers

Check the official compatibility lists first:

Provide the controller brand, model, firmware version, and product link. State whether the controller is genuine or a third-party clone.

Example: Genuine Nintendo Switch Joy-Con with firmware v3.72.

Bluepad32 does not guarantee support for unlisted controllers.

Request support for unsupported controllers

To request support for a new controller, contact us on Discord or file a feature request :

  • Send a link to the controller product page (such as Amazon or AliExpress).
  • Send the cost of the gamepad plus US shipping via PayPal .
  • We will purchase the controller and attempt to add support. We cannot guarantee compatibility, especially for low-cost clones.

Sketch

Share the smallest sketch that reproduces the bug. Remove all code that does not relate to Bluepad32.

Upload your sketch to http://gist.github.com and share the link. Do not paste long code blocks directly into Discord.

Operating system

Specify your host operating system (Windows, macOS, or Linux) and its version.

Example: macOS 12.6.7.

Debug log

Copy the serial console output and upload it to http://gist.github.com.

You can attach a screenshot for context, but you must also provide the text debug log.

Example report

Use this template when you ask a question:

Example

I use Bluepad32 v3.9.0 on a SparkFun Thing ESP32 with Arduino IDE v2.1.0.

I call ctl->setRumble(0xc0, 0xc0); to enable rumble.

Rumble works on a Nintendo Switch controller, but fails on a DualShock 4 controller.

  • Console output: [paste gist.github.com link]
  • Minimal sketch: [paste gist.github.com link]

How can I fix this issue?

(Short link to this page: http://bit.ly/bluepad32-help)