ESPHome 2026.3.0
Loading...
Searching...
No Matches
wifi_component_esp_idf.cpp
Go to the documentation of this file.
1#include "wifi_component.h"
2
3#ifdef USE_WIFI
4#ifdef USE_ESP32
5
6#include <esp_event.h>
7#include <esp_netif.h>
8#include <esp_system.h>
9#include <esp_wifi.h>
10#include <esp_wifi_types.h>
11#include <freertos/FreeRTOS.h>
12#include <freertos/event_groups.h>
13#include <freertos/task.h>
14
15#include <algorithm>
16#include <cinttypes>
17#include <memory>
18#include <utility>
19#ifdef USE_WIFI_WPA2_EAP
20#if (ESP_IDF_VERSION_MAJOR >= 5) && (ESP_IDF_VERSION_MINOR >= 1)
21#include <esp_eap_client.h>
22#else
23#include <esp_wpa2.h>
24#endif
25#endif
26
27#ifdef USE_WIFI_AP
28#include "dhcpserver/dhcpserver.h"
29#endif // USE_WIFI_AP
30
31#ifdef USE_CAPTIVE_PORTAL
33#endif
34
35#include "lwip/apps/sntp.h"
36#include "lwip/dns.h"
37#include "lwip/err.h"
38
40#include "esphome/core/hal.h"
42#include "esphome/core/log.h"
43#include "esphome/core/util.h"
44
45namespace esphome::wifi {
46
47static const char *const TAG = "wifi_esp32";
48
49static EventGroupHandle_t s_wifi_event_group; // NOLINT(cppcoreguidelines-avoid-non-const-global-variables)
50static QueueHandle_t s_event_queue; // NOLINT(cppcoreguidelines-avoid-non-const-global-variables)
51static esp_netif_t *s_sta_netif = nullptr; // NOLINT(cppcoreguidelines-avoid-non-const-global-variables)
52#ifdef USE_WIFI_AP
53static esp_netif_t *s_ap_netif = nullptr; // NOLINT(cppcoreguidelines-avoid-non-const-global-variables)
54#endif // USE_WIFI_AP
55static bool s_sta_started = false; // NOLINT(cppcoreguidelines-avoid-non-const-global-variables)
56static bool s_sta_connected = false; // NOLINT(cppcoreguidelines-avoid-non-const-global-variables)
57static bool s_sta_connect_not_found = false; // NOLINT(cppcoreguidelines-avoid-non-const-global-variables)
58static bool s_sta_connect_error = false; // NOLINT(cppcoreguidelines-avoid-non-const-global-variables)
59static bool s_sta_connecting = false; // NOLINT(cppcoreguidelines-avoid-non-const-global-variables)
60static bool s_wifi_started = false; // NOLINT(cppcoreguidelines-avoid-non-const-global-variables)
61
62struct IDFWiFiEvent {
63 esp_event_base_t event_base;
64 int32_t event_id;
65 union {
66 wifi_event_sta_scan_done_t sta_scan_done;
67 wifi_event_sta_connected_t sta_connected;
68 wifi_event_sta_disconnected_t sta_disconnected;
69 wifi_event_sta_authmode_change_t sta_authmode_change;
70 wifi_event_ap_staconnected_t ap_staconnected;
71 wifi_event_ap_stadisconnected_t ap_stadisconnected;
72 wifi_event_ap_probe_req_rx_t ap_probe_req_rx;
73 wifi_event_bss_rssi_low_t bss_rssi_low;
74 ip_event_got_ip_t ip_got_ip;
75#if USE_NETWORK_IPV6
76 ip_event_got_ip6_t ip_got_ip6;
77#endif /* USE_NETWORK_IPV6 */
78 ip_event_ap_staipassigned_t ip_ap_staipassigned;
79 } data;
80};
81
82// general design: event handler translates events and pushes them to a queue,
83// events get processed in the main loop
84void event_handler(void *arg, esp_event_base_t event_base, int32_t event_id, void *event_data) {
85 IDFWiFiEvent event;
86 memset(&event, 0, sizeof(IDFWiFiEvent));
87 event.event_base = event_base;
88 event.event_id = event_id;
89 if (event_base == WIFI_EVENT && event_id == WIFI_EVENT_STA_START) { // NOLINT(bugprone-branch-clone)
90 // no data
91 } else if (event_base == WIFI_EVENT && event_id == WIFI_EVENT_STA_STOP) { // NOLINT(bugprone-branch-clone)
92 // no data
93 } else if (event_base == WIFI_EVENT && event_id == WIFI_EVENT_STA_AUTHMODE_CHANGE) {
94 memcpy(&event.data.sta_authmode_change, event_data, sizeof(wifi_event_sta_authmode_change_t));
95 } else if (event_base == WIFI_EVENT && event_id == WIFI_EVENT_STA_CONNECTED) {
96 memcpy(&event.data.sta_connected, event_data, sizeof(wifi_event_sta_connected_t));
97 } else if (event_base == WIFI_EVENT && event_id == WIFI_EVENT_STA_DISCONNECTED) {
98 memcpy(&event.data.sta_disconnected, event_data, sizeof(wifi_event_sta_disconnected_t));
99 } else if (event_base == IP_EVENT && event_id == IP_EVENT_STA_GOT_IP) {
100 memcpy(&event.data.ip_got_ip, event_data, sizeof(ip_event_got_ip_t));
101#if USE_NETWORK_IPV6
102 } else if (event_base == IP_EVENT && event_id == IP_EVENT_GOT_IP6) {
103 memcpy(&event.data.ip_got_ip6, event_data, sizeof(ip_event_got_ip6_t));
104#endif
105 } else if (event_base == IP_EVENT && event_id == IP_EVENT_STA_LOST_IP) { // NOLINT(bugprone-branch-clone)
106 // no data
107 } else if (event_base == WIFI_EVENT && event_id == WIFI_EVENT_SCAN_DONE) {
108 memcpy(&event.data.sta_scan_done, event_data, sizeof(wifi_event_sta_scan_done_t));
109 } else if (event_base == WIFI_EVENT && event_id == WIFI_EVENT_AP_START) { // NOLINT(bugprone-branch-clone)
110 // no data
111 } else if (event_base == WIFI_EVENT && event_id == WIFI_EVENT_AP_STOP) { // NOLINT(bugprone-branch-clone)
112 // no data
113 } else if (event_base == WIFI_EVENT && event_id == WIFI_EVENT_AP_PROBEREQRECVED) {
114 memcpy(&event.data.ap_probe_req_rx, event_data, sizeof(wifi_event_ap_probe_req_rx_t));
115 } else if (event_base == WIFI_EVENT && event_id == WIFI_EVENT_AP_STACONNECTED) {
116 memcpy(&event.data.ap_staconnected, event_data, sizeof(wifi_event_ap_staconnected_t));
117 } else if (event_base == WIFI_EVENT && event_id == WIFI_EVENT_AP_STADISCONNECTED) {
118 memcpy(&event.data.ap_stadisconnected, event_data, sizeof(wifi_event_ap_stadisconnected_t));
119 } else if (event_base == IP_EVENT && event_id == IP_EVENT_AP_STAIPASSIGNED) {
120 memcpy(&event.data.ip_ap_staipassigned, event_data, sizeof(ip_event_ap_staipassigned_t));
121 } else {
122 // did not match any event, don't send anything
123 return;
124 }
125
126 // copy to heap to keep queue object small
127 auto *to_send = new IDFWiFiEvent; // NOLINT(cppcoreguidelines-owning-memory)
128 memcpy(to_send, &event, sizeof(IDFWiFiEvent));
129 // don't block, we may miss events but the core can handle that
130 if (xQueueSend(s_event_queue, &to_send, 0L) != pdPASS) {
131 delete to_send; // NOLINT(cppcoreguidelines-owning-memory)
132 }
133}
134
136 uint8_t mac[6];
139 set_mac_address(mac);
140 }
141 esp_err_t err = esp_netif_init();
142 if (err != ERR_OK) {
143 ESP_LOGE(TAG, "esp_netif_init failed: %s", esp_err_to_name(err));
144 return;
145 }
146 s_wifi_event_group = xEventGroupCreate();
147 if (s_wifi_event_group == nullptr) {
148 ESP_LOGE(TAG, "xEventGroupCreate failed");
149 return;
150 }
151 // NOLINTNEXTLINE(bugprone-sizeof-expression)
152 s_event_queue = xQueueCreate(64, sizeof(IDFWiFiEvent *));
153 if (s_event_queue == nullptr) {
154 ESP_LOGE(TAG, "xQueueCreate failed");
155 return;
156 }
157 err = esp_event_loop_create_default();
158 if (err != ERR_OK) {
159 ESP_LOGE(TAG, "esp_event_loop_create_default failed: %s", esp_err_to_name(err));
160 return;
161 }
162 esp_event_handler_instance_t instance_wifi_id, instance_ip_id;
163 err = esp_event_handler_instance_register(WIFI_EVENT, ESP_EVENT_ANY_ID, &event_handler, nullptr, &instance_wifi_id);
164 if (err != ERR_OK) {
165 ESP_LOGE(TAG, "esp_event_handler_instance_register failed: %s", esp_err_to_name(err));
166 return;
167 }
168 err = esp_event_handler_instance_register(IP_EVENT, ESP_EVENT_ANY_ID, &event_handler, nullptr, &instance_ip_id);
169 if (err != ERR_OK) {
170 ESP_LOGE(TAG, "esp_event_handler_instance_register failed: %s", esp_err_to_name(err));
171 return;
172 }
173
174 s_sta_netif = esp_netif_create_default_wifi_sta();
175
176#ifdef USE_WIFI_AP
177 s_ap_netif = esp_netif_create_default_wifi_ap();
178#endif // USE_WIFI_AP
179
180 wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT();
181 // cfg.nvs_enable = false;
182 err = esp_wifi_init(&cfg);
183 if (err != ERR_OK) {
184 ESP_LOGE(TAG, "esp_wifi_init failed: %s", esp_err_to_name(err));
185 return;
186 }
187 err = esp_wifi_set_storage(WIFI_STORAGE_RAM);
188 if (err != ERR_OK) {
189 ESP_LOGE(TAG, "esp_wifi_set_storage failed: %s", esp_err_to_name(err));
190 return;
191 }
192}
193
194bool WiFiComponent::wifi_mode_(optional<bool> sta, optional<bool> ap) {
195 esp_err_t err;
196 wifi_mode_t current_mode = WIFI_MODE_NULL;
197 if (s_wifi_started) {
198 err = esp_wifi_get_mode(&current_mode);
199 if (err != ERR_OK) {
200 ESP_LOGW(TAG, "esp_wifi_get_mode failed: %s", esp_err_to_name(err));
201 return false;
202 }
203 }
204 bool current_sta = current_mode == WIFI_MODE_STA || current_mode == WIFI_MODE_APSTA;
205 bool current_ap = current_mode == WIFI_MODE_AP || current_mode == WIFI_MODE_APSTA;
206
207 bool set_sta = sta.value_or(current_sta);
208 bool set_ap = ap.value_or(current_ap);
209
210 wifi_mode_t set_mode;
211 if (set_sta && set_ap) {
212 set_mode = WIFI_MODE_APSTA;
213 } else if (set_sta && !set_ap) {
214 set_mode = WIFI_MODE_STA;
215 } else if (!set_sta && set_ap) {
216 set_mode = WIFI_MODE_AP;
217 } else {
218 set_mode = WIFI_MODE_NULL;
219 }
220
221 if (current_mode == set_mode)
222 return true;
223
224 if (set_sta && !current_sta) {
225 ESP_LOGV(TAG, "Enabling STA");
226 } else if (!set_sta && current_sta) {
227 ESP_LOGV(TAG, "Disabling STA");
228 }
229 if (set_ap && !current_ap) {
230 ESP_LOGV(TAG, "Enabling AP");
231 } else if (!set_ap && current_ap) {
232 ESP_LOGV(TAG, "Disabling AP");
233 }
234
235 if (set_mode == WIFI_MODE_NULL && s_wifi_started) {
236 err = esp_wifi_stop();
237 if (err != ESP_OK) {
238 ESP_LOGV(TAG, "esp_wifi_stop failed: %s", esp_err_to_name(err));
239 return false;
240 }
241 s_wifi_started = false;
242 return true;
243 }
244
245 err = esp_wifi_set_mode(set_mode);
246 if (err != ERR_OK) {
247 ESP_LOGW(TAG, "esp_wifi_set_mode failed: %s", esp_err_to_name(err));
248 return false;
249 }
250
251 if (set_mode != WIFI_MODE_NULL && !s_wifi_started) {
252 err = esp_wifi_start();
253 if (err != ESP_OK) {
254 ESP_LOGV(TAG, "esp_wifi_start failed: %s", esp_err_to_name(err));
255 return false;
256 }
257 s_wifi_started = true;
258 }
259
260 return true;
261}
262
263bool WiFiComponent::wifi_sta_pre_setup_() { return this->wifi_mode_(true, {}); }
264
265bool WiFiComponent::wifi_apply_output_power_(float output_power) {
266 int8_t val = static_cast<int8_t>(output_power * 4);
267 return esp_wifi_set_max_tx_power(val) == ESP_OK;
268}
269
271 wifi_ps_type_t power_save;
272 switch (this->power_save_) {
274 power_save = WIFI_PS_MIN_MODEM;
275 break;
277 power_save = WIFI_PS_MAX_MODEM;
278 break;
280 default:
281 power_save = WIFI_PS_NONE;
282 break;
283 }
284 bool success = esp_wifi_set_ps(power_save) == ESP_OK;
285#ifdef USE_WIFI_POWER_SAVE_LISTENERS
286 if (success) {
287 for (auto *listener : this->power_save_listeners_) {
288 listener->on_wifi_power_save(this->power_save_);
289 }
290 }
291#endif
292 return success;
293}
294
295#ifdef SOC_WIFI_SUPPORT_5G
296bool WiFiComponent::wifi_apply_band_mode_() { return esp_wifi_set_band_mode(this->band_mode_) == ESP_OK; }
297#endif
298
299bool WiFiComponent::wifi_sta_connect_(const WiFiAP &ap) {
300 // enable STA
301 if (!this->wifi_mode_(true, {}))
302 return false;
303
304 // https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-reference/network/esp_wifi.html#_CPPv417wifi_sta_config_t
305 wifi_config_t conf;
306 memset(&conf, 0, sizeof(conf));
307 if (ap.ssid_.size() > sizeof(conf.sta.ssid)) {
308 ESP_LOGE(TAG, "SSID too long");
309 return false;
310 }
311 if (ap.password_.size() > sizeof(conf.sta.password)) {
312 ESP_LOGE(TAG, "Password too long");
313 return false;
314 }
315 memcpy(reinterpret_cast<char *>(conf.sta.ssid), ap.ssid_.c_str(), ap.ssid_.size());
316 memcpy(reinterpret_cast<char *>(conf.sta.password), ap.password_.c_str(), ap.password_.size());
317
318 // The weakest authmode to accept in the fast scan mode
319 if (ap.password_.empty()) {
320 conf.sta.threshold.authmode = WIFI_AUTH_OPEN;
321 } else {
322 // Set threshold based on configured minimum auth mode
323 switch (this->min_auth_mode_) {
325 conf.sta.threshold.authmode = WIFI_AUTH_WPA_PSK;
326 break;
328 conf.sta.threshold.authmode = WIFI_AUTH_WPA2_PSK;
329 break;
331 conf.sta.threshold.authmode = WIFI_AUTH_WPA3_PSK;
332 break;
333 }
334 }
335
336#ifdef USE_WIFI_WPA2_EAP
337 if (ap.get_eap().has_value()) {
338 conf.sta.threshold.authmode = WIFI_AUTH_WPA2_ENTERPRISE;
339 }
340#endif
341
342#ifdef USE_WIFI_11KV_SUPPORT
343 conf.sta.btm_enabled = this->btm_;
344 conf.sta.rm_enabled = this->rrm_;
345#endif
346
347 if (ap.has_bssid()) {
348 conf.sta.bssid_set = true;
349 memcpy(conf.sta.bssid, ap.get_bssid().data(), 6);
350 } else {
351 conf.sta.bssid_set = false;
352 }
353 if (ap.has_channel()) {
354 conf.sta.channel = ap.get_channel();
355 conf.sta.scan_method = WIFI_FAST_SCAN;
356 } else {
357 conf.sta.scan_method = WIFI_ALL_CHANNEL_SCAN;
358 }
359 // Listen interval for ESP32 station to receive beacon when WIFI_PS_MAX_MODEM is set.
360 // Units: AP beacon intervals. Defaults to 3 if set to 0.
361 conf.sta.listen_interval = 0;
362
363 // Protected Management Frame
364 // Device will prefer to connect in PMF mode if other device also advertises PMF capability.
365 conf.sta.pmf_cfg.capable = true;
366 conf.sta.pmf_cfg.required = false;
367
368 // note, we do our own filtering
369 // The minimum rssi to accept in the fast scan mode
370 conf.sta.threshold.rssi = -127;
371
372 wifi_config_t current_conf;
373 esp_err_t err;
374 err = esp_wifi_get_config(WIFI_IF_STA, &current_conf);
375 if (err != ERR_OK) {
376 ESP_LOGW(TAG, "esp_wifi_get_config failed: %s", esp_err_to_name(err));
377 // can continue
378 }
379
380 if (memcmp(&current_conf, &conf, sizeof(wifi_config_t)) != 0) { // NOLINT
381 err = esp_wifi_disconnect();
382 if (err != ESP_OK) {
383 ESP_LOGV(TAG, "esp_wifi_disconnect failed: %s", esp_err_to_name(err));
384 return false;
385 }
386 }
387
388 err = esp_wifi_set_config(WIFI_IF_STA, &conf);
389 if (err != ESP_OK) {
390 ESP_LOGV(TAG, "esp_wifi_set_config failed: %s", esp_err_to_name(err));
391 return false;
392 }
393
394#ifdef USE_WIFI_MANUAL_IP
395 if (!this->wifi_sta_ip_config_(ap.get_manual_ip())) {
396 return false;
397 }
398#else
399 if (!this->wifi_sta_ip_config_({})) {
400 return false;
401 }
402#endif
403
404 // setup enterprise authentication if required
405#ifdef USE_WIFI_WPA2_EAP
406 auto eap_opt = ap.get_eap();
407 if (eap_opt.has_value()) {
408 // note: all certificates and keys have to be null terminated. Lengths are appended by +1 to include \0.
409 EAPAuth eap = *eap_opt;
410#if (ESP_IDF_VERSION_MAJOR >= 5) && (ESP_IDF_VERSION_MINOR >= 1)
411 err = esp_eap_client_set_identity((uint8_t *) eap.identity.c_str(), eap.identity.length());
412#else
413 err = esp_wifi_sta_wpa2_ent_set_identity((uint8_t *) eap.identity.c_str(), eap.identity.length());
414#endif
415 if (err != ESP_OK) {
416 ESP_LOGV(TAG, "set_identity failed %d", err);
417 }
418 int ca_cert_len = strlen(eap.ca_cert);
419 int client_cert_len = strlen(eap.client_cert);
420 int client_key_len = strlen(eap.client_key);
421 if (ca_cert_len) {
422#if (ESP_IDF_VERSION_MAJOR >= 5) && (ESP_IDF_VERSION_MINOR >= 1)
423 err = esp_eap_client_set_ca_cert((uint8_t *) eap.ca_cert, ca_cert_len + 1);
424#else
425 err = esp_wifi_sta_wpa2_ent_set_ca_cert((uint8_t *) eap.ca_cert, ca_cert_len + 1);
426#endif
427 if (err != ESP_OK) {
428 ESP_LOGV(TAG, "set_ca_cert failed %d", err);
429 }
430 }
431 // workout what type of EAP this is
432 // validation is not required as the config tool has already validated it
433 if (client_cert_len && client_key_len) {
434 // if we have certs, this must be EAP-TLS
435#if (ESP_IDF_VERSION_MAJOR >= 5) && (ESP_IDF_VERSION_MINOR >= 1)
436 err = esp_eap_client_set_certificate_and_key((uint8_t *) eap.client_cert, client_cert_len + 1,
437 (uint8_t *) eap.client_key, client_key_len + 1,
438 (uint8_t *) eap.password.c_str(), eap.password.length());
439#else
440 err = esp_wifi_sta_wpa2_ent_set_cert_key((uint8_t *) eap.client_cert, client_cert_len + 1,
441 (uint8_t *) eap.client_key, client_key_len + 1,
442 (uint8_t *) eap.password.c_str(), eap.password.length());
443#endif
444 if (err != ESP_OK) {
445 ESP_LOGV(TAG, "set_cert_key failed %d", err);
446 }
447 } else {
448 // in the absence of certs, assume this is username/password based
449#if (ESP_IDF_VERSION_MAJOR >= 5) && (ESP_IDF_VERSION_MINOR >= 1)
450 err = esp_eap_client_set_username((uint8_t *) eap.username.c_str(), eap.username.length());
451#else
452 err = esp_wifi_sta_wpa2_ent_set_username((uint8_t *) eap.username.c_str(), eap.username.length());
453#endif
454 if (err != ESP_OK) {
455 ESP_LOGV(TAG, "set_username failed %d", err);
456 }
457#if (ESP_IDF_VERSION_MAJOR >= 5) && (ESP_IDF_VERSION_MINOR >= 1)
458 err = esp_eap_client_set_password((uint8_t *) eap.password.c_str(), eap.password.length());
459#else
460 err = esp_wifi_sta_wpa2_ent_set_password((uint8_t *) eap.password.c_str(), eap.password.length());
461#endif
462 if (err != ESP_OK) {
463 ESP_LOGV(TAG, "set_password failed %d", err);
464 }
465 // set TTLS Phase 2, defaults to MSCHAPV2
466#if (ESP_IDF_VERSION_MAJOR >= 5) && (ESP_IDF_VERSION_MINOR >= 1)
467 err = esp_eap_client_set_ttls_phase2_method(eap.ttls_phase_2);
468#else
469 err = esp_wifi_sta_wpa2_ent_set_ttls_phase2_method(eap.ttls_phase_2);
470#endif
471 if (err != ESP_OK) {
472 ESP_LOGV(TAG, "set_ttls_phase2_method failed %d", err);
473 }
474 }
475#if (ESP_IDF_VERSION_MAJOR >= 5) && (ESP_IDF_VERSION_MINOR >= 1)
476 err = esp_wifi_sta_enterprise_enable();
477#else
478 err = esp_wifi_sta_wpa2_ent_enable();
479#endif
480 if (err != ESP_OK) {
481 ESP_LOGV(TAG, "enterprise_enable failed %d", err);
482 }
483 }
484#endif // USE_WIFI_WPA2_EAP
485
486 // Reset flags, do this _before_ wifi_station_connect as the callback method
487 // may be called from wifi_station_connect
488 s_sta_connecting = true;
489 s_sta_connected = false;
490 s_sta_connect_error = false;
491 s_sta_connect_not_found = false;
492 // Reset IP address flags - ensures we don't report connected before DHCP completes
493 // (IP_EVENT_STA_LOST_IP doesn't always fire on disconnect)
494 this->got_ipv4_address_ = false;
495#if USE_NETWORK_IPV6
496 this->num_ipv6_addresses_ = 0;
497#endif
498
499 err = esp_wifi_connect();
500 if (err != ESP_OK) {
501 ESP_LOGW(TAG, "esp_wifi_connect failed: %s", esp_err_to_name(err));
502 return false;
503 }
504
505 return true;
506}
507
508bool WiFiComponent::wifi_sta_ip_config_(const optional<ManualIP> &manual_ip) {
509 // enable STA
510 if (!this->wifi_mode_(true, {}))
511 return false;
512
513 // Check if the STA interface is initialized before using it
514 if (s_sta_netif == nullptr) {
515 ESP_LOGW(TAG, "STA interface not initialized");
516 return false;
517 }
518
519 esp_netif_dhcp_status_t dhcp_status;
520 esp_err_t err = esp_netif_dhcpc_get_status(s_sta_netif, &dhcp_status);
521 if (err != ESP_OK) {
522 ESP_LOGV(TAG, "esp_netif_dhcpc_get_status failed: %s", esp_err_to_name(err));
523 return false;
524 }
525
526 if (!manual_ip.has_value()) {
527 // lwIP starts the SNTP client if it gets an SNTP server from DHCP. We don't need the time, and more importantly,
528 // the built-in SNTP client has a memory leak in certain situations. Disable this feature.
529 // https://github.com/esphome/issues/issues/2299
530 sntp_servermode_dhcp(false);
531
532 // No manual IP is set; use DHCP client
533 if (dhcp_status != ESP_NETIF_DHCP_STARTED) {
534 err = esp_netif_dhcpc_start(s_sta_netif);
535 if (err != ESP_OK) {
536 ESP_LOGV(TAG, "Starting DHCP client failed: %d", err);
537 }
538 return err == ESP_OK;
539 }
540 return true;
541 }
542
543 esp_netif_ip_info_t info; // struct of ip4_addr_t with ip, netmask, gw
544 info.ip = manual_ip->static_ip;
545 info.gw = manual_ip->gateway;
546 info.netmask = manual_ip->subnet;
547 err = esp_netif_dhcpc_stop(s_sta_netif);
548 if (err != ESP_OK && err != ESP_ERR_ESP_NETIF_DHCP_ALREADY_STOPPED) {
549 ESP_LOGV(TAG, "Stopping DHCP client failed: %s", esp_err_to_name(err));
550 }
551
552 err = esp_netif_set_ip_info(s_sta_netif, &info);
553 if (err != ESP_OK) {
554 ESP_LOGV(TAG, "Setting manual IP info failed: %s", esp_err_to_name(err));
555 }
556
557 esp_netif_dns_info_t dns;
558 if (manual_ip->dns1.is_set()) {
559 dns.ip = manual_ip->dns1;
560 esp_netif_set_dns_info(s_sta_netif, ESP_NETIF_DNS_MAIN, &dns);
561 }
562 if (manual_ip->dns2.is_set()) {
563 dns.ip = manual_ip->dns2;
564 esp_netif_set_dns_info(s_sta_netif, ESP_NETIF_DNS_BACKUP, &dns);
565 }
566
567 return true;
568}
569
571 if (!this->has_sta())
572 return {};
573 network::IPAddresses addresses;
574 esp_netif_ip_info_t ip;
575 esp_err_t err = esp_netif_get_ip_info(s_sta_netif, &ip);
576 if (err != ESP_OK) {
577 ESP_LOGV(TAG, "esp_netif_get_ip_info failed: %s", esp_err_to_name(err));
578 // TODO: do something smarter
579 // return false;
580 } else {
581 addresses[0] = network::IPAddress(&ip.ip);
582 }
583#if USE_NETWORK_IPV6
584 struct esp_ip6_addr if_ip6s[CONFIG_LWIP_IPV6_NUM_ADDRESSES];
585 uint8_t count = 0;
586 count = esp_netif_get_all_ip6(s_sta_netif, if_ip6s);
587 assert(count <= CONFIG_LWIP_IPV6_NUM_ADDRESSES);
588 assert(count < addresses.size());
589 for (int i = 0; i < count; i++) {
590 addresses[i + 1] = network::IPAddress(&if_ip6s[i]);
591 }
592#endif /* USE_NETWORK_IPV6 */
593 return addresses;
594}
595
597 // setting is done in SYSTEM_EVENT_STA_START callback
598 return true;
599}
600const char *get_auth_mode_str(uint8_t mode) {
601 switch (mode) {
602 case WIFI_AUTH_OPEN:
603 return "OPEN";
604 case WIFI_AUTH_WEP:
605 return "WEP";
606 case WIFI_AUTH_WPA_PSK:
607 return "WPA PSK";
608 case WIFI_AUTH_WPA2_PSK:
609 return "WPA2 PSK";
610 case WIFI_AUTH_WPA_WPA2_PSK:
611 return "WPA/WPA2 PSK";
612 case WIFI_AUTH_WPA2_ENTERPRISE:
613 return "WPA2 Enterprise";
614 case WIFI_AUTH_WPA3_PSK:
615 return "WPA3 PSK";
616 case WIFI_AUTH_WPA2_WPA3_PSK:
617 return "WPA2/WPA3 PSK";
618 case WIFI_AUTH_WAPI_PSK:
619 return "WAPI PSK";
620 default:
621 return "UNKNOWN";
622 }
623}
624
625const char *get_disconnect_reason_str(uint8_t reason) {
626 switch (reason) {
627 case WIFI_REASON_AUTH_EXPIRE:
628 return "Auth Expired";
629 case WIFI_REASON_AUTH_LEAVE:
630 return "Auth Leave";
631 case WIFI_REASON_ASSOC_EXPIRE:
632 return "Association Expired";
633 case WIFI_REASON_ASSOC_TOOMANY:
634 return "Too Many Associations";
635 case WIFI_REASON_NOT_AUTHED:
636 return "Not Authenticated";
637 case WIFI_REASON_NOT_ASSOCED:
638 return "Not Associated";
639 case WIFI_REASON_ASSOC_LEAVE:
640 return "Association Leave";
641 case WIFI_REASON_ASSOC_NOT_AUTHED:
642 return "Association not Authenticated";
643 case WIFI_REASON_DISASSOC_PWRCAP_BAD:
644 return "Disassociate Power Cap Bad";
645 case WIFI_REASON_DISASSOC_SUPCHAN_BAD:
646 return "Disassociate Supported Channel Bad";
647 case WIFI_REASON_IE_INVALID:
648 return "IE Invalid";
649 case WIFI_REASON_MIC_FAILURE:
650 return "Mic Failure";
651 case WIFI_REASON_4WAY_HANDSHAKE_TIMEOUT:
652 return "4-Way Handshake Timeout";
653 case WIFI_REASON_GROUP_KEY_UPDATE_TIMEOUT:
654 return "Group Key Update Timeout";
655 case WIFI_REASON_IE_IN_4WAY_DIFFERS:
656 return "IE In 4-Way Handshake Differs";
657 case WIFI_REASON_GROUP_CIPHER_INVALID:
658 return "Group Cipher Invalid";
659 case WIFI_REASON_PAIRWISE_CIPHER_INVALID:
660 return "Pairwise Cipher Invalid";
661 case WIFI_REASON_AKMP_INVALID:
662 return "AKMP Invalid";
663 case WIFI_REASON_UNSUPP_RSN_IE_VERSION:
664 return "Unsupported RSN IE version";
665 case WIFI_REASON_INVALID_RSN_IE_CAP:
666 return "Invalid RSN IE Cap";
667 case WIFI_REASON_802_1X_AUTH_FAILED:
668 return "802.1x Authentication Failed";
669 case WIFI_REASON_CIPHER_SUITE_REJECTED:
670 return "Cipher Suite Rejected";
671 case WIFI_REASON_BEACON_TIMEOUT:
672 return "Beacon Timeout";
673 case WIFI_REASON_NO_AP_FOUND:
674 return "AP Not Found";
675 case WIFI_REASON_AUTH_FAIL:
676 return "Authentication Failed";
677 case WIFI_REASON_ASSOC_FAIL:
678 return "Association Failed";
679 case WIFI_REASON_HANDSHAKE_TIMEOUT:
680 return "Handshake Failed";
681 case WIFI_REASON_CONNECTION_FAIL:
682 return "Connection Failed";
683 case WIFI_REASON_AP_TSF_RESET:
684 return "AP TSF reset";
685 case WIFI_REASON_ROAMING:
686 return "Station Roaming";
687 case WIFI_REASON_ASSOC_COMEBACK_TIME_TOO_LONG:
688 return "Association comeback time too long";
689 case WIFI_REASON_SA_QUERY_TIMEOUT:
690 return "SA query timeout";
691#if (ESP_IDF_VERSION_MAJOR >= 5) && (ESP_IDF_VERSION_MINOR >= 2)
692 case WIFI_REASON_NO_AP_FOUND_W_COMPATIBLE_SECURITY:
693 return "No AP found with compatible security";
694 case WIFI_REASON_NO_AP_FOUND_IN_AUTHMODE_THRESHOLD:
695 return "No AP found in auth mode threshold";
696 case WIFI_REASON_NO_AP_FOUND_IN_RSSI_THRESHOLD:
697 return "No AP found in RSSI threshold";
698#endif
699 case WIFI_REASON_UNSPECIFIED:
700 default:
701 return "Unspecified";
702 }
703}
704
706 while (true) {
707 IDFWiFiEvent *data;
708 if (xQueueReceive(s_event_queue, &data, 0L) != pdTRUE) {
709 // no event ready
710 break;
711 }
712
713 // process event
715
716 delete data; // NOLINT(cppcoreguidelines-owning-memory)
717 }
718}
719// Events are processed from queue in main loop context, but listener notifications
720// must be deferred until after the state machine transitions (in check_connecting_finished)
721// so that conditions like wifi.connected return correct values in automations.
722void WiFiComponent::wifi_process_event_(IDFWiFiEvent *data) {
723 esp_err_t err;
724 if (data->event_base == WIFI_EVENT && data->event_id == WIFI_EVENT_STA_START) {
725 ESP_LOGV(TAG, "STA start");
726 // apply hostname
727 err = esp_netif_set_hostname(s_sta_netif, App.get_name().c_str());
728 if (err != ERR_OK) {
729 ESP_LOGW(TAG, "esp_netif_set_hostname failed: %s", esp_err_to_name(err));
730 }
731
732 s_sta_started = true;
733 // re-apply power save mode
735#ifdef SOC_WIFI_SUPPORT_5G
737#endif
738
739 } else if (data->event_base == WIFI_EVENT && data->event_id == WIFI_EVENT_STA_STOP) {
740 ESP_LOGV(TAG, "STA stop");
741 s_sta_started = false;
742 s_sta_connecting = false;
743
744 } else if (data->event_base == WIFI_EVENT && data->event_id == WIFI_EVENT_STA_AUTHMODE_CHANGE) {
745 const auto &it = data->data.sta_authmode_change;
746 ESP_LOGV(TAG, "Authmode Change old=%s new=%s", get_auth_mode_str(it.old_mode), get_auth_mode_str(it.new_mode));
747
748 } else if (data->event_base == WIFI_EVENT && data->event_id == WIFI_EVENT_STA_CONNECTED) {
749 const auto &it = data->data.sta_connected;
750#if ESPHOME_LOG_LEVEL >= ESPHOME_LOG_LEVEL_VERBOSE
751 char bssid_buf[MAC_ADDRESS_PRETTY_BUFFER_SIZE];
752 format_mac_addr_upper(it.bssid, bssid_buf);
753 ESP_LOGV(TAG, "Connected ssid='%.*s' bssid=" LOG_SECRET("%s") " channel=%u, authmode=%s", it.ssid_len,
754 (const char *) it.ssid, bssid_buf, it.channel, get_auth_mode_str(it.authmode));
755#endif
756 s_sta_connected = true;
757#ifdef USE_WIFI_CONNECT_STATE_LISTENERS
758 // Defer listener notification until state machine reaches STA_CONNECTED
759 // This ensures wifi.connected condition returns true in listener automations
760 this->pending_.connect_state = true;
761#endif
762 // For static IP configurations, GOT_IP event may not fire, so notify IP listeners here
763#if defined(USE_WIFI_IP_STATE_LISTENERS) && defined(USE_WIFI_MANUAL_IP)
764 if (const WiFiAP *config = this->get_selected_sta_(); config && config->get_manual_ip().has_value()) {
766 }
767#endif
768
769 } else if (data->event_base == WIFI_EVENT && data->event_id == WIFI_EVENT_STA_DISCONNECTED) {
770 const auto &it = data->data.sta_disconnected;
771 if (it.reason == WIFI_REASON_NO_AP_FOUND) {
772 ESP_LOGW(TAG, "Disconnected ssid='%.*s' reason='Probe Request Unsuccessful'", it.ssid_len,
773 (const char *) it.ssid);
774 s_sta_connect_not_found = true;
775 } else if (it.reason == WIFI_REASON_ROAMING) {
776 ESP_LOGI(TAG, "Disconnected ssid='%.*s' reason='Station Roaming'", it.ssid_len, (const char *) it.ssid);
777 return;
778 } else {
779 char bssid_s[18];
780 format_mac_addr_upper(it.bssid, bssid_s);
781 ESP_LOGW(TAG, "Disconnected ssid='%.*s' bssid=" LOG_SECRET("%s") " reason='%s'", it.ssid_len,
782 (const char *) it.ssid, bssid_s, get_disconnect_reason_str(it.reason));
783 s_sta_connect_error = true;
784 }
785 s_sta_connected = false;
786 s_sta_connecting = false;
788#ifdef USE_WIFI_CONNECT_STATE_LISTENERS
790#endif
791
792 } else if (data->event_base == IP_EVENT && data->event_id == IP_EVENT_STA_GOT_IP) {
793 const auto &it = data->data.ip_got_ip;
794#if USE_NETWORK_IPV6
795 esp_netif_create_ip6_linklocal(s_sta_netif);
796#endif /* USE_NETWORK_IPV6 */
797 ESP_LOGV(TAG, "static_ip=" IPSTR " gateway=" IPSTR, IP2STR(&it.ip_info.ip), IP2STR(&it.ip_info.gw));
798 this->got_ipv4_address_ = true;
799#ifdef USE_WIFI_IP_STATE_LISTENERS
801#endif
802
803#if USE_NETWORK_IPV6
804 } else if (data->event_base == IP_EVENT && data->event_id == IP_EVENT_GOT_IP6) {
805 const auto &it = data->data.ip_got_ip6;
806 ESP_LOGV(TAG, "IPv6 address=" IPV6STR, IPV62STR(it.ip6_info.ip));
807 this->num_ipv6_addresses_++;
808#ifdef USE_WIFI_IP_STATE_LISTENERS
810#endif
811#endif /* USE_NETWORK_IPV6 */
812
813 } else if (data->event_base == IP_EVENT && data->event_id == IP_EVENT_STA_LOST_IP) {
814 ESP_LOGV(TAG, "Lost IP");
815 this->got_ipv4_address_ = false;
816
817 } else if (data->event_base == WIFI_EVENT && data->event_id == WIFI_EVENT_SCAN_DONE) {
818 const auto &it = data->data.sta_scan_done;
819 ESP_LOGV(TAG, "Scan done: status=%" PRIu32 " number=%u scan_id=%u", it.status, it.number, it.scan_id);
820
821 scan_result_.clear();
822 this->scan_done_ = true;
823 if (it.status != 0) {
824 // scan error
825 return;
826 }
827
828 if (it.number == 0) {
829 // no results
830 return;
831 }
832
833 uint16_t number = it.number;
834 bool needs_full = this->needs_full_scan_results_();
835
836 // Smart reserve: full capacity if needed, small reserve otherwise
837 if (needs_full) {
838 this->scan_result_.reserve(number);
839 } else {
840 this->scan_result_.reserve(WIFI_SCAN_RESULT_FILTERED_RESERVE);
841 }
842
843#ifdef USE_ESP32_HOSTED
844 // getting records one at a time fails on P4 with hosted esp32 WiFi coprocessor
845 // Presumably an upstream bug, work-around by getting all records at once
846 // Use stack buffer (3904 bytes / ~80 bytes per record = ~48 records) with heap fallback
847 static constexpr size_t SCAN_RECORD_STACK_COUNT = 3904 / sizeof(wifi_ap_record_t);
848 SmallBufferWithHeapFallback<SCAN_RECORD_STACK_COUNT, wifi_ap_record_t> records(number);
849 err = esp_wifi_scan_get_ap_records(&number, records.get());
850 if (err != ESP_OK) {
851 esp_wifi_clear_ap_list();
852 ESP_LOGW(TAG, "esp_wifi_scan_get_ap_records failed: %s", esp_err_to_name(err));
853 return;
854 }
855 for (uint16_t i = 0; i < number; i++) {
856 wifi_ap_record_t &record = records.get()[i];
857#else
858 // Process one record at a time to avoid large buffer allocation
859 for (uint16_t i = 0; i < number; i++) {
860 wifi_ap_record_t record;
861 err = esp_wifi_scan_get_ap_record(&record);
862 if (err != ESP_OK) {
863 ESP_LOGW(TAG, "esp_wifi_scan_get_ap_record failed: %s", esp_err_to_name(err));
864 esp_wifi_clear_ap_list(); // Free remaining records not yet retrieved
865 break;
866 }
867#endif // USE_ESP32_HOSTED
868
869 // Check C string first - avoid std::string construction for non-matching networks
870 const char *ssid_cstr = reinterpret_cast<const char *>(record.ssid);
871
872 // Only construct std::string and store if needed
873 if (needs_full || this->matches_configured_network_(ssid_cstr, record.bssid)) {
874 bssid_t bssid;
875 std::copy(record.bssid, record.bssid + 6, bssid.begin());
876 this->scan_result_.emplace_back(bssid, ssid_cstr, strlen(ssid_cstr), record.primary, record.rssi,
877 record.authmode != WIFI_AUTH_OPEN, ssid_cstr[0] == '\0');
878 } else {
879 this->log_discarded_scan_result_(ssid_cstr, record.bssid, record.rssi, record.primary);
880 }
881 }
882 ESP_LOGV(TAG, "Scan complete: %u found, %zu stored%s", number, this->scan_result_.size(),
883 needs_full ? "" : " (filtered)");
884#ifdef USE_WIFI_SCAN_RESULTS_LISTENERS
886#endif
887
888 } else if (data->event_base == WIFI_EVENT && data->event_id == WIFI_EVENT_AP_START) {
889 ESP_LOGV(TAG, "AP start");
890 this->ap_started_ = true;
891
892 } else if (data->event_base == WIFI_EVENT && data->event_id == WIFI_EVENT_AP_STOP) {
893 ESP_LOGV(TAG, "AP stop");
894 this->ap_started_ = false;
895
896 } else if (data->event_base == WIFI_EVENT && data->event_id == WIFI_EVENT_AP_PROBEREQRECVED) {
897#if ESPHOME_LOG_LEVEL >= ESPHOME_LOG_LEVEL_VERY_VERBOSE
898 const auto &it = data->data.ap_probe_req_rx;
899 char mac_buf[MAC_ADDRESS_PRETTY_BUFFER_SIZE];
900 format_mac_addr_upper(it.mac, mac_buf);
901 ESP_LOGVV(TAG, "AP receive Probe Request MAC=%s RSSI=%d", mac_buf, it.rssi);
902#endif
903
904 } else if (data->event_base == WIFI_EVENT && data->event_id == WIFI_EVENT_AP_STACONNECTED) {
905#if ESPHOME_LOG_LEVEL >= ESPHOME_LOG_LEVEL_VERBOSE
906 const auto &it = data->data.ap_staconnected;
907 char mac_buf[MAC_ADDRESS_PRETTY_BUFFER_SIZE];
908 format_mac_addr_upper(it.mac, mac_buf);
909 ESP_LOGV(TAG, "AP client connected MAC=%s", mac_buf);
910#endif
911
912 } else if (data->event_base == WIFI_EVENT && data->event_id == WIFI_EVENT_AP_STADISCONNECTED) {
913#if ESPHOME_LOG_LEVEL >= ESPHOME_LOG_LEVEL_VERBOSE
914 const auto &it = data->data.ap_stadisconnected;
915 char mac_buf[MAC_ADDRESS_PRETTY_BUFFER_SIZE];
916 format_mac_addr_upper(it.mac, mac_buf);
917 ESP_LOGV(TAG, "AP client disconnected MAC=%s", mac_buf);
918#endif
919
920 } else if (data->event_base == IP_EVENT && data->event_id == IP_EVENT_AP_STAIPASSIGNED) {
921 const auto &it = data->data.ip_ap_staipassigned;
922 ESP_LOGV(TAG, "AP client assigned IP " IPSTR, IP2STR(&it.ip));
923 }
924}
925
927 if (s_sta_connected && this->got_ipv4_address_) {
928#if USE_NETWORK_IPV6 && (USE_NETWORK_MIN_IPV6_ADDR_COUNT > 0)
929 if (this->num_ipv6_addresses_ >= USE_NETWORK_MIN_IPV6_ADDR_COUNT) {
931 }
932#else
934#endif /* USE_NETWORK_IPV6 */
935 }
936 if (s_sta_connect_error) {
938 }
939 if (s_sta_connect_not_found) {
941 }
942 if (s_sta_connecting) {
944 }
946}
947bool WiFiComponent::wifi_scan_start_(bool passive) {
948 // enable STA
949 if (!this->wifi_mode_(true, {}))
950 return false;
951
952 wifi_scan_config_t config{};
953 config.ssid = nullptr;
954 config.bssid = nullptr;
955 config.channel = 0;
956 config.show_hidden = true;
957 config.scan_type = passive ? WIFI_SCAN_TYPE_PASSIVE : WIFI_SCAN_TYPE_ACTIVE;
958 if (passive) {
959 config.scan_time.passive = 300;
960 } else {
961 config.scan_time.active.min = 100;
962 config.scan_time.active.max = 300;
963 }
964
965 esp_err_t err = esp_wifi_scan_start(&config, false);
966 if (err != ESP_OK) {
967 ESP_LOGV(TAG, "esp_wifi_scan_start failed: %s", esp_err_to_name(err));
968 return false;
969 }
970
971 this->scan_done_ = false;
972 return true;
973}
974
975#ifdef USE_WIFI_AP
976bool WiFiComponent::wifi_ap_ip_config_(const optional<ManualIP> &manual_ip) {
977 esp_err_t err;
978
979 // enable AP
980 if (!this->wifi_mode_({}, true))
981 return false;
982
983 // Check if the AP interface is initialized before using it
984 if (s_ap_netif == nullptr) {
985 ESP_LOGW(TAG, "AP interface not initialized");
986 return false;
987 }
988
989 esp_netif_ip_info_t info;
990 if (manual_ip.has_value()) {
991 info.ip = manual_ip->static_ip;
992 info.gw = manual_ip->gateway;
993 info.netmask = manual_ip->subnet;
994 } else {
995 info.ip = network::IPAddress(192, 168, 4, 1);
996 info.gw = network::IPAddress(192, 168, 4, 1);
997 info.netmask = network::IPAddress(255, 255, 255, 0);
998 }
999
1000 err = esp_netif_dhcps_stop(s_ap_netif);
1001 if (err != ESP_OK && err != ESP_ERR_ESP_NETIF_DHCP_ALREADY_STOPPED) {
1002 ESP_LOGE(TAG, "esp_netif_dhcps_stop failed: %s", esp_err_to_name(err));
1003 return false;
1004 }
1005
1006 err = esp_netif_set_ip_info(s_ap_netif, &info);
1007 if (err != ESP_OK) {
1008 ESP_LOGE(TAG, "esp_netif_set_ip_info failed: %d", err);
1009 return false;
1010 }
1011
1012 dhcps_lease_t lease;
1013 lease.enable = true;
1014 network::IPAddress start_address = network::IPAddress(&info.ip);
1015 start_address += 99;
1016 lease.start_ip = start_address;
1017#if ESPHOME_LOG_LEVEL >= ESPHOME_LOG_LEVEL_VERBOSE
1018 char ip_buf[network::IP_ADDRESS_BUFFER_SIZE];
1019#endif
1020 ESP_LOGV(TAG, "DHCP server IP lease start: %s", start_address.str_to(ip_buf));
1021 start_address += 10;
1022 lease.end_ip = start_address;
1023 ESP_LOGV(TAG, "DHCP server IP lease end: %s", start_address.str_to(ip_buf));
1024 err = esp_netif_dhcps_option(s_ap_netif, ESP_NETIF_OP_SET, ESP_NETIF_REQUESTED_IP_ADDRESS, &lease, sizeof(lease));
1025
1026 if (err != ESP_OK) {
1027 ESP_LOGE(TAG, "esp_netif_dhcps_option failed: %d", err);
1028 return false;
1029 }
1030
1031#if defined(USE_CAPTIVE_PORTAL) && ESP_IDF_VERSION >= ESP_IDF_VERSION_VAL(5, 4, 0)
1032 // Configure DHCP Option 114 (Captive Portal URI) if captive portal is enabled
1033 // This provides a standards-compliant way for clients to discover the captive portal
1035 // Buffer must be static - dhcps_set_option_info stores pointer, doesn't copy
1036 static char captive_portal_uri[24]; // "http://" (7) + IPv4 max (15) + null
1037 memcpy(captive_portal_uri, "http://", 7); // NOLINT(bugprone-not-null-terminated-result) - str_to null-terminates
1038 network::IPAddress(&info.ip).str_to(captive_portal_uri + 7);
1039 err = esp_netif_dhcps_option(s_ap_netif, ESP_NETIF_OP_SET, ESP_NETIF_CAPTIVEPORTAL_URI, captive_portal_uri,
1040 strlen(captive_portal_uri));
1041 if (err != ESP_OK) {
1042 ESP_LOGV(TAG, "Failed to set DHCP captive portal URI: %s", esp_err_to_name(err));
1043 } else {
1044 ESP_LOGV(TAG, "DHCP Captive Portal URI set to: %s", captive_portal_uri);
1045 }
1046 }
1047#endif
1048
1049 err = esp_netif_dhcps_start(s_ap_netif);
1050
1051 if (err != ESP_OK) {
1052 ESP_LOGE(TAG, "esp_netif_dhcps_start failed: %d", err);
1053 return false;
1054 }
1055
1056 return true;
1057}
1058
1059bool WiFiComponent::wifi_start_ap_(const WiFiAP &ap) {
1060 // enable AP
1061 if (!this->wifi_mode_({}, true))
1062 return false;
1063
1064 wifi_config_t conf;
1065 memset(&conf, 0, sizeof(conf));
1066 if (ap.ssid_.size() > sizeof(conf.ap.ssid)) {
1067 ESP_LOGE(TAG, "AP SSID too long");
1068 return false;
1069 }
1070 memcpy(reinterpret_cast<char *>(conf.ap.ssid), ap.ssid_.c_str(), ap.ssid_.size());
1071 conf.ap.channel = ap.has_channel() ? ap.get_channel() : 1;
1072 conf.ap.ssid_hidden = ap.get_hidden();
1073 conf.ap.max_connection = 5;
1074 conf.ap.beacon_interval = 100;
1075
1076 if (ap.password_.empty()) {
1077 conf.ap.authmode = WIFI_AUTH_OPEN;
1078 *conf.ap.password = 0;
1079 } else {
1080 conf.ap.authmode = WIFI_AUTH_WPA2_PSK;
1081 if (ap.password_.size() > sizeof(conf.ap.password)) {
1082 ESP_LOGE(TAG, "AP password too long");
1083 return false;
1084 }
1085 memcpy(reinterpret_cast<char *>(conf.ap.password), ap.password_.c_str(), ap.password_.size());
1086 }
1087
1088 // pairwise cipher of SoftAP, group cipher will be derived using this.
1089 conf.ap.pairwise_cipher = WIFI_CIPHER_TYPE_CCMP;
1090
1091 esp_err_t err = esp_wifi_set_config(WIFI_IF_AP, &conf);
1092 if (err != ESP_OK) {
1093 ESP_LOGE(TAG, "esp_wifi_set_config failed: %d", err);
1094 return false;
1095 }
1096
1097#ifdef USE_WIFI_MANUAL_IP
1098 if (!this->wifi_ap_ip_config_(ap.get_manual_ip())) {
1099 ESP_LOGE(TAG, "wifi_ap_ip_config_ failed:");
1100 return false;
1101 }
1102#else
1103 if (!this->wifi_ap_ip_config_({})) {
1104 ESP_LOGE(TAG, "wifi_ap_ip_config_ failed:");
1105 return false;
1106 }
1107#endif
1108
1109 return true;
1110}
1111
1112network::IPAddress WiFiComponent::wifi_soft_ap_ip() {
1113 esp_netif_ip_info_t ip;
1114 esp_netif_get_ip_info(s_ap_netif, &ip);
1115 return network::IPAddress(&ip.ip);
1116}
1117#endif // USE_WIFI_AP
1118
1119bool WiFiComponent::wifi_disconnect_() { return esp_wifi_disconnect(); }
1120
1122 bssid_t bssid{};
1123 wifi_ap_record_t info;
1124 esp_err_t err = esp_wifi_sta_get_ap_info(&info);
1125 if (err != ESP_OK) {
1126 // Very verbose only: this is expected during dump_config() before connection is established (PR #9823)
1127 ESP_LOGVV(TAG, "esp_wifi_sta_get_ap_info failed: %s", esp_err_to_name(err));
1128 return bssid;
1129 }
1130 std::copy(info.bssid, info.bssid + 6, bssid.begin());
1131 return bssid;
1132}
1133std::string WiFiComponent::wifi_ssid() {
1134 wifi_ap_record_t info{};
1135 esp_err_t err = esp_wifi_sta_get_ap_info(&info);
1136 if (err != ESP_OK) {
1137 // Very verbose only: this is expected during dump_config() before connection is established (PR #9823)
1138 ESP_LOGVV(TAG, "esp_wifi_sta_get_ap_info failed: %s", esp_err_to_name(err));
1139 return "";
1140 }
1141 auto *ssid_s = reinterpret_cast<const char *>(info.ssid);
1142 size_t len = strnlen(ssid_s, sizeof(info.ssid));
1143 return {ssid_s, len};
1144}
1145const char *WiFiComponent::wifi_ssid_to(std::span<char, SSID_BUFFER_SIZE> buffer) {
1146 wifi_ap_record_t info{};
1147 esp_err_t err = esp_wifi_sta_get_ap_info(&info);
1148 if (err != ESP_OK) {
1149 buffer[0] = '\0';
1150 return buffer.data();
1151 }
1152 // info.ssid is uint8[33], but only 32 bytes are SSID data
1153 size_t len = strnlen(reinterpret_cast<const char *>(info.ssid), 32);
1154 memcpy(buffer.data(), info.ssid, len);
1155 buffer[len] = '\0';
1156 return buffer.data();
1157}
1158int8_t WiFiComponent::wifi_rssi() {
1159 wifi_ap_record_t info;
1160 esp_err_t err = esp_wifi_sta_get_ap_info(&info);
1161 if (err != ESP_OK) {
1162 // Very verbose only: this is expected during dump_config() before connection is established (PR #9823)
1163 ESP_LOGVV(TAG, "esp_wifi_sta_get_ap_info failed: %s", esp_err_to_name(err));
1164 return WIFI_RSSI_DISCONNECTED;
1165 }
1166 return info.rssi;
1167}
1169 uint8_t primary;
1170 wifi_second_chan_t second;
1171 esp_err_t err = esp_wifi_get_channel(&primary, &second);
1172 if (err != ESP_OK) {
1173 ESP_LOGW(TAG, "esp_wifi_get_channel failed: %s", esp_err_to_name(err));
1174 return 0;
1175 }
1176 return primary;
1177}
1178network::IPAddress WiFiComponent::wifi_subnet_mask_() {
1179 esp_netif_ip_info_t ip;
1180 esp_err_t err = esp_netif_get_ip_info(s_sta_netif, &ip);
1181 if (err != ESP_OK) {
1182 ESP_LOGW(TAG, "esp_netif_get_ip_info failed: %s", esp_err_to_name(err));
1183 return {};
1184 }
1185 return network::IPAddress(&ip.netmask);
1186}
1187network::IPAddress WiFiComponent::wifi_gateway_ip_() {
1188 esp_netif_ip_info_t ip;
1189 esp_err_t err = esp_netif_get_ip_info(s_sta_netif, &ip);
1190 if (err != ESP_OK) {
1191 ESP_LOGW(TAG, "esp_netif_get_ip_info failed: %s", esp_err_to_name(err));
1192 return {};
1193 }
1194 return network::IPAddress(&ip.gw);
1195}
1196network::IPAddress WiFiComponent::wifi_dns_ip_(int num) {
1197 const ip_addr_t *dns_ip = dns_getserver(num);
1198 return network::IPAddress(dns_ip);
1199}
1200
1201} // namespace esphome::wifi
1202#endif // USE_ESP32
1203#endif
BedjetMode mode
BedJet operating mode.
const StringRef & get_name() const
Get the name of this Application set by pre_setup().
constexpr const char * c_str() const
Definition string_ref.h:73
const optional< ManualIP > & get_manual_ip() const
void notify_scan_results_listeners_()
Notify scan results listeners with current scan results.
void set_ap(const WiFiAP &ap)
Setup an Access Point that should be created if no connection to a station can be made.
void set_sta(const WiFiAP &ap)
const WiFiAP * get_selected_sta_() const
WiFiSTAConnectStatus wifi_sta_connect_status_() const
struct esphome::wifi::WiFiComponent::@176 pending_
wifi_scan_vector_t< WiFiScanResult > scan_result_
void notify_ip_state_listeners_()
Notify IP state listeners with current addresses.
bool wifi_sta_ip_config_(const optional< ManualIP > &manual_ip)
void wifi_process_event_(IDFWiFiEvent *data)
void notify_disconnect_state_listeners_()
Notify connect state listeners of disconnection.
void log_discarded_scan_result_(const char *ssid, const uint8_t *bssid, int8_t rssi, uint8_t channel)
Log a discarded scan result at VERBOSE level (skipped during roaming scans to avoid log overflow)
ESPDEPRECATED("Use wifi_ssid_to() instead. Removed in 2026.9.0", "2026.3.0") std const char * wifi_ssid_to(std::span< char, SSID_BUFFER_SIZE > buffer)
Write SSID to buffer without heap allocation.
network::IPAddress wifi_dns_ip_(int num)
bool matches_configured_network_(const char *ssid, const uint8_t *bssid) const
Check if network matches any configured network (for scan result filtering) Matches by SSID when conf...
bool wifi_ap_ip_config_(const optional< ManualIP > &manual_ip)
bool needs_full_scan_results_() const
Check if full scan results are needed (captive portal active, improv, listeners)
StaticVector< WiFiPowerSaveListener *, ESPHOME_WIFI_POWER_SAVE_LISTENERS > power_save_listeners_
bool wifi_apply_output_power_(float output_power)
bool wifi_mode_(optional< bool > sta, optional< bool > ap)
network::IPAddresses wifi_sta_ip_addresses()
uint8_t second
in_addr ip_addr_t
Definition ip_address.h:22
mopeka_std_values val[3]
CaptivePortal * global_captive_portal
std::array< IPAddress, 5 > IPAddresses
Definition ip_address.h:187
const char *const TAG
Definition spi.cpp:7
std::array< uint8_t, 6 > bssid_t
const LogString * get_auth_mode_str(uint8_t mode)
const LogString * get_disconnect_reason_str(uint8_t reason)
std::string size_t len
Definition helpers.h:892
bool has_custom_mac_address()
Check if a custom MAC address is set (ESP32 & variants)
Definition helpers.cpp:93
void set_mac_address(uint8_t *mac)
Set the MAC address to use from the provided byte array (6 bytes).
Definition helpers.cpp:91
void get_mac_address_raw(uint8_t *mac)
Get the device MAC address as raw bytes, written into the provided byte array (6 bytes).
Definition helpers.cpp:73
Application App
Global storage of Application pointer - only one Application can exist.
char * format_mac_addr_upper(const uint8_t *mac, char *output)
Format MAC address as XX:XX:XX:XX:XX:XX (uppercase, colon separators)
Definition helpers.h:1267
uint8_t event_id
Definition tt21100.cpp:3