Water Valve

A HomeKit water valve.

Type	Device Type
20	Water Value

Example

{
  "c": {
    "b": [{ "g": 0, "t": 5 }]
  },
  "a": [{
    "t": 20,
    "f0": [{ "g": 0, "t": 1 }],
    "f1": [{ "g": 0, "t": 2 }],
  }]
}

This is an example of a water valve... ???

Sensor Type

Type	Name	Description
0	Water Valve	(default)
1	Sprinkler
2	Shower
3	Tap / Faucet

A variety of one-wire sensors are available and supported by HAA.

Actions

Name	Action	Description
"0"	OFF	(default)
"1"	ON

A water valve has two actions. The digital output array "r": [{}] for each should be configured to attain the desired state.

Accessory Notifications

The list of notifications supported by a water valve are as follows:

Value	Notification
0	Valve OFF (default)
1	Valve ON

Accessory notifications can be included as part of an action definition. When an action occurs any one of the above notifications can be sent to another accessory using the "m" option within the action object.

See the general Accessory Notifications section for details of how to configure these notifications.

Initial State

Name	State	Description
"s"	0	OFF (default)
	1	ON
	4	Defined by fixed state inputs
	5	Last state before restart
	6	Opposite to last state before restart

The initial state that a water valve enters on boot can be set using the "s" option.

Maximum Use Time

Name	State	Description
"d"	0	Timer disabled
	3600	Timer set to 1 hour (default)
	1 to ∞	Time in seconds to set the use time

This option limits the maximum amount of time that the water valve can be in the ON state. The default is to limit the valve on time to 3,600 seconds (1 hour), but this time period can be disabled, lengthened or shortened.

When the timer is enabled then the valve will be turned OFF after the maximum use time has elapsed.

State Inputs

Name	Event
"f0"	Valve Off event
"f1"	Valve On event

Additionally an accessory can have button(s) or digital input(s) associated with a specific state. When a specific state occurs then a fixed HomeKit event is triggered.

Refer to State Inputs for more detail and examples.

See Digital Inputs Array for details on how to define this option.

Inching

Name	Value	Description
"i"	0.02 to very large	The time in seconds to wait

See Inching for details of this option.