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

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

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 %}
## 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).