Skip to main content

Kconfig (menuconfig)

Path: Component config → IOTMER.

OptionPurpose
IOTMER_PROVISION_API_URLBase URL for provisioning (no trailing slash). Default https://console.iotmer.com/api/v1.
IOTMER_PROVISION_AUTH_CODEAPI key sent as iotmer-auth-code. Empty + complete NVS session → HTTPS skipped.
IOTMER_WORKSPACE_IDWorkspace UUID in the JSON body; required when auth code is set.
IOTMER_WORKSPACE_SLUGOptional override; production devices get workspace_slug from the provision API JSON and NVS. Use Kconfig only for testing or non-standard setups.
IOTMER_TEMPLATE_IDOptional device template UUID.
IOTMER_WIFI_SSID / IOTMER_WIFI_PASSWORDStation credentials.
IOTMER_NVS_NAMESPACENVS namespace for credentials (default iotmer_creds).
IOTMER_PROVISION_TIMEOUT_MSHTTPS provision timeout.
IOTMER_AUTO_OTAEnable HTTPS OTA when firmware metadata is present.
IOTMER_OTA_APPLY_EVEN_IF_SAME_SHAAlways OTA when URL+SHA present, even if SHA matches NVS (typical factory image).
IOTMER_OTA_TIMEOUT_MSOTA download timeout.
IOTMER_FIRMWARE_POLLBackground 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.

SymbolPurpose
CONFIG_IOTMER_BLE_WIFI_PROVWhen y, links the NimBLE GATT implementation; when n, stub APIs return ESP_ERR_NOT_SUPPORTED from the same component.
CONFIG_IOTMER_BLE_ADV_TIMEOUT_MSAdvertising duration while not connected (0 = until stop()).
CONFIG_IOTMER_BLE_CONN_IDLE_MSConnected idle timeout without qualifying writes.
CONFIG_IOTMER_BLE_SESSION_MAX_MSMaximum session length after connect.
CONFIG_IOTMER_BLE_ADV_NAME_PREFIXGAP name prefix (suffix is MAC-derived).
CONFIG_IOTMER_BLE_RESTART_ADV_ON_DISCONNECTResume advertising after disconnect while start() window is active.
CONFIG_IOTMER_BLE_SMP_IO_CAPNimBLE SMP IO capability (NO_IO default).

Source: components/iotmer_ble_wifi_prov/Kconfig.projbuild. Behaviour and threat model: BLE Wi‑Fi provisioning.