Water heater - Spook 👻 a scary powerful toolbox for Home Assistant.

The water heater integration is how Home Assistant controls boilers, heat pump water heaters and other things that keep water hot.

Home Assistant can set a water heater to a temperature, but not turn it up a step. Spook adds the step, the same way it does for thermostats.

Devices & entities¶

Spook does not provide any new devices or entities for this integration.

Spook adds the following new actions to your Home Assistant instance:

Turn up a water heater’s setpoint a step, within the limits it reports.

Action properties
Action	Water heater: Increase temperature 👻
Action name	`water_heater.increase_temperature`
Action targets	Yes, `water_heater` entities with a setpoint
Action response	No response
Spook's influence	Added action
Tools	Try this action

Action data parameters
Attribute	Type	Required	Default / Example
`step`	float	No	The water heater’s own step

Example action in YAML

1
2
3
4
5
action: water_heater.increase_temperature
target:
  entity_id: water_heater.boiler
data:
  step: 2

Turn down a water heater’s setpoint a step, within the limits it reports.

Action properties
Action	Water heater: Decrease temperature 👻
Action name	`water_heater.decrease_temperature`
Action targets	Yes, `water_heater` entities with a setpoint
Action response	No response
Spook's influence	Added action
Tools	Try this action

Action data parameters
Attribute	Type	Required	Default / Example
`step`	float	No	The water heater’s own step

Example action in YAML

1
2
3
action: water_heater.decrease_temperature
target:
  entity_id: water_heater.boiler

Both actions work the same way:

The step is the one you give, in Home Assistant’s unit, or the water heater’s own step, or half a degree (one degree in Fahrenheit) when it has none, the same fallback the Home Assistant interface uses.
The setpoint stays within the minimum and maximum the water heater reports. A step that would cross one stops at it.
Everything is worked out in the water heater’s own unit, so one in Fahrenheit is stepped in whole Fahrenheit degrees and meets its own limits exactly.
Adjusting is not switching. A water heater that is off gets its setpoint moved and stays off.

Known limitations

A water heater without a setpoint, like one that can only be switched on and off, cannot be targeted.
A water heater that has not reported a setpoint yet is left alone.
A setpoint already past one of the water heater’s own limits, which some integrations report, is left where it is rather than pulled back.

Spook has no repair detections for this integration.