ESPHome 2026.2.1
Loading...
Searching...
No Matches
esphome::update::UpdateEntity Class Referenceabstract

#include <update_entity.h>

Inheritance diagram for esphome::update::UpdateEntity:
esphome::EntityBase esphome::EntityBase_DeviceClass esphome::esp32_hosted::Esp32HostedUpdate esphome::http_request::HttpRequestUpdate

Public Member Functions

void publish_state ()
 
void perform ()
 
virtual void perform (bool force)=0
 
virtual void check ()=0
 
void add_on_state_callback (std::function< void()> &&callback)
 
Trigger< const UpdateInfo & > * get_update_available_trigger ()
 
- Public Member Functions inherited from esphome::EntityBase
const StringRefget_name () const
 
void set_name (const char *name)
 
void set_name (const char *name, uint32_t object_id_hash)
 Set name with pre-computed object_id hash (avoids runtime hash calculation) Use hash=0 for dynamic names that need runtime calculation.
 
bool has_own_name () const
 
ESPDEPRECATED("object_id mangles names and all object_id methods are planned for removal " "(see https://github.com/esphome/backlog/issues/76). " "Now is the time to stop using object_id. If still needed, use get_object_id_to() " "which will remain available longer. get_object_id() will be removed in 2026.7.0", "2025.12.0") std uint32_t get_object_id_hash ()
 
StringRef get_object_id_to (std::span< char, OBJECT_ID_MAX_LEN > buf) const
 Get object_id with zero heap allocation For static case: returns StringRef to internal storage (buffer unused) For dynamic case: formats into buffer and returns StringRef to buffer.
 
size_t write_object_id_to (char *buf, size_t buf_size) const
 Write object_id directly to buffer, returns length written (excluding null) Useful for building compound strings without intermediate buffer.
 
bool is_internal () const
 
void set_internal (bool internal)
 
bool is_disabled_by_default () const
 
void set_disabled_by_default (bool disabled_by_default)
 
EntityCategory get_entity_category () const
 
void set_entity_category (EntityCategory entity_category)
 
ESPDEPRECATED("Use get_icon_ref() instead for better performance (avoids string copy). Will be removed in ESPHome 2026.5.0", "2025.11.0") std void set_icon (const char *icon)
 
StringRef get_icon_ref () const
 
uint32_t get_device_id () const
 
void set_device (Device *device)
 
Deviceget_device () const
 
bool has_state () const
 
void set_has_state (bool state)
 
 ESPDEPRECATED ("Use make_entity_preference<T>() instead, or preferences won't be migrated. " "See https://github.com/esphome/backlog/issues/85. Will be removed in 2027.1.0.", "2026.7.0") uint32_t get_preference_hash()
 Get a unique hash for storing preferences/settings for this entity.
 
template<typename T >
ESPPreferenceObject make_entity_preference (uint32_t version=0)
 Create a preference object for storing this entity's state/settings.
 
- Public Member Functions inherited from esphome::EntityBase_DeviceClass
ESPDEPRECATED("Use get_device_class_ref() instead for better performance (avoids string copy). Will be removed in " "ESPHome 2026.5.0", "2025.11.0") std void set_device_class (const char *device_class)
 Get the device class, using the manual override if set.
 
StringRef get_device_class_ref () const
 Get the device class as StringRef.
 

Data Fields

const UpdateInfoupdate_info = update_info_
 
const UpdateStatestate = state_
 

Protected Attributes

UpdateState state_ {UPDATE_STATE_UNKNOWN}
 
UpdateInfo update_info_
 
LazyCallbackManager< void()> state_callback_ {}
 
std::unique_ptr< Trigger< const UpdateInfo & > > update_available_trigger_ {nullptr}
 
- Protected Attributes inherited from esphome::EntityBase
StringRef name_
 
const char * icon_c_str_ {nullptr}
 
uint32_t object_id_hash_ {}
 
Devicedevice_ {}
 
struct esphome::EntityBase::EntityFlags flags_
 
- Protected Attributes inherited from esphome::EntityBase_DeviceClass
const char * device_class_ {nullptr}
 Device class override.
 

Additional Inherited Members

- Protected Member Functions inherited from esphome::EntityBase
ESPPreferenceObject make_entity_preference_ (size_t size, uint32_t version)
 Non-template helper for make_entity_preference() to avoid code bloat.
 
void calc_object_id_ ()
 

Detailed Description

Definition at line 32 of file update_entity.h.

Member Function Documentation

◆ add_on_state_callback()

void esphome::update::UpdateEntity::add_on_state_callback ( std::function< void()> && callback)
inline

Definition at line 43 of file update_entity.h.

◆ check()

virtual void esphome::update::UpdateEntity::check ( )
pure virtual

◆ get_update_available_trigger()

Trigger< const UpdateInfo & > * esphome::update::UpdateEntity::get_update_available_trigger ( )
inline

Definition at line 44 of file update_entity.h.

◆ perform() [1/2]

void esphome::update::UpdateEntity::perform ( )
inline

Definition at line 36 of file update_entity.h.

◆ perform() [2/2]

virtual void esphome::update::UpdateEntity::perform ( bool force)
pure virtual

◆ publish_state()

void esphome::update::UpdateEntity::publish_state ( )

Definition at line 20 of file update_entity.cpp.

Field Documentation

◆ state

const UpdateState& esphome::update::UpdateEntity::state = state_

Definition at line 41 of file update_entity.h.

◆ state_

UpdateState esphome::update::UpdateEntity::state_ {UPDATE_STATE_UNKNOWN}
protected

Definition at line 52 of file update_entity.h.

◆ state_callback_

LazyCallbackManager<void()> esphome::update::UpdateEntity::state_callback_ {}
protected

Definition at line 55 of file update_entity.h.

◆ update_available_trigger_

std::unique_ptr<Trigger<const UpdateInfo &> > esphome::update::UpdateEntity::update_available_trigger_ {nullptr}
protected

Definition at line 56 of file update_entity.h.

◆ update_info

const UpdateInfo& esphome::update::UpdateEntity::update_info = update_info_

Definition at line 40 of file update_entity.h.

◆ update_info_

UpdateInfo esphome::update::UpdateEntity::update_info_
protected

Definition at line 53 of file update_entity.h.


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