Home Assistant Home Assistant
Edit this page on GitHub

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

access_token

(string)(Required)

The API KEY assigned to your Hydrawise account.

scan_interval

(integer)(Optional)

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

Default value:

30

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 the 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

monitored_conditions

(list)(Optional)

The binary sensors that should be displayed on the frontend.

Default value:

All binary sensors are enabled.

is_watering

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

rain_sensor

Is on when the rain_sensor (if installed on the controller) is active (wet).

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.

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

monitored_conditions

(list)(Optional)

The sensors that should be displayed on the frontend.

Default value:

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. If the zone is suspended then the value will be NS to indicate Not Scheduled.

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

watering_minutes

(integer)(Optional)

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.

Default value:

15

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 value:

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.

# 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