openhab-addons/bundles/org.openhab.binding.haywardomnilogic/README.md
Matt 770e897f36
[haywardomnilogic] Added filter & pump RPM & state channels (#11223)
* Update unit formating

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* Updates per last review

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* Updated units to decimal

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* Removed erroneous chlorinator code from filterhandler

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* Adding pump support, added body of water to xml paths to prevent detection of terminal or other items

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* Added getApiDef call to initialize when debug=trace

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* Fixed typo on README

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* Cleanup pump xml spotless checks

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* Fix typos in README

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* Fixed a couple typos in pump discovery

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* Fixed README typo

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* Fix untested pump typos

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* Fix pump typo

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* Add thing properties and max filter/pump speed command

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* Add support for relays to exist in the backyard

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* Update README

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* Add support for colorLogicLights to exist in the backyard

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* Remove sensor thing and associated handler.  Hayward does not expose data for stand alone sensors.  Packaged in other things (backyard air temp, body of water temp, etc.)

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* Added heater states

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* Updated heater state in readme

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* Added dynamic state description updates to set pump & filter minimum and maximum speeds.

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* Moved dynamicStateDescription updates to thing initialize routine

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* Code checks

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* Add min/max limits to filter, pump and heater setpoints

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* Add virtual heater dynamic state descriptions.  Change filter & pump speeds back to number:dimensionless

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* Add pump & filter speed RPM channels

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* Fixed typo in pump handler

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* Elaborate on filter/pump handler initialize exception

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* Update bow.xml property intit's to empty values (fix typos)

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* Added debug flag to inject XML until appropriate integration tests are setup

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* Pump and Filter enable to last speed

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* Removed tatus file

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* Update readme

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* format readMe

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* Update ReadMe

Signed-off-by: Matt Myers <mmyers75@icloud.com>

* Remove xml debug code

Signed-off-by: Matt Myers <mmyers75@icloud.com>
2022-01-03 16:49:36 +01:00

8.8 KiB

Hayward Omnilogic Binding

The Hayward Omnilogic binding integrates the Omnilogic pool controller using the Hayward API.

The Hayward Omnilogic API interacts with Hayward's cloud server requiring a connection with the Internet for sending and receiving information.

Supported Things

The table below lists the Hayward OmniLogic binding thing types:

Things Description Thing Type
Hayward OmniLogix Connection Connection to Hayward's Server bridge
Backyard Backyard backyard
Body of Water Body of Water bow
Chlorinator Chlorinator chlorinator
Colorlogic Light Colorlogic Light colorlogic
Filter Filter control filter
Heater Equipment Actual heater (i.e. gas, solar, electric) heater
Pump Auxillary pump control (i.e. spillover) pump
Relay Accessory relay control (deck jet sprinklers, lights, etc.) relay
Virtaul Heater A Virtual Heater that can control all of the heater equipment based on priority virtualHeater

Discovery

The binding will automatically discover the Omnilogic pool things from the cloud server using your Hayward Omnilogic credentials.

Thing Configuration

Hayward OmniLogic Connection Parameters:

Property Default Required Description
Host Name https://app1.haywardomnilogic.com/HAAPI/HomeAutomation/API.ash Yes Host name of the Hayward API server
User Name None Yes Your Hayward User Name (not email address)
Password None Yes Your Hayward User Password
Telemetry Poll Delay 12 Yes Telemetry Poll Delay (10-60 seconds)
Alarm Poll Delay 60 Yes Alarm Poll Delay (0-120 seconds, 0 disabled)

Channels

Backyard Channels

Channel Type ID Item Type Description Read Write
backyardAirTemp Number:Temperature Backyard air temp sensor reading R
backyardStatus String Backyard status R
backyardState String Backyard state R
backyardAlarm1 String Backyard alarm #1 R
backyardAlarm2 String Backyard alarm #2 R
backyardAlarm3 String Backyard alarm #3 R
backyardAlarm4 String Backyard alarm #4 R
backyardAlarm5 String Backyard alarm #5 R

Body of Water Channels

Channel Type ID Item Type Description Read Write
bowFlow Switch Body of Water flow sensor feedback R
bowWaterTemp Number:Temperature Body of Water temperature R

Chlorinator Channels

Channel Type ID Item Type Description Read Write
chlorEnable Switch Chlorinator enable R/W
chlorOperatingMode String Chlorinator operating mode R
chlorTimedPercent Number:Dimensionless Chlorinator timed percent R/W
chlorOperatingState Number Chlorinator operating state R
chlorScMode String Chlorinator super chlorinate mode R
chlorError Number Chlorinator error R
chlorAlert String Chlorinator alert R
chlorAvgSaltLevel Number:Dimensionless Chlorinator average salt level in Part per Million (ppm) R
chlorInstantSaltLevel Number:Dimensionless Chlorinator instant salt level in Part per Million (ppm) R
chlorStatus Number Chlorinator K1/K2 relay status R

Colorlogic Light Channels

Channel Type ID Item Type Description Read Write
colorLogicLightEnable Switch Colorlogic Light enable R/W
colorLogicLightState String Colorlogic Light state R
colorLogicLightCurrentShow String Colorlogic Light current show R/W

Filter Channels

Channel Type ID Item Type Description Read Write
filterEnable Switch Filter enable R/W
filterValvePosition String Filter valve position R
filterSpeedPercent Number:Dimensionless Filter speed in % R/W
filterSpeedRpm Number Filter speed in RPM R/W
filterSpeedSelect String Filter speed presets R/W
filterState String Filter state R
filterLastSpeed Number:Dimensionless Filter last speed in % R

Heater Channels

Channel Type ID Item Type Description Read Write
heaterState String Heater state R
heaterEnable Switch Heater enable R

Pump Channels

Channel Type ID Item Type Description Read Write
pumpEnable Switch Pump enable R/W
pumpSpeedPercent Number:Dimensionless Pump speed in % R/W
pumpSpeedRpm Number Pump speed in RPM R/W
pumpSpeedSelect String Pump speed presets R/W
pumpState String Pump state R
pumpLastSpeed Number:Dimensionless Pump last speed in % R

Relay Channels

Channel Type ID Item Type Description Read Write
relayState Switch Relay state R/W

Virtual Heater Channels

Channel Type ID Item Type Description Read Write
heaterEnable Switch Heater enable R
heaterCurrentSetpoint Number:Temperature Heater Current Setpoint R/W

Full Example

After installing the binding, you will need to manually add the Hayward Connection thing and enter your credentials. All pool items can be automatically discovered by scanning the bridge.
Goto the inbox and add the things.