Valve - Spook 👻 a scary powerful toolbox for Home Assistant.

The valve integration is how Home Assistant controls water, gas and irrigation valves.

Home Assistant can set a valve to a position, but not a bit further. Spook adds the step, the same way it does for covers.

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:

Move a valve a step further open, stopping at fully open.

Action properties
Action	Valve: Increase position 👻
Action name	`valve.increase_position`
Action targets	Yes, `valve` entities that can be set to a position
Action response	No response
Spook's influence	Added action
Tools	Try this action

Action data parameters
Attribute	Type	Required	Default / Example
`step`	integer	No	`10`

Example action in YAML

1
2
3
4
5
action: valve.increase_position
target:
  entity_id: valve.garden_irrigation
data:
  step: 20

Move a valve a step further closed, stopping at fully closed.

Action properties
Action	Valve: Decrease position 👻
Action name	`valve.decrease_position`
Action targets	Yes, `valve` entities that can be set to a position
Action response	No response
Spook's influence	Added action
Tools	Try this action

Action data parameters
Attribute	Type	Required	Default / Example
`step`	integer	No	`10`

Example action in YAML

1
2
3
action: valve.decrease_position
target:
  entity_id: valve.garden_irrigation

Both actions work the same way:

Positions are whole percentages, from 0 for fully closed to 100 for fully open, the same as Home Assistant’s own.
The step is the one you give, or ten percent. A valve does not say how far one step is, the way a thermostat does.
A step that would go past fully open or fully closed stops there.

Known limitations

A valve that can only open and close, like most shutoff valves, cannot be targeted. There is no position to step.
A valve that has not reported a position yet is left alone.

Spook has no repair detections for this integration.