Quick start
Prerequisites
- ESP-IDF v5 or v6
- iotmer.com account with workspace and device
- Component Manager: see Installation
Clone and open
git clone https://github.com/iotmertech/iotmer-sdk-esp-idf
cd iotmer-sdk-esp-idf/examples/02_telemetry
Run 01_provisioning first for initial registration, then flash 02_telemetry for day-to-day use.
Configure
idf.py set-target esp32c3
idf.py menuconfig
Component config → IOTMER:
| Setting | First boot | Field firmware |
|---|---|---|
| Wi‑Fi SSID / password | Required | Required (or NVS / BLE) |
| Provision auth code | Required | Empty |
| Workspace ID | Required with auth code | — |
| Workspace slug | From provision JSON → NVS | From NVS |
IOTMER_WORKSPACE_SLUG in menuconfig is an optional override only.
For bind-claim without re-provision, set lab-only IOTMER_DEVICE_HTTP_TOKEN when NVS dht is empty. See Kconfig.
Build and flash
idf.py build flash monitor
Serial tags: iotmer_wifi, iotmer_provision, iotmer_client.