#pragma once #include "esphome/core/defines.h" #ifdef USE_WIFI #include "esphome/components/network/ip_address.h" #include "esphome/core/automation.h" #include "esphome/core/component.h" #include "esphome/core/helpers.h" #include #include #ifdef USE_ESP32_FRAMEWORK_ARDUINO #include #include #include #endif #ifdef USE_LIBRETINY #include #endif #if defined(USE_ESP_IDF) && defined(USE_WIFI_WPA2_EAP) #if (ESP_IDF_VERSION_MAJOR >= 5) && (ESP_IDF_VERSION_MINOR >= 1) #include #else #include #endif #endif #ifdef USE_ESP8266 #include #include #if defined(USE_ESP8266) && USE_ARDUINO_VERSION_CODE < VERSION_CODE(2, 4, 0) extern "C" { #include }; #endif #endif #ifdef USE_RP2040 extern "C" { #include "cyw43.h" #include "cyw43_country.h" #include "pico/cyw43_arch.h" } #include #endif namespace esphome { namespace wifi { struct SavedWifiSettings { char ssid[33]; char password[65]; } PACKED; // NOLINT struct SavedWifiFastConnectSettings { uint8_t bssid[6]; uint8_t channel; int8_t ap_index; } PACKED; // NOLINT enum WiFiComponentState : uint8_t { /** Nothing has been initialized yet. Internal AP, if configured, is disabled at this point. */ WIFI_COMPONENT_STATE_OFF = 0, /** WiFi is disabled. */ WIFI_COMPONENT_STATE_DISABLED, /** WiFi is in cooldown mode because something went wrong, scanning will begin after a short period of time. */ WIFI_COMPONENT_STATE_COOLDOWN, /** WiFi is in STA-only mode and currently scanning for APs. */ WIFI_COMPONENT_STATE_STA_SCANNING, /** WiFi is in STA(+AP) mode and currently connecting to an AP. */ WIFI_COMPONENT_STATE_STA_CONNECTING, /** WiFi is in STA(+AP) mode and currently connecting to an AP a second time. * * This is required because for some reason ESPs don't like to connect to WiFi APs directly after * a scan. * */ WIFI_COMPONENT_STATE_STA_CONNECTING_2, /** WiFi is in STA(+AP) mode and successfully connected. */ WIFI_COMPONENT_STATE_STA_CONNECTED, /** WiFi is in AP-only mode and internal AP is already enabled. */ WIFI_COMPONENT_STATE_AP, }; enum class WiFiSTAConnectStatus : int { IDLE, CONNECTING, CONNECTED, ERROR_NETWORK_NOT_FOUND, ERROR_CONNECT_FAILED, }; /// Struct for setting static IPs in WiFiComponent. struct ManualIP { network::IPAddress static_ip; network::IPAddress gateway; network::IPAddress subnet; network::IPAddress dns1; ///< The first DNS server. 0.0.0.0 for default. network::IPAddress dns2; ///< The second DNS server. 0.0.0.0 for default. }; #ifdef USE_WIFI_WPA2_EAP struct EAPAuth { std::string identity; // required for all auth types std::string username; std::string password; const char *ca_cert; // optionally verify authentication server // used for EAP-TLS const char *client_cert; const char *client_key; // used for EAP-TTLS #ifdef USE_ESP_IDF esp_eap_ttls_phase2_types ttls_phase_2; #endif }; #endif // USE_WIFI_WPA2_EAP using bssid_t = std::array; class WiFiAP { public: void set_ssid(const std::string &ssid); void set_bssid(bssid_t bssid); void set_bssid(optional bssid); void set_password(const std::string &password); #ifdef USE_WIFI_WPA2_EAP void set_eap(optional eap_auth); #endif // USE_WIFI_WPA2_EAP void set_channel(optional channel); void set_priority(float priority) { priority_ = priority; } void set_manual_ip(optional manual_ip); void set_hidden(bool hidden); const std::string &get_ssid() const; const optional &get_bssid() const; const std::string &get_password() const; #ifdef USE_WIFI_WPA2_EAP const optional &get_eap() const; #endif // USE_WIFI_WPA2_EAP const optional &get_channel() const; float get_priority() const { return priority_; } const optional &get_manual_ip() const; bool get_hidden() const; protected: std::string ssid_; std::string password_; optional bssid_; #ifdef USE_WIFI_WPA2_EAP optional eap_; #endif // USE_WIFI_WPA2_EAP optional manual_ip_; float priority_{0}; optional channel_; bool hidden_{false}; }; class WiFiScanResult { public: WiFiScanResult(const bssid_t &bssid, std::string ssid, uint8_t channel, int8_t rssi, bool with_auth, bool is_hidden); bool matches(const WiFiAP &config); bool get_matches() const; void set_matches(bool matches); const bssid_t &get_bssid() const; const std::string &get_ssid() const; uint8_t get_channel() const; int8_t get_rssi() const; bool get_with_auth() const; bool get_is_hidden() const; float get_priority() const { return priority_; } void set_priority(float priority) { priority_ = priority; } bool operator==(const WiFiScanResult &rhs) const; protected: bssid_t bssid_; std::string ssid_; float priority_{0.0f}; uint8_t channel_; int8_t rssi_; bool matches_{false}; bool with_auth_; bool is_hidden_; }; struct WiFiSTAPriority { bssid_t bssid; float priority; }; enum WiFiPowerSaveMode : uint8_t { WIFI_POWER_SAVE_NONE = 0, WIFI_POWER_SAVE_LIGHT, WIFI_POWER_SAVE_HIGH, }; #ifdef USE_ESP_IDF struct IDFWiFiEvent; #endif /// This component is responsible for managing the ESP WiFi interface. class WiFiComponent : public Component { public: /// Construct a WiFiComponent. WiFiComponent(); void set_sta(const WiFiAP &ap); WiFiAP get_sta() { return this->selected_ap_; } void add_sta(const WiFiAP &ap); void clear_sta(); #ifdef USE_WIFI_AP /** Setup an Access Point that should be created if no connection to a station can be made. * * This can also be used without set_sta(). Then the AP will always be active. * * If both STA and AP are defined, then both will be enabled at startup, but if a connection to a station * can be made, the AP will be turned off again. */ void set_ap(const WiFiAP &ap); WiFiAP get_ap() { return this->ap_; } #endif // USE_WIFI_AP void enable(); void disable(); bool is_disabled(); void start_scanning(); void check_scanning_finished(); void start_connecting(const WiFiAP &ap, bool two); void set_fast_connect(bool fast_connect); void set_ap_timeout(uint32_t ap_timeout) { ap_timeout_ = ap_timeout; } void check_connecting_finished(); void retry_connect(); bool can_proceed() override; void set_reboot_timeout(uint32_t reboot_timeout); bool is_connected(); void set_power_save_mode(WiFiPowerSaveMode power_save); void set_output_power(float output_power) { output_power_ = output_power; } void set_passive_scan(bool passive); void save_wifi_sta(const std::string &ssid, const std::string &password); // ========== INTERNAL METHODS ========== // (In most use cases you won't need these) /// Setup WiFi interface. void setup() override; void start(); void dump_config() override; void restart_adapter(); /// WIFI setup_priority. float get_setup_priority() const override; float get_loop_priority() const override; /// Reconnect WiFi if required. void loop() override; bool has_sta() const; bool has_ap() const; #ifdef USE_WIFI_11KV_SUPPORT void set_btm(bool btm); void set_rrm(bool rrm); #endif network::IPAddress get_dns_address(int num); network::IPAddresses get_ip_addresses(); std::string get_use_address() const; void set_use_address(const std::string &use_address); const std::vector &get_scan_result() const { return scan_result_; } network::IPAddress wifi_soft_ap_ip(); bool has_sta_priority(const bssid_t &bssid) { for (auto &it : this->sta_priorities_) { if (it.bssid == bssid) return true; } return false; } float get_sta_priority(const bssid_t bssid) { for (auto &it : this->sta_priorities_) { if (it.bssid == bssid) return it.priority; } return 0.0f; } void set_sta_priority(const bssid_t bssid, float priority) { for (auto &it : this->sta_priorities_) { if (it.bssid == bssid) { it.priority = priority; return; } } this->sta_priorities_.push_back(WiFiSTAPriority{ .bssid = bssid, .priority = priority, }); } network::IPAddresses wifi_sta_ip_addresses(); std::string wifi_ssid(); bssid_t wifi_bssid(); int8_t wifi_rssi(); void set_enable_on_boot(bool enable_on_boot) { this->enable_on_boot_ = enable_on_boot; } Trigger<> *get_connect_trigger() const { return this->connect_trigger_; }; Trigger<> *get_disconnect_trigger() const { return this->disconnect_trigger_; }; int32_t get_wifi_channel(); protected: #ifdef USE_WIFI_AP void setup_ap_config_(); #endif // USE_WIFI_AP void print_connect_params_(); void wifi_loop_(); bool wifi_mode_(optional sta, optional ap); bool wifi_sta_pre_setup_(); bool wifi_apply_output_power_(float output_power); bool wifi_apply_power_save_(); bool wifi_sta_ip_config_(optional manual_ip); bool wifi_apply_hostname_(); bool wifi_sta_connect_(const WiFiAP &ap); void wifi_pre_setup_(); WiFiSTAConnectStatus wifi_sta_connect_status_(); bool wifi_scan_start_(bool passive); #ifdef USE_WIFI_AP bool wifi_ap_ip_config_(optional manual_ip); bool wifi_start_ap_(const WiFiAP &ap); #endif // USE_WIFI_AP bool wifi_disconnect_(); network::IPAddress wifi_subnet_mask_(); network::IPAddress wifi_gateway_ip_(); network::IPAddress wifi_dns_ip_(int num); bool is_captive_portal_active_(); bool is_esp32_improv_active_(); bool load_fast_connect_settings_(); void save_fast_connect_settings_(); #ifdef USE_ESP8266 static void wifi_event_callback(System_Event_t *event); void wifi_scan_done_callback_(void *arg, STATUS status); static void s_wifi_scan_done_callback(void *arg, STATUS status); #endif #ifdef USE_ESP32_FRAMEWORK_ARDUINO void wifi_event_callback_(arduino_event_id_t event, arduino_event_info_t info); void wifi_scan_done_callback_(); #endif #ifdef USE_ESP_IDF void wifi_process_event_(IDFWiFiEvent *data); #endif #ifdef USE_RP2040 static int s_wifi_scan_result(void *env, const cyw43_ev_scan_result_t *result); void wifi_scan_result(void *env, const cyw43_ev_scan_result_t *result); #endif #ifdef USE_LIBRETINY void wifi_event_callback_(arduino_event_id_t event, arduino_event_info_t info); void wifi_scan_done_callback_(); #endif std::string use_address_; std::vector sta_; std::vector sta_priorities_; std::vector scan_result_; WiFiAP selected_ap_; WiFiAP ap_; optional output_power_; ESPPreferenceObject pref_; ESPPreferenceObject fast_connect_pref_; // Group all 32-bit integers together uint32_t action_started_; uint32_t last_connected_{0}; uint32_t reboot_timeout_{}; uint32_t ap_timeout_{}; // Group all 8-bit values together WiFiComponentState state_{WIFI_COMPONENT_STATE_OFF}; WiFiPowerSaveMode power_save_{WIFI_POWER_SAVE_NONE}; uint8_t num_retried_{0}; uint8_t ap_index_{0}; #if USE_NETWORK_IPV6 uint8_t num_ipv6_addresses_{0}; #endif /* USE_NETWORK_IPV6 */ // Group all boolean values together bool fast_connect_{false}; bool trying_loaded_ap_{false}; bool retry_hidden_{false}; bool has_ap_{false}; bool handled_connected_state_{false}; bool error_from_callback_{false}; bool scan_done_{false}; bool ap_setup_{false}; bool passive_scan_{false}; bool has_saved_wifi_settings_{false}; #ifdef USE_WIFI_11KV_SUPPORT bool btm_{false}; bool rrm_{false}; #endif bool enable_on_boot_; bool got_ipv4_address_{false}; // Pointers at the end (naturally aligned) Trigger<> *connect_trigger_{new Trigger<>()}; Trigger<> *disconnect_trigger_{new Trigger<>()}; }; extern WiFiComponent *global_wifi_component; // NOLINT(cppcoreguidelines-avoid-non-const-global-variables) template class WiFiConnectedCondition : public Condition { public: bool check(Ts... x) override { return global_wifi_component->is_connected(); } }; template class WiFiEnabledCondition : public Condition { public: bool check(Ts... x) override { return !global_wifi_component->is_disabled(); } }; template class WiFiEnableAction : public Action { public: void play(Ts... x) override { global_wifi_component->enable(); } }; template class WiFiDisableAction : public Action { public: void play(Ts... x) override { global_wifi_component->disable(); } }; template class WiFiConfigureAction : public Action, public Component { public: TEMPLATABLE_VALUE(std::string, ssid) TEMPLATABLE_VALUE(std::string, password) TEMPLATABLE_VALUE(bool, save) TEMPLATABLE_VALUE(uint32_t, connection_timeout) void play(Ts... x) override { auto ssid = this->ssid_.value(x...); auto password = this->password_.value(x...); // Avoid multiple calls if (this->connecting_) return; // If already connected to the same AP, do nothing if (global_wifi_component->wifi_ssid() == ssid) { // Callback to notify the user that the connection was successful this->connect_trigger_->trigger(); return; } // Create a new WiFiAP object with the new SSID and password this->new_sta_.set_ssid(ssid); this->new_sta_.set_password(password); // Save the current STA this->old_sta_ = global_wifi_component->get_sta(); // Disable WiFi global_wifi_component->disable(); // Set the state to connecting this->connecting_ = true; // Store the new STA so once the WiFi is enabled, it will connect to it // This is necessary because the WiFiComponent will raise an error and fallback to the saved STA // if trying to connect to a new STA while already connected to another one if (this->save_.value(x...)) { global_wifi_component->save_wifi_sta(new_sta_.get_ssid(), new_sta_.get_password()); } else { global_wifi_component->set_sta(new_sta_); } // Enable WiFi global_wifi_component->enable(); // Set timeout for the connection this->set_timeout("wifi-connect-timeout", this->connection_timeout_.value(x...), [this, x...]() { // If the timeout is reached, stop connecting and revert to the old AP global_wifi_component->disable(); global_wifi_component->save_wifi_sta(old_sta_.get_ssid(), old_sta_.get_password()); global_wifi_component->enable(); // Start a timeout for the fallback if the connection to the old AP fails this->set_timeout("wifi-fallback-timeout", this->connection_timeout_.value(x...), [this]() { this->connecting_ = false; this->error_trigger_->trigger(); }); }); } Trigger<> *get_connect_trigger() const { return this->connect_trigger_; } Trigger<> *get_error_trigger() const { return this->error_trigger_; } void loop() override { if (!this->connecting_) return; if (global_wifi_component->is_connected()) { // The WiFi is connected, stop the timeout and reset the connecting flag this->cancel_timeout("wifi-connect-timeout"); this->cancel_timeout("wifi-fallback-timeout"); this->connecting_ = false; if (global_wifi_component->wifi_ssid() == this->new_sta_.get_ssid()) { // Callback to notify the user that the connection was successful this->connect_trigger_->trigger(); } else { // Callback to notify the user that the connection failed this->error_trigger_->trigger(); } } } protected: bool connecting_{false}; WiFiAP new_sta_; WiFiAP old_sta_; Trigger<> *connect_trigger_{new Trigger<>()}; Trigger<> *error_trigger_{new Trigger<>()}; }; } // namespace wifi } // namespace esphome #endif