From 636b2857724a2bf426b951738f3881416d5cb04d Mon Sep 17 00:00:00 2001 From: muhaidong Date: Wed, 29 Apr 2026 17:22:24 +0800 Subject: [PATCH] fix(wifi): add ESP_WIFI_MAX_CONN_NUM-aligned ranges for soft-AP max STA Kconfig --- examples/network/bridge/main/Kconfig.projbuild | 8 +++++++- examples/network/eth2ap/main/Kconfig.projbuild | 8 +++++++- .../http_server/captive_portal/main/Kconfig.projbuild | 8 +++++++- .../wifi/getting_started/softAP/main/Kconfig.projbuild | 8 +++++++- examples/wifi/softap_sta/main/Kconfig.projbuild | 8 +++++++- .../wifi/wps_softap_registrar/main/Kconfig.projbuild | 10 ++++++++-- 6 files changed, 43 insertions(+), 7 deletions(-) diff --git a/examples/network/bridge/main/Kconfig.projbuild b/examples/network/bridge/main/Kconfig.projbuild index eb3bf58a468..d7abd9d84c2 100644 --- a/examples/network/bridge/main/Kconfig.projbuild +++ b/examples/network/bridge/main/Kconfig.projbuild @@ -40,6 +40,12 @@ menu "Example AP Wifi Configuration" depends on EXAMPLE_BR_WIFI int "Maximal STA connections" default 4 + range 1 4 if IDF_TARGET_ESP32C2 + range 1 15 help - Max number of the STA connects to AP. + Maximum number of STAs allowed to connect to the bridged soft-AP (wifi_config_t.ap.max_connection). + Upper bound matches ESP_WIFI_MAX_CONN_NUM in esp_wifi_types_native.h: + 1-4 on ESP32-C2, 1-15 on other Wi-Fi chips. + Soft-AP and ESP-NOW share encryption keys; see Wi-Fi driver documentation + if ESP-NOW is enabled. endmenu diff --git a/examples/network/eth2ap/main/Kconfig.projbuild b/examples/network/eth2ap/main/Kconfig.projbuild index 885ccf6dbbb..affe95436ee 100644 --- a/examples/network/eth2ap/main/Kconfig.projbuild +++ b/examples/network/eth2ap/main/Kconfig.projbuild @@ -22,7 +22,13 @@ menu "Example Configuration" config EXAMPLE_MAX_STA_CONN int "Maximum STA connections" default 4 + range 1 4 if IDF_TARGET_ESP32C2 + range 1 15 help - Maximum number of the station that allowed to connect to current Wi-Fi hotspot. + Maximum number of STAs allowed to connect to the soft-AP (wifi_config_t.ap.max_connection). + Upper bound matches ESP_WIFI_MAX_CONN_NUM in esp_wifi_types_native.h: + 1-4 on ESP32-C2, 1-15 on other Wi-Fi chips. + Soft-AP and ESP-NOW share encryption keys; see Wi-Fi driver documentation + if ESP-NOW is enabled. endmenu diff --git a/examples/protocols/http_server/captive_portal/main/Kconfig.projbuild b/examples/protocols/http_server/captive_portal/main/Kconfig.projbuild index 9f2a7f1be5b..f2df8400512 100644 --- a/examples/protocols/http_server/captive_portal/main/Kconfig.projbuild +++ b/examples/protocols/http_server/captive_portal/main/Kconfig.projbuild @@ -15,8 +15,14 @@ menu "Example Configuration" config ESP_MAX_STA_CONN int "Maximal STA connections" default 4 + range 1 4 if IDF_TARGET_ESP32C2 + range 1 15 help - Max number of the STA connects to AP. + Maximum number of STAs allowed to connect to the soft-AP (wifi_config_t.ap.max_connection). + Upper bound matches ESP_WIFI_MAX_CONN_NUM in esp_wifi_types_native.h: + 1-4 on ESP32-C2, 1-15 on other Wi-Fi chips. + Soft-AP and ESP-NOW share encryption keys; see Wi-Fi driver documentation + if ESP-NOW is enabled. config ESP_ENABLE_DHCP_CAPTIVEPORTAL bool "DHCP Captive portal" diff --git a/examples/wifi/getting_started/softAP/main/Kconfig.projbuild b/examples/wifi/getting_started/softAP/main/Kconfig.projbuild index 5dcaa97c15b..2f5c38d3985 100644 --- a/examples/wifi/getting_started/softAP/main/Kconfig.projbuild +++ b/examples/wifi/getting_started/softAP/main/Kconfig.projbuild @@ -21,8 +21,14 @@ menu "Example Configuration" config ESP_MAX_STA_CONN int "Maximal STA connections" default 4 + range 1 4 if IDF_TARGET_ESP32C2 + range 1 15 help - Max number of the STA connects to AP. + Maximum number of STAs allowed to connect to the soft-AP (wifi_config_t.ap.max_connection). + Upper bound matches ESP_WIFI_MAX_CONN_NUM in esp_wifi_types_native.h: + 1-4 on ESP32-C2, 1-15 on other Wi-Fi chips. + Soft-AP and ESP-NOW share encryption keys; see Wi-Fi driver documentation + if ESP-NOW is enabled. config ESP_GTK_REKEYING_ENABLE bool "Enable GTK Rekeying" diff --git a/examples/wifi/softap_sta/main/Kconfig.projbuild b/examples/wifi/softap_sta/main/Kconfig.projbuild index c7af1590148..32e5377d2e7 100644 --- a/examples/wifi/softap_sta/main/Kconfig.projbuild +++ b/examples/wifi/softap_sta/main/Kconfig.projbuild @@ -25,8 +25,14 @@ menu "Example Configuration" config ESP_MAX_STA_CONN_AP int "Maximal STA connections" default 4 + range 1 4 if IDF_TARGET_ESP32C2 + range 1 15 help - Max number of the STA connects to AP. + Maximum number of STAs allowed to connect to the soft-AP (wifi_config_t.ap.max_connection). + Upper bound matches ESP_WIFI_MAX_CONN_NUM in esp_wifi_types_native.h: + 1-4 on ESP32-C2, 1-15 on other Wi-Fi chips. + Soft-AP and ESP-NOW share encryption keys; see Wi-Fi driver documentation + if ESP-NOW is enabled. endmenu menu "STA Configuration" diff --git a/examples/wifi/wps_softap_registrar/main/Kconfig.projbuild b/examples/wifi/wps_softap_registrar/main/Kconfig.projbuild index 4f173a0cabe..a1cb700bddc 100644 --- a/examples/wifi/wps_softap_registrar/main/Kconfig.projbuild +++ b/examples/wifi/wps_softap_registrar/main/Kconfig.projbuild @@ -22,8 +22,14 @@ menu "Example Configuration" config EXAMPLE_MAX_STA_CONN int "Maximal STA connections" default 4 + range 1 4 if IDF_TARGET_ESP32C2 + range 1 15 help - Max number of the STA connects to AP. + Maximum number of STAs allowed to connect to the soft-AP (wifi_config_t.ap.max_connection). + Upper bound matches ESP_WIFI_MAX_CONN_NUM in esp_wifi_types_native.h: + 1-4 on ESP32-C2, 1-15 on other Wi-Fi chips. + Soft-AP and ESP-NOW share encryption keys; see Wi-Fi driver documentation + if ESP-NOW is enabled. choice EXAMPLE_WPS_TYPE prompt "WPS mode" @@ -44,7 +50,7 @@ menu "Example Configuration" int "WPS PIN" default 0 help - WPS PIN to be used for the connection, incase its not give, AP will derive a new one. + WPS PIN to be used for the connection, in case its not give, AP will derive a new one. endif endmenu