ESPHome 2026.3.0-dev
Loading...
Searching...
No Matches
esphome::template_::TemplateWaterHeater Class Reference

#include <template_water_heater.h>

Inheritance diagram for esphome::template_::TemplateWaterHeater:
esphome::Component esphome::water_heater::WaterHeater esphome::EntityBase

Public Member Functions

 TemplateWaterHeater ()
 
template<typename F >
void set_current_temperature_lambda (F &&f)
 
template<typename F >
void set_target_temperature_lambda (F &&f)
 
template<typename F >
void set_mode_lambda (F &&f)
 
template<typename F >
void set_away_lambda (F &&f)
 
template<typename F >
void set_is_on_lambda (F &&f)
 
void set_optimistic (bool optimistic)
 
void set_restore_mode (TemplateWaterHeaterRestoreMode restore_mode)
 
void set_supported_modes (const std::initializer_list< water_heater::WaterHeaterMode > &modes)
 
Triggerget_set_trigger ()
 
void setup () override
 
void loop () override
 
void dump_config () override
 
float get_setup_priority () const override
 
water_heater::WaterHeaterCallInternal make_call () override
 
- 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_shutdown ()
 
virtual void on_safe_shutdown ()
 
virtual bool teardown ()
 Called during teardown to allow component to gracefully finish operations.
 
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.
 
 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::water_heater::WaterHeater
WaterHeaterMode get_mode () const
 
float get_current_temperature () const
 
float get_target_temperature () const
 
float get_target_temperature_low () const
 
float get_target_temperature_high () const
 
uint32_t get_state () const
 Get the current state flags bitmask.
 
bool is_away () const
 Check if away mode is currently active.
 
bool is_on () const
 Check if the water heater is on.
 
void set_current_temperature (float current_temperature)
 
virtual void publish_state ()
 
virtual WaterHeaterTraits get_traits ()
 
void set_visual_min_temperature_override (float min_temperature_override)
 
void set_visual_max_temperature_override (float max_temperature_override)
 
void set_visual_target_temperature_step_override (float visual_target_temperature_step_override)
 
- 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.
 

Protected Member Functions

void control (const water_heater::WaterHeaterCall &call) override
 
water_heater::WaterHeaterTraits traits () override
 
- Protected Member Functions inherited from esphome::Component
void call_loop_ ()
 
virtual void call_setup ()
 
void call_dump_config_ ()
 
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 (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 (uint32_t id)
 
bool cancel_interval (InternalSchedulerID id)
 
ESPDEPRECATED("set_retry is deprecated and will be removed in 2026.8.0. Use set_timeout or set_interval instead.", "2026.2.0") void set_retry(const std ESPDEPRECATED ("set_retry is deprecated and will be removed in 2026.8.0. Use set_timeout or set_interval instead.", "2026.2.0") void set_retry(const char *name
 
 ESPDEPRECATED ("set_retry is deprecated and will be removed in 2026.8.0. Use set_timeout or set_interval instead.", "2026.2.0") void set_retry(uint32_t id
 
 ESPDEPRECATED ("set_retry is deprecated and will be removed in 2026.8.0. Use set_timeout or set_interval instead.", "2026.2.0") void set_retry(uint32_t initial_wait_time
 
ESPDEPRECATED("cancel_retry is deprecated and will be removed in 2026.8.0.", "2026.2.0") bool cancel_retry(const std ESPDEPRECATED ("cancel_retry is deprecated and will be removed in 2026.8.0.", "2026.2.0") bool cancel_retry(const char *name)
 
 ESPDEPRECATED ("cancel_retry is deprecated and will be removed in 2026.8.0.", "2026.2.0") bool cancel_retry(uint32_t id)
 
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 (uint32_t id)
 
bool cancel_timeout (InternalSchedulerID id)
 
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 (uint32_t id)
 
- Protected Member Functions inherited from esphome::water_heater::WaterHeater
void dump_traits_ (const char *tag)
 Log the traits of this water heater for dump_config().
 
optional< WaterHeaterCallrestore_state_ ()
 Restore the state of the water heater, call this from your setup() method.
 
void set_mode_ (WaterHeaterMode mode)
 Set the mode of the water heater. Should only be called from control().
 
void set_target_temperature_ (float target_temperature)
 Set the target temperature of the water heater. Should only be called from control().
 
void set_target_temperature_low_ (float target_temperature_low)
 Set the low target temperature (for two-point control). Should only be called from control().
 
void set_target_temperature_high_ (float target_temperature_high)
 Set the high target temperature (for two-point control). Should only be called from control().
 
void set_state_ (uint32_t state)
 Set the state flags. Should only be called from control().
 
void set_state_flag_ (uint32_t flag, bool value)
 Set or clear a state flag. Should only be called from control().
 
- 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_ ()
 

Protected Attributes

Trigger set_trigger_
 
TemplateLambda< float > current_temperature_f_
 
TemplateLambda< float > target_temperature_f_
 
TemplateLambda< water_heater::WaterHeaterModemode_f_
 
TemplateLambda< bool > away_f_
 
TemplateLambda< bool > is_on_f_
 
TemplateWaterHeaterRestoreMode restore_mode_ {WATER_HEATER_NO_RESTORE}
 
water_heater::WaterHeaterModeMask supported_modes_
 
bool optimistic_ {true}
 
- Protected Attributes inherited from esphome::Component
ESPDEPRECATED("Use const char* or uint32_t overload instead. Removed in 2026.7.0", "2026.1.0") void set_interval(const std voi set_interval )(const char *name, uint32_t interval, std::function< void()> &&f)
 Set an interval function with a unique name.
 
ESPDEPRECATED("Use const char* or uint32_t overload instead. Removed in 2026.7.0", "2026.1.0") bool cancel_interval(const std boo cancel_interval )(const char *name)
 Cancel an interval function.
 
ESPDEPRECATED("set_retry is deprecated and will be removed in 2026.8.0. Use set_timeout or set_interval instead.", "2026.2.0") void set_retry(const std uint32_t initial_wait_time
 
ESPDEPRECATED("set_retry is deprecated and will be removed in 2026.8.0. Use set_timeout or set_interval instead.", "2026.2.0") void set_retry(const std uint32_t uint8_t max_attempts
 
ESPDEPRECATED("set_retry is deprecated and will be removed in 2026.8.0. Use set_timeout or set_interval instead.", "2026.2.0") void set_retry(const std uint32_t uint8_t std::function< RetryResult(uint8_t)> && f
 
ESPDEPRECATED("set_retry is deprecated and will be removed in 2026.8.0. Use set_timeout or set_interval instead.", "2026.2.0") void set_retry(const std uint32_t uint8_t std::function< RetryResult(uint8_t)> float backoff_increase_factor = 1.0f)
 
uint32_t initial_wait_time
 
uint32_t uint8_t max_attempts
 
uint32_t uint8_t std::function< RetryResult(uint8_t)> && f
 
uint32_t uint8_t std::function< RetryResult(uint8_t)> float backoff_increase_factor = 1.0f)
 
uint8_t max_attempts
 
uint8_t std::function< RetryResult(uint8_t)> && f
 
uint8_t std::function< RetryResult(uint8_t)> float backoff_increase_factor = 1.0f)
 
ESPDEPRECATED("Use const char* or uint32_t overload instead. Removed in 2026.7.0", "2026.1.0") void set_timeout(const std voi set_timeout )(const char *name, uint32_t timeout, std::function< void()> &&f)
 Set a timeout function with a unique name.
 
ESPDEPRECATED("Use const char* or uint32_t overload instead. Removed in 2026.7.0", "2026.1.0") bool cancel_timeout(const std boo cancel_timeout )(const char *name)
 Cancel a timeout function.
 
ESPDEPRECATED("Use const char* overload instead. Removed in 2026.7.0", "2026.1.0") void defer(const std voi defer )(const char *name, std::function< void()> &&f)
 Defer a callback to the next loop() call.
 
ESPDEPRECATED("Use const char* overload instead. Removed in 2026.7.0", "2026.1.0") bool cancel_defer(const std boo cancel_defer )(const char *name)
 Cancel a defer callback using the specified name, name must not be empty.
 
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 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.
 
- Protected Attributes inherited from esphome::water_heater::WaterHeater
WaterHeaterMode mode_ {WATER_HEATER_MODE_OFF}
 
float current_temperature_ {NAN}
 
float target_temperature_ {NAN}
 
float target_temperature_low_ {NAN}
 
float target_temperature_high_ {NAN}
 
uint32_t state_ {0}
 
float visual_min_temperature_override_ {NAN}
 
float visual_max_temperature_override_ {NAN}
 
float visual_target_temperature_step_override_ {NAN}
 
ESPPreferenceObject pref_
 
- 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_
 

Detailed Description

Definition at line 16 of file template_water_heater.h.

Constructor & Destructor Documentation

◆ TemplateWaterHeater()

esphome::template_::TemplateWaterHeater::TemplateWaterHeater ( )
default

Member Function Documentation

◆ control()

void esphome::template_::TemplateWaterHeater::control ( const water_heater::WaterHeaterCall & call)
overrideprotectedvirtual

Implements esphome::water_heater::WaterHeater.

Definition at line 103 of file template_water_heater.cpp.

◆ dump_config()

void esphome::template_::TemplateWaterHeater::dump_config ( )
overridevirtual

Reimplemented from esphome::Component.

Definition at line 92 of file template_water_heater.cpp.

◆ get_set_trigger()

Trigger * esphome::template_::TemplateWaterHeater::get_set_trigger ( )
inline

Definition at line 36 of file template_water_heater.h.

◆ get_setup_priority()

float esphome::template_::TemplateWaterHeater::get_setup_priority ( ) const
overridevirtual

Reimplemented from esphome::Component.

Definition at line 97 of file template_water_heater.cpp.

◆ loop()

void esphome::template_::TemplateWaterHeater::loop ( )
overridevirtual

Reimplemented from esphome::Component.

Definition at line 44 of file template_water_heater.cpp.

◆ make_call()

water_heater::WaterHeaterCallInternal esphome::template_::TemplateWaterHeater::make_call ( )
overridevirtual

Implements esphome::water_heater::WaterHeater.

Definition at line 99 of file template_water_heater.cpp.

◆ set_away_lambda()

template<typename F >
void esphome::template_::TemplateWaterHeater::set_away_lambda ( F && f)
inline

Definition at line 27 of file template_water_heater.h.

◆ set_current_temperature_lambda()

template<typename F >
void esphome::template_::TemplateWaterHeater::set_current_temperature_lambda ( F && f)
inline

Definition at line 20 of file template_water_heater.h.

◆ set_is_on_lambda()

template<typename F >
void esphome::template_::TemplateWaterHeater::set_is_on_lambda ( F && f)
inline

Definition at line 28 of file template_water_heater.h.

◆ set_mode_lambda()

template<typename F >
void esphome::template_::TemplateWaterHeater::set_mode_lambda ( F && f)
inline

Definition at line 26 of file template_water_heater.h.

◆ set_optimistic()

void esphome::template_::TemplateWaterHeater::set_optimistic ( bool optimistic)
inline

Definition at line 30 of file template_water_heater.h.

◆ set_restore_mode()

void esphome::template_::TemplateWaterHeater::set_restore_mode ( TemplateWaterHeaterRestoreMode restore_mode)
inline

Definition at line 31 of file template_water_heater.h.

◆ set_supported_modes()

void esphome::template_::TemplateWaterHeater::set_supported_modes ( const std::initializer_list< water_heater::WaterHeaterMode > & modes)
inline

Definition at line 32 of file template_water_heater.h.

◆ set_target_temperature_lambda()

template<typename F >
void esphome::template_::TemplateWaterHeater::set_target_temperature_lambda ( F && f)
inline

Definition at line 23 of file template_water_heater.h.

◆ setup()

void esphome::template_::TemplateWaterHeater::setup ( )
overridevirtual

Reimplemented from esphome::Component.

Definition at line 10 of file template_water_heater.cpp.

◆ traits()

water_heater::WaterHeaterTraits esphome::template_::TemplateWaterHeater::traits ( )
overrideprotectedvirtual

Implements esphome::water_heater::WaterHeater.

Definition at line 24 of file template_water_heater.cpp.

Field Documentation

◆ away_f_

TemplateLambda<bool> esphome::template_::TemplateWaterHeater::away_f_
protected

Definition at line 54 of file template_water_heater.h.

◆ current_temperature_f_

TemplateLambda<float> esphome::template_::TemplateWaterHeater::current_temperature_f_
protected

Definition at line 51 of file template_water_heater.h.

◆ is_on_f_

TemplateLambda<bool> esphome::template_::TemplateWaterHeater::is_on_f_
protected

Definition at line 55 of file template_water_heater.h.

◆ mode_f_

TemplateLambda<water_heater::WaterHeaterMode> esphome::template_::TemplateWaterHeater::mode_f_
protected

Definition at line 53 of file template_water_heater.h.

◆ optimistic_

bool esphome::template_::TemplateWaterHeater::optimistic_ {true}
protected

Definition at line 58 of file template_water_heater.h.

◆ restore_mode_

TemplateWaterHeaterRestoreMode esphome::template_::TemplateWaterHeater::restore_mode_ {WATER_HEATER_NO_RESTORE}
protected

Definition at line 56 of file template_water_heater.h.

◆ set_trigger_

Trigger esphome::template_::TemplateWaterHeater::set_trigger_
protected

Definition at line 50 of file template_water_heater.h.

◆ supported_modes_

water_heater::WaterHeaterModeMask esphome::template_::TemplateWaterHeater::supported_modes_
protected

Definition at line 57 of file template_water_heater.h.

◆ target_temperature_f_

TemplateLambda<float> esphome::template_::TemplateWaterHeater::target_temperature_f_
protected

Definition at line 52 of file template_water_heater.h.


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