OpenSprinkler v3 - User Manual

OpenSprinkler User Manual
Firmware 2.1.9(9) (Sep 4, 2021)
Contents
Introduction
What's New in this Firmware?
Hardware Interface
Zone Wire Connection Diagrams
Installation
LCD and Button Functions
Firmware 2.1.9 User Manual
1. Overview
2. Accessing the Controller
3. Homepage
3.1 Device Status
3.2 Zone Attributes
4. Menu Buttons
4.1 Rain Delay
4.2 Stop All Zones or an Individual Zone
5. Edit Options
6. Run-Once Program
7. Programs
7.1 Program Data
7.2 Program Preview
7.3 Zone's Sequential Attribute
8. Logging
9. Firmware Update, FAQ, Support, and Github
Advanced Topics
1. Installing Radio Frequency (RF) Transmitter
Specifications
OpenSprinkler Firmware 2.1.9 User Manual 1

Summary

Introduction

Whats New in this Firmware?

Hardware Interface

Zone Wire Connection Diagrams

Installation

Setting Up Ethernet or WiFi

Reset WiFi; Password Reset; Factory Reset

Procedures for resetting WiFi settings, device password, or performing a full factory reset using controller buttons.

LCD and Button Functions

Overview

Accessing the Controller

Homepage

Device Status

Details the status bar at the footer, showing system, running stations, or rain delay status.

Zone Attributes

Explains how to configure station names, master zones, rain/sensor bypass, and sequential attributes for each zone.

Menu Buttons

Rain Delay

Instructions on how to manually set or cancel a rain delay time for all zones.

Stop All Zones or an Individual Zone

How to stop all currently running zones or select individual zones to stop from the homepage.

Edit Options

Configure Master

Configuration for master stations, including on/off adjustments and defining pump station behavior.

Station Handling

Settings for number of stations, and station delay between consecutive zone activations.

Weather and Sensors

Configuration for weather adjustment methods, restrictions, % watering, and sensor types (Rain, Soil, Flow).

Integrations: MQTT notifications

Integrations: IFTTT notifications

Advanced Settings

Wunderground Key

API key for using Wunderground as a weather data source, with verification and PWS location setup.

HTTP Port

Customizing the device's HTTP port number, with default set to 80.

Boost Time

DC-powered specific setting to increase boost time for energizing 24VAC sprinkler valves.

Special Station Auto-Refresh

Periodic auto-refresh setting for special stations like RF, remote, or HTTP stations.

NTP Sync

Automatic time synchronization using NTP servers, with manual device time setting option.

NTP IP Address

Option to set a custom NTP time-sync server address.

Use DHCP

Enabling or disabling DHCP for dynamic or static IP assignment, with recommendations for reservation.

Reset

Clear Log Data

Clears all logged data from the controller.

Reset All Options

Restores all controller options and settings back to factory defaults.

Reset All Station Data

Restores all station names and settings to factory defaults.

Reset Wireless Settings

Resets wireless settings to put the OpenSprinkler v3 controller into WiFi AP mode.

Run-Once Program

Programs

Program Data

Details on setting up program name, enablement, weather adjustment, start times, and program types.

Station Water Times

Setting water duration for each station, with support for precise seconds and sunrise/sunset durations.

Additional Start Times

Configuring fixed or repeating additional start times for programs to break down watering cycles.

Program Preview

Zones Sequential Attribute

Logging

Firmware Update, FAQ, Support, and Github

Advanced Topics

Installing Radio Frequency (RF) Transmitter

Instructions for installing and using RF transmitters to control powerline devices remotely.

Specifications

Overview

1. Function Description
2. Important Technical Specifications
3. Usage Features
4. Maintenance Features
5. Installation Notes

The OpenSprinkler is an open-source, web-based sprinkler/irrigation controller designed as a modern replacement for conventional sprinkler controllers lacking web connectivity. It offers an intuitive user interface, remote access, and smart weather-based watering control, making it suitable for homeowners and businesses for various irrigation needs, including lawn/garden watering, plant irrigation, drip irrigation, and hydroponics.

Function Description:

The OpenSprinkler controller manages irrigation schedules based on user-defined programs and can incorporate smart weather-based adjustments. It supports multiple zones, which can be expanded using zone expanders. The device offers various ways to access and control it, including a web interface accessible via desktop or mobile browsers, and a dedicated mobile app. It supports different hardware versions (v3, 2.3, and Pi), each with specific power requirements and connectivity options (WiFi, wired Ethernet). The controller can handle both AC-powered and DC-powered sprinkler valves, with a specialized LATCH version for latching solenoid valves.

Important Technical Specifications:

• Hardware Versions: OpenSprinkler v3 (built-in WiFi, optional wired Ethernet), OpenSprinkler 2.3 (wired Ethernet only), OpenSprinkler Pi (driven by Raspberry Pi).
• Input Voltage:
  • AC-powered versions (v3.x and OSPi): 22-28V AC
  • DC-powered and LATCH versions (v3.x): 7.5-12V DC
• Power Consumption: 1-1.5 Watt
• Number of Zones:
  • Main controller: 8 zones
  • Expandable up to 72 zones (v3.x and 2.3)
  • Expandable up to 200 zones (OSPi)
• Max Output Current:
  • AC: 800mA continuous per zone
  • DC: 2A continuous per zone
• Over-voltage Protection: Bi-directional TVS on each zone, power input, and sensor terminal.
• Product Size:
  • OpenSprinkler v3.x: 140mm x 68mm x 34mm
  • OpenSprinkler 2.3: 135mm x 105mm x 30mm
  • OpenSprinkler Pi: 135mm x 105mm x 38mm
• Product Weight:
  • OpenSprinkler v3.x: 140g
  • OpenSprinkler 2.3: 250g
  • OpenSprinkler Pi: 200g
• Expander Size: 130mm x 75mm x 25mm
• Expander Weight: 100g
• Connectivity:
  • OpenSprinkler v3: WiFi (AP and Station modes), optional wired Ethernet module (from v3.2).
  • OpenSprinkler 2.3: Wired Ethernet.
• Default Device Password: opendoor

Usage Features:

• User Interface: Web-based interface and mobile app for configuration and control.
• Zone Management:
  • Customizable station names (up to 32 characters).
  • Ability to define master zones that activate with other zones.
  • Options to ignore rain delay, Sensor1, or Sensor2 for specific zones.
  • Disable zones to prevent them from running and hide them from the UI.
  • Sequential attribute for zones to run one after another, conserving water pressure.
  • Support for "Virtual Zones" including RF zones (for controlling remote power sockets), Remote zones (controlling other OpenSprinklers), GPIO zones (switching spare GPIO pins), and HTTP zones (triggering HTTP GET commands).
• Program Scheduling:
  • Supports up to 40 programs.
  • Program types: Weekly (selected weekdays) or Interval Day (every N days).
  • Restrictions: Odd/Even day restrictions.
  • Customizable start times, including sunrise/sunset offsets.
  • Additional start times: Fixed (up to 3) or Repeating (at regular intervals, can span overnight).
  • "Run-Once Program" for manual, temporary irrigation, ignoring rain delay and sensor settings.
  • Program Preview to visualize schedules.
• Weather-Based Adjustments:
  • Various weather adjustment methods (e.g., Manual, Evapotranspiration) to scale watering times.
  • Weather-based restrictions (e.g., California Restriction to prevent watering if rain has accumulated).
  • Global % Watering factor.
• Sensor Support:
  • Supports Rain, Soil (digital output), Flow, or Program Switch sensors.
  • OpenSprinkler v3 supports two independent sensors (SN1 and SN2).
  • Configurable delayed on/off times for sensors to prevent false triggers.
  • Flow sensor integration for real-time flow rate display and logging, supporting dry-contact 2-wire and 3-wire 5V sensors.
• Master Station Control:
  • Supports up to 2 independent master stations.
  • Adjustable Master On/Off Adjustment times (0 to 600 seconds for on, -600 to 0 seconds for off).
• Station Handling:
  • Configurable delay time between consecutive stations (-600 to 600 seconds).
• Time Synchronization:
  • Automatic time-sync using NTP servers based on location.
  • Manual time zone setting if NTP sync is disabled.
• Network Configuration:
  • DHCP by default, with option for static IP assignment.
  • Customizable HTTP port.
• RF Transmitter Integration: Supports 434MHz or 315MHz RF transmitters to control powerline devices (lights, heaters, pumps) via RF zones. Requires an RFtoy for signal code decoding.

Maintenance Features:

• Firmware Updates: Instructions and resources available on the OpenSprinkler website and Github.
• Logging: Stores zone runs, rain delay, sensor status changes, and watering percentage changes. Logs can be viewed graphically or in a table format.
• Factory Reset:
  • Reset WiFi settings (to AP mode) without erasing program settings.
  • Reset device password if forgotten (requires physical button sequence).
  • Full factory reset to restore all options to default settings (requires physical button sequence).
  • Clear log data.
  • Reset all station data (names and settings).
• Configuration Backup/Restore: Export/Import Configuration feature to save and restore controller settings and programs, useful before firmware upgrades or factory resets.
• System Diagnostics: Displays diagnostic information including last reboot timestamp and cause, weather call details, and response codes.
• Support: Access to FAQs, support tickets, and Github repository for source code and hardware design files.
• Notifications: Supports MQTT and IFTTT notifications.

Installation Notes:

• The device is NOT waterproof and requires a waterproof enclosure for outdoor use.
• Wiring diagrams are provided for connecting zone wires, including common (COM) wires and individual zone ports.
• Zone expanders can be linked to increase the number of controlled zones, requiring unique DIP switch indices for v3.x.
• For OpenSprinkler v3, the wired Ethernet module is an add-on and changes the boot mode between WiFi and wired Ethernet.
• Sensors should be connected between SN1/SN2 and GND, NOT COM, to prevent damage.
• International customers should ensure a compatible 24VAC transformer for AC-powered versions or consider the DC-powered version.

OpenSprinkler v3 Specifications

General

Brand	OpenSprinkler
Model	v3
Category	Irrigation System
Language	English