Jandy iAquaLink

The Jandy iAquaLink integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] lets you monitor and control supported Jandy pool and spa systems from Home Assistant. Depending on the equipment connected to your controller, you can check water and air temperatures, control auxiliary equipment like pumps and water features, manage compatible pool lights, and adjust supported pool or spa heaters.

Use case: Turn on your spa heater before you get home, automate pool lights at sunset, get notified when freeze protection activates, or add your pool equipment status to a dashboard so you can check it at a glance.

Supported devices

The integration supports pool and spa systems that are managed through the iAquaLink cloud service using one of the following platforms:

• iAquaLink 2.0 (iQ20)
• eXO

The entities that appear in Home Assistant depend on the equipment configured in your iAquaLink system. For example, if your system has a spa heater, pool lights, a cleaner, or a waterfall circuit, Home Assistant can create entities for those features.

Unsupported devices

Other iAquaLink systems are not supported. Equipment that is not exposed in the iAquaLink app or cloud service also cannot be added to Home Assistant.

Prerequisites

1. Create an account and log in using either the iAquaLink app or the iAquaLink website.
2. Add your devices to the account you created in the previous step, typically using their serial numbers.

Configuration

To add the Jandy iAquaLink hub to your Home Assistant instance, use this My button:

Supported functionality

Entities

The Jandy iAquaLink integration provides the following entities.

Binary sensors

• Freeze protection
  • Description: Indicates whether the controller has enabled freeze protection.
  • Remarks: Only available on systems that expose freeze protection status.

Climate

• Pool heater or spa heater
  • Description: Lets you turn a supported heater on or off and set the target water temperature.
  • Modes: Heat, Off
  • Remarks: Created only when your iAquaLink system exposes a controllable heater.

Lights

• Pool and spa lights
  • Description: Lets you turn compatible lights on or off.
  • Remarks: Some lights also support brightness control or effect selection, depending on the hardware exposed by your iAquaLink system.

Sensors

• Temperature sensors

  • Description: Report numeric values exposed by the controller, such as pool, spa, or air temperature.
  • Remarks: Temperature units follow the unit configured in your iAquaLink system.

• Other numeric sensors

  • Description: Additional numeric readings may be available when your controller exposes them through the cloud service.

Switches

• Auxiliary equipment
  • Description: Lets you turn supported auxiliary circuits on or off.
  • Examples: Filter pumps, cleaners, waterfalls, blowers, and other equipment connected to auxiliary relays.
  • Remarks: The exact switch entities depend on how your pool or spa system is configured.

Examples

Examples of automations you can create using the Jandy iAquaLink integration.

Preheat the spa on a schedule

This automation turns on the spa heater and sets the target temperature every weekday afternoon.

This example assumes your iAquaLink system is configured to use degrees Fahrenheit.

alias: "Preheat spa before evening"
description: >
  Turn on the spa heater and set the target temperature every weekday afternoon.
triggers:
  - trigger: time
    at: "16:30:00"
conditions:
  - condition: time
    weekday:
      - mon
      - tue
      - wed
      - thu
      - fri
actions:
  - action: climate.set_temperature
    target:
      entity_id: climate.spa_heater
    data:
      hvac_mode: heat
      temperature: 100

Notify when freeze protection turns on

This automation sends a notification when your controller activates freeze protection.

alias: "Notify when freeze protection starts"
description: >
  Send a notification when the pool controller enables
  freeze protection.
triggers:
  - trigger: state
    entity_id: binary_sensor.freeze_protection
    to: "on"
actions:
  - action: notify.mobile_app_your_phone
    data:
      title: "Pool freeze protection active"
      message: >
        The Jandy controller has enabled freeze protection.

Data updates

This integration uses cloud pollingData polling is the process of querying a device or service at regular intervals to check for updates or retrieve data. By defining a custom polling interval, you can control how frequently your system checks for new data, which can help optimize performance and reduce unnecessary network traffic. [Learn more] to refresh data from your iAquaLink system, like equipment status, sensor readings, and climate values. Home Assistant updates this data approximately every 15 seconds.

Known limitations

Only equipment exposed through the iAquaLink cloud service can be added to Home Assistant. The entities you see depend on the controller model and the pool or spa equipment configured in the iAquaLink app.

If you need support for another iAquaLink platform, please open a request in the iaqualink-py Python library repository.

Troubleshooting

logger:
  default: info
  logs:
    iaqualink: debug
    homeassistant.components.iaqualink: debug

Removing the integration

This integration follows standard integration removal.

To remove an integration instance from Home Assistant

1. Go to Settings > Devices & services and select the integration card.
2. From the list of devices, select the integration instance you want to remove.
3. Next to the entry, select the three dots menu. Then, select Delete.