A simple, BLE Buttons controller to implement Simulator's button panels. Now supports multiple BLE profile, you you map at the same time a Keyboard, a Gamepad and a Mouse.
Check this elements also:
- ESP32-BLE-Combo. Implements a multiple BLE profile, so you can send keyboard, mouse and gamepad (joystick) inputs as HID device.
- BL-Radio. A custom made, generic radio panel (or whatever you want) to map the aircraft multiple radios interface. Implements modes and button remapping, as a bluetooth gamepad.
- VoiceButtons. Map joystick inputs to text-to-speech commands. Works on Windows (Windows 10 tested) and includes a configuration file to tailor the app to your needs, and a DCS export module to extract data from it (so you can asign specific radio profiles por each mod (aka plane)). Very useful if you flight in VR and uses the
BL-Radioradio panel.
-
Support clutch (2 modes).
-
4 axis x 3 = 12 axis (8 axis supported for Xinput).
-
17 buttons (x 2 modes) 51 buttons.
-
2 levers (two buttons) x 3 6 additional buttons.
-
Pov hats are not in use.
-
in clutch_mode == 2 (down), support for keyboard events (F1 ... F12) and mouse control.
-
Changed the library BLE Combo to support Gamepad. Use My Fork in order to get the thing working.
- Use These drivers for the ESP32 on Win 10
- To upload, ensure the CLUTCH switch is on 0 (no light) or you can't upload the sketch.
- Use NodeMCU-32S (ESP32) board version to do the work
- Go to https://github.com/me-no-dev/EspExceptionDecoder/releases/ and download the latest release.
- Go to https://github.com/me-no-dev/arduino-esp32fs-plugin/releases/ and download the latest release.
- Go to the Arduino IDE directory, and open the
Toolsfolder. - Unzip the downloaded .zip folders to the Tools folder.
- You should get something like
/Arduino-<version>/tools/ESP32FS/tool/esp32fs.jarand the same for the exception decoder.
- https://amstudioprojects.com/product/32-function-button-box-guide/
- https://www.instructables.com/id/Sim-Racing-Button-Box/ To use SPIFFS:
- Inside the sketch folder, create a new folder called
data - Inside the data folder is where you should put the files you want to be saved into the ESP32 filesystem.
- Then, to upload the files, in the
Arduino IDEyou just need to go toTools > ESP32 Sketch Data Upload.
Note: in some ESP32 development boards you need to keep the ESP32 on-board BOOT button pressed while it’s uploading the files. When you see the Connecting …….____…… message, you need to press the ESP32 on-board BOOT button.
- Bounce2https://github.com/thomasfredericks/Bounce2
- Go to https://github.com/lemmingDev/ESP32-BLE-Gamepad/releases and download the latest release.
- In the Arduino IDE go to
"Sketch" -> "Include Library" -> "Add .ZIP Library..."and select the file you just downloaded. - You can now go to
"File" -> "Examples" -> "ESP32 BLE Gamepad"and select the example to get started. - Updated to https://github.com/MagnusThome/ESP32-BLE-Gamepad
- On laptop works properly.
- A keypad Lib https://github.com/Chris--A/Keypad for The Example
- Info about HID profile https://eleccelerator.com/tutorial-about-usb-hid-report-descriptors/
- Official Nordic HID BLE https://cdn.sparkfun.com/datasheets/Wireless/Bluetooth/RN-HID-User-Guide-v1.0r.pdf
- Two profiles https://www.esp32.com/viewtopic.php?t=10400
- Keyboard HID profile https://github.com/rupin/ESPJoystick/blob/master/gamepadble632/gamepadble632.ino
- USB HID definition tables https://www.usb.org/hid
- USB HID usage tables http://www.freebsddiary.org/APC/usb_hid_usages.php
- More HID details https://cdn.hackaday.io/files/18003770240352/HID.cpp
- Analog Smooth https://github.com/MichaelThessel/arduino-analog-smooth ## Available PINOUTS
| GPIO | ADC | INPUT | OUTPUT | NOTES |
|---|---|---|---|---|
| 0 x | 1/2 | pulled up | OK | Outputs PWM signal at boot |
| 2 x | 2/2 | OK | OK | Connected to LED. LOW->LED Light |
| 4 x | 0/2 | OK | OK | |
| 5 x | OK | OK | Outputs PWM signal at boot | |
| 12 x | 5/2 | OK | OK | Boot fail if pulled HIGH |
| 13 | 4/2 | OK | OK | Boot fail if pulled HIGH |
| 14 x | 6/2 | OK | OK | Outputs PWM signal at boot |
| 15 x | 2/2 | OK | OK | Outputs PWM signal at boot |
| 16 x | -- | -- | used on ESP-32_WROVER_KIT ** | |
| 17 x | OK | OK | used on ESP-32_WROVER_KIT | |
| 18 x | OK | OK | ||
| 19 x | OK | OK | ||
| 21 | OK | OK | ||
| 22 | OK | OK | ||
| 23 | OK | OK | ||
| 25 | 8/2 | OK | OK | |
| 26 x | 9/2 | OK | OK | |
| 27 x | 7/2 | OK | OK | |
| 32 x | 4/1 | OK | OK | |
| 33 x | 5/1 | OK | OK | |
| 34 x | 6/1 | OK | Input Only | |
| 35 x | 7/1 | OK | Input Only |
-
PIN16 on new version, doesn't work. Changed with PIN13
-
ADC Column: ADC Channel/ADC1|ADC2. No number means no ADC.
-
ADC2 pins cannot be used when Wi-Fi is used.
-
The ADC input channels have a 12 bit resolution.
-
This means that you can get analog readings ranging from 0 to 4095, in which 0 corresponds to 0V and 4095 to 3.3V.
-
ANALOG INPUTS: 14 . 10 on ADC2, 4 on ADC1 (usable with WIFI)
-
DIGITAL INPUTS: 21 TOTAL, 7 only DIGITAL. Be careful with 12 and 13
-
ANALOG -> 3 [18]
-
KEYPAD -> 7x7 [14] [49 buttons]
-
Clutch -> 1 dedicated line (to avoid ghosting on the matrix - no use diodes)
| ITEM | QUANTITY | PINS | TOTAL PINS |
|-------|---------------|-------|-----------:|
|LEVC | 2 | 1 | 2 |
|LEV | 9 | 2 | 18 |
|BUT | 16 | 1 | 16 |
|ENC | 5 | 3 | 15 |
|POT | 5 | 1 | 5 |
|-------|---------------|-------|-----------:|
| TOTAL | | | 56 (51+5) |
|-------|---------------|-------|-----------:|
MAX: 21 INPUTS
Clutch LEFT (+1 Digital) 57 (52+5)
ENC->Really are:
2 for DT*CLK signal
1 for SWITCH (serial plug)
-> More push buttons
-> Less Lever
-> Less Rotary (eats 3 pins per rotary)
*****Confirm these values****
Better more push buttons? (24)
4 pot (axis) (21-4=17) [better 4 and leave the wifi alone]
4x4 = 16 buttons (17-(4+4)=9)
2LEVC (9-2=7)
CLUTCH (7-2=5)
2LEV (5-4=1)
1 free XD
| PIN | TO | NOTES |
|-------|-----------------------|---------------------:|
| 14 | COL_0 | Boot Fail if HIGH |
| 27 | COL_1 | |
| 26 | COL_2 | |
| 25 | COL_3 | |
|-------|-----------------------|----------------------|
| 33 | POT_1 (leftmost) | CH_4 ADC1 together |
| 32 | POT_2 | CH_5 ADC1 |
| 35 | POT_3 | CH_6 ADC1 |
| 34 | POT_4 (rightmost) | CH_7 ADC1 |
|-------|-----------------------|----------------------|
| 15 | CLUTCH_1 | |
| 2 | CLUTCH_2 | low or won't flash |
|-------|-----------------------|----------------------|
| 4 | ROW_0 | Pulled up |
| 13 | ROW_1 | Connected to LED (*) |
| 17 | ROW_2 | |
| 5 | ROW_3 | Boot Fail if HIGH |
|-------|-----------------------|----------------------|
| 18 | LEVER_COVER_1 | |
|-------|-----------------------|----------------------|
| 19 | LEVER_COVER_2 | |
|-------|-----------------------|----------------------|
| 21 | BUTTON_1 | |
|-------|-----------------------|----------------------|
| 0 | free pins | not use |
| 2 | | |
| 16 | in new version, fails | (*) changed with 13 |
| 22 | | |
| 23 | | |
|-------|-----------------------|----------------------|
Led Wiring: 300 OHMs resistor
MAX 32 inputs !!!
16 + 2 + 2 + 2 = 22 + 4 axis
CLUTCH mode:
16 buttons x 2 = 32 inputs
BOX: 200x110x65
Lever: 74 x 54 x 12 mm
Lever_Cover: 60 x 130 x 40 mm
ENC: 15
POT: 16x25
BUT: 19
LEVC: 20x50
LEV: 12
Engine Start Water Radiators Oil Radiators Wheel Brake Inlet/Outlet Cowls Mixture RPM lever (Prop pitch) Flaps Landing Gear Open/Close Canopy Open/Close Bomb Bay Doors Airbrakes Mission Brief Screen Engine Boost Fire Guns/Cannons/Missiles/Bombs Auto Level Field of view zoom in Field of view zoom out Recenter Track IR Eject
Nav Lights Instrument Lights Super Charger Stage Toggle Engine Select
0x05, 0x01, // USAGE_PAGE (Generic Desktop)
0x09, 0x04, // USAGE (Joystick)
0xa1, 0x01, // COLLECTION (Application)
0x85, 0x03, // REPORT_ID (3)
0xa1, 0x00, // COLLECTION (Physical)
0x05, 0x09, // USAGE_PAGE (Button)
0x19, 0x01, // USAGE_MINIMUM (Button 1)
0x29, 0x40, // USAGE_MAXIMUM (Button 64)
0x15, 0x00, // LOGICAL_MINIMUM (0)
0x25, 0x01, // LOGICAL_MAXIMUM (1)
0x75, 0x01, // REPORT_SIZE (1)
0x95, 0x40, // REPORT_COUNT (64)
0x81, 0x02, // INPUT (Data,Var,Abs)
0xc0, // END_COLLECTION
0xc0 // END_COLLECTION
exports.report = new Uint8Array([
0x05, 0x01, // USAGE_PAGE (Generic Desktop)
0x09, 0x05, // USAGE (Game Pad) - Hut1_12v2.pdf p28 of 128
0xA1, 0x01, // COLLECTION (Application)
0xA1, 0x00, // COLLECTION (Physical)
0x05, 0x09, // USAGE_PAGE (Button)
0x19, 0x01, // USAGE_MINIMUM (Button 1)
0x29, 0x10, // USAGE_MAXIMUM (Button 16)
0x15, 0x00, // LOGICAL_MINIMUM (0)
0x25, 0x01, // LOGICAL_MAXIMUM (1)
0x95, 0x10, // REPORT_COUNT (16)
0x75, 0x01, // REPORT_SIZE (1)
0x81, 0x02, // INPUT (Data,Var,Abs)
0x05, 0x01, // USAGE_PAGE (Generic Desktop)
0x09, 0x30, // USAGE (X)
0x09, 0x31, // USAGE (Y)
0x09, 0x32, // USAGE (Z) - Hut1_12v2.pdf p26 = represents R X-axis
0x09, 0x33, // USAGE (Rx) - Hut1_12v2.pdf p26 = represents R Y-axis
0x15, 0x81, // LOGICAL_MINIMUM (-127)
0x25, 0x7F, // LOGICAL_MAXIMUM (127)
0x75, 0x08, // REPORT_SIZE (8)
0x95, 0x04, // REPORT_COUNT (4)
0x81, 0x06, // INPUT (Data,Var,Abs) - absolute for joysticks ( != rel for mouse )
0xC0, // END_COLLECTION
0xc0 ] // END_COLLECTION
);
NANO SERIAL: Solved using ATmega328P (Old Bootloader)...