ESPHome
2023.5.5
|
This component is responsible for managing the ESP WiFi interface. More...
#include <wifi_component.h>
Public Member Functions | |
WiFiComponent () | |
Construct a WiFiComponent. More... | |
void | set_sta (const WiFiAP &ap) |
void | add_sta (const WiFiAP &ap) |
void | clear_sta () |
void | set_ap (const WiFiAP &ap) |
Setup an Access Point that should be created if no connection to a station can be made. More... | |
WiFiAP | get_ap () |
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) |
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) |
void | set_passive_scan (bool passive) |
void | save_wifi_sta (const std::string &ssid, const std::string &password) |
void | setup () override |
Setup WiFi interface. More... | |
void | dump_config () override |
float | get_setup_priority () const override |
WIFI setup_priority. More... | |
float | get_loop_priority () const override |
void | loop () override |
Reconnect WiFi if required. More... | |
bool | has_sta () const |
bool | has_ap () const |
void | set_btm (bool btm) |
void | set_rrm (bool rrm) |
network::IPAddress | get_ip_address () |
std::string | get_use_address () const |
void | set_use_address (const std::string &use_address) |
const std::vector< WiFiScanResult > & | get_scan_result () const |
network::IPAddress | wifi_soft_ap_ip () |
bool | has_sta_priority (const bssid_t &bssid) |
float | get_sta_priority (const bssid_t bssid) |
void | set_sta_priority (const bssid_t bssid, float priority) |
network::IPAddress | wifi_sta_ip () |
std::string | wifi_ssid () |
bssid_t | wifi_bssid () |
int8_t | wifi_rssi () |
![]() | |
float | get_actual_setup_priority () const |
void | set_setup_priority (float priority) |
void | call () |
virtual void | on_shutdown () |
virtual void | on_safe_shutdown () |
uint32_t | get_component_state () const |
virtual void | mark_failed () |
Mark this component as failed. More... | |
bool | is_failed () |
bool | is_ready () |
bool | status_has_warning () |
bool | status_has_error () |
void | status_set_warning () |
void | status_set_error () |
void | status_clear_warning () |
void | status_clear_error () |
void | status_momentary_warning (const std::string &name, uint32_t length=5000) |
void | status_momentary_error (const std::string &name, uint32_t length=5000) |
bool | has_overridden_loop () const |
void | set_component_source (const char *source) |
Set where this component was loaded from for some debug messages. More... | |
const char * | get_component_source () const |
Get the integration where this component was declared as a string. More... | |
Protected Member Functions | |
void | setup_ap_config_ () |
void | print_connect_params_ () |
void | wifi_loop_ () |
bool | wifi_mode_ (optional< bool > sta, optional< bool > 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< ManualIP > 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) |
bool | wifi_ap_ip_config_ (optional< ManualIP > manual_ip) |
bool | wifi_start_ap_ (const WiFiAP &ap) |
bool | wifi_disconnect_ () |
int32_t | wifi_channel_ () |
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_ () |
void | wifi_scan_done_callback_ (void *arg, STATUS status) |
void | wifi_event_callback_ (arduino_event_id_t event, arduino_event_info_t info) |
void | wifi_event_callback_ (system_event_id_t event, system_event_info_t info) |
void | wifi_scan_done_callback_ () |
void | wifi_process_event_ (IDFWiFiEvent *data) |
void | wifi_scan_result (void *env, const cyw43_ev_scan_result_t *result) |
![]() | |
virtual void | call_loop () |
virtual void | call_setup () |
virtual void | call_dump_config () |
void | set_interval (const std::string &name, uint32_t interval, std::function< void()> &&f) |
Set an interval function with a unique name. More... | |
void | set_interval (uint32_t interval, std::function< void()> &&f) |
bool | cancel_interval (const std::string &name) |
Cancel an interval function. More... | |
void | set_retry (const std::string &name, uint32_t initial_wait_time, uint8_t max_attempts, std::function< RetryResult(uint8_t)> &&f, float backoff_increase_factor=1.0f) |
Set an retry function with a unique name. More... | |
void | set_retry (uint32_t initial_wait_time, uint8_t max_attempts, std::function< RetryResult(uint8_t)> &&f, float backoff_increase_factor=1.0f) |
bool | cancel_retry (const std::string &name) |
Cancel a retry function. More... | |
void | set_timeout (const std::string &name, uint32_t timeout, std::function< void()> &&f) |
Set a timeout function with a unique name. More... | |
void | set_timeout (uint32_t timeout, std::function< void()> &&f) |
bool | cancel_timeout (const std::string &name) |
Cancel a timeout function. More... | |
void | defer (const std::string &name, std::function< void()> &&f) |
Defer a callback to the next loop() call. More... | |
void | defer (std::function< void()> &&f) |
Defer a callback to the next loop() call. More... | |
bool | cancel_defer (const std::string &name) |
Cancel a defer callback using the specified name, name must not be empty. More... | |
Static Protected Member Functions | |
static std::string | format_mac_addr (const uint8_t mac[6]) |
static void | wifi_event_callback (System_Event_t *event) |
static void | s_wifi_scan_done_callback (void *arg, STATUS status) |
static int | s_wifi_scan_result (void *env, const cyw43_ev_scan_result_t *result) |
Protected Attributes | |
std::string | use_address_ |
std::vector< WiFiAP > | sta_ |
std::vector< WiFiSTAPriority > | sta_priorities_ |
WiFiAP | selected_ap_ |
bool | fast_connect_ {false} |
bool | has_ap_ {false} |
WiFiAP | ap_ |
WiFiComponentState | state_ {WIFI_COMPONENT_STATE_OFF} |
uint32_t | action_started_ |
uint8_t | num_retried_ {0} |
uint32_t | last_connected_ {0} |
uint32_t | reboot_timeout_ {} |
uint32_t | ap_timeout_ {} |
WiFiPowerSaveMode | power_save_ {WIFI_POWER_SAVE_NONE} |
bool | error_from_callback_ {false} |
std::vector< WiFiScanResult > | scan_result_ |
bool | scan_done_ {false} |
bool | ap_setup_ {false} |
optional< float > | output_power_ |
bool | passive_scan_ {false} |
ESPPreferenceObject | pref_ |
bool | has_saved_wifi_settings_ {false} |
bool | btm_ {false} |
bool | rrm_ {false} |
![]() | |
uint32_t | component_state_ {0x0000} |
State of this component. More... | |
float | setup_priority_override_ {NAN} |
const char * | component_source_ {nullptr} |
This component is responsible for managing the ESP WiFi interface.
Definition at line 182 of file wifi_component.h.
esphome::wifi::WiFiComponent::WiFiComponent | ( | ) |
Construct a WiFiComponent.
Definition at line 170 of file wifi_component.cpp.
void esphome::wifi::WiFiComponent::add_sta | ( | const WiFiAP & | ap | ) |
Definition at line 237 of file wifi_component.cpp.
|
overridevirtual |
Reimplemented from esphome::Component.
Definition at line 605 of file wifi_component.cpp.
void esphome::wifi::WiFiComponent::check_connecting_finished | ( | ) |
Definition at line 509 of file wifi_component.cpp.
void esphome::wifi::WiFiComponent::check_scanning_finished | ( | ) |
Definition at line 392 of file wifi_component.cpp.
void esphome::wifi::WiFiComponent::clear_sta | ( | ) |
Definition at line 242 of file wifi_component.cpp.
|
overridevirtual |
Reimplemented from esphome::Component.
Definition at line 504 of file wifi_component.cpp.
|
staticprotected |
Definition at line 620 of file wifi_component.cpp.
|
inline |
Definition at line 199 of file wifi_component.h.
network::IPAddress esphome::wifi::WiFiComponent::get_ip_address | ( | ) |
Definition at line 179 of file wifi_component.cpp.
|
overridevirtual |
Reimplemented from esphome::Component.
Definition at line 230 of file wifi_component.cpp.
|
inline |
Definition at line 247 of file wifi_component.h.
|
overridevirtual |
WIFI setup_priority.
Reimplemented from esphome::Component.
Definition at line 35 of file wifi_component.cpp.
|
inline |
Definition at line 258 of file wifi_component.h.
std::string esphome::wifi::WiFiComponent::get_use_address | ( | ) | const |
Definition at line 186 of file wifi_component.cpp.
bool esphome::wifi::WiFiComponent::has_ap | ( | ) | const |
Definition at line 172 of file wifi_component.cpp.
bool esphome::wifi::WiFiComponent::has_sta | ( | ) | const |
Definition at line 173 of file wifi_component.cpp.
|
inline |
Definition at line 251 of file wifi_component.h.
|
protected |
Definition at line 625 of file wifi_component.cpp.
bool esphome::wifi::WiFiComponent::is_connected | ( | ) |
Definition at line 612 of file wifi_component.cpp.
|
protected |
Definition at line 632 of file wifi_component.cpp.
|
overridevirtual |
Reconnect WiFi if required.
Reimplemented from esphome::Component.
Definition at line 95 of file wifi_component.cpp.
|
protected |
Definition at line 360 of file wifi_component.cpp.
void esphome::wifi::WiFiComponent::retry_connect | ( | ) |
Definition at line 575 of file wifi_component.cpp.
|
staticprotected |
Definition at line 656 of file wifi_component_esp8266.cpp.
|
staticprotected |
Definition at line 113 of file wifi_component_pico_w.cpp.
void esphome::wifi::WiFiComponent::save_wifi_sta | ( | const std::string & | ssid, |
const std::string & | password | ||
) |
Definition at line 243 of file wifi_component.cpp.
void esphome::wifi::WiFiComponent::set_ap | ( | const WiFiAP & | 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.
Definition at line 233 of file wifi_component.cpp.
|
inline |
Definition at line 205 of file wifi_component.h.
void esphome::wifi::WiFiComponent::set_btm | ( | bool | btm | ) |
Definition at line 176 of file wifi_component.cpp.
void esphome::wifi::WiFiComponent::set_fast_connect | ( | bool | fast_connect | ) |
Definition at line 174 of file wifi_component.cpp.
|
inline |
Definition at line 218 of file wifi_component.h.
void esphome::wifi::WiFiComponent::set_passive_scan | ( | bool | passive | ) |
Definition at line 618 of file wifi_component.cpp.
void esphome::wifi::WiFiComponent::set_power_save_mode | ( | WiFiPowerSaveMode | power_save | ) |
Definition at line 616 of file wifi_component.cpp.
void esphome::wifi::WiFiComponent::set_reboot_timeout | ( | uint32_t | reboot_timeout | ) |
Definition at line 611 of file wifi_component.cpp.
void esphome::wifi::WiFiComponent::set_rrm | ( | bool | rrm | ) |
Definition at line 177 of file wifi_component.cpp.
void esphome::wifi::WiFiComponent::set_sta | ( | const WiFiAP & | ap | ) |
Definition at line 238 of file wifi_component.cpp.
|
inline |
Definition at line 265 of file wifi_component.h.
void esphome::wifi::WiFiComponent::set_use_address | ( | const std::string & | use_address | ) |
Definition at line 192 of file wifi_component.cpp.
|
overridevirtual |
Setup WiFi interface.
Reimplemented from esphome::Component.
Definition at line 37 of file wifi_component.cpp.
|
protected |
Definition at line 193 of file wifi_component.cpp.
void esphome::wifi::WiFiComponent::start_connecting | ( | const WiFiAP & | ap, |
bool | two | ||
) |
Definition at line 257 of file wifi_component.cpp.
void esphome::wifi::WiFiComponent::start_scanning | ( | ) |
Definition at line 385 of file wifi_component.cpp.
Definition at line 657 of file wifi_component_esp32_arduino.cpp.
|
protected |
Definition at line 162 of file wifi_component_esp32_arduino.cpp.
|
protected |
Definition at line 62 of file wifi_component_esp32_arduino.cpp.
|
protected |
Definition at line 74 of file wifi_component_esp32_arduino.cpp.
bssid_t esphome::wifi::WiFiComponent::wifi_bssid | ( | ) |
Definition at line 762 of file wifi_component_esp32_arduino.cpp.
|
protected |
Definition at line 773 of file wifi_component_esp32_arduino.cpp.
|
protected |
Definition at line 760 of file wifi_component_esp32_arduino.cpp.
|
protected |
Definition at line 776 of file wifi_component_esp32_arduino.cpp.
|
staticprotected |
Definition at line 461 of file wifi_component_esp8266.cpp.
|
protected |
Definition at line 451 of file wifi_component_esp32_arduino.cpp.
|
protected |
|
protected |
Definition at line 775 of file wifi_component_esp32_arduino.cpp.
|
protected |
Definition at line 777 of file wifi_component_esp32_arduino.cpp.
|
protected |
Definition at line 29 of file wifi_component_esp32_arduino.cpp.
|
protected |
Definition at line 601 of file wifi_component_esp32_arduino.cpp.
|
protected |
Definition at line 586 of file wifi_component_esp_idf.cpp.
int8_t esphome::wifi::WiFiComponent::wifi_rssi | ( | ) |
Definition at line 772 of file wifi_component_esp32_arduino.cpp.
|
protected |
Definition at line 660 of file wifi_component_esp8266.cpp.
|
protected |
Definition at line 635 of file wifi_component_esp32_arduino.cpp.
|
protected |
Definition at line 118 of file wifi_component_pico_w.cpp.
|
protected |
Definition at line 621 of file wifi_component_esp32_arduino.cpp.
network::IPAddress esphome::wifi::WiFiComponent::wifi_soft_ap_ip | ( | ) |
Definition at line 755 of file wifi_component_esp32_arduino.cpp.
std::string esphome::wifi::WiFiComponent::wifi_ssid | ( | ) |
Definition at line 771 of file wifi_component_esp32_arduino.cpp.
|
protected |
Definition at line 166 of file wifi_component_esp32_arduino.cpp.
|
protected |
Definition at line 608 of file wifi_component_esp32_arduino.cpp.
network::IPAddress esphome::wifi::WiFiComponent::wifi_sta_ip | ( | ) |
Definition at line 154 of file wifi_component_esp32_arduino.cpp.
Definition at line 90 of file wifi_component_esp32_arduino.cpp.
|
protected |
Definition at line 66 of file wifi_component_esp32_arduino.cpp.
|
protected |
Definition at line 714 of file wifi_component_esp32_arduino.cpp.
|
protected |
Definition at line 774 of file wifi_component_esp32_arduino.cpp.
|
protected |
Definition at line 343 of file wifi_component.h.
|
protected |
Definition at line 341 of file wifi_component.h.
|
protected |
Definition at line 352 of file wifi_component.h.
|
protected |
Definition at line 347 of file wifi_component.h.
|
protected |
Definition at line 358 of file wifi_component.h.
|
protected |
Definition at line 349 of file wifi_component.h.
|
protected |
Definition at line 338 of file wifi_component.h.
|
protected |
Definition at line 340 of file wifi_component.h.
|
protected |
Definition at line 356 of file wifi_component.h.
|
protected |
Definition at line 345 of file wifi_component.h.
|
protected |
Definition at line 344 of file wifi_component.h.
|
protected |
Definition at line 353 of file wifi_component.h.
|
protected |
Definition at line 354 of file wifi_component.h.
|
protected |
Definition at line 348 of file wifi_component.h.
|
protected |
Definition at line 355 of file wifi_component.h.
|
protected |
Definition at line 346 of file wifi_component.h.
|
protected |
Definition at line 359 of file wifi_component.h.
|
protected |
Definition at line 351 of file wifi_component.h.
|
protected |
Definition at line 350 of file wifi_component.h.
|
protected |
Definition at line 337 of file wifi_component.h.
|
protected |
Definition at line 335 of file wifi_component.h.
|
protected |
Definition at line 336 of file wifi_component.h.
|
protected |
Definition at line 342 of file wifi_component.h.
|
protected |
Definition at line 334 of file wifi_component.h.