Update for rewritten Rachio component (#5589)

* Update for rewritten Rachio component

* ✏️ Minor tweaks

* ⬆️ ha_release 0.73

* ⬆️ ha_release 0.73
This commit is contained in:
Andy Castille 2018-07-02 15:11:20 -05:00 committed by Paulus Schoutsen
parent 4551dcd398
commit a94332fd58
3 changed files with 88 additions and 28 deletions

View File

@ -0,0 +1,31 @@
---
layout: page
title: "Rachio Binary Sensor"
description: "Instructions on how to use Rachio binary sensors with Home Assistant."
date: 2018-06-23 16:15
sidebar: true
comments: false
sharing: true
footer: true
logo: rachio.png
ha_category: Hub
ha_iot_class: "Cloud Push"
ha_release: 0.73
---
The `rachio` binary sensor platform allows you to view the status of your [Rachio irrigation system](http://rachio.com/).
Once configured, a binary sensor will be added that shows whether or not each controller in the account provided is online and reachable by Rachio's servers.
<p class='note'>
You must have the [Rachio component](/components/rachio/) configured to use this switch.
</p>
To add this platform to your installation, add the following to your `configuration.yaml` file:
```yaml
# Example configuration.yaml entry
binary_sensor:
- platform: rachio
```

View File

@ -0,0 +1,43 @@
---
layout: page
title: "Rachio"
description: "Instructions on how to use Rachio with Home Assistant."
date: 2018-06-23 16:04
sidebar: true
comments: false
sharing: true
footer: true
logo: rachio.png
ha_category: Hub
ha_iot_class: "Cloud Push"
ha_release: 0.73
---
The `rachio` platform allows you to control your [Rachio irrigation system](http://rachio.com/).
## {% linkable_title Getting your Rachio API Key %}
1. Log in at [https://app.rach.io/](https://app.rach.io/).
1. Click the "Account Settings" menu item at the bottom of the left sidebar
1. Click "Get API Key"
1. Copy the API key from the dialog that opens.
To add this platform to your installation, add the following to your `configuration.yaml` file:
```yaml
# Example configuration.yaml entry
rachio:
api_key: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
```
### {% linkable_title iFrame %}
If you would like to see and control more detailed zone information, create an [iFrame](/components/panel_iframe/) that renders the Rachio web app.
```yaml
panel_iframe:
rachio:
title: Rachio
url: "https://app.rach.io"
icon: mdi:water-pump
```

View File

@ -2,25 +2,24 @@
layout: page
title: "Rachio Switch"
description: "Instructions on how to use Rachio switches with Home Assistant."
date: 2017-05-29 09:00
date: 2018-06-23 16:09
sidebar: true
comments: false
sharing: true
footer: true
logo: rachio.png
ha_category: Switch
ha_iot_class: "Cloud Polling"
ha_iot_class: "Cloud Push"
ha_release: 0.46
---
The `rachio` switch platform allows you to control your [Rachio irrigation system](http://rachio.com/).
The `rachio` switch platform allows you to toggle zones connected to your [Rachio irrigation system](http://rachio.com/) on and off.
## {% linkable_title Getting your Rachio API Access Token %}
Once configured, a switch will be added for every zone that is enabled on every controller in the account provided, as well as a switch to toggle each controller's standby mode.
1. Log in at [https://app.rach.io/](https://app.rach.io/).
1. Click the user button at the top right.
1. Click API Access Token.
1. Copy the API access token from the dialog that opens.
<p class='note'>
You must have the [Rachio component](/components/rachio/) configured to use this switch.
</p>
To add this platform to your installation, add the following to your `configuration.yaml` file:
@ -28,17 +27,20 @@ To add this platform to your installation, add the following to your `configurat
# Example configuration.yaml entry
switch:
- platform: rachio
access_token: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
```
Configuration variables:
- **access_token** (*Required*): Your Rachio API Access Token.
- **manual_run_mins** (*Optional*): For how long, in minutes, to turn on a station when the switch is enabled. Defaults to 10 minutes.
<p class='note'>
**Water-saving suggestion:**<br>
Set `manual_run_mins` to a high maximum failsafe value when using scripts to control zones. If something goes wrong with your script, Home Assistant, or you hit the Rachio API rate limit of 1700 calls per day, the controller will still turn off the zone after this amount of time.
</p>
## {% linkable_title Examples %}
In this section you find some real life examples of how to use this switch.
In this section, you find some real-life examples of how to use this switch.
### {% linkable_title `groups.yaml` example %}
@ -51,35 +53,19 @@ irrigation:
entities:
- group.zones_front
- group.zones_back
- switch.side_yard
zones_front:
name: Front Yard
view: false
entities:
- switch.driveway
- switch.front_bushes
- switch.front_garden
- switch.front_yard
- switch.side_yard
zones_back:
name: Back Yard
view: false
entities:
- switch.back_bushes
- switch.back_garden
- switch.back_porch
- switch.back_trees
```
### {% linkable_title iFrame %}
If you would like to see and control more detailed zone information, create an [iFrame](/components/panel_iframe/) that renders the Rachio web app.
```yaml
panel_iframe:
rachio:
title: Rachio
url: "https://app.rach.io"
icon: mdi:water-pump
```