Hayward Omnilogic Pool Controller

This integration will provide sensors and control for Hayward Omnilogic based pool controllers.

Sensors include:

• Water and Air Temperature Sensors
• Pump Speed Sensors
• Salt Level Sensors
• Chlorinator Sensors
• PH and ORP Sensors
• Pool Alarm Sensors

Controls include:

• Colorlogic light controls
• Pump on/off and speed controls
• Relay on/off controls
• Water Heater controls

Install

Once installed, go to Configuration -> Integrations and click the + to add a new integration. On new instances of Home Assistant, Settings -> Devices & Services -> Integrations and click the "+ ADD INTEGRATION" in the bottom right to add the Omnilogic integration.

Search for Omnilogic and you will see the integration available.

Click add, confirm you want to install, and enter your email address and password for your Hayward Omnilogic App login and everything should be added and available. A restart will be necessary in the process.

Repository Missing from HACS Integration Search

If the Omnilogic integration isn't found, you may have to add the repository to HACS using the following steps

1. Open the HACS page/tab in Home Assistant
2. Navigate to the "Integrations" tab
3. Click on the three dots in the top right hand and select "Custom repositories" from the list of options
4. Copy and paste this repoistories link https://github.com/djtimca/haomnilogic and paste it into the "Repository" input field
5. Select "Integration" from the "Category" dropdown
6. Click "Add"

• Allow a few seconds for HACS to pull the latest information and data down. Once available, you'll be able to follow the install instructions above

Enjoy!

Integration Usage

Hayward OmniLogic smart pool and spa technology control.

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

• Sensor - Air Temperature, Water Temperature, Variable Pump Speed, Chlorinator Setting, Instant and Average Salt Levels, pH, and ORP. Note that the Omnilogic controller allows temperature sensors to be renamed; sensors must be left at the default naming convention for the integration to properly recognize them (airTemp, waterTemp, etc.)
• Switch - All relays, pumps (single, dual, variable speed), relay-based lights, chlorinator control, and superchlorination control.
• Light - Colorlogic Lights (V1 and V2).
• Water Heater - Pool heaters of different types.

Tips for Usage

Review the Wiki for tips on how I have used custom cards and a few helpers/tricks to get the most out of this integration for my pool!

Sensor Platform Options

If you have pH sensors in your Omnilogic setup, you can add an offset to correct reporting from the sensor in the integration configuration.

Go to the Integrations page in setup and choose 'Configure' to adjust your offsets.

Switch Platform

The switch platform contains custom services for pump speed control and chlorinator management.

Pump Speed Control

To set pump speed on variable speed pumps, call the omnilogic.set_pump_speed service:

# Modern format (recommended)
service: omnilogic.set_pump_speed
target:
  entity_id: switch.pool_pump
data:
  speed: 75

# Legacy format (still supported)
service: omnilogic.set_pump_speed
data:
  entity_id: switch.pool_pump
  speed: 75

Chlorinator Control

The integration provides full chlorinator control with two switch entities:

• Chlorinator Switch: Controls the main chlorinator on/off state
• Superchlorinate Switch: Controls superchlorination mode (only available when chlorinator is on)

To set the chlorinator timed output percentage, use the omnilogic.set_chlor_timed_percent service:

# Modern format (recommended)
service: omnilogic.set_chlor_timed_percent
target:
  entity_id: switch.chlorinator
data:
  timed_percent: 40

# Legacy format (still supported)
service: omnilogic.set_chlor_timed_percent
data:
  entity_id: switch.chlorinator
  timed_percent: 40

The timed_percent value must be between 0 and 100.

Light Platform

The light platform allows you to set the color or effect of your lights from the effect list supported by your light version.

If you have V2 Colorlogic lights you can also set the brightness and speed of the lights using the custom service omnilogic.set_v2_lights:

# Modern format (recommended)
service: omnilogic.set_v2_lights
target:
  entity_id: light.pool_lights
data:
  speed: 5
  brightness: 3

# Legacy format (still supported)
service: omnilogic.set_v2_lights
data:
  entity_id: light.pool_lights
  speed: 5
  brightness: 3

Both speed (0-8) and brightness (0-4) parameters are optional.

Debugging integration

If you have problems with the integration, the first thing we will need to troubleshoot is the telemetry and configuration data for your pool setup. You can easily download this information using Home Assistant's built-in diagnostics feature:

1. Go to Settings → Devices & Services in your Home Assistant dashboard
2. Find the Hayward Omnilogic integration and click on it
3. Click on the 3-dot menu in the top-right corner
4. Select Download diagnostics
5. Save the JSON file to your computer

This file contains all the necessary information for troubleshooting (with sensitive information like system IDs and credentials automatically redacted).

6. When opening an issue on GitHub (https://github.com/djtimca/haomnilogic), attach this diagnostics file to your issue
7. Include a clear description of the problem you're experiencing