Water Valves - jvmahon/Homebridge-HomeSeer4 GitHub Wiki

Valves

Support for simple water valves has been added. To add a valve, put an entry of the following form in your config.json

 {"type":"Valve", "ref":123, "openValve":255, "closeValve":0}

where "ref" specifies the HomeSeer reference controlling the valve. The "openValve" and "closeValve" parameters are optional and do not need to be specified if your device uses the 'typical' values of 255 for open, 0 for closed.

You may also include an optional "valveType" parameter which takes a value 0, 1, 2, or 3. 0= Generic, 1=Irrigation, 2=Shower Head, 3=Water Faucet. As of iOS 11.3, the only effect is that a setting of 1 will change the Icon displayed in the Home app. All other settings use the same icon.

The "Valve" type has also been enhanced to allow use of timers ("useTimer":"true"). A user can set the valve open time on the valve's details' page which is displayed in the iOS Home application. The default minimum time is 30 seconds. The default minimum can be changed in the config.json file using parameter minTime:30. After the valve is opened, the remaining duration will display in the iOS Home app. As of iOS 11.3, there apepars to be a bug which causes the remaining time displayed to 'reset' if the phone screen has been locked and then unlocked. Though the displayed time resets, the actual countdown appears to continue as expected. This appears to be an iOS Home app. bug rather than a plugin bug.

Here's how the valve setup looks if you configure all parameters:

{
	"type": "Valve",
	"name":"Back Yard Water Faucet",
	"ref": 0,
	"valveType": 1,	
	"openValve": 255,
	"closeValve": 0,
	"useTimer": true,
	"minTime": 30
}