|
ESPHome 2026.8.0-dev
|
#include <api_server.h>
Data Structures | |
| struct | ActiveActionCall |
| class | ActiveClientsView |
| struct | HomeAssistantStateSubscription |
| struct | PendingActionResponse |
Public Types | |
| using | ActionResponseCallback = std::function<void(const class ActionResponse &)> |
| using | APIConnectionPtr = std::unique_ptr<APIConnection> |
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) |
| void | on_camera_image (const std::shared_ptr< camera::CameraImage > &image) override |
| 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) |
| APIBuffer & | 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, StringRef error_message) |
| void | handle_action_response (uint32_t call_id, bool success, StringRef 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, StringRef error_message) |
| void | send_action_response (uint32_t action_call_id, bool success, StringRef 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 ZWaveProxyRequest &msg) |
| void | send_infrared_rf_receive_event (uint32_t device_id, uint32_t key, const std::vector< int32_t > *timings) |
| bool | is_connected () const |
| bool | is_connected_with_state_subscription () const |
| ActiveClientsView | active_clients () const |
| void | subscribe_home_assistant_state (const char *entity_id, const char *attribute, std::function< void(StringRef)> &&f) |
| void | get_home_assistant_state (const char *entity_id, const char *attribute, std::function< void(StringRef)> &&f) |
| void | subscribe_home_assistant_state (std::string entity_id, optional< std::string > attribute, std::function< void(StringRef)> &&f) |
| void | get_home_assistant_state (std::string entity_id, optional< std::string > attribute, std::function< void(StringRef)> &&f) |
| void | subscribe_home_assistant_state (std::string entity_id, optional< std::string > attribute, std::function< void(const std::string &)> &&f) |
| void | get_home_assistant_state (std::string entity_id, optional< std::string > attribute, std::function< void(const 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 () |
| Trigger< std::string, std::string > * | get_client_disconnected_trigger () |
Public Member Functions inherited from esphome::Component | |
| float | get_actual_setup_priority () const |
| void | set_setup_priority (float priority) |
| 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. | |
| void | mark_failed () |
| Mark this component as failed. | |
| 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 () |
| void | status_set_warning (const char *message) |
| void | status_set_warning (const LogString *message) |
| void | status_set_error () |
| 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 |
| const LogString * | get_component_log_str () const ESPHOME_ALWAYS_INLINE |
| Get the integration where this component was declared as a LogString for logging. | |
| bool | should_warn_of_blocking (uint32_t blocking_time, uint32_t &threshold_ms_out) |
Public Member Functions inherited from esphome::camera::CameraListener | |
| virtual void | on_stream_start () |
| virtual void | on_stream_stop () |
Protected Member Functions | |
| void | __attribute__ ((noinline)) accept_new_connections_() |
| void | __attribute__ ((noinline)) remove_client_(uint8_t client_index) |
| bool | provisioning_pending_ () const |
| bool | provisioning_pending_ () const |
| bool | update_noise_psk_ (const SavedNoisePsk &new_psk, const LogString *save_log_msg, const LogString *fail_log_msg, bool make_active) |
| bool | load_and_apply_noise_psk_ () |
| void | add_state_subscription_ (const char *entity_id, const char *attribute, std::function< void(StringRef)> &&f, bool once) |
| void | add_state_subscription_ (std::string entity_id, optional< std::string > attribute, std::function< void(StringRef)> &&f, bool once) |
| void | add_state_subscription_ (std::string entity_id, optional< std::string > attribute, std::function< void(const std::string &)> &&f, bool once) |
| void | destroy_socket_ () |
| void | socket_failed_ (const LogString *msg) |
Protected Member Functions inherited from esphome::Component | |
| friend | void::setup () |
| friend | void::original_setup () |
| void | set_component_source_ (uint8_t index) |
| Set where this component was loaded from for some debug messages. | |
| virtual void | call_setup () |
| void | call_dump_config_ () |
| void | enable_loop_slow_path_ () |
| void | set_component_state_ (uint8_t state) |
| Helper to set component state (clears state bits and sets new state) | |
| bool | set_status_flag_ (uint8_t flag) |
| Helper to set a status LED flag on both this component and the app. | |
| 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 id, uint32_t interval, std::function< void()> &&f) |
| Set an interval function with a numeric ID (zero heap allocation). | |
| void | set_interval (InternalSchedulerID id, uint32_t interval, std::function< void()> &&f) |
| void | set_interval (uint32_t interval, std::function< void()> &&f) |
| bool | cancel_interval (const char *name) |
| Cancel an interval function. | |
| bool | cancel_interval (uint32_t id) |
| bool | cancel_interval (InternalSchedulerID id) |
| 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 id, uint32_t timeout, std::function< void()> &&f) |
| Set a timeout function with a numeric ID (zero heap allocation). | |
| void | set_timeout (InternalSchedulerID id, uint32_t timeout, std::function< void()> &&f) |
| void | set_timeout (uint32_t timeout, std::function< void()> &&f) |
| bool | cancel_timeout (const char *name) |
| Cancel a timeout function. | |
| bool | cancel_timeout (uint32_t id) |
| bool | cancel_timeout (InternalSchedulerID id) |
| 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. | |
| void | defer (uint32_t id, std::function< void()> &&f) |
| Defer a callback with a numeric ID (zero heap allocation) | |
| bool | cancel_defer (const char *name) |
| Cancel a defer callback using the specified name, name must not be empty. | |
| bool | cancel_defer (uint32_t id) |
| void | status_clear_warning_slow_path_ () |
| void | status_clear_error_slow_path_ () |
Protected Attributes | |
| socket::ListenSocket * | socket_ {nullptr} |
| Trigger< std::string, std::string > | client_connected_trigger_ |
| Trigger< std::string, std::string > | client_disconnected_trigger_ |
| uint32_t | reboot_timeout_ {300000} |
| uint32_t | last_connected_ {0} |
| std::array< APIConnectionPtr, MAX_API_CONNECTIONS > | clients_ {} |
| APIBuffer | 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} |
| bool | shutting_down_ = false |
| uint8_t | api_connection_count_ {0} |
| uint8_t | provisioning_source_ {0} |
| APINoiseContext | noise_ctx_ |
| ESPPreferenceObject | noise_pref_ |
Protected Attributes inherited from esphome::Component | |
| uint8_t | component_source_index_ {0} |
| Index into component source PROGMEM lookup table (0 = not set) | |
| uint8_t | warn_if_blocking_over_ {WARN_IF_BLOCKING_OVER_CS} |
| Warn threshold in centiseconds (max 2550ms) | |
| 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 Bit 5: Has overridden loop() (set at registration time) Bits 6-7: Unused - reserved for future expansion. | |
| volatile bool | pending_enable_loop_ {false} |
| ISR-safe flag for enable_loop_soon_any_context. | |
| ComponentRuntimeStats | runtime_stats_ |
Definition at line 44 of file api_server.h.
| using esphome::api::APIServer::ActionResponseCallback = std::function<void(const class ActionResponse &)> |
Definition at line 142 of file api_server.h.
| using esphome::api::APIServer::APIConnectionPtr = std::unique_ptr<APIConnection> |
Definition at line 199 of file api_server.h.
| esphome::api::APIServer::APIServer | ( | ) |
Definition at line 32 of file api_server.cpp.
|
protected |
|
protected |
|
inline |
Definition at line 209 of file api_server.h.
|
protected |
Definition at line 476 of file api_server.cpp.
|
protected |
Definition at line 527 of file api_server.cpp.
|
protected |
Definition at line 485 of file api_server.cpp.
| bool esphome::api::APIServer::clear_noise_psk | ( | bool | make_active = true | ) |
Definition at line 620 of file api_server.cpp.
|
inlineprotected |
Definition at line 292 of file api_server.h.
|
overridevirtual |
Reimplemented from esphome::Component.
Definition at line 267 of file api_server.cpp.
|
inline |
Definition at line 69 of file api_server.h.
|
inline |
Definition at line 249 of file api_server.h.
|
inline |
Definition at line 252 of file api_server.h.
| void esphome::api::APIServer::get_home_assistant_state | ( | const char * | entity_id, |
| const char * | attribute, | ||
| std::function< void(StringRef)> && | f ) |
Definition at line 510 of file api_server.cpp.
| void esphome::api::APIServer::get_home_assistant_state | ( | std::string | entity_id, |
| optional< std::string > | attribute, | ||
| std::function< void(const std::string &)> && | f ) |
Definition at line 541 of file api_server.cpp.
| void esphome::api::APIServer::get_home_assistant_state | ( | std::string | entity_id, |
| optional< std::string > | attribute, | ||
| std::function< void(StringRef)> && | f ) |
Definition at line 521 of file api_server.cpp.
|
inline |
Definition at line 79 of file api_server.h.
| uint16_t esphome::api::APIServer::get_port | ( | ) | const |
Definition at line 551 of file api_server.cpp.
|
overridevirtual |
Reimplemented from esphome::Component.
|
inline |
Definition at line 73 of file api_server.h.
| const std::vector< APIServer::HomeAssistantStateSubscription > & esphome::api::APIServer::get_state_subs | ( | ) | const |
Definition at line 546 of file api_server.cpp.
|
inline |
Definition at line 245 of file api_server.h.
| void esphome::api::APIServer::handle_action_response | ( | uint32_t | call_id, |
| bool | success, | ||
| StringRef | error_message ) |
Definition at line 446 of file api_server.cpp.
| void esphome::api::APIServer::handle_action_response | ( | uint32_t | call_id, |
| bool | success, | ||
| StringRef | error_message, | ||
| const uint8_t * | response_data, | ||
| size_t | response_data_len ) |
Definition at line 458 of file api_server.cpp.
| void esphome::api::APIServer::handle_disconnect | ( | APIConnection * | conn | ) |
Definition at line 285 of file api_server.cpp.
|
inline |
Definition at line 152 of file api_server.h.
|
inline |
Definition at line 193 of file api_server.h.
| bool esphome::api::APIServer::is_connected_with_state_subscription | ( | ) | const |
Definition at line 653 of file api_server.cpp.
|
protected |
Definition at line 586 of file api_server.cpp.
|
overridevirtual |
Reimplemented from esphome::Component.
Definition at line 138 of file api_server.cpp.
|
override |
|
override |
|
overridevirtual |
Reimplemented from esphome::camera::CameraListener.
Definition at line 678 of file api_server.cpp.
|
override |
|
override |
|
override |
|
override |
|
override |
|
override |
|
override |
|
override |
| void esphome::api::APIServer::on_log | ( | uint8_t | level, |
| const char * | tag, | ||
| const char * | message, | ||
| size_t | message_len ) |
Definition at line 663 of file api_server.cpp.
|
override |
|
override |
|
override |
|
override |
|
overridevirtual |
Reimplemented from esphome::Component.
Definition at line 686 of file api_server.cpp.
|
override |
|
override |
|
override |
|
override |
|
override |
Definition at line 383 of file api_server.cpp.
|
override |
|
override |
| void esphome::api::APIServer::on_zwave_proxy_request | ( | const ZWaveProxyRequest & | msg | ) |
Definition at line 394 of file api_server.cpp.
|
inlineprotected |
Definition at line 266 of file api_server.h.
|
inlineprotected |
Definition at line 271 of file api_server.h.
| void esphome::api::APIServer::register_action_response_callback | ( | uint32_t | call_id, |
| ActionResponseCallback | callback ) |
Definition at line 442 of file api_server.cpp.
| uint32_t esphome::api::APIServer::register_active_action_call | ( | uint32_t | client_call_id, |
| APIConnection * | conn ) |
Definition at line 724 of file api_server.cpp.
|
inline |
Definition at line 157 of file api_server.h.
| void esphome::api::APIServer::request_time | ( | ) |
Definition at line 643 of file api_server.cpp.
| bool esphome::api::APIServer::save_noise_psk | ( | psk_t | psk, |
| bool | make_active = true ) |
Definition at line 594 of file api_server.cpp.
| void esphome::api::APIServer::send_action_response | ( | uint32_t | action_call_id, |
| bool | success, | ||
| StringRef | error_message ) |
Definition at line 772 of file api_server.cpp.
| void esphome::api::APIServer::send_action_response | ( | uint32_t | action_call_id, |
| bool | success, | ||
| StringRef | error_message, | ||
| const uint8_t * | response_data, | ||
| size_t | response_data_len ) |
Definition at line 782 of file api_server.cpp.
| void esphome::api::APIServer::send_homeassistant_action | ( | const HomeassistantActionRequest & | call | ) |
Definition at line 428 of file api_server.cpp.
| void esphome::api::APIServer::send_infrared_rf_receive_event | ( | uint32_t | device_id, |
| uint32_t | key, | ||
| const std::vector< int32_t > * | timings ) |
Definition at line 403 of file api_server.cpp.
| void esphome::api::APIServer::set_batch_delay | ( | uint16_t | batch_delay | ) |
Definition at line 425 of file api_server.cpp.
|
inline |
Definition at line 70 of file api_server.h.
|
inline |
Definition at line 78 of file api_server.h.
| void esphome::api::APIServer::set_port | ( | uint16_t | port | ) |
| void esphome::api::APIServer::set_reboot_timeout | ( | uint32_t | reboot_timeout | ) |
Definition at line 553 of file api_server.cpp.
|
overridevirtual |
Reimplemented from esphome::Component.
Definition at line 40 of file api_server.cpp.
|
protected |
Definition at line 34 of file api_server.cpp.
| void esphome::api::APIServer::subscribe_home_assistant_state | ( | const char * | entity_id, |
| const char * | attribute, | ||
| std::function< void(StringRef)> && | f ) |
Definition at line 505 of file api_server.cpp.
| void esphome::api::APIServer::subscribe_home_assistant_state | ( | std::string | entity_id, |
| optional< std::string > | attribute, | ||
| std::function< void(const std::string &)> && | f ) |
Definition at line 536 of file api_server.cpp.
| void esphome::api::APIServer::subscribe_home_assistant_state | ( | std::string | entity_id, |
| optional< std::string > | attribute, | ||
| std::function< void(StringRef)> && | f ) |
Definition at line 516 of file api_server.cpp.
|
overridevirtual |
Reimplemented from esphome::Component.
Definition at line 706 of file api_server.cpp.
| void esphome::api::APIServer::unregister_active_action_call | ( | uint32_t | action_call_id | ) |
Definition at line 742 of file api_server.cpp.
| void esphome::api::APIServer::unregister_active_action_calls_for_connection | ( | APIConnection * | conn | ) |
Definition at line 756 of file api_server.cpp.
|
protected |
Definition at line 556 of file api_server.cpp.
|
protected |
Definition at line 340 of file api_server.h.
|
protected |
Definition at line 331 of file api_server.h.
|
protected |
Definition at line 350 of file api_server.h.
|
protected |
Definition at line 345 of file api_server.h.
|
protected |
Definition at line 300 of file api_server.h.
|
protected |
Definition at line 303 of file api_server.h.
|
protected |
Definition at line 311 of file api_server.h.
|
protected |
Definition at line 308 of file api_server.h.
|
protected |
Definition at line 348 of file api_server.h.
|
protected |
Definition at line 332 of file api_server.h.
|
protected |
Definition at line 357 of file api_server.h.
|
protected |
Definition at line 358 of file api_server.h.
|
protected |
Definition at line 344 of file api_server.h.
|
protected |
Definition at line 353 of file api_server.h.
|
protected |
Definition at line 307 of file api_server.h.
|
protected |
Definition at line 317 of file api_server.h.
|
protected |
Definition at line 349 of file api_server.h.
|
protected |
Definition at line 298 of file api_server.h.
|
protected |
Definition at line 319 of file api_server.h.
|
protected |
Definition at line 322 of file api_server.h.