openhab-docs/_bindings/opensprinkler1/readme.md

---
id: opensprinkler
label: OpenSprinkler
title: OpenSprinkler - Bindings
type: binding
description: "This binding is compatible with with both the [OpenSprinkler](http://opensprinkler.com) and [OpenSprinkler Pi](http://pi.opensprinkler.com) hardware. In other words, this binding supports communicating to the OpenSprinkler and OpenSprinkler Pi using HTTP (as long as you have the interval program installed), or directly via GPIO when using the OpenSprinkler Pi."
source: https://github.com/openhab/openhab1-addons/blob/master/bundles/binding/org.openhab.binding.opensprinkler/README.md
since: 1x
logo: images/addons/opensprinkler.png
install: manual
---

<!-- Attention authors: Do not edit directly. Please add your changes to the appropriate source repository -->

{% include base.html %}

# OpenSprinkler Binding

This binding is compatible with with both the [OpenSprinkler](http://opensprinkler.com) and [OpenSprinkler Pi](http://pi.opensprinkler.com) hardware. In other words, this binding supports communicating to the OpenSprinkler and OpenSprinkler Pi using HTTP (as long as you have the interval program installed), or directly via GPIO when using the OpenSprinkler Pi.

[![OpenSprinkler](http://img.youtube.com/vi/lT0uxFlwu9s/hqdefault.jpg)](https://www.youtube.com/watch?v=lT0uxFlwu9s)

The binding will sync itself with the OpenSprinkler device at intervals. This allows state of the stations to be updated if they are manually controlled from the OpenSprinkler web application directly.

There is also a binding specifically for openHAB 2 [here](http://docs.openhab.org/addons/bindings/opensprinkler/readme.html).

## Prerequisites

This binding appears to require you to run openHAB as the `root` user; otherwise you get the error `wiringPiSetup: Must be root.`  You might be able to add the `openhab` user to the `gpio` group, reboot, and try again.

## Binding Configuration

OpenSprinkler stations are numbered 0 through 7 for the default number of stations, but for some users of the OpenSprinkler and OpenSprinkler Pi, they will have extension boards in use. This requires that the binding configuration be edited to specify how many stations are available (by default there are 8, so if you are not using an extension board then you don't need to do this step).

Additionally, if you are wanting to connect via HTTP to your OpenSprinkler (most probably because you have the original version), you will need to specify the URL and password to access the interval program server. Note that by connecting openHAB to the interval program, you will be disabling any timers and forcing it into manual mode. Refer to the example below to see what you need to include in your configuration.

This binding can be configured in the file `services/openSprinkler.cfg`.

| Property | Default | Required | Description |
|----------|---------|:--------:|-------------|
| mode     | gpio    |    No    | The type of OpenSprinkler connection to make. There are two valid options:<br/>`gpio`: this mode is only applicable when running openHAB on a Raspberry Pi which is connected directly to an OpenSprinkler Pi. In this mode the communication is directly over the GPIO pins of the Raspberry Pi.<br/>`http`: this mode is applicable to both OpenSprinkler and OpenSprinkler Pi, as long as they are running the interval program. Realistically though, if you have an OpenSprinkler Pi, it makes more sense to directly connect via `gpio` mode. |
| password | opendoor |   No    | if the `http` mode is used, you need to specify the URL of the internal program, and the password to access it. By default the password is 'opendoor'. |
| httpUrl  |          | if `mode` is `http` | For example, `http://localhost:8080/` |
| httpPassword |      | if `mode` is `http` | For example, `opendoor` |
| numberOfStations | 8 |  No    | the number of stations available. By default this is 8, but for each expansion board installed, this number can be incremented by 8. |
| refreshInterval | 60000 | No  | the number of milliseconds between checks of the Open Sprinkler device |


## Item Configuration

In order to switch a station open or shut using the binding, you must firstly define a switch item in your items file. The syntax (by way of example) of the item configuration is shown below:

```
/* Sprinklers */
Switch Sprinkler_Station_0  "Station 0" { openSprinkler="0" }
Switch Sprinkler_Station_1  "Station 1" { openSprinkler="1" }

/* Rain Sensor (New in 1.6+) */
Contact Sprinkler_Rain_Sensor  "Rain [MAP(rainsensor.map):%s]" { openSprinkler="rs" }
```

You can see in this example that two stations are exposed as items. The first station exposed is the 0th port (i.e. the left-most pin on the OpenSprinkler Pi), and the second station is the 1st port (the second-to-left-most pin on the OpenSprinkler Pi). Note that there is no requirement to use the stations in order - you can open and close any station.

The rainsensor example allows users to see if rain is detected or not by the OpenSprinkler hardware (only supported in HTTP mode).

### transform/rainsensor.map

```
CLOSED=Not Detected
OPEN=Detected
-=Unknown
```