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 IDItem TypeDescription
station01SwitchRWThis channel indicates whether station 01 is on or off.
station02SwitchRWThis channel indicates whether station 02 is on or off.
station03SwitchRWThis channel indicates whether station 03 is on or off.
station04SwitchRWThis channel indicates whether station 04 is on or off.
station05SwitchRWThis channel indicates whether station 05 is on or off.
station06SwitchRWThis channel indicates whether station 06 is on or off.
station07SwitchRWThis channel indicates whether station 07 is on or off.
station08SwitchRWThis channel indicates whether station 08 is on or off.
station09SwitchRWThis channel indicates whether station 09 is on or off.
station10SwitchRWThis channel indicates whether station 10 is on or off.
station11SwitchRWThis channel indicates whether station 11 is on or off.
station12SwitchRWThis channel indicates whether station 12 is on or off.
station13SwitchRWThis channel indicates whether station 13 is on or off.
station14SwitchRWThis channel indicates whether station 14 is on or off.
station15SwitchRWThis channel indicates whether station 15 is on or off.
station16SwitchRWThis channel indicates whether station 16 is on or off.
station17SwitchRWThis channel indicates whether station 17 is on or off.
station18SwitchRWThis channel indicates whether station 18 is on or off.
station19SwitchRWThis channel indicates whether station 19 is on or off.
station20SwitchRWThis channel indicates whether station 20 is on or off.
station21SwitchRWThis channel indicates whether station 21 is on or off.
station22SwitchRWThis channel indicates whether station 22 is on or off.
station23SwitchRWThis channel indicates whether station 23 is on or off.
station24SwitchRWThis channel indicates whether station 24 is on or off.
station25SwitchRWThis channel indicates whether station 25 is on or off.
station26SwitchRWThis channel indicates whether station 26 is on or off.
station27SwitchRWThis channel indicates whether station 27 is on or off.
station28SwitchRWThis channel indicates whether station 28 is on or off.
station29SwitchRWThis channel indicates whether station 29 is on or off.
station30SwitchRWThis channel indicates whether station 30 is on or off.
station31SwitchRWThis channel indicates whether station 31 is on or off.
station32SwitchRWThis channel indicates whether station 32 is on or off.
station33SwitchRWThis channel indicates whether station 33 is on or off.
station34SwitchRWThis channel indicates whether station 34 is on or off.
station35SwitchRWThis channel indicates whether station 35 is on or off.
station36SwitchRWThis channel indicates whether station 36 is on or off.
station37SwitchRWThis channel indicates whether station 37 is on or off.
station38SwitchRWThis channel indicates whether station 38 is on or off.
station39SwitchRWThis channel indicates whether station 39 is on or off.
station40SwitchRWThis channel indicates whether station 40 is on or off.
station41SwitchRWThis channel indicates whether station 41 is on or off.
station42SwitchRWThis channel indicates whether station 42 is on or off.
station43SwitchRWThis channel indicates whether station 43 is on or off.
station44SwitchRWThis channel indicates whether station 44 is on or off.
station45SwitchRWThis channel indicates whether station 45 is on or off.
station46SwitchRWThis channel indicates whether station 46 is on or off.
station47SwitchRWThis channel indicates whether station 47 is on or off.
station48SwitchRWThis channel indicates whether station 48 is on or off.

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

Channel Type IDItem TypeDescription
rainsensorSwitchROThis channel indicates whether rain is detected by the device or not.

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"
    }
}