Note: this support article is being actively updated. Content on this page is NOT finalized until we finish testing firmware 2.2.0. Remote access via OTC is only available for OpenSprinkler hardware 3.x, it is NOT available for OpenSprinkler hardware 2.x or OpenSprinkler Pi / Beagle / Demo. Therefore this article is only relevant to OpenSprinkler 3.x. This support article is related to the forum post about test firmware 2.2.0 


Introduction

From firmware 2.2.0, OpenSprinkler 3.x supports remote access via OpenThings Cloud (OTC) token. This eliminates the need for port forwarding (which is difficult to set up for some routers particularly mobile routers). Before proceeding, make sure you have OpenSprinkler firmware 2.2.0 or above. If not, you can follow the instructions here to upgrade your firmware to 2.2.0. The instructions below explain how to create an OTC token, and use the OTC token for remote access.


Step A: Create an OTC Token

  1. Go to www.openthings.io and log in using your opensprinkler.com login email/username and password. If you do not yet have an opensprinkler.com account, please go to www.opensprinkler.com and click on 'My Account' at the top, then register for a new user account. The two websites share the same log in.

  2. Once you log in to openthings.io, you will see the dashboard. On the left side of the dashboard, click
    My OpenThings Devices
    See the image below for illustration.
    Do NOT click on My OpenThings Blynk Devices (which is above My OpenThings Blynk Devices) as that's for creating Blynk token, not OTC token. 
  3. Next, type in a device description, select 'OpenSprinkler' from the dropdown list, then click on Add New Device. See the image below for illustration.This will create a new OpenSprinkler device, and you will see the OTC token illustrated above. The token is 32-characters long. You will need to copy and paste this token to your OpenSprinkler settings (explained below).

Step B: Update OpenSprinkler Settings

  1. You will need to change settings on your OpenSprinkler device to enable the OTC token. To do so, open a browser and type in the IP address of your device, this should show the web UI. (Please note: at the moment of this writing, the OpenSprinkler mobile app hasn't been updated to enable OTC yet, so for now you have to use a web browser to access the controller).
  2. Click the lower-right corner icon to go to 'Edit Options', and click the 'Integration' tab. Choose Enable. Then copy/paste your entire OTC token into the Token box. The default OTC server is ws.cloud.openthings.io and the default port is 80. You can leave them as is. See the image below for illustration.
  3. Submit the changes and finally reboot your OpenSprinkler. Now you are all set.
  4. To verify if OTC cloud connection is valid, after the controller is rebooted, at the homepage, swipe left to right (or click the upper-left corner icon) to open the left-side menu, then click 'System Diagnostics'. At the bottom of the panel you will see OTC status. If it shows 'Connected' that means the connection is successful. If it shows 'Connecting...' you may want for 30 seconds and re-check. The status shows 'Not enabled' if OTC is not enabled, or 'Disconnected' if for some reason the connection has failed. See image below for illustration.


Step C: Use the OTC Token for remote access


(Please note: at the moment of this writing, the OpenSprinkler mobile app hasn't been updated to enable OTC yet, so for now you have to use a web browser to access the controller).


You can open a browser and type in:

https://cloud.openthings.io/forward/v1/token

where token is your OTC token. This will allow you to remotely access the controller. You can bookmark this link in your browser or on a smartphone device, add this link to the homepage.