mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-05-17 00:18:58 +00:00
71 lines
1.9 KiB
Markdown
71 lines
1.9 KiB
Markdown
---
|
|
layout: page
|
|
title: "Rachio Switch"
|
|
description: "Instructions on how to use Rachio switches with Home Assistant."
|
|
date: 2018-06-23 16:09
|
|
sidebar: true
|
|
comments: false
|
|
sharing: true
|
|
footer: true
|
|
logo: rachio.png
|
|
ha_category: Switch
|
|
ha_iot_class: "Cloud Push"
|
|
ha_release: 0.46
|
|
---
|
|
|
|
The `rachio` switch platform allows you to toggle zones connected to your [Rachio irrigation system](http://rachio.com/) on and off.
|
|
|
|
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.
|
|
|
|
<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
|
|
```
|
|
|
|
Configuration variables:
|
|
|
|
- **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.
|
|
|
|
### {% linkable_title `groups.yaml` example %}
|
|
|
|
```yaml
|
|
irrigation:
|
|
name: Irrigation
|
|
icon: mdi:water-pump
|
|
view: true
|
|
entities:
|
|
- group.zones_front
|
|
- group.zones_back
|
|
- switch.side_yard
|
|
|
|
zones_front:
|
|
name: Front Yard
|
|
view: false
|
|
entities:
|
|
- switch.front_bushes
|
|
- switch.front_yard
|
|
|
|
zones_back:
|
|
name: Back Yard
|
|
view: false
|
|
entities:
|
|
- switch.back_garden
|
|
- switch.back_porch
|
|
```
|