LIFX light driver

This driver provides 2 way communication between an XP-series processor and LIFX light bulbs.

It has been tested on LIFX A19, LIFX mini, and LIFX 100mm downlight.

Tested firmware is 2.76

Without license key, it is time limited to 60 minutes of functionality.

Setup

This driver does not implement discovery. LIFX lights do not allow setting of static IPs so you will need to perform DHCP reservation for the light in your router.

General

Polling Interval

Choose how often the system polls the lights to check for any updates. By default it is set to 15000ms. If you are a heavy user of the LIFX app, you may want it to poll quicker to keep it updated.

Number of Lights

Enter the number of lights you want to control. This applies to the number of physical bulbs you will be controlling. Maximum number of lights is 100.

Number of Groups

Enter the number of groups you want to create. This would usually align to the number of rooms that have LIFX lights in them. All lights in a group will be controlled simultaneously. Lights can be in multiple groups. Simply enter the first group number, followed by a comma, followed by the second group number and so on. This driver currently allows 30 groups.

Group Names

Group Name xx

Fill out the group names for the groups that will be created. These will show in integration designer.

Light xx

Light Location

Fill out the location of each light. This name is not used in integration designer and is intended to simply make it easier to track where each light is installed.

Light UDP Address

Enter the IP address of each light. Remember, LIFX do not allow static IPs, so you will need to reserve an address using DHCP reservations on your router.

Light Group

Enter the group that each light will belong to. Each light can only belong to one group. But any group can contain as many lights as you want. Every light needs to belong to a group. If you have a light by itself, simply make it the only light in the group.

License

License Code

Enter a license code here to disable the trial timer.

Commands

Slider commands

There are 4 slider commands that can be used to alter one aspect of the controlled light. These are Hue, Brightness, Saturation, and Temperature.

There are 3 parameters for each of the slider commands. The first one is the value you want to set. Leave at default if using on a slider.

Transition. This is the time in milliseconds it takes for the light bulb to change to its new value. Default is 250ms. If this value is too low, the change looks jerky. If it is too high, it takes too long and appears unresponsive. Default should give a nice smooth change.

Polling. This is how long the processor waits after a transition to check the light state for feedback. Default is 100ms. Depending on your network, this value may need to be adjusted. If you find that after sliding, the status jumps back a bit, increase the polling time until it doesn’t.

General Commands

Power: You have 3 options. On, Off and toggle.

Transition. This is the time in milliseconds it takes for the light bulb to change to its new value. Default is 250ms. If this value is too low, the change looks jerky. If it is too high, it takes too long and appears unresponsive. Default should give a nice smooth change.

Polling. This is how long the processor waits after a transition to check the light state for feedback. Default for power commands is 2000ms. Depending on your network, this value may need to be adjusted. If you find that after sliding, the status is sometimes incorrect, increase the polling time until it doesn’t.

Set All: This command is able to set all the available parameters for a light in one go. It has to cheat a bit to get around the 4 parameter limit of RTI.

HSBK. This parameter takes the 4 required values of Hue, Saturation, Brightness and Temperature as a colon separated string. Eg for a transition to 200 hue, 50% saturation, 100% brightness, and 3500K temperature, you would enter the string “200:50:100:3500”. Do not leave any fields blank.

Transition. This is the time in milliseconds it takes for the light bulb to change to its new value. Default is 250ms. If this value is too low, the change looks jerky. If it is too high, it takes too long and appears unresponsive. Default should give a nice smooth change.

Polling. This is how long the processor waits after a transition to check the light state for feedback. Default is 100ms. Depending on your network, this value may need to be adjusted. If you find that after sliding, the status jumps back a bit, increase the polling time until it doesn’t.

Get State

This function updates all the values all lights. The lights also update after every command.

Feedback

Feedback is available for every light, but is only available if Groups Only option is unticked in driver settings.

Feedback is available for every group, and is taken from the state of the first light in the group.

Feedback for the ALL LIGHTS commands is taken from the first light entered in config settings.