Deprecation

This package is currently unmaintained, see ristomatti/node-red-contrib-node-lifx for current active branch and NPM publisher

Lifx nodes for Node-Red

An solution to control Lifx lights over local network using Node-Red, uses node-lifx library for communicating with the lights.

This module provides input and output nodes for communicating with Lifx lights, the input node accepts multiple color format and automatically converts the values to the right format.

Features

Convert input arguments to light specific arguments
Trigger events for light changes
Self syncing, uses background polling to detect external changes to light
Displays current state for light in Node-Red ui

Examples

Dashboard example config:

This is an example of how to control the light using the node-red-dashboard The split node is used to get the on and bri payload from the light status message, and the join is used to combine the topic and value to an JSON object.

Wakeup example config:

Simple example of using an inject node to trigger an wakeup light behavior every workday, the light transitions from off to on with 75% brightness over an duration of 30s.

Hub Configuration

Light Configuration

Input node

The light is controlled by sending message with an payload containing the new state

Simplified control by sending the following values as payload

Value	Info
`'on'` or `true`	Turn light on
`'off'`or `false`	Turn light off
numeric value	Turn light on and set brightness (0-100%)

More advanced way to control the light is to send an object payload with one or more of the following properties set

Property	Info
`on`	Set light state (true/false)
`red`, `green` and/or `blue`	Set one or more color changel for light (0-255)
`hex`	Set color (#f49242)
`hue`	Set color hue (0-360)
`sat` or `saturation`	Set color saturation (0-100)
`bri` or `brightness`	Set light brightness (0-100%)
`cr`, `mired` or `mirek`	Set Mired color temperature (153 - 500)
`kelvin`	Set kelvin color temperature (2200-6500)
`duration`	Transition time (ms)

Notice: to get the same behavioras the Lifx app when modifying the color temperature you will need to manually set the saturation to zero. This is because the Lifx light can adjust temperature and color independent of each other and I didn't want to limit the choices for the user.

Example: Sending the following to the light will turn it on and dim it upp to 77% over 10 seconds

{
  "payload": {
    "on": true, 
    "bri": 77,
    "duration": 10000
  }
}

Output node

Example output from change event

{
  "id": "d073d5015103",
  "info": {
    "id": "d073d5015103",
    "name": "Lifx Black",
    "address": "192.168.1.107", 
    "model": "Original 1000",
    "capability": ["temperature", "color"]
  },
  "payload": { 
    "on": true, 
    "reachable": true, 
    "bri": 57, 
    "hsv": [ 169, 37, 57 ], 
    "rgb": [ 91, 145, 135 ], 
    "hex": "5C9187", 
    "color": "cadetblue", 
    "kelvin": 2513, 
    "mired": 397
  },
  "state": {
    "on": true,
    "brightness": 57,
    "hue": 169,
    "saturation": 37,
    "kelvin": 2513
  },
  "event": "change",
  "_msgid": "cfd24df6.65934"
}

Using withouth Node-RED

This library can be used independent from Node-RED, the example/mqtt.js file contains an simple example using MQTT.js to enable control an lights on/off status and brightness over MQTT.

The MQTT topic lights will contain an list of all currently detected lights. Specific light can be controlled by sending an message to the topics lights/<id>/on (boolean) or lights/<id>/brightness (number) with the new state.

jdomeij/node-red-contrib-node-lifx