|
ESPHome 2026.1.0-dev
|
#include <api_server.h>
Data Structures | |
| struct | ActiveActionCall |
| struct | HomeAssistantStateSubscription |
| struct | PendingActionResponse |
Public Types | |
| using | ActionResponseCallback = std::function<void(const class ActionResponse &)> |
Public Member Functions | |
| APIServer () | |
| void | setup () override |
| uint16_t | get_port () const |
| float | get_setup_priority () const override |
| void | loop () override |
| void | dump_config () override |
| void | on_shutdown () override |
| bool | teardown () override |
| void | on_log (uint8_t level, const char *tag, const char *message, size_t message_len) override |
| void | on_camera_image (const std::shared_ptr< camera::CameraImage > &image) override |
| bool | check_password (const uint8_t *password_data, size_t password_len) const |
| void | set_password (const std::string &password) |
| void | set_port (uint16_t port) |
| void | set_reboot_timeout (uint32_t reboot_timeout) |
| void | set_batch_delay (uint16_t batch_delay) |
| uint16_t | get_batch_delay () const |
| void | set_listen_backlog (uint8_t listen_backlog) |
| void | set_max_connections (uint8_t max_connections) |
| std::vector< uint8_t > & | get_shared_buffer_ref () |
| bool | save_noise_psk (psk_t psk, bool make_active=true) |
| bool | clear_noise_psk (bool make_active=true) |
| void | set_noise_psk (psk_t psk) |
| APINoiseContext & | get_noise_ctx () |
| void | handle_disconnect (APIConnection *conn) |
| void | on_binary_sensor_update (binary_sensor::BinarySensor *obj) override |
| void | on_cover_update (cover::Cover *obj) override |
| void | on_fan_update (fan::Fan *obj) override |
| void | on_light_update (light::LightState *obj) override |
| void | on_sensor_update (sensor::Sensor *obj) override |
| void | on_switch_update (switch_::Switch *obj) override |
| void | on_text_sensor_update (text_sensor::TextSensor *obj) override |
| void | on_climate_update (climate::Climate *obj) override |
| void | on_number_update (number::Number *obj) override |
| void | on_date_update (datetime::DateEntity *obj) override |
| void | on_time_update (datetime::TimeEntity *obj) override |
| void | on_datetime_update (datetime::DateTimeEntity *obj) override |
| void | on_text_update (text::Text *obj) override |
| void | on_select_update (select::Select *obj) override |
| void | on_lock_update (lock::Lock *obj) override |
| void | on_valve_update (valve::Valve *obj) override |
| void | on_media_player_update (media_player::MediaPlayer *obj) override |
| void | on_water_heater_update (water_heater::WaterHeater *obj) override |
| void | send_homeassistant_action (const HomeassistantActionRequest &call) |
| void | register_action_response_callback (uint32_t call_id, ActionResponseCallback callback) |
| void | handle_action_response (uint32_t call_id, bool success, const std::string &error_message) |
| void | handle_action_response (uint32_t call_id, bool success, const std::string &error_message, const uint8_t *response_data, size_t response_data_len) |
| void | initialize_user_services (std::initializer_list< UserServiceDescriptor * > services) |
| void | register_user_service (UserServiceDescriptor *descriptor) |
| uint32_t | register_active_action_call (uint32_t client_call_id, APIConnection *conn) |
| void | unregister_active_action_call (uint32_t action_call_id) |
| void | unregister_active_action_calls_for_connection (APIConnection *conn) |
| void | send_action_response (uint32_t action_call_id, bool success, const std::string &error_message) |
| void | send_action_response (uint32_t action_call_id, bool success, const std::string &error_message, const uint8_t *response_data, size_t response_data_len) |
| void | request_time () |
| void | on_alarm_control_panel_update (alarm_control_panel::AlarmControlPanel *obj) override |
| void | on_event (event::Event *obj) override |
| void | on_update (update::UpdateEntity *obj) override |
| void | on_zwave_proxy_request (const esphome::api::ProtoMessage &msg) |
| bool | is_connected (bool state_subscription_only=false) const |
| void | subscribe_home_assistant_state (const char *entity_id, const char *attribute, std::function< void(std::string)> f) |
| void | get_home_assistant_state (const char *entity_id, const char *attribute, std::function< void(std::string)> f) |
| void | subscribe_home_assistant_state (std::string entity_id, optional< std::string > attribute, std::function< void(std::string)> f) |
| void | get_home_assistant_state (std::string entity_id, optional< std::string > attribute, std::function< void(std::string)> f) |
| const std::vector< HomeAssistantStateSubscription > & | get_state_subs () const |
| const std::vector< UserServiceDescriptor * > & | get_user_services () const |
| Trigger< std::string, std::string > * | get_client_connected_trigger () const |
| Trigger< std::string, std::string > * | get_client_disconnected_trigger () const |
Public Member Functions inherited from esphome::Component | |
| float | get_actual_setup_priority () const |
| void | set_setup_priority (float priority) |
| virtual float | get_loop_priority () const |
| priority of loop(). | |
| void | call () |
| virtual void | on_safe_shutdown () |
| virtual void | on_powerdown () |
| Called after teardown is complete to power down hardware. | |
| uint8_t | get_component_state () const |
| void | reset_to_construction_state () |
| Reset this component back to the construction state to allow setup to run again. | |
| bool | is_in_loop_state () const |
| Check if this component has completed setup and is in the loop state. | |
| bool | is_idle () const |
| Check if this component is idle. | |
| virtual void | mark_failed () |
| Mark this component as failed. | |
| ESPDEPRECATED ("Use mark_failed(LOG_STR(\"static string literal\")) instead. Do NOT use .c_str() from temporary " "strings. Will stop working in 2026.6.0", "2025.12.0") void mark_failed(const char *message) | |
| void | mark_failed (const LogString *message) |
| void | disable_loop () |
| Disable this component's loop. | |
| void | enable_loop () |
| Enable this component's loop. | |
| void | enable_loop_soon_any_context () |
| Thread and ISR-safe version of enable_loop() that can be called from any context. | |
| bool | is_failed () const |
| bool | is_ready () const |
| virtual bool | can_proceed () |
| bool | status_has_warning () const |
| bool | status_has_error () const |
| void | status_set_warning (const char *message=nullptr) |
| void | status_set_warning (const LogString *message) |
| void | status_set_error () |
| ESPDEPRECATED ("Use status_set_error(LOG_STR(\"static string literal\")) instead. Do NOT use .c_str() from temporary " "strings. Will stop working in 2026.6.0", "2025.12.0") void status_set_error(const char *message) | |
| void | status_set_error (const LogString *message) |
| void | status_clear_warning () |
| void | status_clear_error () |
| void | status_momentary_warning (const char *name, uint32_t length=5000) |
| Set warning status flag and automatically clear it after a timeout. | |
| void | status_momentary_error (const char *name, uint32_t length=5000) |
| Set error status flag and automatically clear it after a timeout. | |
| bool | has_overridden_loop () const |
| void | set_component_source (const LogString *source) |
| Set where this component was loaded from for some debug messages. | |
| const LogString * | get_component_log_str () const |
| Get the integration where this component was declared as a LogString for logging. | |
| bool | should_warn_of_blocking (uint32_t blocking_time) |
Public Member Functions inherited from esphome::Controller | |
Public Member Functions inherited from esphome::logger::LogListener | |
Public Member Functions inherited from esphome::camera::CameraListener | |
| virtual void | on_stream_start () |
| virtual void | on_stream_stop () |
Protected Member Functions | |
| bool | update_noise_psk_ (const SavedNoisePsk &new_psk, const LogString *save_log_msg, const LogString *fail_log_msg, const psk_t &active_psk, bool make_active) |
| void | add_state_subscription_ (const char *entity_id, const char *attribute, std::function< void(std::string)> f, bool once) |
| void | add_state_subscription_ (std::string entity_id, optional< std::string > attribute, std::function< void(std::string)> f, bool once) |
Protected Member Functions inherited from esphome::Component | |
| virtual void | call_loop () |
| virtual void | call_setup () |
| virtual void | call_dump_config () |
| void | set_component_state_ (uint8_t state) |
| Helper to set component state (clears state bits and sets new state) | |
| void | set_interval (const std::string &name, uint32_t interval, std::function< void()> &&f) |
| Set an interval function with a unique name. | |
| void | set_interval (const char *name, uint32_t interval, std::function< void()> &&f) |
| Set an interval function with a const char* name. | |
| void | set_interval (uint32_t interval, std::function< void()> &&f) |
| bool | cancel_interval (const std::string &name) |
| Cancel an interval function. | |
| bool | cancel_interval (const char *name) |
| 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. | |
| void | set_retry (const char *name, uint32_t initial_wait_time, uint8_t max_attempts, std::function< RetryResult(uint8_t)> &&f, float backoff_increase_factor=1.0f) |
| 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. | |
| bool | cancel_retry (const char *name) |
| void | set_timeout (const std::string &name, uint32_t timeout, std::function< void()> &&f) |
| Set a timeout function with a unique name. | |
| void | set_timeout (const char *name, uint32_t timeout, std::function< void()> &&f) |
| Set a timeout function with a const char* name. | |
| void | set_timeout (uint32_t timeout, std::function< void()> &&f) |
| bool | cancel_timeout (const std::string &name) |
| Cancel a timeout function. | |
| bool | cancel_timeout (const char *name) |
| void | defer (const std::string &name, std::function< void()> &&f) |
| Defer a callback to the next loop() call. | |
| void | defer (const char *name, std::function< void()> &&f) |
| Defer a callback to the next loop() call with a const char* name. | |
| void | defer (std::function< void()> &&f) |
| Defer a callback to the next loop() call. | |
| bool | cancel_defer (const std::string &name) |
| Cancel a defer callback using the specified name, name must not be empty. | |
Protected Attributes | |
| std::unique_ptr< socket::Socket > | socket_ = nullptr |
| Trigger< std::string, std::string > * | client_connected_trigger_ = new Trigger<std::string, std::string>() |
| Trigger< std::string, std::string > * | client_disconnected_trigger_ = new Trigger<std::string, std::string>() |
| uint32_t | reboot_timeout_ {300000} |
| uint32_t | last_connected_ {0} |
| std::vector< std::unique_ptr< APIConnection > > | clients_ |
| std::string | password_ |
| std::vector< uint8_t > | shared_write_buffer_ |
| std::vector< HomeAssistantStateSubscription > | state_subs_ |
| std::vector< UserServiceDescriptor * > | user_services_ |
| std::vector< ActiveActionCall > | active_action_calls_ |
| uint32_t | next_action_call_id_ {1} |
| std::vector< PendingActionResponse > | action_response_callbacks_ |
| uint16_t | port_ {6053} |
| uint16_t | batch_delay_ {100} |
| uint8_t | listen_backlog_ {4} |
| uint8_t | max_connections_ {8} |
| bool | shutting_down_ = false |
| APINoiseContext | noise_ctx_ |
| ESPPreferenceObject | noise_pref_ |
Protected Attributes inherited from esphome::Component | |
| const LogString * | component_source_ {nullptr} |
| uint16_t | warn_if_blocking_over_ {WARN_IF_BLOCKING_OVER_MS} |
| Warn if blocked for this many ms (max 65.5s) | |
| uint8_t | component_state_ {0x00} |
| State of this component - each bit has a purpose: Bits 0-2: Component state (0x00=CONSTRUCTION, 0x01=SETUP, 0x02=LOOP, 0x03=FAILED, 0x04=LOOP_DONE) Bit 3: STATUS_LED_WARNING Bit 4: STATUS_LED_ERROR Bits 5-7: Unused - reserved for future expansion. | |
| volatile bool | pending_enable_loop_ {false} |
| ISR-safe flag for enable_loop_soon_any_context. | |
Definition at line 37 of file api_server.h.
| using esphome::api::APIServer::ActionResponseCallback = std::function<void(const class ActionResponse &)> |
Definition at line 144 of file api_server.h.
| esphome::api::APIServer::APIServer | ( | ) |
Definition at line 31 of file api_server.cpp.
|
protected |
Definition at line 427 of file api_server.cpp.
|
protected |
Definition at line 436 of file api_server.cpp.
| bool esphome::api::APIServer::check_password | ( | const uint8_t * | password_data, |
| size_t | password_len ) const |
Definition at line 228 of file api_server.cpp.
| bool esphome::api::APIServer::clear_noise_psk | ( | bool | make_active = true | ) |
Definition at line 530 of file api_server.cpp.
|
overridevirtual |
Reimplemented from esphome::Component.
Definition at line 210 of file api_server.cpp.
|
inline |
Definition at line 70 of file api_server.h.
|
inline |
Definition at line 224 of file api_server.h.
|
inline |
Definition at line 227 of file api_server.h.
| void esphome::api::APIServer::get_home_assistant_state | ( | const char * | entity_id, |
| const char * | attribute, | ||
| std::function< void(std::string)> | f ) |
Definition at line 461 of file api_server.cpp.
| void esphome::api::APIServer::get_home_assistant_state | ( | std::string | entity_id, |
| optional< std::string > | attribute, | ||
| std::function< void(std::string)> | f ) |
Definition at line 472 of file api_server.cpp.
|
inline |
Definition at line 81 of file api_server.h.
| uint16_t esphome::api::APIServer::get_port | ( | ) | const |
Definition at line 482 of file api_server.cpp.
|
overridevirtual |
Reimplemented from esphome::Component.
|
inline |
Definition at line 75 of file api_server.h.
| const std::vector< APIServer::HomeAssistantStateSubscription > & esphome::api::APIServer::get_state_subs | ( | ) | const |
Definition at line 477 of file api_server.cpp.
|
inline |
Definition at line 220 of file api_server.h.
| void esphome::api::APIServer::handle_action_response | ( | uint32_t | call_id, |
| bool | success, | ||
| const std::string & | error_message ) |
Definition at line 397 of file api_server.cpp.
| void esphome::api::APIServer::handle_action_response | ( | uint32_t | call_id, |
| bool | success, | ||
| const std::string & | error_message, | ||
| const uint8_t * | response_data, | ||
| size_t | response_data_len ) |
Definition at line 409 of file api_server.cpp.
| void esphome::api::APIServer::handle_disconnect | ( | APIConnection * | conn | ) |
Definition at line 259 of file api_server.cpp.
|
inline |
Definition at line 154 of file api_server.h.
| bool esphome::api::APIServer::is_connected | ( | bool | state_subscription_only = false | ) | const |
Definition at line 554 of file api_server.cpp.
|
overridevirtual |
Reimplemented from esphome::Component.
Definition at line 117 of file api_server.cpp.
|
overridevirtual |
Reimplemented from esphome::Controller.
|
overridevirtual |
Reimplemented from esphome::Controller.
|
overridevirtual |
Reimplemented from esphome::camera::CameraListener.
Definition at line 583 of file api_server.cpp.
|
overridevirtual |
Reimplemented from esphome::Controller.
|
overridevirtual |
Reimplemented from esphome::Controller.
|
overridevirtual |
Reimplemented from esphome::Controller.
|
overridevirtual |
Reimplemented from esphome::Controller.
|
overridevirtual |
Reimplemented from esphome::Controller.
|
overridevirtual |
Reimplemented from esphome::Controller.
|
overridevirtual |
Reimplemented from esphome::Controller.
|
overridevirtual |
Reimplemented from esphome::Controller.
|
overridevirtual |
Implements esphome::logger::LogListener.
Definition at line 568 of file api_server.cpp.
|
overridevirtual |
Reimplemented from esphome::Controller.
|
overridevirtual |
Reimplemented from esphome::Controller.
|
overridevirtual |
Reimplemented from esphome::Controller.
|
overridevirtual |
Reimplemented from esphome::Controller.
|
overridevirtual |
Reimplemented from esphome::Component.
Definition at line 591 of file api_server.cpp.
|
overridevirtual |
Reimplemented from esphome::Controller.
|
overridevirtual |
Reimplemented from esphome::Controller.
|
overridevirtual |
Reimplemented from esphome::Controller.
|
overridevirtual |
Reimplemented from esphome::Controller.
|
overridevirtual |
Reimplemented from esphome::Controller.
Definition at line 355 of file api_server.cpp.
|
overridevirtual |
Reimplemented from esphome::Controller.
|
overridevirtual |
Reimplemented from esphome::Controller.
| void esphome::api::APIServer::on_zwave_proxy_request | ( | const esphome::api::ProtoMessage & | msg | ) |
Definition at line 364 of file api_server.cpp.
| void esphome::api::APIServer::register_action_response_callback | ( | uint32_t | call_id, |
| ActionResponseCallback | callback ) |
Definition at line 393 of file api_server.cpp.
| uint32_t esphome::api::APIServer::register_active_action_call | ( | uint32_t | client_call_id, |
| APIConnection * | conn ) |
Definition at line 633 of file api_server.cpp.
|
inline |
Definition at line 159 of file api_server.h.
| void esphome::api::APIServer::request_time | ( | ) |
Definition at line 546 of file api_server.cpp.
| bool esphome::api::APIServer::save_noise_psk | ( | psk_t | psk, |
| bool | make_active = true ) |
Definition at line 512 of file api_server.cpp.
| void esphome::api::APIServer::send_action_response | ( | uint32_t | action_call_id, |
| bool | success, | ||
| const std::string & | error_message ) |
Definition at line 681 of file api_server.cpp.
| void esphome::api::APIServer::send_action_response | ( | uint32_t | action_call_id, |
| bool | success, | ||
| const std::string & | error_message, | ||
| const uint8_t * | response_data, | ||
| size_t | response_data_len ) |
Definition at line 691 of file api_server.cpp.
| void esphome::api::APIServer::send_homeassistant_action | ( | const HomeassistantActionRequest & | call | ) |
Definition at line 387 of file api_server.cpp.
| void esphome::api::APIServer::set_batch_delay | ( | uint16_t | batch_delay | ) |
Definition at line 384 of file api_server.cpp.
|
inline |
Definition at line 71 of file api_server.h.
|
inline |
Definition at line 72 of file api_server.h.
|
inline |
Definition at line 80 of file api_server.h.
| void esphome::api::APIServer::set_password | ( | const std::string & | password | ) |
Definition at line 381 of file api_server.cpp.
| void esphome::api::APIServer::set_port | ( | uint16_t | port | ) |
| void esphome::api::APIServer::set_reboot_timeout | ( | uint32_t | reboot_timeout | ) |
Definition at line 484 of file api_server.cpp.
|
overridevirtual |
Reimplemented from esphome::Component.
Definition at line 37 of file api_server.cpp.
| void esphome::api::APIServer::subscribe_home_assistant_state | ( | const char * | entity_id, |
| const char * | attribute, | ||
| std::function< void(std::string)> | f ) |
Definition at line 456 of file api_server.cpp.
| void esphome::api::APIServer::subscribe_home_assistant_state | ( | std::string | entity_id, |
| optional< std::string > | attribute, | ||
| std::function< void(std::string)> | f ) |
Definition at line 467 of file api_server.cpp.
|
overridevirtual |
Reimplemented from esphome::Component.
Definition at line 615 of file api_server.cpp.
| void esphome::api::APIServer::unregister_active_action_call | ( | uint32_t | action_call_id | ) |
Definition at line 651 of file api_server.cpp.
| void esphome::api::APIServer::unregister_active_action_calls_for_connection | ( | APIConnection * | conn | ) |
Definition at line 665 of file api_server.cpp.
|
protected |
Definition at line 487 of file api_server.cpp.
|
protected |
Definition at line 285 of file api_server.h.
|
protected |
Definition at line 276 of file api_server.h.
|
protected |
Definition at line 290 of file api_server.h.
|
protected |
Definition at line 247 of file api_server.h.
|
protected |
Definition at line 250 of file api_server.h.
|
protected |
Definition at line 258 of file api_server.h.
|
protected |
Definition at line 255 of file api_server.h.
|
protected |
Definition at line 293 of file api_server.h.
|
protected |
Definition at line 294 of file api_server.h.
|
protected |
Definition at line 277 of file api_server.h.
|
protected |
Definition at line 299 of file api_server.h.
|
protected |
Definition at line 300 of file api_server.h.
|
protected |
Definition at line 260 of file api_server.h.
|
protected |
Definition at line 289 of file api_server.h.
|
protected |
Definition at line 254 of file api_server.h.
|
protected |
Definition at line 262 of file api_server.h.
|
protected |
Definition at line 295 of file api_server.h.
|
protected |
Definition at line 245 of file api_server.h.
|
protected |
Definition at line 264 of file api_server.h.
|
protected |
Definition at line 267 of file api_server.h.