jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-17 22:36:51 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add RainMachine config option to use default run times from app (#24706)

Browse Source
This commit is contained in:
shbatm 2022-10-27 09:37:57 -05:00 committed by GitHub
parent 59910792ee
commit 10feb670bf
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 11 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
source/_integrations/rainmachine.markdown
View File

@ -39,6 +39,13 @@ Note that some entities are disabled by default. If you are missing a sensor or
{% include integrations/config_flow.md %} {% 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
Services accept either device IDs or entity IDs, depending on the nature of the service: 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. Start a RainMachine zone for a set number of seconds.
| Service Data Attribute | Optional | Description | | Service Data Attribute | Optional | Description |
| ---------------------- | -------- | ---------------------------------------------------- | | ---------------------- | -------- | ----------------------------------------------------- |
| `zone_run_time` | yes | The number of seconds to run; defaults to 60 seconds | | `zone_run_time` | yes | The number of seconds to run; defaults to 600 seconds |
### `rainmachine.stop_all` ### `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: 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 - 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). 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).