OpenSprinkler Remote access with OpenThings Cloud (OTC) token

Note

Supported from firmware 2.2.0 OpenSprinkler 3.x remote access via OTC tokens. Please note that this is only for OpenSprinkler-Hardware 3.x is available, it is NOT available for OpenSprinkler-Hardware 2.x or OpenSprinkler Pi / Beagle / demo. So this article is only for OpenSprinkler 3.x relevant. For OpenSprinkler 3 requires a firmware update.

Preface

Supported from firmware 2.2.0 (official version, not my betas! There is beta 2.3.0 here). OpenSprinkler 3.x remote access via OpenThings Cloud (OTC) token. This eliminates the need for port forwarding (which is difficult to set up on some routers, especially mobile routers). Before proceeding, make sure you have the OpenSprinkler- Have firmware 2.2.0 or higher. If not, you can follow the instructions here to update 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: Creating an OTC token

Go to https://www.openthings.io and log in with your opensprinkler.com login email/username and password. If you don't have one opensprinkler.com account, please go to https://www.opensprinkler.com and click “My Account” above, then register for a new user account. The two websites use the same login.

Once you have logged into openthings.io you will see the dashboard. On the left side of the dashboard, click
My OpenThings devices (My OpenThings OTC Devices)

Note: Registration in German OpenSprinklerShop.de site has NOTHING to do with registering on the OpenSprinkler.com site to do! You have to register there again!

See the image below for illustration.

DO NOT click My OpenThings Blynk Devices (above My OpenThings Blynk Devices) as this is for creating Blynk tokens and not OTC tokens.
Next, enter a device description, select “OpenSprinkler” from the drop-down list and then click !Add New Device”. This will create a new one OpenSprinklerdevice and you will see the OTC token shown above. The token is 32 characters long. You need to copy this token and put it in your OpenSprinkler-Insert settings (see below).

Step B: Update OpenSprinkler Settings

1. You need to change the settings on your OpenSprinkler-Change device to activate the OTC token. To do this, open a browser and enter your device's IP address, which will bring up the web UI.
2. Click on the icon in the lower right corner to go to "Edit Options" and click on the "Integration" tab. Select "Activate". Then copy and paste your entire OTC token into the Token field. 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. Apply the changes and finally start your OpenSprinkler new. Now you are ready.
   
4. To check if the OTC cloud connection is valid, after restarting the controller, swipe from left to right on the home page (or click the icon in the top left corner) to close the menu on the left Open, and then click "System Diagnostics." In the lower part of the window you can see the OTC status. If it says 'Connected' there, it means the connection is successful. If 'Connecting…' is displayed, you should wait 30 seconds and then check again. The status will show “Not Activated” if OTC is not activated, or “Disconnected” if the connection failed for some reason. See image below for illustration.

Step C: Use the OTC token for remote access

The current version of the OpenSprinkler Mobile app supports adding a device via its OTC token. To add a remote control location, add a device with its OTC token.

You can also use a web browser to visit https://ui.opensprinkler.com and add a device with its OTC token.

Alternatively, you can open a browser and type:

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

in which token Your OTC token is. This allows you to access the control unit remotely. You can bookmark this link in your browser or add this link to the homepage on a smartphone.