mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-05-30 06:46:49 +00:00
86 lines
2.0 KiB
Markdown
86 lines
2.0 KiB
Markdown
---
|
|
layout: page
|
|
title: "Rachio Switch"
|
|
description: "Instructions how to use Rachio switches with Home Assistant."
|
|
date: 2017-05-29 09:00
|
|
sidebar: true
|
|
comments: false
|
|
sharing: true
|
|
footer: true
|
|
logo: rachio.png
|
|
ha_category: Switch
|
|
ha_iot_class: "Cloud Polling"
|
|
ha_release: 0.46
|
|
---
|
|
|
|
The `rachio` switch platform allows you to control your [Rachio irrigation system](http://rachio.com/).
|
|
|
|
## {% linkable_title Getting your Rachio API Access Token %}
|
|
|
|
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.
|
|
|
|
To add this platform to your installation, add the following to your `configuration.yaml` file:
|
|
|
|
```yaml
|
|
# 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.
|
|
|
|
## {% linkable_title Examples %}
|
|
|
|
In this section you find some real life examples of how to use this switch.
|
|
|
|
### {% linkable_title `groups.yaml` example %}
|
|
|
|
|
|
```yaml
|
|
irrigation:
|
|
name: Irrigation
|
|
icon: mdi:water-pump
|
|
view: true
|
|
entities:
|
|
- group.zones_front
|
|
- group.zones_back
|
|
|
|
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
|
|
```
|