mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-16 05:46:52 +00:00
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:
parent
4551dcd398
commit
a94332fd58
31
source/_components/binary_sensor.rachio.markdown
Normal file
31
source/_components/binary_sensor.rachio.markdown
Normal 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
|
||||
```
|
43
source/_components/rachio.markdown
Normal file
43
source/_components/rachio.markdown
Normal 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
|
||||
```
|
@ -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
|
||||
```
|
||||
|
Loading…
x
Reference in New Issue
Block a user