ESP-IDF SDK
iotmer-sdk-esp-idf connects Espressif chips to IOTMER.
| Capability | API |
|---|---|
| Wi‑Fi + HTTPS provision + NVS | iotmer_init(), iotmer_provision() |
| MQTT (TLS) | iotmer_connect(), iotmer_subscribe() |
| Telemetry / state / presence | iotmer_telemetry_publish(), etc. |
| OTA (HTTP(S) + MQTT command) | iotmer_ota_apply_if_needed(); app worker for MQTT |
| BLE JSON (optional) | iotmer_ble component |
Public header: iotmer_client.h
Platform docs (console, REST, MQTT): docs.iotmer.com
Install
iotmertech/iotmer · iotmertech/iotmer_ble
See Installation.
Boot flow
- Wi‑Fi association
- Load credentials from NVS
- HTTPS provision (skipped when NVS session is complete and auth code is empty)
- Save credentials to NVS
- HTTP(S) OTA (when auto-OTA is on and the server returns
firmware_url+ SHA256) iotmer_connect()— publish telemetry, subscribe to cmd/config (MQTT OTA after this)
Factory vs field firmware
| Image | Example | Auth code | HTTPS provision |
|---|---|---|---|
| Factory | 01_provisioning | Set | Every boot |
| Field | 02_telemetry | Empty | Skipped when NVS is complete |
Requirements
- ESP-IDF ≥ 5.x (6.x supported)
- Dual OTA partitions when HTTP(S) auto-OTA or MQTT OTA is used