From 10feb670bf2069ce988f3502f981ed4df808dd55 Mon Sep 17 00:00:00 2001 From: shbatm Date: Thu, 27 Oct 2022 09:37:57 -0500 Subject: [PATCH] Add RainMachine config option to use default run times from app (#24706) --- source/_integrations/rainmachine.markdown | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/source/_integrations/rainmachine.markdown b/source/_integrations/rainmachine.markdown index 1b410073002..623dfb4a29d 100644 --- a/source/_integrations/rainmachine.markdown +++ b/source/_integrations/rainmachine.markdown @@ -39,6 +39,13 @@ Note that some entities are disabled by default. If you are missing a sensor or {% include integrations/config_flow.md %} +## Configuaration Options + +The integration has two configuration options: + +1. "Default Zone Run Time": sets a default duration when turning on a zone switch (default: 600 seconds). This can be overriden with a service call (see below). +2. "Use Run Times from App": if enabled, will use the zone-specific run times from the last time the zone was turned on manually in the RainMachine App – this allows you to set per-zone default times using the RainMachine app instead of the same default time for all zones. + ## Services Services accept either device IDs or entity IDs, depending on the nature of the service: @@ -116,9 +123,9 @@ Start a RainnMachine program. Start a RainMachine zone for a set number of seconds. -| Service Data Attribute | Optional | Description | -| ---------------------- | -------- | ---------------------------------------------------- | -| `zone_run_time` | yes | The number of seconds to run; defaults to 60 seconds | +| Service Data Attribute | Optional | Description | +| ---------------------- | -------- | ----------------------------------------------------- | +| `zone_run_time` | yes | The number of seconds to run; defaults to 600 seconds | ### `rainmachine.stop_all` @@ -145,7 +152,7 @@ Remove all watering restrictions enforced by `rainmachine.restrict_watering`. After Home Assistant loads, new switches will be added for every enabled program and zone. These work as expected: - Program On/Off: starts/stops a program -- Zone On/Off: starts/stops a zone (using the `zone_run_time` parameter to determine how long to run for) +- Zone On/Off: starts/stops a zone (using the configuration options described above to determine how long to run for) Programs and zones are linked. While a program is running, you will see both the program and zone switches turned on; turning either one off will turn the other one off (just like in the web app).