From c596a5617cacd7119ad759f8184fe86248348334 Mon Sep 17 00:00:00 2001 From: Brian Rogers Date: Wed, 27 Mar 2024 05:53:19 -0400 Subject: [PATCH] Add smart hose timer info to Rachio (#30811) * add smart hose timer info * Add missing word * Add notes about polling * Update start watering service * Tiny tweaks --------- Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/rachio.markdown | 28 +++++++++++++++++++++++----- 1 file changed, 23 insertions(+), 5 deletions(-) diff --git a/source/_integrations/rachio.markdown b/source/_integrations/rachio.markdown index 3898de7b15b..f58ecddc2ca 100644 --- a/source/_integrations/rachio.markdown +++ b/source/_integrations/rachio.markdown @@ -39,7 +39,7 @@ They will be automatically added if the Rachio integration is loaded.
-In order for Rachio switches and sensors to update, your Home Assistant instance must be accessible from the internet, either via Home Assistant Cloud or another method. See the [Remote Access documentation](/docs/configuration/remote/) for more information. +In order for Rachio switches and sensors to update, your Home Assistant instance must be accessible from the internet, either via Home Assistant Cloud or another method. See the [Remote Access documentation](/docs/configuration/remote/) for more information. The smart hose timers use polling and don't require external access to be setup.
@@ -50,6 +50,10 @@ After setting up the integration, change the options to set the duration in minu +### Smart hose timers + +The Rachio smart hose timers are not currently capable of receiving real-time updates. Instead, they rely on polling. Because of this, the current state of valves started from a schedule or the physical button will not show up immediately. Polling occurs every 2 minutes when one base station is used, with an additional minute added for every additional base station to remain with the API rate limit. Up to 4 valves can be paired to a single base station. + ### iFrame If you would like to see and control more detailed zone information, create an [iFrame](/integrations/panel_iframe/) that renders the Rachio web app. @@ -64,12 +68,25 @@ panel_iframe: ## Switch -The `rachio` switch platform allows you to toggle zones and schedules connected to your [Rachio irrigation system](https://rachio.com/) on and off. +The `rachio` switch platform allows you to toggle zones, valves, and schedules connected to your [Rachio irrigation system](https://rachio.com/) on and off. -Once configured, a switch will be added for every zone that is enabled on every controller in the account provided and a switch to start or stop every schedule on a controller. There will also be a switch to toggle each controller's standby mode, as well as to activate a 24 hour rain delay on the device. +Once configured, a switch will be added for every zone that is enabled on every controller in the account provided, as well as a switch for each smart hose timer valve and a switch to start or stop every schedule on a controller. There will also be a switch to toggle each controller's standby mode, as well as to activate a 24-hour rain delay on the device. ## Services +### Service `rachio.start_watering` + +Allows starting one zone on a sprinkler controller, any number of smart hose timer valves, or a schedule. To sequentially start multiple zones on a sprinkler controller, use the `start_multiple_zone_schedule` service below. + +Service data attribute | Optional | Description | +| ---------------------- | -------- | ----------- | +| `entity_id` | no | Individual zone, schedule, or multiple smart hose timer valves to run. A smart hose timer base station device can also be selected to run all valves on the given base. +| `duration` | yes | Duration in minutes to run the zone or valves. Leave empty for schedules. + +
+The services below only apply to sprinkler controllers and will not be shown if only smart hose timers are on the account. +
+ ### Service `rachio.start_multiple_zone_schedule` Allows a list of zones to be passed with a corresponding list of durations to create a custom schedule directly from Home Assistant. @@ -86,7 +103,7 @@ It is not currently possible to have zones from multiple controllers in the same ### Examples ```yaml -#Example sctipt to start multiple zones with individual duration for each zone. +#Example script to start multiple zones with individual duration for each zone. script: run_grass_zones: sequence: @@ -101,7 +118,7 @@ script: ``` ```yaml -#Example sctipt to start multiple zones with one duration for all zones. +#Example script to start multiple zones with one duration for all zones. script: run_grass_zones: sequence: @@ -114,6 +131,7 @@ script: data: duration: 20 ``` + ### Service `rachio.set_zone_moisture_percent` Set the zone moisture percentage for a zone or group of zones.