uploaded 2 days ago
IOTMER BLE JSON channel (NimBLE GATT transport) for ESP-IDF
readme
# `iotmer_ble` (optional ESP-IDF component) `iotmer_ble` adds a small **BLE GATT JSON channel** built on **ESP-IDF NimBLE**. **ESP Component Registry:** [`iotmertech/iotmer_ble`](https://components.espressif.com/components/iotmertech/iotmer_ble) — link points at the component page (**Latest**); you do not need to edit docs when you publish a new version. Add to `idf_component.yml`: `iotmertech/iotmer_ble: "*"` then `idf.py update-dependencies`. - **Purpose**: A general transport for UTF-8 JSON messages between a phone/PC and the device. - **Relation to provisioning**: Wi‑Fi provisioning is implemented *on top* of this channel via the JSON contract in `docs/sdk/esp-idf/ble-json-provisioning.md` (see `examples/05_ble_json`). ## Public API - Header: `include/iotmer_ble.h` - Kconfig: `Kconfig.projbuild` (Component config → IOTMER BLE) ## GATT layout - Service UUID: `IOTMER_BLE_UUID_SVC_STR` - RX characteristic: write JSON (`IOTMER_BLE_UUID_RX_STR`) - TX characteristic: notify/read JSON (`IOTMER_BLE_UUID_TX_STR`) ## Notes - Advertising places **service UUID** in the advertising PDU and the **GAP name** in scan response to stay within common **31‑byte** advertising payload limits. - If `CONFIG_IOTMER_BLE_REQUIRE_ENC=y`, centrals must pair/encrypt before writing to RX.
Links
- Homepage
-
Repository
387c9a9dbc2ca396dbb572f637b7f103d74a7d7f
Maintainer
- IOTMER Tech <support@iotmer.com>
License: MIT
Tags
To add this component to your project, run:
download archive
idf.py add-dependency "iotmertech/iotmer_ble^0.1.2"
Stats
-
Archive size ~ 7.61 KB
-
Downloaded in total 2 times
-
Weekly Downloads (All Versions)
-
This version: 1 time
Badge
