BLE-Gamepad-Client

This library enables connecting BLE (Bluetooth Low Energy) gamepads to ESP32 boards. Currently, only the Xbox Wireless Controller is supported.

PlatformIO dependency

Add the following line to the lib_deps option of platformio.ini file.

tbekas/BLE-Gamepad-Client@^0.3.2

Example usage

#include <Arduino.h>
#include <BLEController.h>
 
BLEController controller;
 
void setup(void) {
  Serial.begin(115200);
  controller.begin();
}
 
void loop() {
  BLEControlsEvent e;
 
  if (controller.isConnected()) {
    controller.readControls(e);
    Serial.printf("lx: %.2f, ly: %.2f\n", e.leftStickX, e.leftStickY);
  }
 
  delay(100);
}

More examples

Checkout the code examples in the examples directory.

Supported gamepads

Xbox One Wireless Controller (model 1708)

Pairing instructions are the same as for model 1914. If controller is not pairing, you probably need to update the controller's firmware to version 5.x using these instructions.

Xbox Series S/X Wireless Controller (model 1914)

Pairing instructions:

• Turn on your controller by pressing the Xbox button.
• Press and hold the controller’s pair button for 3 seconds, then release.

Acknowledgments

• h2zero for the excellent NimBLE-Arduino library, which this library is built upon.