homebridge-opensprinkler-system
v1.0.1
Published
Control OpenSprinkler with Homebridge
Downloads
5
Readme
This is based off of the homebridge-opensprinkler plugin originally created by Tim Charper used under the ISC license.
OpenSprinkler
"Hey Siri, turn off my sprinklers."
"Hey Siri, are the Back Patio sprinklers on?"
Overview
Simple OpenSprinkler / Homebridge integration.
What works:
- Read and set rain delay
- Automatically update changes in state
- Show sprinkler state: idle, scheduled, running
- Show remaining duration
- Turn off sprinklers
- Ad-hoc turn on a single valve at a time.
- Allow duration to be specified per-station when enabled
What doesn't work:
- Starting multiple programs in sequence (turning on multiple stations causes them to run concurrently)
- Persisting Home-configured station-specific default durations after restart
- Does not support multiple OpenSprinkler systems
Installation
You must have NodeJS v10.17.0
or later. Check your node version:
node --version
You need Homebridge installed and configured. This plugin was developed against Homebridge 1.0.0
.
npm install -g homebridge
Install this plug-in:
npm install -g homebridge-opensprinkler-system
Updating:
npm update -g homebridge-opensprinkler-system
Add the section below to your homebridge platforms
section.
Configuration
host
: The IP or DNS name of the OpenSprinkler controllerpassword
: Either the md5 hash of the password, or the password in plain text. I.E.{"md5": "a6d82bced638de3def1e9bbb4983225c"}
or{"plain": "opendoor"}
defaultDurationSecs
: The duration for which a station will be run when toggled on.pollIntervalMs
: The interval at which homebridge-opensprinkler will poll for state changes in OpenSprinkler.
Sample configuration:
{
"platform": "OpenSprinkler",
"host": "sprinkler.lan",
"password": {"md5": "a6d82bced638de3def1e9bbb4983225c"},
"defaultDurationSecs": 600,
"pollIntervalMs": 5000
}