Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/finger563/esp-hid-service-table
Example showing BLE HID services using the ESP-IDF GATT Server Service Table
https://github.com/finger563/esp-hid-service-table
Last synced: 5 days ago
JSON representation
Example showing BLE HID services using the ESP-IDF GATT Server Service Table
- Host: GitHub
- URL: https://github.com/finger563/esp-hid-service-table
- Owner: finger563
- License: mit
- Created: 2023-10-05T15:57:51.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-01-05T20:13:22.000Z (about 1 year ago)
- Last Synced: 2024-12-11T18:25:01.824Z (about 1 month ago)
- Language: C++
- Size: 372 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ESP HID Service Table
Example providing HID over GATT (HoG) profile for BLE on ESP using the ESP-IDF
GATT Service Table APIs.
https://github.com/finger563/esp-hid-service-table/assets/213467/f972932c-6285-44ac-a576-f49e8d22fc9b
https://github.com/finger563/esp-hid-service-table/assets/213467/a30da3aa-47da-4cad-b3cb-7772f54a4562
## Implementation
The way this example works is to create the following service tables in order:
- Battery Service (0x180F)
- Device Information Service (0x180A)
- HID Service (0x1812)
The HID service is the last service created in the table, and uses the
`include_service_uuid` (0x2802) attribute to include the Battery and Device
Information services in the HID service.
This example was based on the ESP-IDF [ble_hid_device_demo
example](https://github.com/espressif/esp-idf/tree/master/examples/bluetooth/bluedroid/ble/ble_hid_device_demo),
which performs a similar function for a mouse/keyboard input device also using
the GATT Service Table APIs (see
[hid_device_le_prf.c](https://github.com/espressif/esp-idf/blob/master/examples/bluetooth/bluedroid/ble/ble_hid_device_demo/main/hid_device_le_prf.c))
## Cloning
Since this repo contains a submodule, you need to make sure you clone it
recursively, e.g. with:
``` sh
git clone --recurse-submodules [email protected]:finger563/esp-hid-service-table
```
Alternatively, you can always ensure the submodules are up to date after cloning
(or if you forgot to clone recursively) by running:
``` sh
git submodule update --init --recursive
```
## Build and Flash
Build the project and flash it to the board, then run monitor tool to view serial output:
```
idf.py -p PORT flash monitor
```
(Replace PORT with the name of the serial port to use.)
(To exit the serial monitor, type ``Ctrl-]``.)
See the Getting Started Guide for full steps to configure and use ESP-IDF to build projects.
## Output
