From 85b2a7fa5a8ce0afbdefc9b1619cf14e3b916a16 Mon Sep 17 00:00:00 2001 From: David Knowles Date: Tue, 30 Jul 2024 08:01:28 -0400 Subject: [PATCH] Add documentation for Hydrawise services (#33495) * Add documentation for Hydrawise services * Tiny tweaks * rename service to action * Changes requested by review and small tweaks * revert changes to Gemfile.lock * Update Gemfile.lock --------- Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/hydrawise.markdown | 30 +++++++++++++++++++++++++ 1 file changed, 30 insertions(+) diff --git a/source/_integrations/hydrawise.markdown b/source/_integrations/hydrawise.markdown index 8d1812f1526..071beb21d46 100644 --- a/source/_integrations/hydrawise.markdown +++ b/source/_integrations/hydrawise.markdown @@ -78,6 +78,36 @@ When `manual_watering` is `on` the zone will run for 15 minutes. Due to changes in the Hydrawise API the status of the Auto Watering switches has changed. Under normal conditions the Auto Watering switches correctly reflect the Smart Watering schedule on the Hydrawise mobile or web app. However, if a rain sensor is connected to the system and it is active (rain detected), or the zone is running the Auto Watering switch will turn off. After both of those conditions are removed the switch will again show the correct Auto Watering condition. {% endnote %} +## Actions + +The Hydrawise integration makes various custom {% term actions %} available. + +### Action `hydrawise.start_watering` + +Starts a watering cycle in an irrigation zone. + +| Data attribute | Optional | Description | +| -------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `entity_id` | no | The irrigation zone in which to start watering. | +| `duration` | yes | The length of time (in minutes) to run a watering cycle. If not specified (or zero), the default watering duration set in the Hydrawise mobile or web app for the irrigation zone will be used. | + +### Action `hydrawise.suspend` + +Suspends automatic watering in an irrigation zone until a specified date. + +| Data attribute | Optional | Description | +| -------------- | -------- | ------------------------------------------------------------------------------------------ | +| `entity_id` | no | The irrigation zone in which to suspend watering. | +| `until` | no | The date & time when automatic watering should be resumed. For example, `2024-08-30 08:30` | + +### Action `hydrawise.resume` + +Resumes automatic watering in an irrigation zone. + +| Data attribute | Optional | Description | +| -------------- | -------- | ------------------------------------------------ | +| `entity_id` | no | The irrigation zone in which to resume watering. | + ## Valve A valve is added for each zone allowing manual control of zone watering.