zyonse / homebridge-pentair-screenlogic

Add your Pentair Pool Controller to Apple HomeKit
MIT License
6 stars 4 forks source link

homebridge-pentair-screenlogic

verified-by-homebridge NPM version License Downloads

Fork of schemers/homebridge-screenlogic with some of my own improvements and fixes.

ScreenLogic plug-in for Homebridge using the node-screenlogic library.

Requirements

This plugin was recently rewritten in Typescript to use the latest capabilities of Homebridge 1.x, so it requires at a minimum:

  1. Homebridge >= 1.0.0
  2. Node >= 10.17.0

Installation

  1. Install homebridge using: npm install -g homebridge
  2. Install this plug-in using: npm install -g homebridge-pentair-screenlogic
  3. Update your configuration file. See example config.json snippet below.

Configuration

Configuration samples (edit ~/.homebridge/config.json):

UDP Broadcast

This performs a UDP broadcast on 255.255.255.255, port 1444, so ensure your network supports UDP broadcasts and the device is on the same subnet.

"platforms": [
        {
            "platform": "ScreenLogic"
        }
    ],

Direct connection via IP Address

Use this when you know the local static IP address.

"platforms": [
        {
            "platform": "ScreenLogic",
            "ip_address": "192.168.0.100"
        }
    ],

Remote connection via gateway

Use this to go through Pentair servers.

"platforms": [
        {
            "platform": "ScreenLogic",
            "username": "Pentair: XX-XX-XX",
            "password": "..."
        }
    ],

Optional fields:

Sample config

{
  "platform": "ScreenLogic",
  "hidePoolTemperatureSensor": false,
  "hideSpaTemperatureSensor": true,
  "hideAirTemperatureSensor": true,
  "hidePoolThermostat": false,
  "hideSpaThermostat": false,
  "statusPollingSeconds": 60,
  "createLightColorSwitches": true,
  "disabledLightColors": ["Pool Mode Party", "Pool Mode Romance"],
  "hidden_circuits": "Fountains,Floor Cleaner,Aux 6"
}

Implemented HomeKit Accessory Types

Air Temperature

Pool

Spa

Circuits

Pool Heater

Spa Heater

Light Colors

"On" State

Pool and spa heaters do not turn the pool and/or spa on or off, they just change the heat mode.

i.e., if you want to heat the spa, you need to do two things:

  1. turn on the Spa (via the Spa Switch)
  2. make sure the Spa Heater is set to something other than off (most likely Heat)

This should work well in practice though, as you will generally have a set target temperature and mode, and then just turn the spa on/off without mucking with the thermostat.

This also means that even if the Pool/Spa is turned off and you open the Pool/Spa Heater it mght say "HEATING TO". It will not actually being heating unless the corresponding Pool/Spa switch is turned on.

Note on Light Colors

The light color commands (for modes and colors) are exposed as switches in HomeKit if you enable createLightColorSwitches (it is false by default).

Semantics

Since I don't have the ability to query the current state of which color/mode is active (Screenlogic app doesn't show it either), I implemented the following behavior:

  1. light mode/color switch is turned on (i.e., Pool Mode Sunset)
  2. light command is sent to Screenlogic controller
  3. after a few seconds, the same switch is turned off to give feedback that the command was sent
  4. all pool/spa lights will be turned on (if they aren't already), and set to that mode/color. This is done by the screenlogic controller itself.

Single Tile

Instead of cluttering the room with a bunch of switches, they are all shown in HomeKit as a single accessory called "Light Colors". Tap on the tile to expand, and then turn on the individual switch for the desired mode/color.

If you'd like to show them as separate tiles, you can tap the gear icon at the bottom of the expanded tile (or slide up at the bottom) and then select "Show as Separate Tiles". If you are showing as separate tiles and want to revert back to a single tile, you can select any switch and then select "Show as Single Tile"

Renaming

While showing the light switches as separate tiles, you can rename them if desired, which will let you pick a different name to use with Siri. After renaming you can then show as a single tile again if you'd like.

Siri

You can set a mode/color by saying the mode/color name:

Which will set the selected mode/color and turn on all the lights if they aren't on.