#Rachio

The Rachio integration allows you to control your Rachio irrigation system.

There is currently support for the following device types within Home Assistant:

• Binary sensor - Allows you to view the status of your Rachio irrigation system.
• Switch
• Calendar

They will be automatically added if the Rachio integration is loaded.

#Getting your Rachio API Key

1. Log in at https://app.rach.io/.
2. Go to Settings.
3. Click Get API Key.
4. Copy the API key from the dialog that opens.

:::important In order for Rachio switches and sensors to update, your Home Assistant instance must be accessible from the internet, either via Home Assistant Cloud or another method. See the Remote Access documentation for more information. The smart hose timers use polling and don't require external access to be setup.

::: :::note 配置 此集成可通过 UI 配置。前往 设置 > 设备与服务 添加。 :::

Water-saving suggestion:
After setting up the integration, change the options to set the duration in minutes to run when activating a zone switch to a 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.

#Smart hose timers

The Rachio smart hose timers are not currently capable of receiving real-time updates. Instead, they rely on polling. Because of this, the current state of valves started from a schedule or the physical button will not show up immediately. Polling occurs every 2 minutes when one base station is used, with an additional minute added for every additional base station to remain with the API rate limit. Up to 4 valves can be paired to a single base station.

#iFrame

If you would like to see and control more detailed zone information, create an iFrame that renders the Rachio web app.

panel_iframe:
  rachio:
    title: Rachio
    url: "https://app.rach.io"
    icon: mdi:sprinkler-variant

#Switch

The rachio switch platform allows you to toggle zones, valves, and schedules connected to your Rachio irrigation system 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 for each smart hose timer valve and a switch to start or stop every schedule on a controller. There will also be a switch to toggle each controller's standby mode, as well as to activate a 24-hour rain delay on the device.

#Calendar

A calendar entity will be added for each smart hose timer base station on the account, which will show past and future events for all enabled schedules. An upcoming event can be deleted from the calendar, which will trigger a skip of that event.

#Actions

#Action rachio.start_watering

Allows starting one zone on a sprinkler controller, any number of smart hose timer valves, or a schedule. To sequentially start multiple zones on a sprinkler controller, use the start_multiple_zone_schedule action below.

#Action rachio.start_multiple_zone_schedule

Allows a list of zones to be passed with a corresponding list of durations to create a custom schedule directly from Home Assistant.

#Examples

#Example script to start multiple zones with individual duration for each zone.
script:
  run_grass_zones:
    sequence: 
      - action: rachio.start_multiple_zone_schedule
        target:
          entity_id:
            - switch.front_yard_west
            - switch.front_yard_east
            - switch.side_yard_west
        data:
          duration: 20, 15, 10

#Example script to start multiple zones with one duration for all zones.
script:
  run_grass_zones:
    sequence: 
      - action: rachio.start_multiple_zone_schedule
        target:
          entity_id:
            - switch.front_yard_west
            - switch.front_yard_east
            - switch.side_yard_west
        data:
          duration: 20

#Action rachio.set_zone_moisture_percent

Set the zone moisture percentage for a zone or group of zones.

Rachio allows for setting the moisture percentage of a zone or group of zones. As Rachio only uses moisture levels for zones in a Flex Daily schedule, this action is only available when at least one zone is part of a Flex Daily schedule.

#Action rachio.pause_watering

Pause a currently running schedule.

This action will not be available if only a Generation 1 controller is on the account, as these controllers do not support pause or resume.

#Action rachio.resume_watering

Resume a currently paused schedule.

This action will not be available if only a Generation 1 controller is on the account, as these controllers do not support pause or resume.

#Action rachio.stop_watering

Stops all currently running schedules.

#Examples

In this section, you find some real-life examples of how to use this switch.

#groups.yaml example

irrigation:
  name: Irrigation
  icon: mdi:water-pump
  view: true
  entities:
  - group.zones_front
  - group.zones_back
  - switch.side_yard
  - switch.every_day_6am

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