#include <api_server.h>

Inheritance diagram for esphome::api::APIServer:

Data Structures
struct	HomeAssistantStateSubscription

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

bool	check_password (const std::string &password) const

bool	uses_password () const

void	set_port (uint16_t port)

void	set_password (const std::string &password)

void	set_reboot_timeout (uint32_t reboot_timeout)

void	set_batch_delay (uint32_t batch_delay)

uint32_t	get_batch_delay () const

std::vector< uint8_t > &	get_shared_buffer_ref ()

bool	save_noise_psk (psk_t psk, bool make_active=true)

void	set_noise_psk (psk_t psk)

std::shared_ptr< APINoiseContext >	get_noise_ctx ()

void	handle_disconnect (APIConnection *conn)

void	on_binary_sensor_update (binary_sensor::BinarySensor *obj, bool state) 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, float state) override

void	on_switch_update (switch_::Switch *obj, bool state) override

void	on_text_sensor_update (text_sensor::TextSensor *obj, const std::string &state) override

void	on_climate_update (climate::Climate *obj) override

void	on_number_update (number::Number *obj, float state) 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, const std::string &state) override

void	on_select_update (select::Select *obj, const std::string &state, size_t index) 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	send_homeassistant_service_call (const HomeassistantServiceResponse &call)

void	register_user_service (UserServiceDescriptor *descriptor)

void	request_time ()

void	on_alarm_control_panel_update (alarm_control_panel::AlarmControlPanel *obj) override

void	on_event (event::Event *obj, const std::string &event_type) override

void	on_update (update::UpdateEntity *obj) override

bool	is_connected () const

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.

virtual void	mark_failed ()
	Mark this component as failed.

void	mark_failed (const char *message)

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="unspecified")

void	status_set_error (const char *message="unspecified")

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.

const char *	get_component_source () const
	Get the integration where this component was declared as a string.

bool	should_warn_of_blocking (uint32_t blocking_time)

Public Member Functions inherited from esphome::Controller
void	setup_controller (bool include_internal=false)

Protected Attributes
bool	shutting_down_ = false

std::unique_ptr< socket::Socket >	socket_ = nullptr

uint16_t	port_ {6053}

uint32_t	reboot_timeout_ {300000}

uint32_t	batch_delay_ {100}

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_

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>()

std::shared_ptr< APINoiseContext >	noise_ctx_ = std::make_shared<APINoiseContext>()

ESPPreferenceObject	noise_pref_

Protected Attributes inherited from esphome::Component
uint8_t	component_state_ {0x00}
	State of this component - each bit has a purpose: Bits 0-1: Component state (0x00=CONSTRUCTION, 0x01=SETUP, 0x02=LOOP, 0x03=FAILED) Bit 2: STATUS_LED_WARNING Bit 3: STATUS_LED_ERROR Bits 4-7: Unused - reserved for future expansion (50% of the bits are free)

float	setup_priority_override_ {NAN}

const char *	component_source_ {nullptr}

uint16_t	warn_if_blocking_over_ {WARN_IF_BLOCKING_OVER_MS}
	Warn if blocked for this many ms (max 65.5s)

std::string	error_message_ {}

Additional Inherited Members
Protected Member Functions inherited from esphome::Component
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.

void	set_interval (uint32_t interval, std::function< void()> &&f)

bool	cancel_interval (const std::string &name)
	Cancel an interval function.

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 (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.

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 (uint32_t timeout, std::function< void()> &&f)

bool	cancel_timeout (const std::string &name)
	Cancel a timeout function.

void	defer (const std::string &name, std::function< void()> &&f)
	Defer a callback to the next loop() call.

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.

Detailed Description

Definition at line 28 of file api_server.h.

Constructor & Destructor Documentation

◆ APIServer()

esphome::api::APIServer::APIServer ( )

Definition at line 27 of file api_server.cpp.

Member Function Documentation

◆ check_password()

bool esphome::api::APIServer::check_password ( const std::string & password ) const

Definition at line 198 of file api_server.cpp.

◆ dump_config()

void esphome::api::APIServer::dump_config ( )

overridevirtual

Reimplemented from esphome::Component.

Definition at line 181 of file api_server.cpp.

◆ get_batch_delay()

uint32_t esphome::api::APIServer::get_batch_delay ( ) const

inline

Definition at line 44 of file api_server.h.

◆ get_client_connected_trigger()

Trigger< std::string, std::string > * esphome::api::APIServer::get_client_connected_trigger ( ) const

inline

Definition at line 139 of file api_server.h.

◆ get_client_disconnected_trigger()

Trigger< std::string, std::string > * esphome::api::APIServer::get_client_disconnected_trigger ( ) const

inline

Definition at line 140 of file api_server.h.

◆ get_home_assistant_state()

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 429 of file api_server.cpp.

◆ get_noise_ctx()

std::shared_ptr< APINoiseContext > esphome::api::APIServer::get_noise_ctx ( )

inline

Definition at line 52 of file api_server.h.

◆ get_port()

uint16_t esphome::api::APIServer::get_port ( ) const

Definition at line 443 of file api_server.cpp.

◆ get_setup_priority()

float esphome::api::APIServer::get_setup_priority ( ) const

overridevirtual

Reimplemented from esphome::Component.

Definition at line 405 of file api_server.cpp.

◆ get_shared_buffer_ref()

std::vector< uint8_t > & esphome::api::APIServer::get_shared_buffer_ref ( )

inline

Definition at line 47 of file api_server.h.

◆ get_state_subs()

const std::vector< APIServer::HomeAssistantStateSubscription > & esphome::api::APIServer::get_state_subs ( ) const

Definition at line 439 of file api_server.cpp.

◆ get_user_services()

const std::vector< UserServiceDescriptor * > & esphome::api::APIServer::get_user_services ( ) const

inline

Definition at line 137 of file api_server.h.

◆ handle_disconnect()

void esphome::api::APIServer::handle_disconnect ( APIConnection * conn )

Definition at line 227 of file api_server.cpp.

◆ is_connected()

bool esphome::api::APIServer::is_connected ( ) const

Definition at line 488 of file api_server.cpp.

◆ loop()

void esphome::api::APIServer::loop ( )

overridevirtual

Reimplemented from esphome::Component.

Definition at line 124 of file api_server.cpp.

◆ on_alarm_control_panel_update()

void esphome::api::APIServer::on_alarm_control_panel_update ( alarm_control_panel::AlarmControlPanel * obj )

overridevirtual

Reimplemented from esphome::Controller.

Definition at line 397 of file api_server.cpp.

◆ on_binary_sensor_update()

void esphome::api::APIServer::on_binary_sensor_update	(	binary_sensor::BinarySensor *	obj,
		bool	state )

overridevirtual

Reimplemented from esphome::Controller.

Definition at line 230 of file api_server.cpp.

◆ on_climate_update()

void esphome::api::APIServer::on_climate_update ( climate::Climate * obj )

overridevirtual

Reimplemented from esphome::Controller.

Definition at line 293 of file api_server.cpp.

◆ on_cover_update()

void esphome::api::APIServer::on_cover_update ( cover::Cover * obj )

overridevirtual

Reimplemented from esphome::Controller.

Definition at line 239 of file api_server.cpp.

◆ on_date_update()

void esphome::api::APIServer::on_date_update ( datetime::DateEntity * obj )

overridevirtual

Reimplemented from esphome::Controller.

Definition at line 311 of file api_server.cpp.

◆ on_datetime_update()

void esphome::api::APIServer::on_datetime_update ( datetime::DateTimeEntity * obj )

overridevirtual

Reimplemented from esphome::Controller.

Definition at line 329 of file api_server.cpp.

◆ on_event()

void esphome::api::APIServer::on_event	(	event::Event *	obj,
		const std::string &	event_type )

overridevirtual

Reimplemented from esphome::Controller.

Definition at line 383 of file api_server.cpp.

◆ on_fan_update()

void esphome::api::APIServer::on_fan_update ( fan::Fan * obj )

overridevirtual

Reimplemented from esphome::Controller.

Definition at line 248 of file api_server.cpp.

◆ on_light_update()

void esphome::api::APIServer::on_light_update ( light::LightState * obj )

overridevirtual

Reimplemented from esphome::Controller.

Definition at line 257 of file api_server.cpp.

◆ on_lock_update()

void esphome::api::APIServer::on_lock_update ( lock::Lock * obj )

overridevirtual

Reimplemented from esphome::Controller.

Definition at line 356 of file api_server.cpp.

◆ on_media_player_update()

void esphome::api::APIServer::on_media_player_update ( media_player::MediaPlayer * obj )

overridevirtual

Reimplemented from esphome::Controller.

Definition at line 374 of file api_server.cpp.

◆ on_number_update()

void esphome::api::APIServer::on_number_update	(	number::Number *	obj,
		float	state )

overridevirtual

Reimplemented from esphome::Controller.

Definition at line 302 of file api_server.cpp.

◆ on_select_update()

void esphome::api::APIServer::on_select_update	(	select::Select *	obj,
		const std::string &	state,
		size_t	index )

overridevirtual

Reimplemented from esphome::Controller.

Definition at line 347 of file api_server.cpp.

◆ on_sensor_update()

void esphome::api::APIServer::on_sensor_update	(	sensor::Sensor *	obj,
		float	state )

overridevirtual

Reimplemented from esphome::Controller.

Definition at line 266 of file api_server.cpp.

◆ on_shutdown()

void esphome::api::APIServer::on_shutdown ( )

overridevirtual

Reimplemented from esphome::Component.

Definition at line 490 of file api_server.cpp.

◆ on_switch_update()

void esphome::api::APIServer::on_switch_update	(	switch_::Switch *	obj,
		bool	state )

overridevirtual

Reimplemented from esphome::Controller.

Definition at line 275 of file api_server.cpp.

◆ on_text_sensor_update()

void esphome::api::APIServer::on_text_sensor_update	(	text_sensor::TextSensor *	obj,
		const std::string &	state )

overridevirtual

Reimplemented from esphome::Controller.

Definition at line 284 of file api_server.cpp.

◆ on_text_update()

void esphome::api::APIServer::on_text_update	(	text::Text *	obj,
		const std::string &	state )

overridevirtual

Reimplemented from esphome::Controller.

Definition at line 338 of file api_server.cpp.

◆ on_time_update()

void esphome::api::APIServer::on_time_update ( datetime::TimeEntity * obj )

overridevirtual

Reimplemented from esphome::Controller.

Definition at line 320 of file api_server.cpp.

◆ on_update()

void esphome::api::APIServer::on_update ( update::UpdateEntity * obj )

overridevirtual

Reimplemented from esphome::Controller.

Definition at line 390 of file api_server.cpp.

◆ on_valve_update()

void esphome::api::APIServer::on_valve_update ( valve::Valve * obj )

overridevirtual

Reimplemented from esphome::Controller.

Definition at line 365 of file api_server.cpp.

◆ register_user_service()

void esphome::api::APIServer::register_user_service ( UserServiceDescriptor * descriptor )

inline

Definition at line 108 of file api_server.h.

◆ request_time()

void esphome::api::APIServer::request_time ( )

Definition at line 480 of file api_server.cpp.

◆ save_noise_psk()

bool esphome::api::APIServer::save_noise_psk	(	psk_t	psk,
		bool	make_active = true )

Definition at line 448 of file api_server.cpp.

◆ send_homeassistant_service_call()

void esphome::api::APIServer::send_homeassistant_service_call ( const HomeassistantServiceResponse & call )

Definition at line 413 of file api_server.cpp.

◆ set_batch_delay()

void esphome::api::APIServer::set_batch_delay ( uint32_t batch_delay )

Definition at line 411 of file api_server.cpp.

◆ set_noise_psk()

void esphome::api::APIServer::set_noise_psk ( psk_t psk )

inline

Definition at line 51 of file api_server.h.

◆ set_password()

void esphome::api::APIServer::set_password ( const std::string & password )

Definition at line 409 of file api_server.cpp.

◆ set_port()

void esphome::api::APIServer::set_port ( uint16_t port )

Definition at line 407 of file api_server.cpp.

◆ set_reboot_timeout()

void esphome::api::APIServer::set_reboot_timeout ( uint32_t reboot_timeout )

Definition at line 445 of file api_server.cpp.

◆ setup()

void esphome::api::APIServer::setup ( )

overridevirtual

Reimplemented from esphome::Component.

Definition at line 33 of file api_server.cpp.

◆ subscribe_home_assistant_state()

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 419 of file api_server.cpp.

◆ teardown()

bool esphome::api::APIServer::teardown ( )

overridevirtual

Reimplemented from esphome::Component.

Definition at line 512 of file api_server.cpp.

◆ uses_password()

bool esphome::api::APIServer::uses_password ( ) const

Definition at line 196 of file api_server.cpp.

Field Documentation

◆ batch_delay_

uint32_t esphome::api::APIServer::batch_delay_ {100}

protected

Definition at line 149 of file api_server.h.

◆ client_connected_trigger_

Trigger<std::string, std::string>* esphome::api::APIServer::client_connected_trigger_ = new Trigger<std::string, std::string>()

protected

Definition at line 156 of file api_server.h.

◆ client_disconnected_trigger_

Trigger<std::string, std::string>* esphome::api::APIServer::client_disconnected_trigger_ = new Trigger<std::string, std::string>()

protected

Definition at line 157 of file api_server.h.

◆ clients_

std::vector<std::unique_ptr<APIConnection> > esphome::api::APIServer::clients_

protected

Definition at line 151 of file api_server.h.

◆ last_connected_

uint32_t esphome::api::APIServer::last_connected_ {0}

protected

Definition at line 150 of file api_server.h.

◆ noise_ctx_

std::shared_ptr<APINoiseContext> esphome::api::APIServer::noise_ctx_ = std::make_shared<APINoiseContext>()

protected

Definition at line 160 of file api_server.h.

◆ noise_pref_

ESPPreferenceObject esphome::api::APIServer::noise_pref_

protected

Definition at line 161 of file api_server.h.

◆ password_

std::string esphome::api::APIServer::password_

protected

Definition at line 152 of file api_server.h.

◆ port_

uint16_t esphome::api::APIServer::port_ {6053}

protected

Definition at line 147 of file api_server.h.

◆ reboot_timeout_

uint32_t esphome::api::APIServer::reboot_timeout_ {300000}

protected

Definition at line 148 of file api_server.h.

◆ shared_write_buffer_

std::vector<uint8_t> esphome::api::APIServer::shared_write_buffer_

protected

Definition at line 153 of file api_server.h.

◆ shutting_down_

bool esphome::api::APIServer::shutting_down_ = false

protected

Definition at line 145 of file api_server.h.

◆ socket_

std::unique_ptr<socket::Socket> esphome::api::APIServer::socket_ = nullptr

protected

Definition at line 146 of file api_server.h.

◆ state_subs_

std::vector<HomeAssistantStateSubscription> esphome::api::APIServer::state_subs_

protected

Definition at line 154 of file api_server.h.

◆ user_services_

std::vector<UserServiceDescriptor *> esphome::api::APIServer::user_services_

protected

Definition at line 155 of file api_server.h.

The documentation for this class was generated from the following files:

esphome/components/api/api_server.h
esphome/components/api/api_server.cpp

Data Structures

Public Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ APIServer()

Member Function Documentation

◆ check_password()

◆ dump_config()

◆ get_batch_delay()

◆ get_client_connected_trigger()

◆ get_client_disconnected_trigger()

◆ get_home_assistant_state()

◆ get_noise_ctx()

◆ get_port()

◆ get_setup_priority()

◆ get_shared_buffer_ref()

◆ get_state_subs()

◆ get_user_services()

◆ handle_disconnect()

◆ is_connected()

◆ loop()

◆ on_alarm_control_panel_update()

◆ on_binary_sensor_update()

◆ on_climate_update()

◆ on_cover_update()

◆ on_date_update()

◆ on_datetime_update()

◆ on_event()

◆ on_fan_update()

◆ on_light_update()

◆ on_lock_update()

◆ on_media_player_update()

◆ on_number_update()

◆ on_select_update()

◆ on_sensor_update()

◆ on_shutdown()

◆ on_switch_update()

◆ on_text_sensor_update()

◆ on_text_update()

◆ on_time_update()

◆ on_update()

◆ on_valve_update()

◆ register_user_service()

◆ request_time()

◆ save_noise_psk()

◆ send_homeassistant_service_call()

◆ set_batch_delay()

◆ set_noise_psk()

◆ set_password()

◆ set_port()

◆ set_reboot_timeout()

◆ setup()

◆ subscribe_home_assistant_state()

◆ teardown()

◆ uses_password()

Field Documentation

◆ batch_delay_

◆ client_connected_trigger_

◆ client_disconnected_trigger_

◆ clients_

◆ last_connected_

◆ noise_ctx_

◆ noise_pref_

◆ password_

◆ port_

◆ reboot_timeout_

◆ shared_write_buffer_

◆ shutting_down_

◆ socket_

◆ state_subs_

◆ user_services_