LIFX is quite a complex system to integrate into Hubitat so it's not as simple as just installing a single driver
There are several components
- The LIFX Master App - this is where you discover devices
- Various LIFX device handlers
- LIFX Color
- LIFXPlus Color (does not currently include support for Infrared/Night Vision)
- LIFX White
- LIFX Day and Dusk
- LIFX Tile - dummy driver, only supports on/off
- LIFX Multizone - for Beam and Strip, currently only supports on/off
On the Apps Code page, press the New App button
Paste the code for LIFXMasterApp.groovy and press the Save button (or type Ctrl-S)
On the Devices Code page, press the New Driver button
Paste the code for LIFXColor.groovy and save
Repeat this process for each of the device handlers you want to install. It's probably best to add all of them even if you don't have a corresponding device at the moment, I've found that buying LIFX devices is a bit addictive.
On the Apps page press the Add User App button then click on LIFX Master in the list of available apps.
####IMPORTANT: don't forget to press the Done button to make sure the the LIFX Master app sticks around.
First of all, make sure that all your LIFX devices are powered on, obviously discovery won't find any device that doesn't have power.
Again IMPORTANT if you didn't press the Done button when you created the LIFX Master app then do it now.
Open the LIFX Master app and press the Discover devices button. You may notice the LIFX Discovery device in your list of devices, but this should disappear at the end of the scan.
When the drivers/app have been updated I'll post a message on the Hubitat forum.
To update a device or the app just open the corresponding code,
- click the
Importbutton at the top of the window - a dialog should open with the URL prefilled - click its
Importbutton - click
OKon the override dialog that should have appeared - click the
Savebutton
I normally open the code for each app and device driver in a new tab, then for each tab I'll just do the import (steps 1-3) then once the code has been updated I'll go through the tabs one at a time clicking save and then closing that tab.
While this is happening, you may find some errors appearing in the log if I've made significant changes. Only be concerned if you see errors after all the drivers and the app have been updated.
The LIFX Lan Protocol uses UDP messages, it seems that sometimes these can be missed or lost, so the discovery process makes 5 passes over your local network to try to mitigate this. So far this seems good enough on my network.
Further to this, when a command is sent to change a LIFX setting it requests an acknowledgement and the sequence number is tracked with the LAN Protocol packet. When a subsequent command or query is sent it checks to see whether the acknowledgement was received. If it wasn't received the packet is sent one more time. The reason for this is that UDP messages are not guaranteed to arrive, so it's pretty much a small safety net. You can expect that this will happen at least when the device is next polled (under a minute).
If you find that some devices aren't discovered
- try the Discover new only new devices button
- make sure that the missing devices still have power - someone may have turned off a switch :)
- try altering some of the options as described below.
With recent improvements I've found that the default settings should be more than enough to discover all your devices in two passes, but your mileage may vary.
My first recommendation would be increasing the value of Time between commands (milliseconds).
Try increasing it by 10 at a time.
You can also increase Maximum number of passes to give discovery a better chance of reaching all the devices in your network.
I've found that all my devices are found in the first pass at least 95% of the time.
Let me know if you see any errors in the log, and I'll do my best to fix the issue as soon as possible
I have assumed that you will be running a Class C network (also known as /24), ie that your subnet mask is 255.255.255.0, which limits you to a total of 254 IP addresses.
Note that this uses the IP address as the device network id - if you change the id you may break things. If you don't assign fixed IP addresses to your LIFX devices then you may be able to use this to avoid having to scan for new devices.