ioBroker.cloudrain

Tests:

cloudrain adapter for ioBroker

This Adapter connects iobroker to the Cloudrain Smart Irrigation System See https://cloudrain.com/.

The irrigation system consists of at least one controller. Each irrigation controller can control different zones (valves). Both reading current irrigation status and manual start/stop of irrigation for each zone is possible.

You might start/stop irrigations through the App and monitor the changes.

Installation

This adapter is currently under development, but should work as intended.

Please test it and give feedback: https://github.com/ioBroker/AdapterRequests/issues/370

Recommended Installation method (GUI)

• In Adapter panel activate expert mode
• Click the "Install from own URL" Icon
• Select "User Defined"
• insert URL https://github.com/hendrikhoffmann/ioBroker.cloudrain
• Click Install
• Add a new instance of the cloudrain adapter

Alternate Installation method (Shell)

cd /opt/iobroker
npm install iobroker.cloudrain
iobroker add cloudrain

To Update:

cd /opt/iobroker
iobroker stop cloudrain
npm install iobroker.cloudrain
iobroker update cloudrain
iobroker start cloudrain

Configuration

• Insert your Cloudrain Username + Password in the Instance Configuration
• The Cloudrain API is polled at regular intervals for updates.
• Set this Data Request Interval during idle (60 sec is a perfect default value)
• increase the Data Request Interval if total data transfered is an issue (you might miss irrigations configured in the App)
• Note: If the system is irrigating, data updates are polled at 10 sec intervall.

Object Tree Value Description

For each Zone, the Read-Only Values are

• irrigating : boolean value indicating wether the irrigation is currently running
• startTime : the start time (HH:MM) of the current irrigation cycle or --:-- if no irrigation is running
• plannedEndTime : the planned end time (HH:MM) of the current irrigation cycle or --:-- if no irrigation is running
• duration : the total duration of the current irrigation cycle in seconds
• remainingSeconds : the remaining duration of the current irrigation cycle in seconds

Write-Values

• startIrrigation - set a duration value in seconds to immediatly start an irrigation cycle, set a 0 to stop a currently running cycle

Changelog

0.3.0 (2023-06-15)

• fixed a bug where Admin Interface was not displayed if node.js Version >12

0.1.3 (2021-11-10)

• irrigation poll intervall is now 10 sec during irrigation and min. 60 sec otherwise
• dependency of request and util lib removed, replaced by got

0.1.2 (2021-11-09)

• Updated installation instructions

0.1.1 (2021-11-09)

• irrigation status is updated instantly after execution of an irrigation command
• Debug and Info Log Messages clarified
• Installation instructions added to README

0.0.8 (2021-11-08)

• Updated Documentation

0.0.5 (2021-11-08)

• Implemented info.connection to indicate valid Cloudrain access token
• Removed Boilerplate Code and Refactored some Stuff
• Implemented Start / Stop irrigation
• Updated Documentation

0.0.3 (2021-11-07)

npm release script hazzle

0.0.2 (2021-11-07)

• (hendrikhoffmann) initial release

License

MIT License

Copyright (c) 2021 hendrikhoffmann [email protected]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.