| 
									
										
										
										
											2019-04-09 14:12:47 +08:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2019-09-23 16:10:57 +02:00
										 |  |  | menu "Wi-Fi" | 
					
						
							| 
									
										
										
										
											2024-11-06 15:17:31 +08:00
										 |  |  |     visible if (SOC_WIFI_SUPPORTED || SOC_WIRELESS_HOST_SUPPORTED) | 
					
						
							| 
									
										
										
										
											2021-06-08 20:09:27 +08:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2023-02-11 07:38:45 +08:00
										 |  |  |     config ESP_WIFI_ENABLED | 
					
						
							| 
									
										
										
										
											2021-06-11 16:30:22 +08:00
										 |  |  |         bool | 
					
						
							| 
									
										
										
										
											2022-05-10 04:00:01 -04:00
										 |  |  |         default y if SOC_WIFI_SUPPORTED | 
					
						
							| 
									
										
										
										
											2019-04-09 14:12:47 +08:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2024-03-27 16:29:09 +08:00
										 |  |  |     config ESP_HOST_WIFI_ENABLED | 
					
						
							|  |  |  |         bool "Host WiFi Enable" | 
					
						
							|  |  |  |         depends on SOC_WIRELESS_HOST_SUPPORTED | 
					
						
							|  |  |  |         default n | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |     config ESP_WIFI_CONTROLLER_TARGET | 
					
						
							|  |  |  |         depends on ESP_HOST_WIFI_ENABLED | 
					
						
							|  |  |  |         string | 
					
						
							|  |  |  |         default "esp32" | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |     config ESP_WIFI_TARGET_ESP32 | 
					
						
							|  |  |  |         depends on ESP_HOST_WIFI_ENABLED | 
					
						
							|  |  |  |         bool | 
					
						
							|  |  |  |         default y if ESP_WIFI_CONTROLLER_TARGET="esp32" | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |     if (ESP_WIFI_ENABLED || ESP_HOST_WIFI_ENABLED) | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_STATIC_RX_BUFFER_NUM | 
					
						
							|  |  |  |             int "Max number of WiFi static RX buffers" | 
					
						
							|  |  |  |             range 2 25 if !SOC_WIFI_HE_SUPPORT | 
					
						
							|  |  |  |             range 2 128 if SOC_WIFI_HE_SUPPORT | 
					
						
							| 
									
										
										
										
											2024-08-28 13:33:47 +08:00
										 |  |  |             default 10 if !(SPIRAM_TRY_ALLOCATE_WIFI_LWIP && !SPIRAM_IGNORE_NOTFOUND) | 
					
						
							|  |  |  |             default 16 if (SPIRAM_TRY_ALLOCATE_WIFI_LWIP && !SPIRAM_IGNORE_NOTFOUND) | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  |             help | 
					
						
							|  |  |  |                 Set the number of WiFi static RX buffers. Each buffer takes approximately 1.6KB of RAM. | 
					
						
							|  |  |  |                 The static rx buffers are allocated when esp_wifi_init is called, they are not freed | 
					
						
							|  |  |  |                 until esp_wifi_deinit is called. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |                 WiFi hardware use these buffers to receive all 802.11 frames. | 
					
						
							|  |  |  |                 A higher number may allow higher throughput but increases memory use. If ESP_WIFI_AMPDU_RX_ENABLED | 
					
						
							|  |  |  |                 is enabled, this value is recommended to set equal or bigger than ESP_WIFI_RX_BA_WIN in order to | 
					
						
							|  |  |  |                 achieve better throughput and compatibility with both stations and APs. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_DYNAMIC_RX_BUFFER_NUM | 
					
						
							|  |  |  |             int "Max number of WiFi dynamic RX buffers" | 
					
						
							|  |  |  |             range 0 128 if !LWIP_WND_SCALE | 
					
						
							|  |  |  |             range 0 1024 if LWIP_WND_SCALE | 
					
						
							|  |  |  |             default 32 | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Set the number of WiFi dynamic RX buffers, 0 means unlimited RX buffers will be allocated | 
					
						
							|  |  |  |                 (provided sufficient free RAM). The size of each dynamic RX buffer depends on the size of | 
					
						
							|  |  |  |                 the received data frame. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |                 For each received data frame, the WiFi driver makes a copy to an RX buffer and then delivers | 
					
						
							|  |  |  |                 it to the high layer TCP/IP stack. The dynamic RX buffer is freed after the higher layer has | 
					
						
							|  |  |  |                 successfully received the data frame. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |                 For some applications, WiFi data frames may be received faster than the application can | 
					
						
							|  |  |  |                 process them. In these cases we may run out of memory if RX buffer number is unlimited (0). | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |                 If a dynamic RX buffer limit is set, it should be at least the number of static RX buffers. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         choice ESP_WIFI_TX_BUFFER | 
					
						
							|  |  |  |             prompt "Type of WiFi TX buffers" | 
					
						
							|  |  |  |             default ESP_WIFI_DYNAMIC_TX_BUFFER | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Select type of WiFi TX buffers: | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |                 If "Static" is selected, WiFi TX buffers are allocated when WiFi is initialized and released | 
					
						
							|  |  |  |                 when WiFi is de-initialized. The size of each static TX buffer is fixed to about 1.6KB. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |                 If "Dynamic" is selected, each WiFi TX buffer is allocated as needed when a data frame is | 
					
						
							|  |  |  |                 delivered to the Wifi driver from the TCP/IP stack. The buffer is freed after the data frame | 
					
						
							|  |  |  |                 has been sent by the WiFi driver. The size of each dynamic TX buffer depends on the length | 
					
						
							|  |  |  |                 of each data frame sent by the TCP/IP layer. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |                 If PSRAM is enabled, "Static" should be selected to guarantee enough WiFi TX buffers. | 
					
						
							|  |  |  |                 If PSRAM is disabled, "Dynamic" should be selected to improve the utilization of RAM. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |             config ESP_WIFI_STATIC_TX_BUFFER | 
					
						
							|  |  |  |                 bool "Static" | 
					
						
							|  |  |  |             config ESP_WIFI_DYNAMIC_TX_BUFFER | 
					
						
							|  |  |  |                 bool "Dynamic" | 
					
						
							| 
									
										
										
										
											2024-08-28 13:33:47 +08:00
										 |  |  |                 depends on !(SPIRAM_TRY_ALLOCATE_WIFI_LWIP && !SPIRAM_IGNORE_NOTFOUND) | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  |         endchoice | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_TX_BUFFER_TYPE | 
					
						
							|  |  |  |             int | 
					
						
							|  |  |  |             default 0 if ESP_WIFI_STATIC_TX_BUFFER | 
					
						
							|  |  |  |             default 1 if ESP_WIFI_DYNAMIC_TX_BUFFER | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_STATIC_TX_BUFFER_NUM | 
					
						
							|  |  |  |             int "Max number of WiFi static TX buffers" | 
					
						
							|  |  |  |             depends on ESP_WIFI_STATIC_TX_BUFFER | 
					
						
							|  |  |  |             range 1 64 | 
					
						
							|  |  |  |             default 16 | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Set the number of WiFi static TX buffers. Each buffer takes approximately 1.6KB of RAM. | 
					
						
							|  |  |  |                 The static RX buffers are allocated when esp_wifi_init() is called, they are not released | 
					
						
							|  |  |  |                 until esp_wifi_deinit() is called. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |                 For each transmitted data frame from the higher layer TCP/IP stack, the WiFi driver makes a | 
					
						
							|  |  |  |                 copy of it in a TX buffer.  For some applications especially UDP applications, the upper | 
					
						
							|  |  |  |                 layer can deliver frames faster than WiFi layer can transmit. In these cases, we may run out | 
					
						
							|  |  |  |                 of TX buffers. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_CACHE_TX_BUFFER_NUM | 
					
						
							|  |  |  |             int "Max number of WiFi cache TX buffers" | 
					
						
							| 
									
										
										
										
											2024-08-28 13:33:47 +08:00
										 |  |  |             depends on (SPIRAM_TRY_ALLOCATE_WIFI_LWIP && !SPIRAM_IGNORE_NOTFOUND) | 
					
						
							|  |  |  |             range 0 128 | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  |             default 32 | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Set the number of WiFi cache TX buffer number. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |                 For each TX packet from uplayer, such as LWIP etc, WiFi driver needs to allocate a static TX | 
					
						
							|  |  |  |                 buffer and makes a copy of uplayer packet. If WiFi driver fails to allocate the static TX buffer, | 
					
						
							|  |  |  |                 it caches the uplayer packets to a dedicated buffer queue, this option is used to configure the | 
					
						
							|  |  |  |                 size of the cached TX queue. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_DYNAMIC_TX_BUFFER_NUM | 
					
						
							|  |  |  |             int "Max number of WiFi dynamic TX buffers" | 
					
						
							|  |  |  |             depends on ESP_WIFI_DYNAMIC_TX_BUFFER | 
					
						
							|  |  |  |             range 1 128 | 
					
						
							|  |  |  |             default 32 | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Set the number of WiFi dynamic TX buffers. The size of each dynamic TX buffer is not fixed, | 
					
						
							|  |  |  |                 it depends on the size of each transmitted data frame. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |                 For each transmitted frame from the higher layer TCP/IP stack, the WiFi driver makes a copy | 
					
						
							|  |  |  |                 of it in a TX buffer. For some applications, especially UDP applications, the upper layer | 
					
						
							|  |  |  |                 can deliver frames faster than WiFi layer can transmit. In these cases, we may run out of TX | 
					
						
							|  |  |  |                 buffers. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         choice ESP_WIFI_MGMT_RX_BUFFER | 
					
						
							|  |  |  |             prompt "Type of WiFi RX MGMT buffers" | 
					
						
							|  |  |  |             default ESP_WIFI_STATIC_RX_MGMT_BUFFER | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Select type of WiFi RX MGMT buffers: | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |                 If "Static" is selected, WiFi RX MGMT buffers are allocated when WiFi is initialized and released | 
					
						
							|  |  |  |                 when WiFi is de-initialized. The size of each static RX MGMT buffer is fixed to about 500 Bytes. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |                 If "Dynamic" is selected, each WiFi RX MGMT buffer is allocated as needed when a MGMT data frame is | 
					
						
							|  |  |  |                 received. The MGMT buffer is freed after the MGMT data frame has been processed by the WiFi driver. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |             config ESP_WIFI_STATIC_RX_MGMT_BUFFER | 
					
						
							|  |  |  |                 bool "Static" | 
					
						
							|  |  |  |             config ESP_WIFI_DYNAMIC_RX_MGMT_BUFFER | 
					
						
							|  |  |  |                 bool "Dynamic" | 
					
						
							|  |  |  |         endchoice | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_DYNAMIC_RX_MGMT_BUF | 
					
						
							|  |  |  |             int | 
					
						
							|  |  |  |             default 0 if ESP_WIFI_STATIC_RX_MGMT_BUFFER | 
					
						
							|  |  |  |             default 1 if ESP_WIFI_DYNAMIC_RX_MGMT_BUFFER | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_RX_MGMT_BUF_NUM_DEF | 
					
						
							|  |  |  |             int "Max number of WiFi RX MGMT buffers" | 
					
						
							|  |  |  |             range 1 10 | 
					
						
							|  |  |  |             default 5 | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Set the number of WiFi RX_MGMT buffers. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |                 For Management buffers, the number of dynamic and static management buffers is the same. | 
					
						
							|  |  |  |                 In order to prevent memory fragmentation, the management buffer type should be set to static first. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_CSI_ENABLED | 
					
						
							|  |  |  |             bool "WiFi CSI(Channel State Information)" | 
					
						
							|  |  |  |             depends on SOC_WIFI_CSI_SUPPORT | 
					
						
							|  |  |  |             default n | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Select this option to enable CSI(Channel State Information) feature. CSI takes about | 
					
						
							|  |  |  |                 CONFIG_ESP_WIFI_STATIC_RX_BUFFER_NUM KB of RAM. If CSI is not used, it is better to disable | 
					
						
							|  |  |  |                 this feature in order to save memory. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_AMPDU_TX_ENABLED | 
					
						
							|  |  |  |             bool "WiFi AMPDU TX" | 
					
						
							|  |  |  |             default y | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Select this option to enable AMPDU TX feature | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_TX_BA_WIN | 
					
						
							|  |  |  |             int "WiFi AMPDU TX BA window size" | 
					
						
							|  |  |  |             depends on ESP_WIFI_AMPDU_TX_ENABLED | 
					
						
							|  |  |  |             range 2 32 if !SOC_WIFI_HE_SUPPORT | 
					
						
							|  |  |  |             range 2 64 if SOC_WIFI_HE_SUPPORT | 
					
						
							|  |  |  |             default 6 | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Set the size of WiFi Block Ack TX window. Generally a bigger value means higher throughput but | 
					
						
							|  |  |  |                 more memory. Most of time we should NOT change the default value unless special reason, e.g. | 
					
						
							|  |  |  |                 test the maximum UDP TX throughput with iperf etc. For iperf test in shieldbox, the recommended | 
					
						
							|  |  |  |                 value is 9~12. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_AMPDU_RX_ENABLED | 
					
						
							|  |  |  |             bool "WiFi AMPDU RX" | 
					
						
							|  |  |  |             default y | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Select this option to enable AMPDU RX feature | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_RX_BA_WIN | 
					
						
							|  |  |  |             int "WiFi AMPDU RX BA window size" | 
					
						
							|  |  |  |             depends on ESP_WIFI_AMPDU_RX_ENABLED | 
					
						
							|  |  |  |             range 2 32 if !SOC_WIFI_HE_SUPPORT | 
					
						
							|  |  |  |             range 2 64 if SOC_WIFI_HE_SUPPORT | 
					
						
							| 
									
										
										
										
											2024-08-28 13:33:47 +08:00
										 |  |  |             default 6 if !(SPIRAM_TRY_ALLOCATE_WIFI_LWIP && !SPIRAM_IGNORE_NOTFOUND) | 
					
						
							|  |  |  |             default 16 if (SPIRAM_TRY_ALLOCATE_WIFI_LWIP && !SPIRAM_IGNORE_NOTFOUND) | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  |             help | 
					
						
							|  |  |  |                 Set the size of WiFi Block Ack RX window. Generally a bigger value means higher throughput and better | 
					
						
							|  |  |  |                 compatibility but more memory. Most of time we should NOT change the default value unless special | 
					
						
							|  |  |  |                 reason, e.g. test the maximum UDP RX throughput with iperf etc. For iperf test in shieldbox, the | 
					
						
							| 
									
										
										
										
											2024-03-27 16:29:09 +08:00
										 |  |  |                 recommended value is 9~12. If PSRAM is used and WiFi memory is preferred to allocate in PSRAM first, | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  |                 the default and minimum value should be 16 to achieve better throughput and compatibility with both | 
					
						
							|  |  |  |                 stations and APs. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_AMSDU_TX_ENABLED | 
					
						
							|  |  |  |             bool "WiFi AMSDU TX" | 
					
						
							| 
									
										
										
										
											2024-08-28 13:33:47 +08:00
										 |  |  |             depends on (ESP_WIFI_CACHE_TX_BUFFER_NUM >= 2) | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  |             default n | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Select this option to enable AMSDU TX feature | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_NVS_ENABLED | 
					
						
							|  |  |  |             bool "WiFi NVS flash" | 
					
						
							|  |  |  |             default y | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Select this option to enable WiFi NVS flash | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         choice ESP_WIFI_TASK_CORE_ID | 
					
						
							|  |  |  |             depends on !FREERTOS_UNICORE | 
					
						
							|  |  |  |             prompt "WiFi Task Core ID" | 
					
						
							|  |  |  |             default ESP_WIFI_TASK_PINNED_TO_CORE_0 | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Pinned WiFi task to core 0 or core 1. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |             config ESP_WIFI_TASK_PINNED_TO_CORE_0 | 
					
						
							|  |  |  |                 bool "Core 0" | 
					
						
							|  |  |  |             config ESP_WIFI_TASK_PINNED_TO_CORE_1 | 
					
						
							|  |  |  |                 bool "Core 1" | 
					
						
							|  |  |  |         endchoice | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_SOFTAP_BEACON_MAX_LEN | 
					
						
							|  |  |  |             int "Max length of WiFi SoftAP Beacon" | 
					
						
							|  |  |  |             range 752 1256 | 
					
						
							|  |  |  |             default 752 | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 ESP-MESH utilizes beacon frames to detect and resolve root node conflicts (see documentation). However | 
					
						
							|  |  |  |                 the default length of a beacon frame can simultaneously hold only five root node identifier structures, | 
					
						
							| 
									
										
										
										
											2024-03-27 16:29:09 +08:00
										 |  |  |                 meaning that a root node conflict of up to five nodes can be detected at one time. In the occurrence of | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  |                 more root nodes conflict involving more than five root nodes, the conflict resolution process will | 
					
						
							|  |  |  |                 detect five of the root nodes, resolve the conflict, and re-detect more root nodes. This process will | 
					
						
							|  |  |  |                 repeat until all root node conflicts are resolved. However this process can generally take a very long | 
					
						
							|  |  |  |                 time. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |                 To counter this situation, the beacon frame length can be increased such that more root nodes can be | 
					
						
							| 
									
										
										
										
											2024-03-27 16:29:09 +08:00
										 |  |  |                 detected simultaneously. Each additional root node will require 36 bytes and should be added on top of | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  |                 the default beacon frame length of | 
					
						
							|  |  |  |                 752 bytes. For example, if you want to detect 10 root nodes simultaneously, you need to set the beacon | 
					
						
							|  |  |  |                 frame length as | 
					
						
							|  |  |  |                 932 (752+36*5). | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |                 Setting a longer beacon length also assists with debugging as the conflicting root nodes can be | 
					
						
							|  |  |  |                 identified more quickly. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_MGMT_SBUF_NUM | 
					
						
							|  |  |  |             int "WiFi mgmt short buffer number" | 
					
						
							|  |  |  |             range 6 32 | 
					
						
							|  |  |  |             default 32 | 
					
						
							|  |  |  |             help | 
					
						
							| 
									
										
										
										
											2024-07-29 16:09:25 +08:00
										 |  |  |                 Set the maximum number of Wi-Fi management short buffers. These buffers are dynamically allocated, | 
					
						
							|  |  |  |                 with their size determined by the length of the management packet to be sent. When a management | 
					
						
							|  |  |  |                 packet is less than 64 bytes, the Wi-Fi driver classifies it as a short management packet and | 
					
						
							|  |  |  |                 assigns it to one of these buffers. | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_IRAM_OPT | 
					
						
							|  |  |  |             bool "WiFi IRAM speed optimization" | 
					
						
							|  |  |  |             default n if (BT_ENABLED && SPIRAM && IDF_TARGET_ESP32) | 
					
						
							|  |  |  |             default y | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Select this option to place frequently called Wi-Fi library functions in IRAM. | 
					
						
							|  |  |  |                 When this option is disabled, more than 10Kbytes of IRAM memory will be saved | 
					
						
							|  |  |  |                 but Wi-Fi throughput will be reduced. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_EXTRA_IRAM_OPT | 
					
						
							|  |  |  |             bool "WiFi EXTRA IRAM speed optimization" | 
					
						
							| 
									
										
										
										
											2024-03-28 20:52:43 +08:00
										 |  |  |             default y if SOC_WIFI_HE_SUPPORT | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  |             default n | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Select this option to place additional frequently called Wi-Fi library functions | 
					
						
							|  |  |  |                 in IRAM. When this option is disabled, more than 5Kbytes of IRAM memory will be saved | 
					
						
							|  |  |  |                 but Wi-Fi throughput will be reduced. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_RX_IRAM_OPT | 
					
						
							|  |  |  |             bool "WiFi RX IRAM speed optimization" | 
					
						
							|  |  |  |             default n if (BT_ENABLED && SPIRAM && IDF_TARGET_ESP32) | 
					
						
							|  |  |  |             default y | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Select this option to place frequently called Wi-Fi library RX functions in IRAM. | 
					
						
							|  |  |  |                 When this option is disabled, more than 17Kbytes of IRAM memory will be saved | 
					
						
							|  |  |  |                 but Wi-Fi performance will be reduced. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_ENABLE_WPA3_SAE | 
					
						
							|  |  |  |             bool "Enable WPA3-Personal" | 
					
						
							|  |  |  |             default y | 
					
						
							|  |  |  |             select ESP_WIFI_MBEDTLS_CRYPTO | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Select this option to allow the device to establish a WPA3-Personal connection with eligible AP's. | 
					
						
							|  |  |  |                 PMF (Protected Management Frames) is a prerequisite feature for a WPA3 connection, it needs to be | 
					
						
							|  |  |  |                 explicitly configured before attempting connection. Please refer to the Wi-Fi Driver API Guide | 
					
						
							|  |  |  |                 for details. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_ENABLE_SAE_PK | 
					
						
							|  |  |  |             bool "Enable SAE-PK" | 
					
						
							|  |  |  |             default y | 
					
						
							|  |  |  |             depends on ESP_WIFI_ENABLE_WPA3_SAE | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Select this option to enable SAE-PK | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_SOFTAP_SAE_SUPPORT | 
					
						
							|  |  |  |             bool "Enable WPA3 Personal(SAE) SoftAP" | 
					
						
							|  |  |  |             default y | 
					
						
							|  |  |  |             depends on ESP_WIFI_ENABLE_WPA3_SAE | 
					
						
							|  |  |  |             depends on ESP_WIFI_SOFTAP_SUPPORT | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Select this option to enable SAE support in softAP mode. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_ENABLE_WPA3_OWE_STA | 
					
						
							|  |  |  |             bool "Enable OWE STA" | 
					
						
							|  |  |  |             default y | 
					
						
							|  |  |  |             select ESP_WIFI_MBEDTLS_CRYPTO | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Select this option to allow the device to establish OWE connection with eligible AP's. | 
					
						
							|  |  |  |                 PMF (Protected Management Frames) is a prerequisite feature for a WPA3 connection, it needs to be | 
					
						
							|  |  |  |                 explicitly configured before attempting connection. Please refer to the Wi-Fi Driver API Guide | 
					
						
							|  |  |  |                 for details. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_SLP_IRAM_OPT | 
					
						
							|  |  |  |             bool "WiFi SLP IRAM speed optimization" | 
					
						
							|  |  |  |             select PM_SLP_DEFAULT_PARAMS_OPT | 
					
						
							|  |  |  |             select PERIPH_CTRL_FUNC_IN_IRAM | 
					
						
							| 
									
										
										
										
											2024-03-28 20:52:43 +08:00
										 |  |  |             default y if SOC_WIFI_HE_SUPPORT | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  |             help | 
					
						
							|  |  |  |                 Select this option to place called Wi-Fi library TBTT process and receive beacon functions in IRAM. | 
					
						
							|  |  |  |                 Some functions can be put in IRAM either by ESP_WIFI_IRAM_OPT and ESP_WIFI_RX_IRAM_OPT, or this one. | 
					
						
							|  |  |  |                 If already enabled ESP_WIFI_IRAM_OPT, the other 7.3KB IRAM memory would be taken by this option. | 
					
						
							|  |  |  |                 If already enabled ESP_WIFI_RX_IRAM_OPT, the other 1.3KB IRAM memory would be taken by this option. | 
					
						
							|  |  |  |                 If neither of them are enabled, the other 7.4KB IRAM memory would be taken by this option. | 
					
						
							|  |  |  |                 Wi-Fi power-save mode average current would be reduced if this option is enabled. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_SLP_DEFAULT_MIN_ACTIVE_TIME | 
					
						
							|  |  |  |             int "Minimum active time" | 
					
						
							|  |  |  |             range 8 60 | 
					
						
							|  |  |  |             default 50 | 
					
						
							|  |  |  |             help | 
					
						
							| 
									
										
										
										
											2024-03-20 13:48:36 +08:00
										 |  |  |                 Only for station in WIFI_PS_MIN_MODEM or WIFI_PS_MAX_MODEM. When the station enters the active state, | 
					
						
							|  |  |  |                 it will work for at least ESP_WIFI_SLP_DEFAULT_MIN_ACTIVE_TIME. If a data packet is received or sent | 
					
						
							|  |  |  |                 during this period, the time will be refreshed. If the time is up, but the station still has packets | 
					
						
							|  |  |  |                 to receive or send, the time will also be refreshed. unit: milliseconds. | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_SLP_DEFAULT_MAX_ACTIVE_TIME | 
					
						
							|  |  |  |             int "Maximum keep alive time" | 
					
						
							|  |  |  |             range 10 60 | 
					
						
							|  |  |  |             default 10 | 
					
						
							|  |  |  |             help | 
					
						
							| 
									
										
										
										
											2024-03-20 13:48:36 +08:00
										 |  |  |                 Only for station in WIFI_PS_MIN_MODEM or WIFI_PS_MAX_MODEM. If no packet has been | 
					
						
							|  |  |  |                 sent within ESP_WIFI_SLP_DEFAULT_MAX_ACTIVE_TIME, a null data packet will be sent | 
					
						
							|  |  |  |                 to maintain the connection with the AP. unit: seconds. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_SLP_DEFAULT_WAIT_BROADCAST_DATA_TIME | 
					
						
							|  |  |  |             int "Minimum wait broadcast data time" | 
					
						
							|  |  |  |             range 10 30 | 
					
						
							|  |  |  |             default 15 | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Only for station in WIFI_PS_MIN_MODEM or WIFI_PS_MAX_MODEM. When the station knows through the beacon | 
					
						
							|  |  |  |                 that AP will send broadcast packet, it will wait for ESP_WIFI_SLP_DEFAULT_WAIT_BROADCAST_DATA_TIME | 
					
						
							|  |  |  |                 before entering the sleep process. If a broadcast packet is received with more data bits, the time | 
					
						
							|  |  |  |                 will refreshed. unit: milliseconds. | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_FTM_ENABLE | 
					
						
							|  |  |  |             bool "WiFi FTM" | 
					
						
							|  |  |  |             default n | 
					
						
							|  |  |  |             depends on SOC_WIFI_FTM_SUPPORT | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Enable feature Fine Timing Measurement for calculating WiFi Round-Trip-Time (RTT). | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_FTM_INITIATOR_SUPPORT | 
					
						
							|  |  |  |             bool "FTM Initiator support" | 
					
						
							|  |  |  |             default y | 
					
						
							|  |  |  |             depends on ESP_WIFI_FTM_ENABLE | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_FTM_RESPONDER_SUPPORT | 
					
						
							|  |  |  |             bool "FTM Responder support" | 
					
						
							|  |  |  |             default y | 
					
						
							|  |  |  |             depends on ESP_WIFI_FTM_ENABLE | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_STA_DISCONNECTED_PM_ENABLE | 
					
						
							|  |  |  |             bool "Power Management for station at disconnected" | 
					
						
							|  |  |  |             default y | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Select this option to enable power_management for station when disconnected. | 
					
						
							|  |  |  |                 Chip will do modem-sleep when rf module is not in use any more. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_GCMP_SUPPORT | 
					
						
							|  |  |  |             bool "WiFi GCMP Support(GCMP128 and GCMP256)" | 
					
						
							|  |  |  |             default n | 
					
						
							|  |  |  |             depends on SOC_WIFI_GCMP_SUPPORT | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Select this option to enable GCMP support. GCMP support is compulsory for WiFi Suite-B support. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_GMAC_SUPPORT | 
					
						
							|  |  |  |             bool "WiFi GMAC Support(GMAC128 and GMAC256)" | 
					
						
							| 
									
										
										
										
											2024-06-04 17:27:18 +08:00
										 |  |  |             default y | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  |             help | 
					
						
							|  |  |  |                 Select this option to enable GMAC support. GMAC support is compulsory for WiFi 192 bit certification. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_SOFTAP_SUPPORT | 
					
						
							|  |  |  |             bool "WiFi SoftAP Support" | 
					
						
							| 
									
										
										
										
											2023-02-11 07:38:45 +08:00
										 |  |  |             default y | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  |             help | 
					
						
							|  |  |  |                 WiFi module can be compiled without SoftAP to save code size. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_ENHANCED_LIGHT_SLEEP | 
					
						
							|  |  |  |             bool "WiFi modem automatically receives the beacon" | 
					
						
							|  |  |  |             default n | 
					
						
							|  |  |  |             depends on ESP_PHY_MAC_BB_PD && SOC_PM_SUPPORT_BEACON_WAKEUP | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 The wifi modem automatically receives the beacon frame during light sleep. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_SLP_BEACON_LOST_OPT | 
					
						
							|  |  |  |             bool "Wifi sleep optimize when beacon lost" | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Enable wifi sleep optimization when beacon loss occurs and immediately enter | 
					
						
							|  |  |  |                 sleep mode when the WiFi module detects beacon loss. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_SLP_BEACON_LOST_TIMEOUT | 
					
						
							|  |  |  |             int "Beacon loss timeout" | 
					
						
							|  |  |  |             range 5 100 | 
					
						
							|  |  |  |             default 10 | 
					
						
							|  |  |  |             depends on ESP_WIFI_SLP_BEACON_LOST_OPT | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Timeout time for close rf phy when beacon loss occurs, Unit: 1024 microsecond. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_SLP_BEACON_LOST_THRESHOLD | 
					
						
							|  |  |  |             int "Maximum number of consecutive lost beacons allowed" | 
					
						
							|  |  |  |             range 0 8 | 
					
						
							|  |  |  |             default 3 | 
					
						
							|  |  |  |             depends on ESP_WIFI_SLP_BEACON_LOST_OPT | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Maximum number of consecutive lost beacons allowed, WiFi keeps Rx state when | 
					
						
							|  |  |  |                 the number of consecutive beacons lost is greater than the given threshold. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_SLP_PHY_ON_DELTA_EARLY_TIME | 
					
						
							|  |  |  |             int "Delta early time for RF PHY on" | 
					
						
							|  |  |  |             range 0 100 | 
					
						
							|  |  |  |             default 2 | 
					
						
							|  |  |  |             depends on ESP_WIFI_SLP_BEACON_LOST_OPT && SOC_WIFI_SUPPORT_VARIABLE_BEACON_WINDOW | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Delta early time for rf phy on, When the beacon is lost, the next rf phy on will | 
					
						
							|  |  |  |                 be earlier the time specified by the configuration item, Unit: 32 microsecond. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_SLP_PHY_OFF_DELTA_TIMEOUT_TIME | 
					
						
							|  |  |  |             int "Delta timeout time for RF PHY off" | 
					
						
							|  |  |  |             range 0 8 | 
					
						
							|  |  |  |             default 2 | 
					
						
							|  |  |  |             depends on ESP_WIFI_SLP_BEACON_LOST_OPT && SOC_WIFI_SUPPORT_VARIABLE_BEACON_WINDOW | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Delta timeout time for rf phy off, When the beacon is lost, the next rf phy off will | 
					
						
							|  |  |  |                 be delayed for the time specified by the configuration item. Unit: 1024 microsecond. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_ESPNOW_MAX_ENCRYPT_NUM | 
					
						
							|  |  |  |             int "Maximum espnow encrypt peers number" | 
					
						
							|  |  |  |             range 0 4 if IDF_TARGET_ESP32C2 | 
					
						
							|  |  |  |             range 0 17 if (!IDF_TARGET_ESP32C2) | 
					
						
							|  |  |  |             default 2 if IDF_TARGET_ESP32C2 | 
					
						
							|  |  |  |             default 7 if (!IDF_TARGET_ESP32C2) | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Maximum number of encrypted peers supported by espnow. | 
					
						
							|  |  |  |                 The number of hardware keys for encryption is fixed. And the espnow and SoftAP share the same | 
					
						
							|  |  |  |                 hardware keys. So this configuration will affect the maximum connection number of SoftAP. | 
					
						
							|  |  |  |                 Maximum espnow encrypted peers number + maximum number of connections of SoftAP = Max hardware | 
					
						
							|  |  |  |                 keys number. When using ESP mesh, this value should be set to a maximum of 6. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_NAN_ENABLE | 
					
						
							|  |  |  |             bool "WiFi Aware" | 
					
						
							|  |  |  |             default n | 
					
						
							|  |  |  |             depends on SOC_WIFI_NAN_SUPPORT | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Enable WiFi Aware (NAN) feature. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_MBEDTLS_CRYPTO | 
					
						
							|  |  |  |             bool "Use MbedTLS crypto APIs" | 
					
						
							|  |  |  |             default y | 
					
						
							|  |  |  |             select MBEDTLS_AES_C | 
					
						
							|  |  |  |             select MBEDTLS_ECP_C | 
					
						
							|  |  |  |             select MBEDTLS_ECDH_C | 
					
						
							|  |  |  |             select MBEDTLS_ECDSA_C | 
					
						
							|  |  |  |             select MBEDTLS_CMAC_C | 
					
						
							|  |  |  |             select MBEDTLS_ECP_DP_SECP256R1_ENABLED | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Select this option to enable the use of MbedTLS crypto APIs. | 
					
						
							|  |  |  |                 The internal crypto support within the supplicant is limited | 
					
						
							|  |  |  |                 and may not suffice for all new security features, including WPA3. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |                 It is recommended to always keep this option enabled. Additionally, | 
					
						
							|  |  |  |                 note that MbedTLS can leverage hardware acceleration if available, | 
					
						
							|  |  |  |                 resulting in significantly faster cryptographic operations. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         if ESP_WIFI_MBEDTLS_CRYPTO | 
					
						
							|  |  |  |             config ESP_WIFI_MBEDTLS_TLS_CLIENT | 
					
						
							|  |  |  |                 bool "Use MbedTLS TLS client for WiFi Enterprise connection" | 
					
						
							|  |  |  |                 depends on ESP_WIFI_ENTERPRISE_SUPPORT | 
					
						
							|  |  |  |                 default y | 
					
						
							|  |  |  |                 select MBEDTLS_TLS_ENABLED | 
					
						
							|  |  |  |                 help | 
					
						
							|  |  |  |                     Select this option to use MbedTLS TLS client for WPA2 enterprise connection. | 
					
						
							|  |  |  |                     Please note that from MbedTLS-3.0 onwards, MbedTLS does not support SSL-3.0 | 
					
						
							| 
									
										
										
										
											2024-03-27 16:29:09 +08:00
										 |  |  |                     TLS-v1.0, TLS-v1.1 versions. In case your server is using one of these version, | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  |                     it is advisable to update your server. | 
					
						
							| 
									
										
										
										
											2024-03-27 16:29:09 +08:00
										 |  |  |                     Please disable this option for compatibility with older TLS versions. | 
					
						
							| 
									
										
										
										
											2023-11-11 13:39:31 +05:30
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2024-02-06 13:12:12 +05:30
										 |  |  |             config ESP_WIFI_EAP_TLS1_3 | 
					
						
							|  |  |  |                 bool "Enable EAP-TLS v1.3 Support for WiFi Enterprise connection" | 
					
						
							|  |  |  |                 default n | 
					
						
							|  |  |  |                 select MBEDTLS_SSL_PROTO_TLS1_3 | 
					
						
							|  |  |  |                 depends on ESP_WIFI_MBEDTLS_TLS_CLIENT && IDF_EXPERIMENTAL_FEATURES | 
					
						
							|  |  |  |                 help | 
					
						
							|  |  |  |                     Select this option to support EAP with TLS v1.3. | 
					
						
							|  |  |  |                     This configuration still supports compatibility with EAP-TLS v1.2. | 
					
						
							|  |  |  |                     Please note that enabling this configuration will cause every application which | 
					
						
							|  |  |  |                     uses TLS go for TLS1.3 if server supports that. TLS1.3 is still in development in mbedtls | 
					
						
							|  |  |  |                     and there may be interoperability issues with this. Please modify your application to set | 
					
						
							|  |  |  |                     max version as TLS1.2 if you want to enable TLS1.3 only for WiFi connection. | 
					
						
							| 
									
										
										
										
											2023-11-11 13:39:31 +05:30
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  |         endif | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_WAPI_PSK | 
					
						
							|  |  |  |             bool "Enable WAPI PSK support" | 
					
						
							|  |  |  |             depends on SOC_WIFI_WAPI_SUPPORT | 
					
						
							| 
									
										
										
										
											2023-02-21 11:46:17 +05:30
										 |  |  |             default n | 
					
						
							|  |  |  |             help | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  |                 Select this option to enable WAPI-PSK | 
					
						
							|  |  |  |                 which is a Chinese National Standard Encryption for Wireless LANs (GB 15629.11-2003). | 
					
						
							| 
									
										
										
										
											2023-02-21 11:46:17 +05:30
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  |         config ESP_WIFI_SUITE_B_192 | 
					
						
							|  |  |  |             bool "Enable NSA suite B support with 192 bit key" | 
					
						
							| 
									
										
										
										
											2023-02-21 11:46:17 +05:30
										 |  |  |             default n | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  |             depends on SOC_WIFI_GCMP_SUPPORT | 
					
						
							|  |  |  |             select ESP_WIFI_GCMP_SUPPORT | 
					
						
							|  |  |  |             select ESP_WIFI_GMAC_SUPPORT | 
					
						
							| 
									
										
										
										
											2023-02-21 11:46:17 +05:30
										 |  |  |             help | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  |                 Select this option to enable 192 bit NSA suite-B. | 
					
						
							|  |  |  |                 This is necessary to support WPA3 192 bit security. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_11KV_SUPPORT | 
					
						
							|  |  |  |             bool "Enable 802.11k, 802.11v APIs Support" | 
					
						
							|  |  |  |             default n | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Select this option to enable 802.11k 802.11v APIs(RRM and BTM support). | 
					
						
							| 
									
										
										
										
											2024-10-01 18:35:32 +05:30
										 |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_RRM_SUPPORT | 
					
						
							|  |  |  |             bool "Enable 802.11k APIs Support" | 
					
						
							|  |  |  |             depends on ESP_WIFI_11KV_SUPPORT | 
					
						
							| 
									
										
										
										
											2025-03-03 16:14:39 +05:30
										 |  |  |             default y | 
					
						
							| 
									
										
										
										
											2024-10-01 18:35:32 +05:30
										 |  |  |             help | 
					
						
							|  |  |  |                 Select this option to enable 802.11k APIs(RRM support). | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  |                 Only APIs which are helpful for network assisted roaming | 
					
						
							|  |  |  |                 are supported for now. | 
					
						
							| 
									
										
										
										
											2024-10-01 18:35:32 +05:30
										 |  |  |                 Enable this option with RRM enabled in sta config | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  |                 to make device ready for network assisted roaming. | 
					
						
							|  |  |  |                 RRM: Radio measurements enable STAs to understand the radio environment, | 
					
						
							|  |  |  |                 it enables STAs to observe and gather data on radio link performance | 
					
						
							|  |  |  |                 and on the radio environment. Current implementation adds beacon report, | 
					
						
							|  |  |  |                 link measurement, neighbor report. | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2024-10-01 18:35:32 +05:30
										 |  |  |         config ESP_WIFI_WNM_SUPPORT | 
					
						
							|  |  |  |             bool "Enable 802.11v APIs Support" | 
					
						
							|  |  |  |             depends on ESP_WIFI_11KV_SUPPORT | 
					
						
							| 
									
										
										
										
											2025-03-03 16:14:39 +05:30
										 |  |  |             default y | 
					
						
							| 
									
										
										
										
											2024-10-01 18:35:32 +05:30
										 |  |  |             help | 
					
						
							|  |  |  |                 Select this option to enable 802.11v APIs(BTM support). | 
					
						
							|  |  |  |                 Only APIs which are helpful for network assisted roaming | 
					
						
							|  |  |  |                 are supported for now. | 
					
						
							|  |  |  |                 Enable this option with BTM enabled in sta config | 
					
						
							|  |  |  |                 to make device ready for network assisted roaming. | 
					
						
							|  |  |  |                 BTM: BSS transition management enables an AP to request a station to transition | 
					
						
							|  |  |  |                 to a specific AP, or to indicate to a station a set of preferred APs. | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  |         config ESP_WIFI_SCAN_CACHE | 
					
						
							|  |  |  |             bool "Keep scan results in cache" | 
					
						
							| 
									
										
										
										
											2024-10-01 18:35:32 +05:30
										 |  |  |             depends on ESP_WIFI_RRM_SUPPORT | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  |             default n | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Keep scan results in cache, if not enabled, those | 
					
						
							|  |  |  |                 will be flushed immediately. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_MBO_SUPPORT | 
					
						
							|  |  |  |             bool "Enable Multi Band Operation Certification Support" | 
					
						
							|  |  |  |             default n | 
					
						
							|  |  |  |             select ESP_WIFI_11KV_SUPPORT | 
					
						
							| 
									
										
										
										
											2024-10-01 18:35:32 +05:30
										 |  |  |             select ESP_WIFI_RRM_SUPPORT | 
					
						
							|  |  |  |             select ESP_WIFI_WNM_SUPPORT | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  |             select ESP_WIFI_SCAN_CACHE | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Select this option to enable WiFi Multiband operation certification support. | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2024-03-29 18:39:47 +05:30
										 |  |  |         config ESP_WIFI_ENABLE_ROAMING_APP | 
					
						
							|  |  |  |             bool "Advanced support for Wi-Fi Roaming (Experimental)" | 
					
						
							|  |  |  |             depends on IDF_EXPERIMENTAL_FEATURES | 
					
						
							|  |  |  |             default n | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Enable Espressif's roaming app to allow for efficient Wi-Fi roaming. | 
					
						
							|  |  |  |                 This includes configurable periodic environment scans, maintaining a cache of the | 
					
						
							|  |  |  |                 best APs, handling low rssi events etc. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |                 Risk Warning | 
					
						
							| 
									
										
										
										
											2024-04-01 17:14:01 +05:30
										 |  |  |                 Please note that this feature is still experimental and enabling this potentially can | 
					
						
							|  |  |  |                 lead to unpredictable scanning, connection and roaming attempts. | 
					
						
							|  |  |  |                 We are still working on tuning and optimising this feature to ensure reliable and stable use. | 
					
						
							| 
									
										
										
										
											2024-03-29 18:39:47 +05:30
										 |  |  | 
 | 
					
						
							|  |  |  |         menu "Configure roaming App" | 
					
						
							|  |  |  |             depends on ESP_WIFI_ENABLE_ROAMING_APP | 
					
						
							|  |  |  |             rsource "wifi_apps/roaming_app/src/Kconfig.roaming" | 
					
						
							|  |  |  |         endmenu | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  |         config ESP_WIFI_DPP_SUPPORT | 
					
						
							|  |  |  |             bool "Enable DPP support" | 
					
						
							|  |  |  |             default n | 
					
						
							|  |  |  |             select ESP_WIFI_MBEDTLS_CRYPTO | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Select this option to enable WiFi Easy Connect Support. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_11R_SUPPORT | 
					
						
							|  |  |  |             bool "Enable 802.11R (Fast Transition) Support" | 
					
						
							|  |  |  |             default n | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Select this option to enable WiFi Fast Transition Support. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_WPS_SOFTAP_REGISTRAR | 
					
						
							|  |  |  |             bool "Add WPS Registrar support in SoftAP mode" | 
					
						
							|  |  |  |             depends on ESP_WIFI_SOFTAP_SUPPORT | 
					
						
							|  |  |  |             default n | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Select this option to enable WPS registrar support in softAP mode. | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2024-03-28 20:52:43 +08:00
										 |  |  |         config ESP_WIFI_ENABLE_WIFI_TX_STATS | 
					
						
							|  |  |  |             bool "Enable Wi-Fi transmission statistics" | 
					
						
							|  |  |  |             depends on SOC_WIFI_HE_SUPPORT | 
					
						
							|  |  |  |             default n | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Enable Wi-Fi transmission statistics. Total support 4 access category. Each access category | 
					
						
							|  |  |  |                 will use 346 bytes memory. | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  |         config ESP_WIFI_ENABLE_WIFI_RX_STATS | 
					
						
							|  |  |  |             bool "Enable Wi-Fi reception statistics" | 
					
						
							|  |  |  |             depends on SOC_WIFI_HE_SUPPORT | 
					
						
							| 
									
										
										
										
											2024-03-28 20:52:43 +08:00
										 |  |  |             default n | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  |             help | 
					
						
							|  |  |  |                 Enable Wi-Fi reception statistics. Total support 2 access category. Each access category | 
					
						
							|  |  |  |                 will use 190 bytes memory. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_ENABLE_WIFI_RX_MU_STATS | 
					
						
							|  |  |  |             bool "Enable Wi-Fi DL MU-MIMO and DL OFDMA reception statistics" | 
					
						
							|  |  |  |             depends on ESP_WIFI_ENABLE_WIFI_RX_STATS | 
					
						
							| 
									
										
										
										
											2024-03-28 20:52:43 +08:00
										 |  |  |             default n | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  |             help | 
					
						
							|  |  |  |                 Enable Wi-Fi DL MU-MIMO and DL OFDMA reception statistics. Will use 10932 bytes memory. | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2024-03-28 20:52:43 +08:00
										 |  |  |         config ESP_WIFI_TX_HETB_QUEUE_NUM | 
					
						
							|  |  |  |             int "WiFi TX HE TB QUEUE number for STA HE TB PPDU transmission" | 
					
						
							|  |  |  |             depends on SOC_WIFI_HE_SUPPORT | 
					
						
							|  |  |  |             range 1 4 | 
					
						
							|  |  |  |             default 3 | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Set the maximum number of queue that can be aggregated by the STA in the A-MPDU carried in the | 
					
						
							|  |  |  |                 HE TB PPDU. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_ENABLE_DUMP_HESIGB | 
					
						
							|  |  |  |             bool "Enable Wi-Fi dump HE-SIGB which is contained in DL HE MU PPDUs" | 
					
						
							|  |  |  |             depends on SOC_WIFI_HE_SUPPORT_5G | 
					
						
							|  |  |  |             default "n" | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Enable Wi-Fi dump HE-SIGB which is contained in DL HE MU PPDUs. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_ENABLE_DUMP_MU_CFO | 
					
						
							|  |  |  |             bool "Enable Wi-Fi dump MU CFO" | 
					
						
							|  |  |  |             depends on SOC_WIFI_HE_SUPPORT_5G | 
					
						
							|  |  |  |             default "n" | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Enable Wi-Fi dump MU CFO. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_ENABLE_DUMP_CTRL_NDPA | 
					
						
							|  |  |  |             bool "Enable Wi-Fi dump NDPA frames" | 
					
						
							|  |  |  |             depends on SOC_WIFI_HE_SUPPORT_5G | 
					
						
							|  |  |  |             default "n" | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Enable Wi-Fi dump NDPA frames. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_ENABLE_DUMP_CTRL_BFRP | 
					
						
							|  |  |  |             bool "Enable Wi-Fi dump BFRP frames" | 
					
						
							|  |  |  |             depends on SOC_WIFI_HE_SUPPORT_5G | 
					
						
							|  |  |  |             default "n" | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Enable Wi-Fi dump BFRP frames. | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  |         menu "WPS Configuration Options" | 
					
						
							|  |  |  |             config ESP_WIFI_WPS_STRICT | 
					
						
							|  |  |  |                 bool "Strictly validate all WPS attributes" | 
					
						
							|  |  |  |                 default n | 
					
						
							|  |  |  |                 help | 
					
						
							|  |  |  |                     Select this option to enable validate each WPS attribute | 
					
						
							| 
									
										
										
										
											2024-03-27 16:29:09 +08:00
										 |  |  |                     rigorously. Disabling this add the workarounds with various APs. | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  |                     Enabling this may cause inter operability issues with some APs. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |             config ESP_WIFI_WPS_PASSPHRASE | 
					
						
							|  |  |  |                 bool "Get WPA2 passphrase in WPS config" | 
					
						
							|  |  |  |                 default n | 
					
						
							|  |  |  |                 help | 
					
						
							|  |  |  |                     Select this option to get passphrase during WPS configuration. | 
					
						
							| 
									
										
										
										
											2024-03-27 16:29:09 +08:00
										 |  |  |                     This option fakes the virtual display capabilities to get the | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  |                     configuration in passphrase mode. | 
					
						
							| 
									
										
										
										
											2024-03-27 16:29:09 +08:00
										 |  |  |                     Not recommended to be used since WPS credentials should not | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  |                     be shared to other devices, making it in readable format increases | 
					
						
							|  |  |  |                     that risk, also passphrase requires pbkdf2 to convert in psk. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         endmenu # "WPS Configuration Options" | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_DEBUG_PRINT | 
					
						
							|  |  |  |             bool "Print debug messages from WPA Supplicant" | 
					
						
							|  |  |  |             default n | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Select this option to print logging information from WPA supplicant, | 
					
						
							|  |  |  |                 this includes handshake information and key hex dumps depending | 
					
						
							|  |  |  |                 on the project logging level. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |                 Enabling this could increase the build size ~60kb | 
					
						
							|  |  |  |                 depending on the project logging level. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_TESTING_OPTIONS | 
					
						
							|  |  |  |             bool "Add DPP testing code" | 
					
						
							|  |  |  |             default n | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Select this to enable unity test for DPP. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |         config ESP_WIFI_ENTERPRISE_SUPPORT | 
					
						
							|  |  |  |             bool "Enable enterprise option" | 
					
						
							|  |  |  |             default y | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Select this to enable/disable enterprise connection support. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |                 disabling this will reduce binary size. | 
					
						
							|  |  |  |                 disabling this will disable the use of any esp_wifi_sta_wpa2_ent_* (as APIs will be meaningless) | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2024-02-07 21:40:40 +05:30
										 |  |  |                 Note that when using bigger certificates on low-power chips without crypto | 
					
						
							|  |  |  |                 hardware acceleration, it is recommended to adjust the task watchdog timer (TWDT) | 
					
						
							|  |  |  |                 if it is enabled. For precise information on timing requirements, you can check | 
					
						
							|  |  |  |                 performance numbers at https://github.com/espressif/mbedtls/wiki/Performance-Numbers. | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2023-10-06 12:56:00 +02:00
										 |  |  |         config ESP_WIFI_ENT_FREE_DYNAMIC_BUFFER | 
					
						
							|  |  |  |             bool "Free dynamic buffers during WiFi enterprise connection" | 
					
						
							|  |  |  |             depends on ESP_WIFI_ENTERPRISE_SUPPORT | 
					
						
							|  |  |  |             default y if IDF_TARGET_ESP32C2 | 
					
						
							|  |  |  |             default n if !IDF_TARGET_ESP32C2 | 
					
						
							|  |  |  |             help | 
					
						
							|  |  |  |                 Select this configuration to free dynamic buffers during WiFi enterprise connection. | 
					
						
							|  |  |  |                 This will enable chip to reduce heap consumption during WiFi enterprise connection. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |     endif # wifi enabled | 
					
						
							| 
									
										
										
										
											2024-01-02 21:08:10 +05:30
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-12-29 12:58:02 +08:00
										 |  |  | endmenu # Wi-Fi |