OpenSprinkler Pi (OSPi) Pre-Configured SD Card

May 31, 2015 (with OpenSprinkler Unified Firmware)

OpenSprinkler Pi (OSPi) is a sprinkler / irrigation extension board for Raspberry Pi. This page includes instructions to get you started using the OSPi software.

If you are reading this page, congratulations, you've successfully installed the pre-configured SD card. For ssh and logging in, the system uses the default raspbian user name pi and password raspberry.

Configuration

This SD card image is based on the latest Raspbian image. At first use, please configured the following items:


Running the OpenSprinkler Unified Firmware

The OpenSprinkler Unified Firmware is the default firmware set to run on start-up. It provides a rich set of features including weather integration. The web interface is on port 8080 of your Raspberry Pi's IP address. To access the web interface, open a browser, and type in http://ospi_ip:8080 (where ospi_ip is your Raspberry Pi's IP address). The default password for the interval program is opendoor. To change settings or modifying sprinkler schedules, the program requires the same password. Note that this is different from the Raspberry Pi's log in user name and password.

(Additional Info): the unified firmware and source code are installed in folder ~/OpenSprinklerGen2. When a new firmware becomes available (or if you need to re-install the firmware), you can go to that folder, and run the following two commands:

Additional information can be found on the firmware's Github page.

OpenSprinkler Mobile App

The OpenSprinkler mobile app (written by Samer Albahra) is available on all major mobile platforms (iOS, Android, Windows Mobile, Kindle, Firefox OS etc.). Search opensprinkler in your mobile device's app store, and you should be able to find and install the app.


Alternative Firmware: Python Interval Program

The OpenSprinkler Interval Program version 2 is an alternative, Python-based firmware , written by Jonathan Marsh and Dan Kimberling. It comes with plug-in architecture which makes it easy to extend.

(Before Proceeding): because the Python Interval Program by default uses port 8080, which conflicts with the Unified Firmware, you need to uninstall / remove the Unified Firmware by running the following:

Then install the Python Interval Program by following instructions on the Wiki page here, and set it to run automatically on start-up. After installation, you can run the Python Interval Program by opening a browser and typing in http://ospi_ip:8080 (where ospi_ip is your Raspberry Pi's IP address).


Alternative Firmware: the sprinklers_pi Program

The sprinklers_pi program is another alternative firmware written by Rich Zimmerman. It provides an integrated mobile web page and built-in weather feature.

(Before Proceeding): because the Python Interval Program by default uses port 8080, which conflicts with the Unified Firmware, you need to uninstall / remove the Unified Firmware by running the following:

Similarly, if you have installed the Python Interval Program, which uses the same port, you need to uninstall / remove that by running:

Then install the sprinklers_pi program by following instructions on Rich's github page here. Note that by default the program uses the first station as a master / pump station.


OSPi Demo

In the /home/pi/demo folder, there is a self-test program, useful for diagnosing sprinkler connection problems. Please follow the README.txt in that folder for instructions.

Another demo is a feature program that makes use of the Google Calendar for scheduling sprinkler events. This requires installing the Google API Python library, and obtaining a Google API key. For details, please visit the Rayshobby Github page.


Thank you again. Questions, comments, and suggestions should be directed to the OpenSprinkler Forum.