Kconfig Options
Configure via idf.py menuconfig → WiFi Config, or set in sdkconfig.defaults.
Core Options
| Option | Default | Description |
|---|---|---|
CONFIG_WIFI_CFG_MAX_NETWORKS | 5 | Maximum number of saved networks |
CONFIG_WIFI_CFG_MAX_VARS | 10 | Maximum number of custom variables |
CONFIG_WIFI_CFG_DEFAULT_RETRY | 3 | Retries per network before moving to next |
CONFIG_WIFI_CFG_RETRY_INTERVAL_MS | 5000 | Base retry interval in milliseconds |
CLI
| Option | Default | Description |
|---|---|---|
CONFIG_WIFI_CFG_ENABLE_CLI | n | Enable serial console CLI commands |
Web UI
| Option | Default | Description |
|---|---|---|
CONFIG_WIFI_CFG_ENABLE_WEBUI | n | Enable the embedded Web UI |
CONFIG_WIFI_CFG_WEBUI_CUSTOM_PATH | "" | Path to custom frontend files (LittleFS/SPIFFS) |
BLE
| Option | Default | Description |
|---|---|---|
CONFIG_WIFI_CFG_ENABLE_CUSTOM_BLE | n | Enable custom BLE GATT interface (UUID 0xFFE0) |
Improv WiFi
| Option | Default | Description |
|---|---|---|
CONFIG_WIFI_CFG_ENABLE_IMPROV_BLE | n | Enable Improv BLE transport (requires BT enabled) |
CONFIG_WIFI_CFG_ENABLE_IMPROV_SERIAL | n | Enable Improv Serial transport |
CONFIG_WIFI_CFG_IMPROV_SERIAL_UART_NUM | 0 | UART port for Improv Serial |
CONFIG_WIFI_CFG_IMPROV_SERIAL_BAUD | 115200 | Baud rate for Improv Serial |
Common sdkconfig.defaults Combinations
Basic WiFi (no extra features)
# No extra config needed — defaults work
WiFi + Web UI
CONFIG_WIFI_CFG_ENABLE_WEBUI=y
WiFi + BLE (Bluedroid)
CONFIG_BT_ENABLED=y
CONFIG_BT_BLUEDROID_ENABLED=y
CONFIG_WIFI_CFG_ENABLE_CUSTOM_BLE=y
CONFIG_PARTITION_TABLE_SINGLE_APP_LARGE=y
WiFi + BLE (NimBLE, lighter)
CONFIG_BT_ENABLED=y
CONFIG_BT_NIMBLE_ENABLED=y
CONFIG_BT_NIMBLE_HOST_TASK_STACK_SIZE=6144
CONFIG_WIFI_CFG_ENABLE_CUSTOM_BLE=y
CONFIG_PARTITION_TABLE_SINGLE_APP_LARGE=y
WiFi + Improv BLE Only
CONFIG_BT_ENABLED=y
CONFIG_BT_BLUEDROID_ENABLED=y
CONFIG_WIFI_CFG_ENABLE_IMPROV_BLE=y
CONFIG_PARTITION_TABLE_SINGLE_APP_LARGE=y
WiFi + Improv + Custom BLE
CONFIG_BT_ENABLED=y
CONFIG_BT_BLUEDROID_ENABLED=y
CONFIG_WIFI_CFG_ENABLE_CUSTOM_BLE=y
CONFIG_WIFI_CFG_ENABLE_IMPROV_BLE=y
CONFIG_PARTITION_TABLE_SINGLE_APP_LARGE=y
Kitchen Sink (all features)
CONFIG_BT_ENABLED=y
CONFIG_BT_BLUEDROID_ENABLED=y
CONFIG_WIFI_CFG_ENABLE_CLI=y
CONFIG_WIFI_CFG_ENABLE_WEBUI=y
CONFIG_WIFI_CFG_ENABLE_CUSTOM_BLE=y
CONFIG_WIFI_CFG_ENABLE_IMPROV_BLE=y
CONFIG_PARTITION_TABLE_SINGLE_APP_LARGE=y