Skip to content

Commit f014543

Browse files
committed
2 parents 73a86c2 + 8389232 commit f014543

File tree

1 file changed

+12
-29
lines changed

1 file changed

+12
-29
lines changed

README.md

Lines changed: 12 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
1-
# ESP32 BLE Keyboard library
1+
# ESP32 NIMBLE Keyboard library
22

3-
This library allows you to make the ESP32 act as a Bluetooth Keyboard and control what it does.
4-
You might also be interested in:
5-
- [ESP32-BLE-Mouse](https://github.com/T-vK/ESP32-BLE-Mouse)
6-
- [ESP32-BLE-Gamepad](https://github.com/lemmingDev/ESP32-BLE-Gamepad)
3+
This library allows you to make the ESP32 act as a <b>NimBLE-Arduino 2.x</b> Keyboard and control what it does.
74

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
88

99
## Features
1010

@@ -22,17 +22,17 @@ You might also be interested in:
2222

2323
## Installation
2424
- (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)
2626
- 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.
2828

2929
## Example
3030

3131
``` C++
3232
/**
3333
* 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
3434
*/
35-
#include <BleKeyboard.h>
35+
#include <NimBleKeyboard.h>
3636

3737
BleKeyboard bleKeyboard;
3838

@@ -83,7 +83,7 @@ https://www.arduino.cc/reference/en/language/functions/usb/keyboard/
8383

8484
Just remember that you have to use `bleKeyboard` instead of just `Keyboard` and you need these two lines at the top of your script:
8585
```
86-
#include <BleKeyboard.h>
86+
#include <NimBleKeyboard.h>
8787
BleKeyboard bleKeyboard;
8888
```
8989

@@ -113,7 +113,7 @@ There is also a `setDelay` method to set a delay between each key event. E.g. `b
113113
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.
114114

115115
## NimBLE-Mode
116-
The NimBLE mode 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.
117117

118118
### Comparison (SendKeyStrokes.ino at compile-time)
119119

@@ -137,26 +137,9 @@ Flash: [==== ] 44.2% (used 579158 bytes from 1310720 bytes)
137137
| `ESP.getFreeHeap()` | 143.572 | 260.764 | **+ 117.192** |
138138
| `ESP.getSketchSize()` | 994.224 | 579.264 | **- 414.960** |
139139

140-
## How to activate NimBLE mode?
141-
142-
### ArduinoIDE:
143-
Uncomment the first line in BleKeyboard.h
144-
```C++
145-
#define USE_NIMBLE
146-
```
147-
148-
### PlatformIO:
149-
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
159141

142+
Original author [ T-vK](https://github.com/Berg0162/ESP32-NIMBLE-Keyboard)<br>
160143
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!
161144
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!
162145
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

Comments
 (0)