background image

 

Software Setup 

1. Install OpenSprinkler Unified Firmware 

The recommended way to install OpenSprinkler Firmware is to start from a standard Raspbian image, make sure you can 
boot RPi correctly, then follow the OSPi firmware installation instructions below to install the firmware yourself: 

OSPi Firmware Installation Instructions

 

NOTE:

 ​

some Raspbian systems installed by NOOBs will take over GPIO 4 for 1-wire interface, but that OSPi needs GPIO 4 

to send control signals to the solenoid valves. If you found that the firmware runs correctly but OSPi does not turn on 
valves correctly, one solution is to sudo open ​

/etc/modules

, and comment out the line containing ​

w1-gpio

, then reboot. 

Another solution is to reinstall Raspbian OS from scratch without using NOOBs.

 

The previous OSPi pre-configured SD card image is retired -- we no longer provide pre-configured SD card image because 
it's relatively easy to install a fresh Raspbian and follow the instructions above to install the OpenSprinkler firmware.

 

2. Using OSPi Firmware 

The default firmware set to run on start-up is the OpenSprinkler Unified Firmware. It’s available at ​port 8080​. Open a 
browser, and type in ​http://ospi_ip:8080/​ to start using the firmware, where ospi_ip is your OSPi's local IP address. Details 
about the OpenSprinkler Unified Firmware can be found in the OpenSprinkler Firmware User Manual: 

OpenSprinkler User Manual

 

The two alternative firmwares are the ​

Python Interval Program​

 (written by Dan Kimberling) and the ​

sprinklers_pi

 program 

(written by Rich Zimmerman). Please refer to their specific Github repositories for installation and usage instructions. 

 

If you want to write your own firmware, use the provided firmwares as starting point. In addition, in the OSPi Github folder, 
there are ​

a few demo programs

 that shows basic solenoid control in various programming languages. 

 
Technical Details 

RPi Pin Uses 

OSPi uses the following GPIO pins on the RPi (shaded in red). The other pins are free. The power pins as well as SDA/SCL 
pins can be shared with other devices. All 40 pins from RPi are mapped out in the pinout area at the upper left corner of 
the circuit board. The layout of the mapped out pins match the GPIO pins. Pins use by OSPi is marked by a white outline. 

Summary of Contents for OSPi

Page 1: ...Attach RPi to OSPi 3 Web Connectivity 5 Zone Expansion Board 6 Rain Sensor Flow Sensor Program Switch 7 Analog Digital Converter Advanced Topic 8 Radio Frequency RF Transmitter Advanced Topic Software Setup 1 Install OpenSprinkler Unified Firmware 2 Using OSPi Firmware Technical Details RPi Pin Uses Specifications Terms and Conditions Open Source Links ...

Page 2: ...t per station transient voltage protector NOTE from version 1 44 the real time clock RTC and battery that were in previous versions have been removed as the firmware never uses these components To get started you will also need the following which are NOT included by default and need to be purchased separately a Raspberry Pi any version a nano size USB WiFi dongle optional if your RPi does not hav...

Page 3: ...o first remove all terminal blocks before assembling the acrylic enclosure In some kits the acrylic pieces may be replaced by 3D printed versions this is due to shortage of acrylic supply that occurred during the COVID 19 pandemic 1 Test Power Supply First Make sure the sprinkler transformer is unplugged to begin with Insert the sprinkler transformer wires into the orange terminal block tighten th...

Page 4: ...ngle You can insert the dongle into any of the available RPi USB ports If you prefer wired connection note that there is no special cutout for the Ethernet cable you can take out one side panel of the laser cut acrylic enclosure or alternatively use a Dremel to make a cutout yourself in order to allow Ethernet cable to pass through If you use RPi 3 or 4 and notice dropped performance of built in W...

Page 5: ...as two wires and is essentially a rain activated switch The OSPi software can decide what to do when rain is detected such as turn off stations or ignore rain The latest OpenSprinkler also supports using the sensor terminal to connect a flow sensor or program switch Please refer to the OpenSprinkler User Manual Sensors Section for details 7 Analog Digital Converter Advanced Topic OSPi has a built ...

Page 6: ...rmware The default firmware set to run on start up is the OpenSprinkler Unified Firmware It s available at port 8080 Open a browser and type in http ospi_ip 8080 to start using the firmware where ospi_ip is your OSPi s local IP address Details about the OpenSprinkler Unified Firmware can be found in the OpenSprinkler Firmware User Manual OpenSprinkler User Manual The two alternative firmwares are ...

Page 7: ... RPi Terms and Conditions OpenSprinkler Pi OSPi is an open source project The hardware design and software code are made publicly available under the Creative Commons Attribution ShareAlike CC BY SA 3 0 license The product is open source for educational purpose and to promote innovations The hardware and software are provided as is We Rayshobby LLC are not responsible for any damage or accident th...

Reviews: