/ESP32-BLE-Gamepad

Bluetooth LE Gamepad library for the ESP32 - Multiple Atari Joysticks

Primary LanguageC++

ESP32-BLE-Gamepad

Forked from https://github.com/lemmingDev/ESP32-BLE-Gamepad

Bluetooth LE Gamepad library for the ESP32 with Dual Joystick Support and simplified for 5 button and 2 axes for retro Atari Joysticks

This library allows you to make the ESP32 act as a Bluetooth Gamepad and control what it does. E.g. move axes and press buttons

Features

  • Button press (5 buttons)
  • Button release (5 buttons)
  • Axes movement (2 axes (x, y))
  • Point of view hat (d-pad)
  • Report optional battery level to host (basically works, but it doesn't show up in Android's status bar)
  • Customize Bluetooth device name/manufacturer
  • Compatible with Windows
  • Compatible with Android (Untested)
  • Compatible with Linux (Untested)
  • Compatible with MacOS X (Untested)
  • Compatible with iOS (Untested)

Example

/*
 * This example turns the ESP32 into a Bluetooth LE gamepad that presses buttons and moves axis
 * 
 * Possible buttons are:
 * BUTTON_1 through to BUTTON_5* 
 * 
 * bleGamepad.setAxes takes the following signed char parameters: 
 * (X, Y);
 */
 
#include <BleGamepad.h> 

BleGamepad bleGamepad;

void setup() {
  Serial.begin(115200);
  Serial.println("Starting BLE work!");
  bleGamepad.begin();
}

void loop() {
  if(bleGamepad.isConnected()) {
    Serial.println("Press buttons 1 and 5. Move all axes to max.");
    bleGamepad.press(BUTTON_5);
    bleGamepad.press(BUTTON_1);
    bleGamepad.setAxes(127, 127);
    delay(500);

    Serial.println("Release button 14. Move all axes to min.");
    bleGamepad.release(BUTTON_5);
    bleGamepad.setAxes(-127, -127);
    delay(500);
  }
}

There is also Bluetooth specific information that you can use (optional):

Instead of BleGamepad bleGamepad; you can do BleGamepad bleGamepad("Bluetooth Device Name", "Bluetooth Device Manufacturer", 100);. The third parameter is the initial battery level of your device. To adjust the battery level later on you can simply call e.g. bleMouse.setBatteryLevel(50) (set battery level to 50%). By default the battery level will be set to 100%, the device name will be ESP32 BLE Gamepad and the manufacturer will be Espressif.

Credits

Credits to lemmingDev as this library is froxed from his (https://github.com/lemmingDev/ESP32-BLE-Gamepad).

Credits to T-vK as this library is based on his ESP32-BLE-Mouse library (https://github.com/T-vK/ESP32-BLE-Mouse) that he provided.

Credits to chegewara as the ESP32-BLE-Mouse library is based on this piece of code that he provided.