node-red-contrib-yeelight-compat-hue

Node-RED nodes to control MiHome/Xiaomi Yeelights from your smart home, somewhat API compatible with node-red-contrib-node-hue nodes.

Install

Run the following command in your Node-RED user directory – typically ~/.node-red:

npm i node-red-contrib-yeelight-compat-hue -S

Usage

Provides two palette nodes – one to send control commands to a Yeelight, and one to receive messages when a Yeelight's state changes.

Output node

Sets the state of the selected Yeelight device.

msg.payload must be an object containing the new state's properties of the selected Yeelight device.

| Property | Details | | :---| :---| | on | Sets the on state where the value is true or false| | bri | Sets the brightness value from 0 to 255 | | ct | Sets the color temperature value in Kelvin from 1700 to 6500 | | hue | Sets the hue value from 0 to 65535 | | sat | Sets the saturation value from 0 to 255 | | hex | Sets the rgb value from #00000 to #FFFFFF | | duration | Sets a transition time in milliseconds, e.g. 4500 means 4.5 seconds. Defaults to 500 |

Example payloads

 {
    "on": true,
    "bri": 255,
    "hue": 913,
    "sat": 255,
    "duration": 5000
}

{
    "on": true,
    "bri": 120,
    "hex": "#AA00CC",
}

{
    "ct": 2200,
}

The node supports sending color temperature values, hex values and HSV values.
The brightness value will always have to be provided separately and will not be deducted from e.g. a hex value's brightness component.

References

This node's input payload structure is based on node-red-contrib-node-hue, which is based on Node Hue API.

Input node

Returns the current state of the selected Yeelight device.

msg.payload is an object containing the current state of the selected Yeelight device.

The node will listen to changes of the connected Yeelight and send a message whenever a change is detected. The payload property of the message will be set to the new state of the Yeelight.

Additionally, a fresh state can be requested from the connected Yeelight by sending a message to the node. The payload property of the message will be overwritten with the state of the Yeelight. All other properties of the msg are preserved.

Example payload

{
    "state": {
        "on": false,
        "bri": 255,
        "colormode": "rgb",
        "hex": "#ff1500",
        "hue": 913,
        "sat": 255
    },
    "name": "Closet",
    "raw": {
        "name": "Closet",
        "power": "off",
        "bright": "100",
        "rgb": "16717056",
        "ct": "4244",
        "hue": "0",
        "sat": "100",
        "color_mode": "1",
        "delayoff": "0",
        "flowing": "0",
        "flow_params": "0,1,10000,1,16711680,69,33000,1,16711882,34,39000,1,16744704,17,34000,1,16711680,61",
        "music_on": "0"
    }
}

The raw property of msg.payload contains the raw state information retrieved from the Yeelight for advanced usage.
Note that value scales are not compatible with node-red-contrib-node-hue, and that hue value and rgb value will not match since only the correct color per color_mode is returned by the lamp.

Configuration node

Configures a Yeelight connection to one light in the local network.

Options

| Property | Details | | :--- | :--- | | Hostname | An IP address or other hostname that points to a Yeelight on the network | | Port number | Port number the Yeelight is accessible over, default being 55443 |

Details

Developer mode/LAN control has to be activated (usually from within the Yeelight app) to allow local control of the Yeelight through Node-RED. You can learn more about Yeelight developer options here.

Support

If something is not working as expected, if you think there is a feature missing, or if you think this node could be improved in other ways, please create an issue on GitHub.

Links

• Find node-red-contrib-yeelight-compat-hue in the Node-RED flow library
• Find node-red-contrib-yeelight-compat-hue on npm
• Find node-red-contrib-yeelight-compat-hue on GitHub

Hello bear