From 7f4b07a887f658888ab9a54a6c44b8cfd159ba2b Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Tue, 30 May 2017 10:08:12 +0200 Subject: [PATCH] Add initial Rachio docs (#2723) * Add initial Rachio docs * Add default for manual run * Minor fixes * Add iframe sample --- source/_components/switch.rachio.markdown | 85 ++++++++++++++++++++++ source/images/supported_brands/rachio.png | Bin 0 -> 7253 bytes 2 files changed, 85 insertions(+) create mode 100644 source/_components/switch.rachio.markdown create mode 100644 source/images/supported_brands/rachio.png diff --git a/source/_components/switch.rachio.markdown b/source/_components/switch.rachio.markdown new file mode 100644 index 00000000000..e75c4ed155e --- /dev/null +++ b/source/_components/switch.rachio.markdown @@ -0,0 +1,85 @@ +--- +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: "Local Polling" +ha_release: 0.46 +--- + +The `rachio` switch platform allows you to control your [Rachio irrigations system](http://rachio.com/). + +## {% linkable_title Getting your Rachio API Access Token %} + +- Log in at [https://app.rach.io/](https://app.rach.io/). +- Click the user button at the top right. +- Click API Access Token. +- 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** (*Required3): 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 the Rachio details then create an [iFrame](/components/panel_iframe/) that contains the information accessible through your panel. + +```yaml +panel_iframe: + rachio: + title: Rachio + url: "https://app.rach.io" + icon: mdi:water-pump +``` diff --git a/source/images/supported_brands/rachio.png b/source/images/supported_brands/rachio.png new file mode 100644 index 0000000000000000000000000000000000000000..340105ff8249064e0387995c5d1a8a4dbe483c99 GIT binary patch literal 7253 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 YA(J|h2+TXvJ6wqKNZU}WQUe_EUyZ-wX8-^I literal 0 HcmV?d00001