Kconfig (menuconfig)
Path: Component config → IOTMER.
| Option | Purpose |
|---|---|
IOTMER_PROVISION_API_URL | Base URL for provisioning (no trailing slash). Default https://console.iotmer.com/api/v1. |
IOTMER_PROVISION_AUTH_CODE | API key sent as iotmer-auth-code. Empty + complete NVS session → HTTPS skipped. |
IOTMER_WORKSPACE_ID | Workspace UUID in the JSON body; required when auth code is set. |
IOTMER_WORKSPACE_SLUG | Optional override; production devices get workspace_slug from the provision API JSON and NVS. Use Kconfig only for testing or non-standard setups. |
IOTMER_TEMPLATE_ID | Optional device template UUID. |
IOTMER_WIFI_SSID / IOTMER_WIFI_PASSWORD | Station credentials. |
IOTMER_NVS_NAMESPACE | NVS namespace for credentials (default iotmer_creds). |
IOTMER_PROVISION_TIMEOUT_MS | HTTPS provision timeout. |
IOTMER_AUTO_OTA | Enable HTTPS OTA when firmware metadata is present. |
IOTMER_OTA_APPLY_EVEN_IF_SAME_SHA | Always OTA when URL+SHA present, even if SHA matches NVS (typical factory image). |
IOTMER_OTA_TIMEOUT_MS | OTA download timeout. |
IOTMER_FIRMWARE_POLL | Background task when firmware fields missing or OTA rejects image. |
IOTMER_FIRMWARE_POLL_* | Interval, stack, priority for the poll task. |
The mbedTLS certificate bundle and dual OTA partition table must match the target hardware (see example sdkconfig.defaults).
IOTMER BLE Wi‑Fi provisioning (optional component)
When the repository component iotmer_ble_wifi_prov is included in your project, its options appear under Component config → IOTMER BLE Wi‑Fi provisioning.
| Symbol | Purpose |
|---|---|
CONFIG_IOTMER_BLE_WIFI_PROV | When y, links the NimBLE GATT implementation; when n, stub APIs return ESP_ERR_NOT_SUPPORTED from the same component. |
CONFIG_IOTMER_BLE_ADV_TIMEOUT_MS | Advertising duration while not connected (0 = until stop()). |
CONFIG_IOTMER_BLE_CONN_IDLE_MS | Connected idle timeout without qualifying writes. |
CONFIG_IOTMER_BLE_SESSION_MAX_MS | Maximum session length after connect. |
CONFIG_IOTMER_BLE_ADV_NAME_PREFIX | GAP name prefix (suffix is MAC-derived). |
CONFIG_IOTMER_BLE_RESTART_ADV_ON_DISCONNECT | Resume advertising after disconnect while start() window is active. |
CONFIG_IOTMER_BLE_SMP_IO_CAP | NimBLE SMP IO capability (NO_IO default). |
Source: components/iotmer_ble_wifi_prov/Kconfig.projbuild. Behaviour and threat model: BLE Wi‑Fi provisioning.