homebridge-screenlogic
Homebridge using the node-screenlogic library.
Screen Logic plug-in for
Requirements
This plugin was recently rewritten in Typescript to use the latest capabilities of Homebridge 1.x, so it requires at a minimum:
- Homebridge >= 1.0.0
- Node >= 10.17.0
Installation
- Install homebridge using:
npm install -g homebridge
- Install this plug-in using:
npm install -g homebridge-screenlogic
- 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": ,
Direct connection via IP Address
Use this when you know the local static IP address.
"platforms": ,
"port"
is optional and defaults to 80"username"
is optional, but is recommended as it is used to keep accessory UUIDs consistent. Should be in the format"Pentair: XX-XX-XX"
.
Remote connection via gateway
Use this to go through Pentair servers.
"platforms": ,
Optional fields:
-
"hidden_circuits"
comma-separated list of circuit names to hide. Set this for circuits you don't want showing up as switches. (ie..,"Aux 6,Floor Cleaner"
). -
"hideAirTemperatureSensor"
hides the air temperature sensor. Default isfalse
. -
"hidePoolTemperatureSensor"
hides the pool temperature sensor, which is redundant if you are showing pool thermostat. Default isfalse
. -
"hideSpaTemperatureSensor"
hides the spa temperature sensor, which is redundant if you are showing spa thermostat. Default isfalse
. -
"hidePoolThermostat"
hides the pool thermostat (aka, pool heater) if you don't want to allow changes via HomeKit. Default isfalse
. -
"hideSpaThermostat"
hides the spa thermostat (aka, spa heater) if you don't want to allow changes via HomeKit. Default isfalse
. -
"statusPollingSeconds"
time in seconds to poll for pool statu. Default is 60 seconds. -
createLightColorSwitches
will create a "Pool Lights" accessory that contains switches for turing on light modes/colors. Default isfalse
. -
disabledLightColors
an array of strings with the names of light mode/colors you want to disable. Default is an empty array.
Sample config
Implemented HomeKit Accessory Types
Air Temperature
- TemperatureSensor accessory (Air) indicating the ambient temperature where thee screenlogic hardware is located
Pool
- TemperatureSensor accessory (Pool) indicating the ambient temperature of the pool (last known temperature if pool isn't running)
Spa
- TemperatureSensor accessory (Spa) indicating the ambient temperature of the Spa (last known temperature if pool isn't running)
Circuits
- creates a Switch accessory for each discovered circuit (i.e., Pool, Spa, Jets, Pool Light, Spa Light, etc)
Pool Heater
- Thermostat accessory with ambient temperature, mode control (heat/cool/auto/off), and target temperature control. See also Note on Pool/Spa Heater below.
Spa Heater
- Thermostat accessory with ambient temperature, mode control (heat/cool/auto/off), and target temperature control. See also Note on Pool/Spa Heater below.
Light Colors
- Light Colors accessory with multiple switches for setting a light mode/color. See also Note on Light Colors
Note on Pool/Spa Heater
The Pool and Spa Heater accessories are exposed as Thermostats in HomeKit. Since the semantics are slightly different between Pentair heat mode and a thermostat target heating state, a mapping is required.
Mapping
I picked the following mapping, which seemed like the most logical mapping:
Pentair Heat Mode | Thermostat State |
---|---|
Off | Off |
Heater | Heat |
Solar Preferred | Auto |
Solar | Cool |
The only strange one is mapping Solar
to Cool
. I decided to go that route given the first three were fairly obvious (to me at least).
An alternative would be to expose three distinct on/off switches that represent each mode, and then ignore state changes (and maybe just allowing Off/Heat).
"On" State
The other compromise is that the 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:
- turn on the Spa (via the Spa Switch)
- 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:
- light mode/color switch is turned on (i.e., Pool Mode Sunset)
- light command is sent to Screenlogic controller
- after a few seconds, the same switch is turned off to give feedback that the command was sent
- all pool/spa lights will be turned on (if they aren't already), and set to that mode/color. This is done by the screen logic 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:
- "Hey Siri, turn on pool mode sunset"
- "Hey Siri, turn on pool color blue"
Which will set the selected mode/color and turn on all the lights if they aren't on.