Home Assistant Home Assistant

Hunter Hydrawise

The hydrawise integration allows you to integrate your Hunter Hydrawise Wi-Fi irrigation controller system in Home Assistant.

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

Configuration

To enable it, add the following to your configuration.yaml file:

# Example configuration.yaml entry
hydrawise:
  access_token: YOUR_API_KEY

Configuration Variables

Looking for your configuration file?
access_token string Required

The API KEY assigned to your Hydrawise account.

scan_interval integer (Optional, default: 120)

The time interval, in seconds, to poll the Hydrawise cloud.

To get your API access token log into your Hydrawise account and in the ‘My Account Details’ section under Account Settings click ‘Generate API Key’. Enter that key in your configuration file as YOUR_API_KEY.

Binary Sensor

Once you have enabled the hydrawise component, add the following to your configuration.yaml file:

# Example configuration.yaml entry
binary_sensor:
  - platform: hydrawise

Configuration Variables

Looking for your configuration file?
monitored_conditions list (Optional)

The binary sensors that should be displayed on the frontend.

Default:

All binary sensors are enabled.

is_watering

The binary sensor is on when the zone is actively watering.

status

This will indicate on when there is a connection to the Hydrawise cloud. It is not an indication of whether the irrigation controller hardware is online.

The Hydrawise API removed the ability to read the rain sensor status. Therefore it is no longer supported by the Hydrawise integration to Home Assistant.

The Hydrawise API uses rate limiting and might throw errors in case the scan_interval is too low or too many manual service calls are triggered: The limit is 3 calls to start/stop/suspend a zone per 30 seconds and an additional limit across the entire API of 30 calls in a 5-minute period per user.

Sensor

Once you have enabled the hydrawise component, add the following to your configuration.yaml file:

# Example configuration.yaml entry
sensor:
  - platform: hydrawise

Configuration Variables

Looking for your configuration file?
monitored_conditions list (Optional)

The sensors that should be displayed on the frontend.

Default:

All sensors are enabled.

watering_time

The amount of time left if the zone is actively watering. Otherwise the time is 0.

next_cycle

The day and time when the next scheduled automatic watering cycle will start.

Switch

Once you have enabled the hydrawise component, add the following to your configuration.yaml file:

# Example configuration.yaml entry
switch:
  - platform: hydrawise

Configuration Variables

Looking for your configuration file?
watering_minutes integer (Optional, default: 15)

When manual watering is enabled this will determine the length of time in minutes that the irrigation zone will run. The allowed values are 5, 10, 15, 30, 45, or 60.

monitored_conditions list (Optional)

Selects the set of switches that should be enabled on the frontend. Also sets the length of time a zone will run under manual control.

Default:

All switches are enabled.

auto_watering

Enables the Smart Watering features for this zone.

manual_watering

Enables the manual watering control for this zone.

Switch Operation

When auto_watering is on the irrigation zone will follow the Smart Watering schedule set through the Hydrawise mobile or web app. When the auto_watering switch is off the zone’s Smart Watering schedule is suspended for 1 year.

When manual_watering is on the zone will run for the amount of time set by watering_minutes.

Due to changes in the Hydrawise API the status of the Auto Watering switches has changed. Under normal conditions the Auto Watering switches correctly reflect the Smart Watering schedule on the Hydrawise mobile or web app. However, if a rain sensor is connected to the system and it is active (rain detected), or the zone is running the Auto Watering switch will turn off. After both of those conditions are removed the switch will again show the correct Auto Watering condition. 
# An example that enables all the switches, and sets the manual watering time to 20 minutes.
switch:
  - platform: hydrawise
    watering_minutes: 20

# An example that enables only the manual control switches.
switch:
  - platform: hydrawise
    monitored_conditions: manual_watering