Shop
ConfiguratorGenerally
OpenSprinkler remote access with OpenThings Cloud (OTC) token
Notice
Starting with firmware 2.2.0, OpenSprinkler 3.x supports remote access via OTC tokens. Please note that this is only available for OpenSprinkler hardware 3.x, it is NOT available for OpenSprinkler hardware 2.x or OpenSprinkler Pi (NEW with firmware 2.3.1(161+) also with OSPi) / Beagle / Demo. Therefore, this article is only relevant for OpenSprinkler 3.x. A firmware update is necessary for OpenSprinkler 3.
introduction
Starting with firmware 2.2.0 (official version, not my betas! There is beta 2.3.0 here) OpenSprinkler 3.x supports remote access via OpenThings Cloud (OTC) tokens. 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 OpenSprinkler firmware 2.2.0 or later. If not, you can follow the instructions here to update your firmware to 2.2.0. The following instructions 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 an OpenSprinkler.com account, please go to https://www.OpenSprinkler.com and click on “My Account” above, then register for a new user account. The two websites use the same login.
Once you log in to openthings.io, you will see the dashboard. On the left side of the dashboard, click
My OpenThings devices (My OpenThings OTC Devices)
Note: Registering on the German OpenSprinklerShop.de site has NOTHING to do with registering on the OpenSprinkler.com site! 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, not OTC tokens.
Next, enter a device description, select “OpenSprinkler” from the drop-down list, then click !Add New Device. This will create a new OpenSprinkler device and you will see the OTC token pictured above. The token is 32 characters long. You will need to copy and paste this token into your OpenSprinkler settings (see below).
Step B: Update OpenSprinkler Settings
- You must change the settings on your OpenSprinkler device to activate the OTC token. To do this, open a browser and enter your device's IP address, which will display the web UI.
- Click the icon in the bottom right corner to go to “Edit Options” and click 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.
- Transfer the changes and finally restart your OpenSprinkler. Now you are ready.
- To check whether 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 upper left corner) to open the menu on the left, then click “System Diagnostics”. In the lower part of the window you can see the OTC status. If it says 'Connected', it means the connection is successful. If 'Connecting...' is displayed, you should wait 30 seconds and then check again. The status displays “Not Enabled” if OTC is not enabled 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 go to https://ui.OpenSprinkler.com in a web browser and add a device using its OTC token.
Alternatively, you can open a browser and type:
https://cloud.openthings.io/forward/v1/token
where 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.
I would like to create an OTC device. On the Openthings/My Open Things OTC Devices page, the “Add new device” button cannot be clicked after selecting OpenSprinkler. What to do. Thanks.
Thanks. Completed. It was the missing device name
You must first enter a device name in the description field (“enter a description here”), then the “Add new device” button will also work.
Meanwhile, OTC works for OpenSprinkler 3.x AND OSPi!
Hello,
I still have firmware 2.1.9 (7), which means OTC is not an option for me.
How can I access my Open Sprinkler controller remotely?
Thanks!
Hello,
If you have an OpenSprinkler OSPi, an OpenSprinkler 3.0 or newer, simply update the firmware.
https://OpenSprinklerShop.de/2019/12/04/firmware-update/
Or if you are familiar with port sharing, activate it on your router.
Thanks, then I don't have to go further troubleshooting...
It's a shame, but maybe this will be added again for the OSPI.
In principle, someone would have to adapt the WebSocket library for the Raspberry Pi and then it would work. I would also donate an OSPi including accessories if someone would adapt it in their free time.
I installed OpenSprinkler on my new OSPi 2.2.0 (2)) according to the instructions and I also don't have the entry for the integration. How can I install the official firmware to use the Cloud function?
The OTC function is NOT available for OpenSprinkler hardware 2.x or OpenSprinkler Pi (OSPi)!
https://OpenSprinkler.com/forums/topic/otc-support-for-ospi
Very cool feature!
“Disconnected” if the connection failed for some reason. Does anyone know of any reasons why it would be disconnected. Is there any troubleshooting info at all why it won’t connect?
Unfortunately, on my OS (2.2.0.112) the OTC entry does not exist under Integration. MQQT and IFTTT only.
In fact, 2.2.0 refers to the official OpenSprinkler firmware. The 2.2.0(112) is still the BETA firmware from last year and does not contain this function.