openhab-docs/_addons_bindings/opensprinkler

id	label	title	type	description	since	logo	install
opensprinkler	OpenSprinkler	OpenSprinkler - Bindings	binding	This binding allows allows basic control of the OpenSprinkler and OpenSprinkler PI (Plus) devices. Stations can be controlled to be turned on or off and rain sensor state can be read.	2x	images/addons/opensprinkler.png	auto

{% include base.html %}

OpenSprinkler Binding

This binding allows allows basic control of the OpenSprinkler and OpenSprinkler PI (Plus) devices. Stations can be controlled to be turned on or off and rain sensor state can be read.

Supported Things

• OpenSprinkler using the HTTP API access on the network.
• OpenSprinkler PI (Plus) through the GPIO when openHAB is installed on the same Raspberry Pi used in the OpenSprinkler PI.

Discovery

• OpenSprinkler devices can be manually discovered by sending a request to every IP on the network. Discovery needs to be run manually as this is a brute force method of finding devices that can saturate network or device available bandwidth.

Thing Configuration

OpenSprinkler

opensprinkler:http:1 [ hostname="127.0.0.1", port=80, password="opendoor", refresh=60 ]

• hostname: Hostname or IP address of the OpenSprinkler HTTP API.
• port: Port the OpenSprinkler device is listening on. Usually 80.
• password: Admin password of the API. Factory default is: opendoor
• refresh: Number of seconds in between refreshing the Thing state with the API.

OpenSprinkler PI

opensprinkler:pi:1 [ stations=8, refresh=60 ]

• stations: Number of stations to control.
• refresh: Number of seconds in between refreshing the Thing state with the API.

Channels

The following channels are supported by all devices.

Channel Type ID	Item Type		Description
station01	Switch	RW	This channel indicates whether station 01 is on or off.
station02	Switch	RW	This channel indicates whether station 02 is on or off.
station03	Switch	RW	This channel indicates whether station 03 is on or off.
station04	Switch	RW	This channel indicates whether station 04 is on or off.
station05	Switch	RW	This channel indicates whether station 05 is on or off.
station06	Switch	RW	This channel indicates whether station 06 is on or off.
station07	Switch	RW	This channel indicates whether station 07 is on or off.
station08	Switch	RW	This channel indicates whether station 08 is on or off.
station09	Switch	RW	This channel indicates whether station 09 is on or off.
station10	Switch	RW	This channel indicates whether station 10 is on or off.
station11	Switch	RW	This channel indicates whether station 11 is on or off.
station12	Switch	RW	This channel indicates whether station 12 is on or off.
station13	Switch	RW	This channel indicates whether station 13 is on or off.
station14	Switch	RW	This channel indicates whether station 14 is on or off.
station15	Switch	RW	This channel indicates whether station 15 is on or off.
station16	Switch	RW	This channel indicates whether station 16 is on or off.
station17	Switch	RW	This channel indicates whether station 17 is on or off.
station18	Switch	RW	This channel indicates whether station 18 is on or off.
station19	Switch	RW	This channel indicates whether station 19 is on or off.
station20	Switch	RW	This channel indicates whether station 20 is on or off.
station21	Switch	RW	This channel indicates whether station 21 is on or off.
station22	Switch	RW	This channel indicates whether station 22 is on or off.
station23	Switch	RW	This channel indicates whether station 23 is on or off.
station24	Switch	RW	This channel indicates whether station 24 is on or off.
station25	Switch	RW	This channel indicates whether station 25 is on or off.
station26	Switch	RW	This channel indicates whether station 26 is on or off.
station27	Switch	RW	This channel indicates whether station 27 is on or off.
station28	Switch	RW	This channel indicates whether station 28 is on or off.
station29	Switch	RW	This channel indicates whether station 29 is on or off.
station30	Switch	RW	This channel indicates whether station 30 is on or off.
station31	Switch	RW	This channel indicates whether station 31 is on or off.
station32	Switch	RW	This channel indicates whether station 32 is on or off.
station33	Switch	RW	This channel indicates whether station 33 is on or off.
station34	Switch	RW	This channel indicates whether station 34 is on or off.
station35	Switch	RW	This channel indicates whether station 35 is on or off.
station36	Switch	RW	This channel indicates whether station 36 is on or off.
station37	Switch	RW	This channel indicates whether station 37 is on or off.
station38	Switch	RW	This channel indicates whether station 38 is on or off.
station39	Switch	RW	This channel indicates whether station 39 is on or off.
station40	Switch	RW	This channel indicates whether station 40 is on or off.
station41	Switch	RW	This channel indicates whether station 41 is on or off.
station42	Switch	RW	This channel indicates whether station 42 is on or off.
station43	Switch	RW	This channel indicates whether station 43 is on or off.
station44	Switch	RW	This channel indicates whether station 44 is on or off.
station45	Switch	RW	This channel indicates whether station 45 is on or off.
station46	Switch	RW	This channel indicates whether station 46 is on or off.
station47	Switch	RW	This channel indicates whether station 47 is on or off.
station48	Switch	RW	This channel indicates whether station 48 is on or off.

The following are only support by the OpenSprinkler using the HTTP API interface.

Channel Type ID	Item Type		Description
rainsensor	Switch	RO	This channel indicates whether rain is detected by the device or not.

Full Example

demo.Things:

opensprinkler:http:1 [ hostname="192.168.1.23", port=80, password="opendoor", refresh=60 ]

demo.items:

Group stations
Switch Station01 (stations) { channel="opensprinkler:http:1:station01" }
Switch Station02 (stations) { channel="opensprinkler:http:1:station02" }
Switch Station03 (stations) { channel="opensprinkler:http:1:station03" }
Switch Station04 (stations) { channel="opensprinkler:http:1:station04" }
Switch Station05 (stations) { channel="opensprinkler:http:1:station05" }
Switch Station06 (stations) { channel="opensprinkler:http:1:station06" }
Switch Station07 (stations) { channel="opensprinkler:http:1:station07" }
Switch Station08 (stations) { channel="opensprinkler:http:1:station08" }

Switch RainSensor { channel="opensprinkler:http:1:rainsensor" }

demo.sitemap:

sitemap demo label="Main Menu"
{
    Frame {
        Text item=RainSensor label="Rain [%s]"
        Group item=stations label="Water Stations"
    }
}