You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This library allows you to make the ESP32 act as a <b>NimBLE-Arduino 2.x</b> Keyboard and control what it does.
7
4
5
+
# Credits
6
+
This project is based on the excellent [ESP32-BLE-Keyboard](https://github.com/Berg0162/ESP32-NIMBLE-Keyboard) by <b>T-vK</b>.
7
+
The original <b>ESP32-BLE-Keyboard</b> library has been cloned and modified to comply to the latest version of NimBLE-Arduino 2.x
8
8
9
9
## Features
10
10
@@ -22,17 +22,17 @@ You might also be interested in:
22
22
23
23
## Installation
24
24
- (Make sure you can use the ESP32 with the Arduino IDE. [Instructions can be found here.](https://github.com/espressif/arduino-esp32#installation-instructions))
25
-
-[Download the latest release of this library from the release page.](https://github.com/T-vK/ESP32-BLE-Keyboard/releases)
25
+
-[Download the latest release of this library from the release page.](https://github.com/Berg0162/ESP32-NIMBLE-Keyboard/releases)
26
26
- In the Arduino IDE go to "Sketch" -> "Include Library" -> "Add .ZIP Library..." and select the file you just downloaded.
27
-
- You can now go to "File" -> "Examples" -> "ESP32 BLE Keyboard" and select any of the examples to get started.
27
+
- You can now go to "File" -> "Examples" -> "ESP32 NIMBLE Keyboard" and select any of the examples to get started.
28
28
29
29
## Example
30
30
31
31
```C++
32
32
/**
33
33
* This example turns the ESP32 into a Bluetooth LE keyboard that writes the words, presses Enter, presses a media key and then Ctrl+Alt+Delete
Just remember that you have to use `bleKeyboard` instead of just `Keyboard` and you need these two lines at the top of your script:
85
85
```
86
-
#include <BleKeyboard.h>
86
+
#include <NimBleKeyboard.h>
87
87
BleKeyboard bleKeyboard;
88
88
```
89
89
@@ -113,7 +113,7 @@ There is also a `setDelay` method to set a delay between each key event. E.g. `b
113
113
This feature is meant to compensate for some applications and devices that can't handle fast input and will skip letters if too many keys are sent in a small time frame.
114
114
115
115
## NimBLE-Mode
116
-
The NimBLEmode enables a significant saving of RAM and FLASH memory.
116
+
This version <b>exclusively</b> supports NimBLE-Arduino 2.x mode, enabling a significant saving of RAM and FLASH memory.
117
117
118
118
### Comparison (SendKeyStrokes.ino at compile-time)
Change your `platformio.ini` to the following settings
150
-
```ini
151
-
lib_deps =
152
-
NimBLE-Arduino
153
-
154
-
build_flags =
155
-
-D USE_NIMBLE
156
-
```
157
-
158
-
## Credits
140
+
## Credits to original author and contributors
159
141
142
+
Original author [ T-vK](https://github.com/Berg0162/ESP32-NIMBLE-Keyboard)<br>
160
143
Credits to [chegewara](https://github.com/chegewara) and [the authors of the USB keyboard library](https://github.com/arduino-libraries/Keyboard/) as this project is heavily based on their work!
161
144
Also, credits to [duke2421](https://github.com/T-vK/ESP32-BLE-Keyboard/issues/1) who helped a lot with testing, debugging and fixing the device descriptor!
162
145
And credits to [sivar2311](https://github.com/sivar2311) for adding NimBLE support, greatly reducing the memory footprint, fixing advertising issues and for adding the `setDelay` method.
0 commit comments