ESPHome 2026.1.0b1
Loading...
Searching...
No Matches
esphome::water_heater::WaterHeater Class Referenceabstract

#include <water_heater.h>

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

Public Member Functions

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 ()
 
virtual WaterHeaterCallInternal make_call ()=0
 
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)
 
virtual void control (const WaterHeaterCall &call)=0
 
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
virtual void loop ()
 This method will be called repeatedly.
 
virtual void dump_config ()
 
virtual float get_setup_priority () const
 priority of setup().
 
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

virtual WaterHeaterTraits traits ()=0
 
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 (uint32_t id, uint32_t interval, std::function< void()> &&f)
 Set an interval function with a numeric ID (zero heap allocation).
 
void set_interval (uint32_t interval, std::function< void()> &&f)
 
bool cancel_interval (uint32_t id)
 
void set_retry (uint32_t id, uint32_t initial_wait_time, uint8_t max_attempts, std::function< RetryResult(uint8_t)> &&f, float backoff_increase_factor=1.0f)
 Set a retry function with a numeric ID (zero heap allocation).
 
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 (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 (uint32_t timeout, std::function< void()> &&f)
 
bool cancel_timeout (uint32_t id)
 
void defer (std::function< void()> &&f)
 Defer a callback to the next loop() call.
 

Protected Attributes

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
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("Use const char* or uint32_t overload instead. Removed in 2026.7.0", "2026.1.0") void set_retry(const std voi 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)
 Set an retry function with a unique name.
 
ESPDEPRECATED("Use const char* or uint32_t overload instead. Removed in 2026.7.0", "2026.1.0") bool cancel_retry(const std boo cancel_retry )(const char *name)
 Cancel a retry function.
 
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 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 180 of file water_heater.h.

Member Function Documentation

◆ control()

virtual void esphome::water_heater::WaterHeater::control ( const WaterHeaterCall & call)
pure virtual

◆ dump_traits_()

void esphome::water_heater::WaterHeater::dump_traits_ ( const char * tag)
protected

Log the traits of this water heater for dump_config().

Definition at line 259 of file water_heater.cpp.

◆ get_current_temperature()

float esphome::water_heater::WaterHeater::get_current_temperature ( ) const
inline

Definition at line 183 of file water_heater.h.

◆ get_mode()

WaterHeaterMode esphome::water_heater::WaterHeater::get_mode ( ) const
inline

Definition at line 182 of file water_heater.h.

◆ get_state()

uint32_t esphome::water_heater::WaterHeater::get_state ( ) const
inline

Get the current state flags bitmask.

Definition at line 188 of file water_heater.h.

◆ get_target_temperature()

float esphome::water_heater::WaterHeater::get_target_temperature ( ) const
inline

Definition at line 184 of file water_heater.h.

◆ get_target_temperature_high()

float esphome::water_heater::WaterHeater::get_target_temperature_high ( ) const
inline

Definition at line 186 of file water_heater.h.

◆ get_target_temperature_low()

float esphome::water_heater::WaterHeater::get_target_temperature_low ( ) const
inline

Definition at line 185 of file water_heater.h.

◆ get_traits()

WaterHeaterTraits esphome::water_heater::WaterHeater::get_traits ( )
virtual

Definition at line 210 of file water_heater.cpp.

◆ is_away()

bool esphome::water_heater::WaterHeater::is_away ( ) const
inline

Check if away mode is currently active.

Definition at line 190 of file water_heater.h.

◆ is_on()

bool esphome::water_heater::WaterHeater::is_on ( ) const
inline

Check if the water heater is on.

Definition at line 192 of file water_heater.h.

◆ make_call()

virtual WaterHeaterCallInternal esphome::water_heater::WaterHeater::make_call ( )
pure virtual

◆ publish_state()

void esphome::water_heater::WaterHeater::publish_state ( )
virtual

Definition at line 153 of file water_heater.cpp.

◆ restore_state()

optional< WaterHeaterCall > esphome::water_heater::WaterHeater::restore_state ( )

Definition at line 191 of file water_heater.cpp.

◆ set_current_temperature()

void esphome::water_heater::WaterHeater::set_current_temperature ( float current_temperature)
inline

Definition at line 194 of file water_heater.h.

◆ set_mode_()

void esphome::water_heater::WaterHeater::set_mode_ ( WaterHeaterMode mode)
inlineprotected

Set the mode of the water heater. Should only be called from control().

Definition at line 218 of file water_heater.h.

◆ set_state_()

void esphome::water_heater::WaterHeater::set_state_ ( uint32_t state)
inlineprotected

Set the state flags. Should only be called from control().

Definition at line 230 of file water_heater.h.

◆ set_state_flag_()

void esphome::water_heater::WaterHeater::set_state_flag_ ( uint32_t flag,
bool value )
inlineprotected

Set or clear a state flag. Should only be called from control().

Definition at line 232 of file water_heater.h.

◆ set_target_temperature_()

void esphome::water_heater::WaterHeater::set_target_temperature_ ( float target_temperature)
inlineprotected

Set the target temperature of the water heater. Should only be called from control().

Definition at line 220 of file water_heater.h.

◆ set_target_temperature_high_()

void esphome::water_heater::WaterHeater::set_target_temperature_high_ ( float target_temperature_high)
inlineprotected

Set the high target temperature (for two-point control). Should only be called from control().

Definition at line 226 of file water_heater.h.

◆ set_target_temperature_low_()

void esphome::water_heater::WaterHeater::set_target_temperature_low_ ( float target_temperature_low)
inlineprotected

Set the low target temperature (for two-point control). Should only be called from control().

Definition at line 222 of file water_heater.h.

◆ set_visual_max_temperature_override()

void esphome::water_heater::WaterHeater::set_visual_max_temperature_override ( float max_temperature_override)

Definition at line 230 of file water_heater.cpp.

◆ set_visual_min_temperature_override()

void esphome::water_heater::WaterHeater::set_visual_min_temperature_override ( float min_temperature_override)

Definition at line 227 of file water_heater.cpp.

◆ set_visual_target_temperature_step_override()

void esphome::water_heater::WaterHeater::set_visual_target_temperature_step_override ( float visual_target_temperature_step_override)

Definition at line 233 of file water_heater.cpp.

◆ setup()

void esphome::water_heater::WaterHeater::setup ( )
overridevirtual

Reimplemented from esphome::Component.

Definition at line 149 of file water_heater.cpp.

◆ traits()

virtual WaterHeaterTraits esphome::water_heater::WaterHeater::traits ( )
protectedpure virtual

Field Documentation

◆ current_temperature_

float esphome::water_heater::WaterHeater::current_temperature_ {NAN}
protected

Definition at line 241 of file water_heater.h.

◆ mode_

WaterHeaterMode esphome::water_heater::WaterHeater::mode_ {WATER_HEATER_MODE_OFF}
protected

Definition at line 240 of file water_heater.h.

◆ pref_

ESPPreferenceObject esphome::water_heater::WaterHeater::pref_
protected

Definition at line 253 of file water_heater.h.

◆ state_

uint32_t esphome::water_heater::WaterHeater::state_ {0}
protected

Definition at line 245 of file water_heater.h.

◆ target_temperature_

float esphome::water_heater::WaterHeater::target_temperature_ {NAN}
protected

Definition at line 242 of file water_heater.h.

◆ target_temperature_high_

float esphome::water_heater::WaterHeater::target_temperature_high_ {NAN}
protected

Definition at line 244 of file water_heater.h.

◆ target_temperature_low_

float esphome::water_heater::WaterHeater::target_temperature_low_ {NAN}
protected

Definition at line 243 of file water_heater.h.

◆ visual_max_temperature_override_

float esphome::water_heater::WaterHeater::visual_max_temperature_override_ {NAN}
protected

Definition at line 249 of file water_heater.h.

◆ visual_min_temperature_override_

float esphome::water_heater::WaterHeater::visual_min_temperature_override_ {NAN}
protected

Definition at line 248 of file water_heater.h.

◆ visual_target_temperature_step_override_

float esphome::water_heater::WaterHeater::visual_target_temperature_step_override_ {NAN}
protected

Definition at line 250 of file water_heater.h.


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