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

#include <template_water_heater.h>

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

Public Member Functions

 TemplateWaterHeater ()
 
template<typename F >
void set_current_temperature_lambda (F &&f)
 
template<typename F >
void set_mode_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 () const
 
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::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)
 
void setup () override
 
optional< WaterHeaterCallrestore_state ()
 
- 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)
 
uint32_t get_preference_hash ()
 Get a unique hash for storing preferences/settings for this entity.
 
- 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.
 
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)
 

Protected Member Functions

void control (const water_heater::WaterHeaterCall &call) override
 
water_heater::WaterHeaterTraits traits () override
 
- 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().
 
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
void calc_object_id_ ()
 
- 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

Triggerset_trigger_
 
TemplateLambda< float > current_temperature_f_
 
TemplateLambda< water_heater::WaterHeaterModemode_f_
 
TemplateWaterHeaterRestoreMode restore_mode_ {WATER_HEATER_NO_RESTORE}
 
water_heater::WaterHeaterModeMask supported_modes_
 
bool optimistic_ {true}
 
- 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_
 
- 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.
 

Detailed Description

Definition at line 16 of file template_water_heater.h.

Constructor & Destructor Documentation

◆ TemplateWaterHeater()

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

Definition at line 8 of file template_water_heater.cpp.

Member Function Documentation

◆ control()

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

Implements esphome::water_heater::WaterHeater.

Definition at line 69 of file template_water_heater.cpp.

◆ dump_config()

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

Reimplemented from esphome::Component.

Definition at line 58 of file template_water_heater.cpp.

◆ get_set_trigger()

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

Definition at line 31 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 63 of file template_water_heater.cpp.

◆ loop()

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

Reimplemented from esphome::Component.

Definition at line 34 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 65 of file template_water_heater.cpp.

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

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

Definition at line 23 of file template_water_heater.h.

◆ set_optimistic()

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

Definition at line 25 of file template_water_heater.h.

◆ set_restore_mode()

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

Definition at line 26 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 27 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 23 of file template_water_heater.cpp.

Field Documentation

◆ current_temperature_f_

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

Definition at line 46 of file template_water_heater.h.

◆ mode_f_

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

Definition at line 47 of file template_water_heater.h.

◆ optimistic_

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

Definition at line 50 of file template_water_heater.h.

◆ restore_mode_

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

Definition at line 48 of file template_water_heater.h.

◆ set_trigger_

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

Definition at line 45 of file template_water_heater.h.

◆ supported_modes_

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

Definition at line 49 of file template_water_heater.h.


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