Irrigation Control Guide

Important Information

• OpenSprinkler needs to be using firmware version 2.1.9 (9), 2.1.9 (10), 2.1.9 (11) or 2.2.0 (1). New OpenSprinkler are shipped with the most recent firmware, so a firmware revert might be required. Please see the “Guides” section below for instructions on how to change the OpenSprinkler firmware. 
• If you have schedules that you don't want to lose then you should back up your data before adding a new irrigation schedule through AROYA. This is done in the OpenSprinkler user interface.
• AROYA integration only supports the Standard station type in OpenSprinkler.
• We recommend having a static IP setup in your facility.
• Multiple OpenSprinkler devices can be connected to a single Gateway, but an OpenSprinkler may be connected to at most one Gateway
• A user should not add the same controller multiple times to a single facility or multiple facilities. Please delete a controller if you plan to move it, and then add it again in the new location.
• We recommend users use WiFi instead of ethernet if possible due to OpenSprinkler ethernet incompatibility with certain routers.

If OpenSprinkler is Not Installed at Your Facility

Facility Information

• If an OpenSprinkler disconnects from the gateway it will continue running the most recently added irrigation schedules. The schedules will be updated the next time the user connects their OpenSprinkler to the gateway.
• If you don't use a static IP then you may experience random disconnects from the OpenSprinkler with your network.
• If users have alerts enabled for their account then they will receive text messages when their OpenSprinkler has lost connection and if an unexpected irrigation event has occurred. If alerts are disabled for the facility then the user should reach out to AROYA customer support to have these turned back on. 

Connecting OpenSprinkler

• The default OpenSprinkler port is 80.
• Users should be careful which ports they use. They should check online for available ports. It may be difficult to find something that works under the number 1000 besides 80.
• Certain ethernet traffic can cause loss of connectivity. This is a known bug with OpenSprinkler ethernet drivers. Work-arounds include upgrading to the latest version of supported firmware, using WiFi, changing network switch models/brands, and segmenting network traffic to limit what the OpenSprinkler sees (by putting it behind a different router or using a VLAN to only send required traffic to the OpenSprinkler). Any work-around will require that the Gateway can access the OpenSprinkler and that the Gateway can still connect to the Internet. 
• If the wrong hostname/IP, port, or password is entered when trying to connect to an OpenSprinkler, the controller will attempt to connect up to 3 times. If it fails after that, we try to connect again once every 15 minutes. 

If OpenSprinkler is Already Installed at Your Facility

AROYA Behavior

• When the first irrigation schedule is pushed to the OpenSprinkler, AROYA will remove all of the preexisting irrigation schedules from the OpenSprinkler. If you have schedules that you don't want to lose then you should back up your data before adding a new irrigation schedule through AROYA.
• If the last communicated status shows an amount of time and error then this is showing that we have a connection with the gateway. However, the gateway is no longer connected with the OpenSprinkler
• If a user opens the OpenSprinkler UI they are able to update the station types of their channels. The default station type is Standard. AROYA integration only supports the Standard station type. Any other selection may have unpredictable consequences. Some selections require unsupported third party hardware.
• If an OpenSprinkler is disconnected when a schedule should have been pushed then the user needs to go push a new schedule. This can be done by pausing and/or pushing play on a schedule (preferably a schedule not currently running so that your irrigation isn't interrupted)
• If an irrigation controller is disconnected either during or before a change was made to the channels then the user should wait up to 2 minutes after the controller is reconnected before attempting to make additional changes. It can take up to 2 minutes for AROYA and the OpenSprinkler controller to sync back up with each other in relation to what each channel was set to.
• If an OpenSprinkler is set up to run schedules sequentially, no more than one zone can be open at once. Schedules will be staggered automatically to achieve this. 
• It takes about 15 minutes to receive a text message alert when something has gone wrong.

Expansions

• When plugging in or unplugging expansions, the user should unplug the OpenSprinkler from power before proceeding
• When using expansions, make sure to flip the pins on the back to the corresponding expansion numbers so that the OpenSprinkler recognizes the appropriate number of channels (24 ports for single expansion). Having the pins in the incorrect order will result in the expansions not being recognized.
• Rooms/Zones in a channel can't be individually unassigned after an expansion is disconnected. Users can unassign all of their channels for a disconnected expansion through the controller setup module.
• Schedules can be created in AROYA for disconnected expansions, however, they will be stuck in a pending status forever. Reconnecting the expansion will not fix the problem. Any schedules created for a zone that had a disconnected channel must be deleted and recreated in order for it to successfully be sent to the OpenSprinkler

A Note About Timezone Sync

• NTP must be disabled for time zone settings to match that of a user's facility. AROYA will automatically disable this for you when you push a schedule

“Run Once” Functionality - Proposed Workaround

The ability to push a “one-time” irrigation event is not currently supported through AROYA. If a single irrigation event is needed, it is recommended to do the following work around:

1. Create and activate a room schedule to trigger the desired irrigation event
2. Please note: A room schedule can be created and activated alongside any other running schedule without disabling any current ongoing schedules
3. Delete the room schedule once the irrigation event has happened  

Troubleshooting

Debug A Device

• Make sure the device is plugged in
• Make sure the device is connected to a valid network
• If you are unsure about the connection of your OpenSprinkler to AROYA, check to see if you can access the OpenSprinkler web portal via it's assigned IP address in your browser
• OpenSprinkler should be on the latest version of supported firmware (see above)

Guides

Updating the OpenSprinkler firmware, including reverting the firmware to a supported version

Warning: firmware update will likely set OS back to factory defaults. This includes all settings, programs, and device password (which will be set back to the default: “opendoor”). Please ensure you back up your current configurations in the Open Sprinkler UI (e.g. Export Configurations) before proceeding with firmware update. In addition, for OS 3.x, the WiFi settings will be erased too, so after firmware update, please follow the OS firmware User Manual to repeat the WiFi settings steps.

• Click here for detailed instructions on how to update your firmware. Please make sure to choose a supported version of the firmware (see “Important Information” at the top of this document for supported firmware versions)

Reconnecting OpenSprinkler when using a static IP

• Go to your OpenSprinkler
• Push B1 on your OpenSprinkler
• Record the new IP address on the screen of the OpenSprinkler
• Open AROYA and go to the controller tab within setup
• Open your OpenSprinkler edit page and change the IP address of your OpenSprinkler to the new address

Factory Reset OpenSprinkler

• Unplug power
• Plug in Power and immediately press B1 until screen shows "Factor Reset"
• Select Yes, then press B3.

Error Codes and Proposed Solutions

Resources

Open Sprinkler Quick Start Guide

OpenSprinkler Resources

Purchase OpenSprinkler

OpenSprinkler FAQs

OpenSprinkler Manuals

Using 24V AC Relays

How did we do?

Related Articles

• Manual Irrigation Event - Setup
• Cultivation Quick Start Guide
• Create an Irrigation Schedule Template