homebridge-luxor

homebridge-luxor 4.0.0

This is a PLATFORM module for the HomeBridge Platform to control FX Luminaire.

This plug-in enables power and brightness controls for:

• FX Luminaire Luxor ZD
• FX Luminaire Luxor ZDC
• FX Luminaire Luxor LXTWO

Installation

1. Install homebridge - Full directions at HomeBridge page
2. Install this plugin using

• Homebridge UI
• npm install -g homebridge-luxor. Update your configuration file. See sample-config.json in this repository for a sample.

Specific ZDC controller with ZDC lights notes

1. This app will designate a specific Luxor color palette for each group. The formula is (250-[group number]+1). Group 1 will user C250, Group 2 will use C249, etc. Homekit will then assign any colors to this new group. This allows you to keep your existing color palettes in case you want to change the lights from the Luxor app.
2. The first time you load this module it will copy the current color palette values (hue and saturation) to the aforementioned new groups.
3. This module will poll the Luxor controller every 30 seconds for color (see note below in known issues on brightness/on/off). If the color is changed in the Luxor app or controller, it will NOT be indicated here. However, we will accurately display brightness/on/off.
4. If you change any of brightness/color/on/off through HomeKit, all values will be updated in this module.

NOTE: Experimental Support for LXTWO

Not supported:

• Color wheel values 251-260 and DMC control 65535

Themes

1. Themes will show up as a switch (instead of a lightbulb). The way Luxor implements themes is that you can only turn them on (eg the theme has no knowledge if individual lights in the theme are changed after a theme is "set"). Therefor, the switch will illuminate momentarily and then turn itself off.
2. The two themes "Illuminate All" and "Extinguish All" will be automatically added to your themes.

Remove accessories

1. There may be occasions (upgrading from the original version of this code) when some accessories will not be removed. You can remove these by including the line removeAllAccessories:true to remove all accessories. Or, list individual UUID's in removeAccessories with a comma delimited string of the names of any Luxor accessories you want to remove. Once you remove the accessories Homebridge will exit. Run homebridge then stop it, reset the value back to the defaults and restart Homebridge.

Known Issues

1. This module will poll the Luxor controller every 30 seconds for updates to brightness/on/off. This may appear to have a small delay when reporting a status that is changed outside of HomeKit.

Future enhancements (in no particular order)

1. Any requests?

Credit

1. I knew that the FX controller had a minimal web interface, and discovered a couple of the API calls, but then found a full(?) list and implementation of the code in a Go library written by Scott Lamb.
2. I used the original WeMo code from rudders as a template and hacked away at it until I got to this point.
3. Of course, to nfarina for the HomeBridge and, in turn, KhaosT for the original HAP-NodeJS project.
4. David Parry for helping convert v1.0 to a platform module.
5. The Luxor team at Hunter for providing support and test materials.