+ You must have the [Rachio component](/components/rachio/) configured to use this switch. +
+ + +To add this platform to your installation, add the following to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +binary_sensor: + - platform: rachio +``` diff --git a/source/_components/rachio.markdown b/source/_components/rachio.markdown new file mode 100644 index 00000000000..f50050f514c --- /dev/null +++ b/source/_components/rachio.markdown @@ -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 +``` diff --git a/source/_components/switch.rachio.markdown b/source/_components/switch.rachio.markdown index 9208a2d4754..786c3574132 100644 --- a/source/_components/switch.rachio.markdown +++ b/source/_components/switch.rachio.markdown @@ -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. ++ You must have the [Rachio component](/components/rachio/) configured to use this switch. +
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. +
+**Water-saving suggestion:**
+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.
+