10#include <esp_wifi_types.h>
11#include <freertos/FreeRTOS.h>
12#include <freertos/event_groups.h>
13#include <freertos/task.h>
19#ifdef USE_WIFI_WPA2_EAP
20#if ESP_IDF_VERSION >= ESP_IDF_VERSION_VAL(5, 1, 0)
21#include <esp_eap_client.h>
28#include "dhcpserver/dhcpserver.h"
31#ifdef USE_CAPTIVE_PORTAL
35#include "lwip/apps/sntp.h"
47static const char *
const TAG =
"wifi_esp32";
49static EventGroupHandle_t s_wifi_event_group;
50static esp_netif_t *s_sta_netif =
nullptr;
52static esp_netif_t *s_ap_netif =
nullptr;
54static bool s_sta_started =
false;
55static bool s_sta_connected =
false;
56static bool s_sta_connect_not_found =
false;
57static bool s_sta_connect_error =
false;
58static bool s_sta_connecting =
false;
59static bool s_wifi_started =
false;
62 esp_event_base_t event_base;
65 wifi_event_sta_scan_done_t sta_scan_done;
66 wifi_event_sta_connected_t sta_connected;
67 wifi_event_sta_disconnected_t sta_disconnected;
68 wifi_event_sta_authmode_change_t sta_authmode_change;
69 wifi_event_ap_staconnected_t ap_staconnected;
70 wifi_event_ap_stadisconnected_t ap_stadisconnected;
71 wifi_event_ap_probe_req_rx_t ap_probe_req_rx;
72 wifi_event_bss_rssi_low_t bss_rssi_low;
73 ip_event_got_ip_t ip_got_ip;
75 ip_event_got_ip6_t ip_got_ip6;
77#if ESP_IDF_VERSION >= ESP_IDF_VERSION_VAL(6, 0, 0)
78 ip_event_assigned_ip_to_client_t ip_assigned_ip_to_client;
80 ip_event_ap_staipassigned_t ip_ap_staipassigned;
87void event_handler(
void *arg, esp_event_base_t event_base, int32_t
event_id,
void *event_data) {
89 memset(&event, 0,
sizeof(IDFWiFiEvent));
90 event.event_base = event_base;
92 if (event_base == WIFI_EVENT &&
event_id == WIFI_EVENT_STA_START) {
94 }
else if (event_base == WIFI_EVENT &&
event_id == WIFI_EVENT_STA_STOP) {
96 }
else if (event_base == WIFI_EVENT &&
event_id == WIFI_EVENT_STA_AUTHMODE_CHANGE) {
97 memcpy(&event.data.sta_authmode_change, event_data,
sizeof(wifi_event_sta_authmode_change_t));
98 }
else if (event_base == WIFI_EVENT &&
event_id == WIFI_EVENT_STA_CONNECTED) {
99 memcpy(&event.data.sta_connected, event_data,
sizeof(wifi_event_sta_connected_t));
100 }
else if (event_base == WIFI_EVENT &&
event_id == WIFI_EVENT_STA_DISCONNECTED) {
101 memcpy(&event.data.sta_disconnected, event_data,
sizeof(wifi_event_sta_disconnected_t));
102 }
else if (event_base == IP_EVENT &&
event_id == IP_EVENT_STA_GOT_IP) {
103 memcpy(&event.data.ip_got_ip, event_data,
sizeof(ip_event_got_ip_t));
105 }
else if (event_base == IP_EVENT &&
event_id == IP_EVENT_GOT_IP6) {
106 memcpy(&event.data.ip_got_ip6, event_data,
sizeof(ip_event_got_ip6_t));
108 }
else if (event_base == IP_EVENT &&
event_id == IP_EVENT_STA_LOST_IP) {
110 }
else if (event_base == WIFI_EVENT &&
event_id == WIFI_EVENT_SCAN_DONE) {
111 memcpy(&event.data.sta_scan_done, event_data,
sizeof(wifi_event_sta_scan_done_t));
112 }
else if (event_base == WIFI_EVENT &&
event_id == WIFI_EVENT_AP_START) {
114 }
else if (event_base == WIFI_EVENT &&
event_id == WIFI_EVENT_AP_STOP) {
116 }
else if (event_base == WIFI_EVENT &&
event_id == WIFI_EVENT_AP_PROBEREQRECVED) {
117 memcpy(&event.data.ap_probe_req_rx, event_data,
sizeof(wifi_event_ap_probe_req_rx_t));
118 }
else if (event_base == WIFI_EVENT &&
event_id == WIFI_EVENT_AP_STACONNECTED) {
119 memcpy(&event.data.ap_staconnected, event_data,
sizeof(wifi_event_ap_staconnected_t));
120 }
else if (event_base == WIFI_EVENT &&
event_id == WIFI_EVENT_AP_STADISCONNECTED) {
121 memcpy(&event.data.ap_stadisconnected, event_data,
sizeof(wifi_event_ap_stadisconnected_t));
122#if ESP_IDF_VERSION >= ESP_IDF_VERSION_VAL(6, 0, 0)
123 }
else if (event_base == IP_EVENT &&
event_id == IP_EVENT_ASSIGNED_IP_TO_CLIENT) {
124 memcpy(&event.data.ip_assigned_ip_to_client, event_data,
sizeof(ip_event_assigned_ip_to_client_t));
126 }
else if (event_base == IP_EVENT &&
event_id == IP_EVENT_AP_STAIPASSIGNED) {
127 memcpy(&event.data.ip_ap_staipassigned, event_data,
sizeof(ip_event_ap_staipassigned_t));
135 auto *to_send =
new IDFWiFiEvent;
136 memcpy(to_send, &event,
sizeof(IDFWiFiEvent));
148 esp_err_t err = esp_netif_init();
150 ESP_LOGE(TAG,
"esp_netif_init failed: %s", esp_err_to_name(err));
153 s_wifi_event_group = xEventGroupCreate();
154 if (s_wifi_event_group ==
nullptr) {
155 ESP_LOGE(TAG,
"xEventGroupCreate failed");
158 err = esp_event_loop_create_default();
160 ESP_LOGE(TAG,
"esp_event_loop_create_default failed: %s", esp_err_to_name(err));
163 esp_event_handler_instance_t instance_wifi_id, instance_ip_id;
164 err = esp_event_handler_instance_register(WIFI_EVENT, ESP_EVENT_ANY_ID, &
event_handler,
nullptr, &instance_wifi_id);
166 ESP_LOGE(TAG,
"esp_event_handler_instance_register failed: %s", esp_err_to_name(err));
169 err = esp_event_handler_instance_register(IP_EVENT, ESP_EVENT_ANY_ID, &
event_handler,
nullptr, &instance_ip_id);
171 ESP_LOGE(TAG,
"esp_event_handler_instance_register failed: %s", esp_err_to_name(err));
175 s_sta_netif = esp_netif_create_default_wifi_sta();
178 s_ap_netif = esp_netif_create_default_wifi_ap();
181 wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT();
183 err = esp_wifi_init(&cfg);
185 ESP_LOGE(TAG,
"esp_wifi_init failed: %s", esp_err_to_name(err));
188 err = esp_wifi_set_storage(WIFI_STORAGE_RAM);
190 ESP_LOGE(TAG,
"esp_wifi_set_storage failed: %s", esp_err_to_name(err));
197 wifi_mode_t current_mode = WIFI_MODE_NULL;
198 if (s_wifi_started) {
199 err = esp_wifi_get_mode(¤t_mode);
201 ESP_LOGW(TAG,
"esp_wifi_get_mode failed: %s", esp_err_to_name(err));
205 bool current_sta = current_mode == WIFI_MODE_STA || current_mode == WIFI_MODE_APSTA;
206 bool current_ap = current_mode == WIFI_MODE_AP || current_mode == WIFI_MODE_APSTA;
208 bool set_sta = sta.value_or(current_sta);
209 bool set_ap = ap.value_or(current_ap);
211 wifi_mode_t set_mode;
213 set_mode = WIFI_MODE_APSTA;
215 set_mode = WIFI_MODE_STA;
217 set_mode = WIFI_MODE_AP;
219 set_mode = WIFI_MODE_NULL;
222 if (current_mode == set_mode)
226 ESP_LOGV(TAG,
"Enabling STA");
227 }
else if (!
set_sta && current_sta) {
228 ESP_LOGV(TAG,
"Disabling STA");
230 if (
set_ap && !current_ap) {
231 ESP_LOGV(TAG,
"Enabling AP");
232 }
else if (!
set_ap && current_ap) {
233 ESP_LOGV(TAG,
"Disabling AP");
236 if (set_mode == WIFI_MODE_NULL && s_wifi_started) {
237 err = esp_wifi_stop();
239 ESP_LOGV(TAG,
"esp_wifi_stop failed: %s", esp_err_to_name(err));
242 s_wifi_started =
false;
246 err = esp_wifi_set_mode(set_mode);
248 ESP_LOGW(TAG,
"esp_wifi_set_mode failed: %s", esp_err_to_name(err));
252 if (set_mode != WIFI_MODE_NULL && !s_wifi_started) {
253 err = esp_wifi_start();
255 ESP_LOGV(TAG,
"esp_wifi_start failed: %s", esp_err_to_name(err));
258 s_wifi_started =
true;
267 int8_t
val =
static_cast<int8_t
>(output_power * 4);
268 return esp_wifi_set_max_tx_power(
val) == ESP_OK;
272 wifi_ps_type_t power_save;
275 power_save = WIFI_PS_MIN_MODEM;
278 power_save = WIFI_PS_MAX_MODEM;
282 power_save = WIFI_PS_NONE;
285 bool success = esp_wifi_set_ps(power_save) == ESP_OK;
286#ifdef USE_WIFI_POWER_SAVE_LISTENERS
296#ifdef SOC_WIFI_SUPPORT_5G
307 memset(&conf, 0,
sizeof(conf));
308 if (ap.ssid_.size() >
sizeof(conf.sta.ssid)) {
309 ESP_LOGE(TAG,
"SSID too long");
312 if (ap.password_.size() >
sizeof(conf.sta.password)) {
313 ESP_LOGE(TAG,
"Password too long");
316 memcpy(
reinterpret_cast<char *
>(conf.sta.ssid), ap.ssid_.c_str(), ap.ssid_.size());
317 memcpy(
reinterpret_cast<char *
>(conf.sta.password), ap.password_.c_str(), ap.password_.size());
320 if (ap.password_.empty()) {
321 conf.sta.threshold.authmode = WIFI_AUTH_OPEN;
326 conf.sta.threshold.authmode = WIFI_AUTH_WPA_PSK;
329 conf.sta.threshold.authmode = WIFI_AUTH_WPA2_PSK;
332 conf.sta.threshold.authmode = WIFI_AUTH_WPA3_PSK;
337#ifdef USE_WIFI_WPA2_EAP
338 if (ap.get_eap().has_value()) {
339 conf.sta.threshold.authmode = WIFI_AUTH_WPA2_ENTERPRISE;
343#ifdef USE_WIFI_11KV_SUPPORT
344 conf.sta.btm_enabled = this->
btm_;
345 conf.sta.rm_enabled = this->
rrm_;
348 if (ap.has_bssid()) {
349 conf.sta.bssid_set =
true;
350 memcpy(conf.sta.bssid, ap.get_bssid().data(), 6);
352 conf.sta.bssid_set =
false;
354 if (ap.has_channel()) {
355 conf.sta.channel = ap.get_channel();
356 conf.sta.scan_method = WIFI_FAST_SCAN;
358 conf.sta.scan_method = WIFI_ALL_CHANNEL_SCAN;
362 conf.sta.listen_interval = 0;
366 conf.sta.pmf_cfg.capable =
true;
367 conf.sta.pmf_cfg.required =
false;
371 conf.sta.threshold.rssi = -127;
373 wifi_config_t current_conf;
375 err = esp_wifi_get_config(WIFI_IF_STA, ¤t_conf);
377 ESP_LOGW(TAG,
"esp_wifi_get_config failed: %s", esp_err_to_name(err));
381 if (memcmp(¤t_conf, &conf,
sizeof(wifi_config_t)) != 0) {
382 err = esp_wifi_disconnect();
384 ESP_LOGV(TAG,
"esp_wifi_disconnect failed: %s", esp_err_to_name(err));
389 err = esp_wifi_set_config(WIFI_IF_STA, &conf);
391 ESP_LOGV(TAG,
"esp_wifi_set_config failed: %s", esp_err_to_name(err));
395#ifdef USE_WIFI_MANUAL_IP
406#ifdef USE_WIFI_WPA2_EAP
407 auto eap_opt = ap.get_eap();
408 if (eap_opt.has_value()) {
410 EAPAuth eap = *eap_opt;
411#if ESP_IDF_VERSION >= ESP_IDF_VERSION_VAL(5, 1, 0)
412 err = esp_eap_client_set_identity((uint8_t *) eap.identity.c_str(), eap.identity.length());
414 err = esp_wifi_sta_wpa2_ent_set_identity((uint8_t *) eap.identity.c_str(), eap.identity.length());
417 ESP_LOGV(TAG,
"set_identity failed %d", err);
419 int ca_cert_len = strlen(eap.ca_cert);
420 int client_cert_len = strlen(eap.client_cert);
421 int client_key_len = strlen(eap.client_key);
423#if ESP_IDF_VERSION >= ESP_IDF_VERSION_VAL(5, 1, 0)
424 err = esp_eap_client_set_ca_cert((uint8_t *) eap.ca_cert, ca_cert_len + 1);
426 err = esp_wifi_sta_wpa2_ent_set_ca_cert((uint8_t *) eap.ca_cert, ca_cert_len + 1);
429 ESP_LOGV(TAG,
"set_ca_cert failed %d", err);
434 if (client_cert_len && client_key_len) {
436#if ESP_IDF_VERSION >= ESP_IDF_VERSION_VAL(5, 1, 0)
437 err = esp_eap_client_set_certificate_and_key((uint8_t *) eap.client_cert, client_cert_len + 1,
438 (uint8_t *) eap.client_key, client_key_len + 1,
439 (uint8_t *) eap.password.c_str(), eap.password.length());
441 err = esp_wifi_sta_wpa2_ent_set_cert_key((uint8_t *) eap.client_cert, client_cert_len + 1,
442 (uint8_t *) eap.client_key, client_key_len + 1,
443 (uint8_t *) eap.password.c_str(), eap.password.length());
446 ESP_LOGV(TAG,
"set_cert_key failed %d", err);
450#if ESP_IDF_VERSION >= ESP_IDF_VERSION_VAL(5, 1, 0)
451 err = esp_eap_client_set_username((uint8_t *) eap.username.c_str(), eap.username.length());
453 err = esp_wifi_sta_wpa2_ent_set_username((uint8_t *) eap.username.c_str(), eap.username.length());
456 ESP_LOGV(TAG,
"set_username failed %d", err);
458#if ESP_IDF_VERSION >= ESP_IDF_VERSION_VAL(5, 1, 0)
459 err = esp_eap_client_set_password((uint8_t *) eap.password.c_str(), eap.password.length());
461 err = esp_wifi_sta_wpa2_ent_set_password((uint8_t *) eap.password.c_str(), eap.password.length());
464 ESP_LOGV(TAG,
"set_password failed %d", err);
467#if ESP_IDF_VERSION >= ESP_IDF_VERSION_VAL(5, 1, 0)
468 err = esp_eap_client_set_ttls_phase2_method(eap.ttls_phase_2);
470 err = esp_wifi_sta_wpa2_ent_set_ttls_phase2_method(eap.ttls_phase_2);
473 ESP_LOGV(TAG,
"set_ttls_phase2_method failed %d", err);
476#if ESP_IDF_VERSION >= ESP_IDF_VERSION_VAL(5, 1, 0)
477 err = esp_wifi_sta_enterprise_enable();
479 err = esp_wifi_sta_wpa2_ent_enable();
482 ESP_LOGV(TAG,
"enterprise_enable failed %d", err);
489 s_sta_connecting =
true;
490 s_sta_connected =
false;
491 s_sta_connect_error =
false;
492 s_sta_connect_not_found =
false;
500 err = esp_wifi_connect();
502 ESP_LOGW(TAG,
"esp_wifi_connect failed: %s", esp_err_to_name(err));
515 if (s_sta_netif ==
nullptr) {
516 ESP_LOGW(TAG,
"STA interface not initialized");
520 esp_netif_dhcp_status_t dhcp_status;
521 esp_err_t err = esp_netif_dhcpc_get_status(s_sta_netif, &dhcp_status);
523 ESP_LOGV(TAG,
"esp_netif_dhcpc_get_status failed: %s", esp_err_to_name(err));
527 if (!manual_ip.has_value()) {
531 sntp_servermode_dhcp(
false);
534 if (dhcp_status != ESP_NETIF_DHCP_STARTED) {
535 err = esp_netif_dhcpc_start(s_sta_netif);
537 ESP_LOGV(TAG,
"Starting DHCP client failed: %d", err);
539 return err == ESP_OK;
544 esp_netif_ip_info_t info;
545 info.ip = manual_ip->static_ip;
546 info.gw = manual_ip->gateway;
547 info.netmask = manual_ip->subnet;
548 err = esp_netif_dhcpc_stop(s_sta_netif);
549 if (err != ESP_OK && err != ESP_ERR_ESP_NETIF_DHCP_ALREADY_STOPPED) {
550 ESP_LOGV(TAG,
"Stopping DHCP client failed: %s", esp_err_to_name(err));
553 err = esp_netif_set_ip_info(s_sta_netif, &info);
555 ESP_LOGV(TAG,
"Setting manual IP info failed: %s", esp_err_to_name(err));
558 esp_netif_dns_info_t dns;
559 if (manual_ip->dns1.is_set()) {
560 dns.ip = manual_ip->dns1;
561 esp_netif_set_dns_info(s_sta_netif, ESP_NETIF_DNS_MAIN, &dns);
563 if (manual_ip->dns2.is_set()) {
564 dns.ip = manual_ip->dns2;
565 esp_netif_set_dns_info(s_sta_netif, ESP_NETIF_DNS_BACKUP, &dns);
575 esp_netif_ip_info_t ip;
576 esp_err_t err = esp_netif_get_ip_info(s_sta_netif, &ip);
578 ESP_LOGV(TAG,
"esp_netif_get_ip_info failed: %s", esp_err_to_name(err));
582 addresses[0] = network::IPAddress(&ip.ip);
585 struct esp_ip6_addr if_ip6s[CONFIG_LWIP_IPV6_NUM_ADDRESSES];
587 count = esp_netif_get_all_ip6(s_sta_netif, if_ip6s);
588 assert(count <= CONFIG_LWIP_IPV6_NUM_ADDRESSES);
589 assert(count < addresses.size());
590 for (
int i = 0; i < count; i++) {
591 addresses[i + 1] = network::IPAddress(&if_ip6s[i]);
607 case WIFI_AUTH_WPA_PSK:
609 case WIFI_AUTH_WPA2_PSK:
611 case WIFI_AUTH_WPA_WPA2_PSK:
612 return "WPA/WPA2 PSK";
613 case WIFI_AUTH_WPA2_ENTERPRISE:
614 return "WPA2 Enterprise";
615 case WIFI_AUTH_WPA3_PSK:
617 case WIFI_AUTH_WPA2_WPA3_PSK:
618 return "WPA2/WPA3 PSK";
619 case WIFI_AUTH_WAPI_PSK:
628 case WIFI_REASON_AUTH_EXPIRE:
629 return "Auth Expired";
630 case WIFI_REASON_AUTH_LEAVE:
632#if ESP_IDF_VERSION >= ESP_IDF_VERSION_VAL(6, 0, 0)
633 case WIFI_REASON_DISASSOC_DUE_TO_INACTIVITY:
634 return "Disassociated Due to Inactivity";
636 case WIFI_REASON_ASSOC_EXPIRE:
637 return "Association Expired";
639 case WIFI_REASON_ASSOC_TOOMANY:
640 return "Too Many Associations";
641#if ESP_IDF_VERSION >= ESP_IDF_VERSION_VAL(6, 0, 0)
642 case WIFI_REASON_CLASS2_FRAME_FROM_NONAUTH_STA:
643 return "Class 2 Frame from Non-Authenticated STA";
644 case WIFI_REASON_CLASS3_FRAME_FROM_NONASSOC_STA:
645 return "Class 3 Frame from Non-Associated STA";
647 case WIFI_REASON_NOT_AUTHED:
648 return "Not Authenticated";
649 case WIFI_REASON_NOT_ASSOCED:
650 return "Not Associated";
652 case WIFI_REASON_ASSOC_LEAVE:
653 return "Association Leave";
654 case WIFI_REASON_ASSOC_NOT_AUTHED:
655 return "Association not Authenticated";
656 case WIFI_REASON_DISASSOC_PWRCAP_BAD:
657 return "Disassociate Power Cap Bad";
658 case WIFI_REASON_DISASSOC_SUPCHAN_BAD:
659 return "Disassociate Supported Channel Bad";
660 case WIFI_REASON_IE_INVALID:
662 case WIFI_REASON_MIC_FAILURE:
663 return "Mic Failure";
664 case WIFI_REASON_4WAY_HANDSHAKE_TIMEOUT:
665 return "4-Way Handshake Timeout";
666 case WIFI_REASON_GROUP_KEY_UPDATE_TIMEOUT:
667 return "Group Key Update Timeout";
668 case WIFI_REASON_IE_IN_4WAY_DIFFERS:
669 return "IE In 4-Way Handshake Differs";
670 case WIFI_REASON_GROUP_CIPHER_INVALID:
671 return "Group Cipher Invalid";
672 case WIFI_REASON_PAIRWISE_CIPHER_INVALID:
673 return "Pairwise Cipher Invalid";
674 case WIFI_REASON_AKMP_INVALID:
675 return "AKMP Invalid";
676 case WIFI_REASON_UNSUPP_RSN_IE_VERSION:
677 return "Unsupported RSN IE version";
678 case WIFI_REASON_INVALID_RSN_IE_CAP:
679 return "Invalid RSN IE Cap";
680 case WIFI_REASON_802_1X_AUTH_FAILED:
681 return "802.1x Authentication Failed";
682 case WIFI_REASON_CIPHER_SUITE_REJECTED:
683 return "Cipher Suite Rejected";
684 case WIFI_REASON_BEACON_TIMEOUT:
685 return "Beacon Timeout";
686 case WIFI_REASON_NO_AP_FOUND:
687 return "AP Not Found";
688 case WIFI_REASON_AUTH_FAIL:
689 return "Authentication Failed";
690 case WIFI_REASON_ASSOC_FAIL:
691 return "Association Failed";
692 case WIFI_REASON_HANDSHAKE_TIMEOUT:
693 return "Handshake Failed";
694 case WIFI_REASON_CONNECTION_FAIL:
695 return "Connection Failed";
696 case WIFI_REASON_AP_TSF_RESET:
697 return "AP TSF reset";
698 case WIFI_REASON_ROAMING:
699 return "Station Roaming";
700 case WIFI_REASON_ASSOC_COMEBACK_TIME_TOO_LONG:
701 return "Association comeback time too long";
702 case WIFI_REASON_SA_QUERY_TIMEOUT:
703 return "SA query timeout";
704#if ESP_IDF_VERSION >= ESP_IDF_VERSION_VAL(5, 2, 0)
705 case WIFI_REASON_NO_AP_FOUND_W_COMPATIBLE_SECURITY:
706 return "No AP found with compatible security";
707 case WIFI_REASON_NO_AP_FOUND_IN_AUTHMODE_THRESHOLD:
708 return "No AP found in auth mode threshold";
709 case WIFI_REASON_NO_AP_FOUND_IN_RSSI_THRESHOLD:
710 return "No AP found in RSSI threshold";
712 case WIFI_REASON_UNSPECIFIED:
714 return "Unspecified";
721 ESP_LOGW(TAG,
"Dropped %u WiFi events due to buffer overflow", dropped);
735 if (
data->event_base == WIFI_EVENT &&
data->event_id == WIFI_EVENT_STA_START) {
736 ESP_LOGV(TAG,
"STA start");
740 ESP_LOGW(TAG,
"esp_netif_set_hostname failed: %s", esp_err_to_name(err));
743 s_sta_started =
true;
746#ifdef SOC_WIFI_SUPPORT_5G
750 }
else if (
data->event_base == WIFI_EVENT &&
data->event_id == WIFI_EVENT_STA_STOP) {
751 ESP_LOGV(TAG,
"STA stop");
752 s_sta_started =
false;
753 s_sta_connecting =
false;
755 }
else if (
data->event_base == WIFI_EVENT &&
data->event_id == WIFI_EVENT_STA_AUTHMODE_CHANGE) {
756 const auto &it =
data->data.sta_authmode_change;
759 }
else if (
data->event_base == WIFI_EVENT &&
data->event_id == WIFI_EVENT_STA_CONNECTED) {
760 const auto &it =
data->data.sta_connected;
761#if ESPHOME_LOG_LEVEL >= ESPHOME_LOG_LEVEL_VERBOSE
762 char bssid_buf[MAC_ADDRESS_PRETTY_BUFFER_SIZE];
764 ESP_LOGV(TAG,
"Connected ssid='%.*s' bssid=" LOG_SECRET(
"%s")
" channel=%u, authmode=%s", it.ssid_len,
767 s_sta_connected =
true;
768#ifdef USE_WIFI_CONNECT_STATE_LISTENERS
771 this->
pending_.connect_state =
true;
774#if defined(USE_WIFI_IP_STATE_LISTENERS) && defined(USE_WIFI_MANUAL_IP)
780 }
else if (data->event_base == WIFI_EVENT &&
data->event_id == WIFI_EVENT_STA_DISCONNECTED) {
781 const auto &it =
data->data.sta_disconnected;
782 if (it.reason == WIFI_REASON_NO_AP_FOUND) {
783 ESP_LOGW(TAG,
"Disconnected ssid='%.*s' reason='Probe Request Unsuccessful'", it.ssid_len,
784 (
const char *) it.ssid);
785 s_sta_connect_not_found =
true;
786 }
else if (it.reason == WIFI_REASON_ROAMING) {
787 ESP_LOGI(TAG,
"Disconnected ssid='%.*s' reason='Station Roaming'", it.ssid_len, (
const char *) it.ssid);
792 ESP_LOGW(TAG,
"Disconnected ssid='%.*s' bssid=" LOG_SECRET(
"%s")
" reason='%s'", it.ssid_len,
794 s_sta_connect_error =
true;
796 s_sta_connected =
false;
797 s_sta_connecting =
false;
799#ifdef USE_WIFI_CONNECT_STATE_LISTENERS
803 }
else if (data->event_base == IP_EVENT &&
data->event_id == IP_EVENT_STA_GOT_IP) {
804 const auto &it =
data->data.ip_got_ip;
806 esp_netif_create_ip6_linklocal(s_sta_netif);
808 ESP_LOGV(TAG,
"static_ip=" IPSTR
" gateway=" IPSTR, IP2STR(&it.ip_info.ip), IP2STR(&it.ip_info.gw));
810#ifdef USE_WIFI_IP_STATE_LISTENERS
815 }
else if (data->event_base == IP_EVENT &&
data->event_id == IP_EVENT_GOT_IP6) {
816 const auto &it =
data->data.ip_got_ip6;
817 ESP_LOGV(TAG,
"IPv6 address=" IPV6STR, IPV62STR(it.ip6_info.ip));
819#ifdef USE_WIFI_IP_STATE_LISTENERS
824 }
else if (data->event_base == IP_EVENT &&
data->event_id == IP_EVENT_STA_LOST_IP) {
825 ESP_LOGV(TAG,
"Lost IP");
828 }
else if (data->event_base == WIFI_EVENT &&
data->event_id == WIFI_EVENT_SCAN_DONE) {
829 const auto &it =
data->data.sta_scan_done;
830 ESP_LOGV(TAG,
"Scan done: status=%" PRIu32
" number=%u scan_id=%u", it.status, it.number, it.scan_id);
834 if (it.status != 0) {
839 if (it.number == 0) {
844 uint16_t number = it.number;
851 this->
scan_result_.reserve(WIFI_SCAN_RESULT_FILTERED_RESERVE);
854#ifdef USE_ESP32_HOSTED
858 static constexpr size_t SCAN_RECORD_STACK_COUNT = 3904 /
sizeof(wifi_ap_record_t);
859 SmallBufferWithHeapFallback<SCAN_RECORD_STACK_COUNT, wifi_ap_record_t> records(number);
860 err = esp_wifi_scan_get_ap_records(&number, records.get());
862 esp_wifi_clear_ap_list();
863 ESP_LOGW(TAG,
"esp_wifi_scan_get_ap_records failed: %s", esp_err_to_name(err));
866 for (uint16_t i = 0; i < number; i++) {
867 wifi_ap_record_t &record = records.get()[i];
870 for (uint16_t i = 0; i < number; i++) {
871 wifi_ap_record_t record;
872 err = esp_wifi_scan_get_ap_record(&record);
874 ESP_LOGW(TAG,
"esp_wifi_scan_get_ap_record failed: %s", esp_err_to_name(err));
875 esp_wifi_clear_ap_list();
881 const char *ssid_cstr =
reinterpret_cast<const char *
>(record.ssid);
886 std::copy(record.bssid, record.bssid + 6, bssid.begin());
887 this->
scan_result_.emplace_back(bssid, ssid_cstr, strlen(ssid_cstr), record.primary, record.rssi,
888 record.authmode != WIFI_AUTH_OPEN, ssid_cstr[0] ==
'\0');
893 ESP_LOGV(TAG,
"Scan complete: %u found, %zu stored%s", number, this->
scan_result_.size(),
894 needs_full ?
"" :
" (filtered)");
895#ifdef USE_WIFI_SCAN_RESULTS_LISTENERS
899 }
else if (data->event_base == WIFI_EVENT &&
data->event_id == WIFI_EVENT_AP_START) {
900 ESP_LOGV(TAG,
"AP start");
903 }
else if (data->event_base == WIFI_EVENT &&
data->event_id == WIFI_EVENT_AP_STOP) {
904 ESP_LOGV(TAG,
"AP stop");
907 }
else if (data->event_base == WIFI_EVENT &&
data->event_id == WIFI_EVENT_AP_PROBEREQRECVED) {
908#if ESPHOME_LOG_LEVEL >= ESPHOME_LOG_LEVEL_VERY_VERBOSE
909 const auto &it =
data->data.ap_probe_req_rx;
910 char mac_buf[MAC_ADDRESS_PRETTY_BUFFER_SIZE];
912 ESP_LOGVV(TAG,
"AP receive Probe Request MAC=%s RSSI=%d", mac_buf, it.rssi);
915 }
else if (
data->event_base == WIFI_EVENT &&
data->event_id == WIFI_EVENT_AP_STACONNECTED) {
916#if ESPHOME_LOG_LEVEL >= ESPHOME_LOG_LEVEL_VERBOSE
917 const auto &it =
data->data.ap_staconnected;
918 char mac_buf[MAC_ADDRESS_PRETTY_BUFFER_SIZE];
920 ESP_LOGV(TAG,
"AP client connected MAC=%s", mac_buf);
923 }
else if (
data->event_base == WIFI_EVENT &&
data->event_id == WIFI_EVENT_AP_STADISCONNECTED) {
924#if ESPHOME_LOG_LEVEL >= ESPHOME_LOG_LEVEL_VERBOSE
925 const auto &it =
data->data.ap_stadisconnected;
926 char mac_buf[MAC_ADDRESS_PRETTY_BUFFER_SIZE];
928 ESP_LOGV(TAG,
"AP client disconnected MAC=%s", mac_buf);
931#if ESP_IDF_VERSION >= ESP_IDF_VERSION_VAL(6, 0, 0)
932 }
else if (
data->event_base == IP_EVENT &&
data->event_id == IP_EVENT_ASSIGNED_IP_TO_CLIENT) {
933 const auto &it =
data->data.ip_assigned_ip_to_client;
935 }
else if (
data->event_base == IP_EVENT &&
data->event_id == IP_EVENT_AP_STAIPASSIGNED) {
936 const auto &it =
data->data.ip_ap_staipassigned;
938 ESP_LOGV(TAG,
"AP client assigned IP " IPSTR, IP2STR(&it.ip));
944#if USE_NETWORK_IPV6 && (USE_NETWORK_MIN_IPV6_ADDR_COUNT > 0)
952 if (s_sta_connect_error) {
955 if (s_sta_connect_not_found) {
958 if (s_sta_connecting) {
968 wifi_scan_config_t config{};
969 config.ssid =
nullptr;
970 config.bssid =
nullptr;
972 config.show_hidden =
true;
973 config.scan_type = passive ? WIFI_SCAN_TYPE_PASSIVE : WIFI_SCAN_TYPE_ACTIVE;
975 config.scan_time.passive = 300;
977 config.scan_time.active.min = 100;
978 config.scan_time.active.max = 300;
982#ifdef CONFIG_SOC_WIFI_SUPPORTED
984 config.coex_background_scan =
true;
988 esp_err_t err = esp_wifi_scan_start(&config,
false);
990 ESP_LOGV(TAG,
"esp_wifi_scan_start failed: %s", esp_err_to_name(err));
1007 if (s_ap_netif ==
nullptr) {
1008 ESP_LOGW(TAG,
"AP interface not initialized");
1012 esp_netif_ip_info_t info;
1013 if (manual_ip.has_value()) {
1014 info.ip = manual_ip->static_ip;
1015 info.gw = manual_ip->gateway;
1016 info.netmask = manual_ip->subnet;
1018 info.ip = network::IPAddress(192, 168, 4, 1);
1019 info.gw = network::IPAddress(192, 168, 4, 1);
1020 info.netmask = network::IPAddress(255, 255, 255, 0);
1023 err = esp_netif_dhcps_stop(s_ap_netif);
1024 if (err != ESP_OK && err != ESP_ERR_ESP_NETIF_DHCP_ALREADY_STOPPED) {
1025 ESP_LOGE(TAG,
"esp_netif_dhcps_stop failed: %s", esp_err_to_name(err));
1029 err = esp_netif_set_ip_info(s_ap_netif, &info);
1030 if (err != ESP_OK) {
1031 ESP_LOGE(TAG,
"esp_netif_set_ip_info failed: %d", err);
1035 dhcps_lease_t lease;
1036 lease.enable =
true;
1037 network::IPAddress start_address = network::IPAddress(&info.ip);
1038 start_address += 99;
1039 lease.start_ip = start_address;
1040#if ESPHOME_LOG_LEVEL >= ESPHOME_LOG_LEVEL_VERBOSE
1041 char ip_buf[network::IP_ADDRESS_BUFFER_SIZE];
1043 ESP_LOGV(TAG,
"DHCP server IP lease start: %s", start_address.str_to(ip_buf));
1044 start_address += 10;
1045 lease.end_ip = start_address;
1046 ESP_LOGV(TAG,
"DHCP server IP lease end: %s", start_address.str_to(ip_buf));
1047 err = esp_netif_dhcps_option(s_ap_netif, ESP_NETIF_OP_SET, ESP_NETIF_REQUESTED_IP_ADDRESS, &lease,
sizeof(lease));
1049 if (err != ESP_OK) {
1050 ESP_LOGE(TAG,
"esp_netif_dhcps_option failed: %d", err);
1054#if defined(USE_CAPTIVE_PORTAL) && ESP_IDF_VERSION >= ESP_IDF_VERSION_VAL(5, 4, 0)
1059 static char captive_portal_uri[24];
1060 memcpy(captive_portal_uri,
"http://", 7);
1061 network::IPAddress(&info.ip).str_to(captive_portal_uri + 7);
1062 err = esp_netif_dhcps_option(s_ap_netif, ESP_NETIF_OP_SET, ESP_NETIF_CAPTIVEPORTAL_URI, captive_portal_uri,
1063 strlen(captive_portal_uri));
1064 if (err != ESP_OK) {
1065 ESP_LOGV(TAG,
"Failed to set DHCP captive portal URI: %s", esp_err_to_name(err));
1067 ESP_LOGV(TAG,
"DHCP Captive Portal URI set to: %s", captive_portal_uri);
1072 err = esp_netif_dhcps_start(s_ap_netif);
1074 if (err != ESP_OK) {
1075 ESP_LOGE(TAG,
"esp_netif_dhcps_start failed: %d", err);
1088 memset(&conf, 0,
sizeof(conf));
1089 if (ap.ssid_.size() >
sizeof(conf.ap.ssid)) {
1090 ESP_LOGE(TAG,
"AP SSID too long");
1093 memcpy(
reinterpret_cast<char *
>(conf.ap.ssid), ap.ssid_.c_str(), ap.ssid_.size());
1094 conf.ap.channel = ap.has_channel() ? ap.get_channel() : 1;
1095 conf.ap.ssid_hidden = ap.get_hidden();
1096 conf.ap.max_connection = 5;
1097 conf.ap.beacon_interval = 100;
1099 if (ap.password_.empty()) {
1100 conf.ap.authmode = WIFI_AUTH_OPEN;
1101 *conf.ap.password = 0;
1103 conf.ap.authmode = WIFI_AUTH_WPA2_PSK;
1104 if (ap.password_.size() >
sizeof(conf.ap.password)) {
1105 ESP_LOGE(TAG,
"AP password too long");
1108 memcpy(
reinterpret_cast<char *
>(conf.ap.password), ap.password_.c_str(), ap.password_.size());
1112 conf.ap.pairwise_cipher = WIFI_CIPHER_TYPE_CCMP;
1114 esp_err_t err = esp_wifi_set_config(WIFI_IF_AP, &conf);
1115 if (err != ESP_OK) {
1116 ESP_LOGE(TAG,
"esp_wifi_set_config failed: %d", err);
1120#ifdef USE_WIFI_MANUAL_IP
1122 ESP_LOGE(TAG,
"wifi_ap_ip_config_ failed:");
1127 ESP_LOGE(TAG,
"wifi_ap_ip_config_ failed:");
1136 esp_netif_ip_info_t ip;
1137 esp_netif_get_ip_info(s_ap_netif, &ip);
1138 return network::IPAddress(&ip.ip);
1146 wifi_ap_record_t info;
1147 esp_err_t err = esp_wifi_sta_get_ap_info(&info);
1148 if (err != ESP_OK) {
1150 ESP_LOGVV(TAG,
"esp_wifi_sta_get_ap_info failed: %s", esp_err_to_name(err));
1153 std::copy(info.bssid, info.bssid + 6, bssid.begin());
1156std::string WiFiComponent::wifi_ssid() {
1157 wifi_ap_record_t info{};
1158 esp_err_t err = esp_wifi_sta_get_ap_info(&info);
1159 if (err != ESP_OK) {
1161 ESP_LOGVV(TAG,
"esp_wifi_sta_get_ap_info failed: %s", esp_err_to_name(err));
1164 auto *ssid_s =
reinterpret_cast<const char *
>(info.ssid);
1165 size_t len = strnlen(ssid_s,
sizeof(info.ssid));
1166 return {ssid_s,
len};
1169 wifi_ap_record_t info{};
1170 esp_err_t err = esp_wifi_sta_get_ap_info(&info);
1171 if (err != ESP_OK) {
1173 return buffer.data();
1176 size_t len = strnlen(
reinterpret_cast<const char *
>(info.ssid), 32);
1177 memcpy(buffer.data(), info.ssid,
len);
1179 return buffer.data();
1182 wifi_ap_record_t info;
1183 esp_err_t err = esp_wifi_sta_get_ap_info(&info);
1184 if (err != ESP_OK) {
1186 ESP_LOGVV(TAG,
"esp_wifi_sta_get_ap_info failed: %s", esp_err_to_name(err));
1187 return WIFI_RSSI_DISCONNECTED;
1193 wifi_second_chan_t
second;
1194 esp_err_t err = esp_wifi_get_channel(&primary, &
second);
1195 if (err != ESP_OK) {
1196 ESP_LOGW(TAG,
"esp_wifi_get_channel failed: %s", esp_err_to_name(err));
1202 esp_netif_ip_info_t ip;
1203 esp_err_t err = esp_netif_get_ip_info(s_sta_netif, &ip);
1204 if (err != ESP_OK) {
1205 ESP_LOGW(TAG,
"esp_netif_get_ip_info failed: %s", esp_err_to_name(err));
1208 return network::IPAddress(&ip.netmask);
1211 esp_netif_ip_info_t ip;
1212 esp_err_t err = esp_netif_get_ip_info(s_sta_netif, &ip);
1213 if (err != ESP_OK) {
1214 ESP_LOGW(TAG,
"esp_netif_get_ip_info failed: %s", esp_err_to_name(err));
1217 return network::IPAddress(&ip.gw);
1220 const ip_addr_t *dns_ip = dns_getserver(num);
1221 return network::IPAddress(dns_ip);
BedjetMode mode
BedJet operating mode.
const StringRef & get_name() const
Get the name of this Application set by pre_setup().
uint16_t get_and_reset_dropped_count()
constexpr const char * c_str() const
const optional< ManualIP > & get_manual_ip() const
void notify_scan_results_listeners_()
Notify scan results listeners with current scan results.
bool error_from_callback_
bool wifi_apply_power_save_()
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)
WiFiPowerSaveMode power_save_
const WiFiAP * get_selected_sta_() const
WiFiSTAConnectStatus wifi_sta_connect_status_() const
wifi_scan_vector_t< WiFiScanResult > scan_result_
struct esphome::wifi::WiFiComponent::@190 pending_
bool wifi_apply_band_mode_()
void notify_ip_state_listeners_()
Notify IP state listeners with current addresses.
bool wifi_sta_ip_config_(const optional< ManualIP > &manual_ip)
RoamingState roaming_state_
wifi_band_mode_t band_mode_
void wifi_process_event_(IDFWiFiEvent *data)
void notify_disconnect_state_listeners_()
Notify connect state listeners of disconnection.
friend void event_handler(void *arg, esp_event_base_t event_base, int32_t event_id, void *event_data)
bool wifi_start_ap_(const WiFiAP &ap)
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)
int32_t get_wifi_channel()
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_subnet_mask_()
network::IPAddress wifi_soft_ap_ip()
network::IPAddress wifi_gateway_ip_()
network::IPAddress wifi_dns_ip_(int num)
bool wifi_apply_hostname_()
bool wifi_sta_pre_setup_()
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)
LockFreeQueue< IDFWiFiEvent, 17 > event_queue_
StaticVector< WiFiPowerSaveListener *, ESPHOME_WIFI_POWER_SAVE_LISTENERS > power_save_listeners_
WifiMinAuthMode min_auth_mode_
bool wifi_apply_output_power_(float output_power)
bool wifi_sta_connect_(const WiFiAP &ap)
bool wifi_mode_(optional< bool > sta, optional< bool > ap)
network::IPAddresses wifi_sta_ip_addresses()
uint8_t num_ipv6_addresses_
bool wifi_scan_start_(bool passive)
CaptivePortal * global_captive_portal
const std::vector< uint8_t > & data
std::array< IPAddress, 5 > IPAddresses
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)
@ WIFI_MIN_AUTH_MODE_WPA2
@ WIFI_MIN_AUTH_MODE_WPA3
@ ERROR_NETWORK_NOT_FOUND
WiFiComponent * global_wifi_component
@ SCANNING
Scanning for better AP.
bool has_custom_mac_address()
Check if a custom MAC address is set (ESP32 & variants)
void set_mac_address(uint8_t *mac)
Set the MAC address to use from the provided byte array (6 bytes).
void get_mac_address_raw(uint8_t *mac)
Get the device MAC address as raw bytes, written into the provided byte array (6 bytes).
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)