|
1 | | -## POSSIBLE BREAKING CHANGES - PLEASE READ |
2 | | -A large code rebase (configuration class) along with some extra features (start, select, menu, home, back, volume up, volume down and volume mute buttons) has been committed thanks to @dexterdy |
3 | | - |
4 | | -Since version 5 of this library, the axes and simulation controls have configurable min and max values |
5 | | -The decision was made to set defaults to 0 for minimum and 32767 for maximum (previously -32767 to 32767) |
6 | | -This was due to the fact that non-Windows operating systems and some online web-based game controller testers didn't play well with negative numbers. Existing sketches should take note, and see the DrivingControllerTest example for how to set back to -32767 if wanted |
7 | | - |
8 | | -This version endeavors to be compatible with the latest released version of NimBLE-Arduino through the Arduino Library Manager; currently version 2.1.3 at the time of this writing; --> https://github.com/h2zero/NimBLE-Arduino/releases/tag/2.1.3 |
9 | | - |
10 | | -Please see updated examples |
11 | | - |
12 | | -## NimBLE |
13 | | -Since version 3 of this library, the more efficient NimBLE library is used instead of the default BLE implementation |
14 | | -Please use the library manager to install it, or get it from here: https://github.com/h2zero/NimBLE-Arduino |
15 | | -Since version 3, this library also supports a configurable HID desciptor, which allows users to customise how the device presents itself to the OS (number of buttons, hats, axes, sliders, simulation controls etc). |
16 | | -See the examples for guidance. |
17 | | - |
18 | 1 | # ESP32-BLE-Gamepad |
19 | 2 |
|
20 | 3 | ## License |
@@ -42,7 +25,24 @@ It would be great however if any improvements are fed back into this version. |
42 | 25 | - [x] Compatible with Linux (limited testing) |
43 | 26 | - [x] Compatible with MacOS X (limited testing) |
44 | 27 | - [ ] Compatible with iOS (No - not even for accessibility switch - This is not a “Made for iPhone” (MFI) compatible device) |
45 | | - (Use the Xinput fork suggested below which has been tested to work) |
| 28 | + (Use the Xinput fork suggested below which has been tested to work) |
| 29 | + |
| 30 | +## NimBLE |
| 31 | +Since version 3 of this library, the more efficient NimBLE library is used instead of the default BLE implementation |
| 32 | +Please use the library manager to install it, or get it from here: https://github.com/h2zero/NimBLE-Arduino |
| 33 | +Since version 3, this library also supports a configurable HID desciptor, which allows users to customise how the device presents itself to the OS (number of buttons, hats, axes, sliders, simulation controls etc). |
| 34 | +See the examples for guidance. |
| 35 | + |
| 36 | +## POSSIBLE BREAKING CHANGES - PLEASE READ |
| 37 | +A large code rebase (configuration class) along with some extra features (start, select, menu, home, back, volume up, volume down and volume mute buttons) has been committed thanks to @dexterdy |
| 38 | + |
| 39 | +Since version 5 of this library, the axes and simulation controls have configurable min and max values |
| 40 | +The decision was made to set defaults to 0 for minimum and 32767 for maximum (previously -32767 to 32767) |
| 41 | +This was due to the fact that non-Windows operating systems and some online web-based game controller testers didn't play well with negative numbers. Existing sketches should take note, and see the DrivingControllerTest example for how to set back to -32767 if wanted |
| 42 | + |
| 43 | +This version endeavors to be compatible with the latest released version of NimBLE-Arduino through the Arduino Library Manager; currently version 2.1.3 at the time of this writing; --> https://github.com/h2zero/NimBLE-Arduino/releases/tag/2.1.3 |
| 44 | + |
| 45 | +Please see updated examples |
46 | 46 |
|
47 | 47 | ## Installation |
48 | 48 | - (Make sure you can use the ESP32 with the Arduino IDE. [Instructions can be found here.](https://github.com/espressif/arduino-esp32#installation-instructions)) |
|
0 commit comments