Water Heater Entity



Properties should always only return information from memory and not do I/O (like network requests). Implement update() or async_update() to fetch data.

min_tempfloat110°FThe minimum temperature that can be set.
max_tempfloat140°FThe maximum temperature that can be set.
temperaturefloatnoneThe current temperature in °C or °F.
operation_modestringnoneThe current operation mode.
operation_listlistnoneList of possible operation modes.
away_modestringnoneThe current status of away mode. (on, off)

The allowed operation modes are specified in the base component and implementations of the water_heater component cannot differ.

Properties have to follow the units defined in the unit_system.


STATE_ECOEnergy efficient mode, provides energy savings and fast heating.
STATE_ELECTRICElectric only mode, uses the most energy.
STATE_PERFORMANCEHigh performance mode.
STATE_HIGH_DEMANDMeet high demands when water heater is undersized.
STATE_HEAT_PUMPSlowest to heat, but uses less energy.
STATE_GASGas only mode, uses the most energy.
STATE_OFFThe water heater is off.


set_temperature or async_set_temperature

Sets the temperature the water heater should heat water to.

set_operation_modeor async_set_operation_mode

Sets the operation mode of the water heater. Must be in the operation_list.

turn_away_mode_on or async_turn_away_mode_on

Set the water heater to away mode.

turn_away_mode_off or async_turn_away_mode_off

Set the water heater back to the previous operation mode. Turn off away mode.

Last updated on