developers.home-assistant/docs/entity_water_heater.md

1.8 KiB

title sidebar_label
Water Heater Entity Water Heater

Properties

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

Name Type Default Description
min_temp float 110°F The minimum temperature that can be set.
max_temp float 140°F The maximum temperature that can be set.
temperature float none The current temperature in °C or °F.
operation_mode string none The current operation mode.
operation_list list none List of possible operation modes.
away_mode string none The 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.

States

State Description
STATE_ECO Energy efficient mode, provides energy savings and fast heating.
STATE_ELECTRIC Electric only mode, uses the most energy.
STATE_PERFORMANCE High performance mode.
STATE_HIGH_DEMAND Meet high demands when water heater is undersized.
STATE_HEAT_PUMP Slowest to heat, but uses less energy.
STATE_GAS Gas only mode, uses the most energy.
STATE_OFF The water heater is off.

Methods

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.