Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 31 additions & 0 deletions source/_components/binary_sensor.rachio.markdown
Original file line number Diff line number Diff line change
@@ -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 changes: 43 additions & 0 deletions source/_components/rachio.markdown
Original file line number Diff line number Diff line change
@@ -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
```
42 changes: 14 additions & 28 deletions source/_components/switch.rachio.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -2,43 +2,45 @@
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:

```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.

<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 %}

Expand All @@ -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
```