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-16 13:56:53 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update for V1.4 API (#13093)

Browse Source
This commit is contained in:
David Ryan 2020-06-22 07:51:43 -04:00 committed by GitHub
parent 2f74a8e27b
commit 0e68e8e34e
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 10 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
source/_integrations/hydrawise.markdown
View File

@ -41,7 +41,7 @@ scan_interval:
default: 30
{% endconfiguration %}
To get your API access token log into your [Hydrawise account](https://app.hydrawise.com/config/login) and in the 'My Account Details' section under Account Settings click 'Generate API Key'. Enter that key in your configuration file as the `API_KEY`.
To get your API access token log into your [Hydrawise account](https://app.hydrawise.com/config/login) and in the 'My Account Details' section under Account Settings click 'Generate API Key'. Enter that key in your configuration file as `YOUR_API_KEY`.
## Binary Sensor
@ -62,12 +62,14 @@ monitored_conditions:
keys:
is_watering:
description: The binary sensor is `on` when the zone is actively watering.
rain_sensor:
description: Is `on` when the rain_sensor (if installed on the controller) is active (wet).
status:
description: This will indicate `on` when there is a connection to the Hydrawise cloud. It is not an indication of whether the irrigation controller hardware is online.
{% endconfiguration %}
<div class='note warning'>
The Hydrawise API removed the ability to read the rain sensor status. Therefore it is no longer suppored by the Hydrawise integration to Home Assistant.
</div>
## Sensor
Once you have enabled the `hydrawise` component, add the following to your `configuration.yaml` file:
@ -88,7 +90,7 @@ monitored_conditions:
watering_time:
description: The amount of time left if the zone is actively watering. Otherwise the time is 0.
next_cycle:
description: The day and time when the next scheduled automatic watering cycle will start. If the zone is suspended then the value will be `NS` to indicate Not Scheduled.
description: The day and time when the next scheduled automatic watering cycle will start.
{% endconfiguration %}
## Switch
@ -125,6 +127,10 @@ When `auto_watering` is `on` the irrigation zone will follow the Smart Watering
When `manual_watering` is `on` the zone will run for the amount of time set by `watering_minutes`.
<div class='note warning'>
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.
</div>
```yaml
# An example that enables all the switches, and sets the manual watering time to 20 minutes.
switch: