2024.11.3
Home ▸ Integrations ▸

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:

Prerequisites

  1. To set up the Hydrawise integration, you must first set up an online account at https://app.hydrawise.com.
  2. Then, use your online credentials to configure the integration.

Configuration

To add the Hunter Hydrawise integration to your Home Assistant instance, use this My button:

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & Services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select Hunter Hydrawise.

  • Follow the instructions on screen to complete the setup.

Binary sensor

Binary sensor entities are created for the controller:

  • Cloud API availability
  • Rain sensor moisture detection (if a rain sensor is attached to the controller)

Binary sensor entities are created for each irrigation zone:

  • Running status

Sensor

Sensor entities are created for the controller:

  • Daily total water use (if a flow sensor is attached to the controller)
  • Daily active water use (if a flow sensor is attached to the controller)
  • Daily inactive water use (if a flow sensor is attached to the controller)

Sensor entities are created for each irrigation zone:

  • Timestamp for the next scheduled automatic watering cycle
  • Remaining time (in minutes) for the current watering cycle
  • Daily active water use for the zone (if a flow sensor is attached to the irrigation zone)

Switch

Switches are added for each zone, controlling:

  • Smart watering features
  • Manual watering

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 15 minutes.

Note

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.

Actions

The Hydrawise integration makes various custom actionsActions are used in several places in Home Assistant. As part of a script or automation, actions define what is going to happen once a trigger is activated. In scripts, an action is called sequence. [Learn more] available.

Action hydrawise.start_watering

Starts a watering cycle in an irrigation zone.

Data attribute Optional Description
entity_id no The irrigation zone in which to start watering.
duration yes The length of time (in minutes) to run a watering cycle. If not specified (or zero), the default watering duration set in the Hydrawise mobile or web app for the irrigation zone will be used.

Action hydrawise.suspend

Suspends automatic watering in an irrigation zone until a specified date.

Data attribute Optional Description
entity_id no The irrigation zone in which to suspend watering.
until no The date & time when automatic watering should be resumed. For example, 2024-08-30 08:30

Action hydrawise.resume

Resumes automatic watering in an irrigation zone.

Data attribute Optional Description
entity_id no The irrigation zone in which to resume watering.

Valve

A valve is added for each zone allowing manual control of zone watering.

When a zone’s valve is opened through Home Assistant, it will have an automatic shutoff time set to the zone’s default watering duration configured in the Hydrawise mobile or web app.