Skip to content

Water Valves

jvmahon edited this page Oct 13, 2019 · 1 revision

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
}

Home

Installation

I've deleted most of my "old" installation instructions that used to be here. Homebridge has updated their instructions and they are now more comprehensive than what I had. Just follow their instructions: https://www.npmjs.com/package/homebridge

And be sure to use config-ui-x. Its really great for setting up the plugin.

Configuring Devices

These instructions are now a bit out of date. You can follow them to set up the plugin, but there is now a settings interface in config-ui-x which makes it much easier.

FAQs

Why won't my device names change after I edit them in config.json

Miscellaneous

Clone this wiki locally