Yeelight Binding

This binding integrates the Yeelight Lighting Product (opens new window).

Supported Things

• Yeelight LED White Bulb (opens new window) (Thing type dolphin)
• Yeelight LED Color Bulb (opens new window) (Thing type wonder)
• Yeelight LED Color Stripe (opens new window) (Thing type stripe)
• Yeelight LED Ceiling Light (opens new window) (Thing type ceiling)

Preconditions

To control Yeelight devices with this binding, you need to connect the device to your local network at first with the Yeelight app. This app is available in the iOS AppStore and on Google Play.

Then you need to activate LAN control mode by enable Developer Mode in device settings, after which it will become discoverable by openHAB.

Discovery

Yeelight smart LED devices announce themselves on the network through UPnP, so that they can be discovered.

Thing Configuration

All Yeelight things require the deviceId from the device as a configuration parameter. This table shows all available parameters:

Parameter	Values	Mandatory
deviceId	ID of the Yeelight device	Yes
duration	Duration for changing between different states	No

Channels

All devices support some of the following channels:

Channel	Item Type	Description
brightness	Dimmer	This channel supports adjusting the brightness value, it is available on dolphin and ceiling.
color	Color	This channel supports color control, it is available on wonder and stripe.
colorTemperature	Dimmer	This channel supports adjusting the color temperature, it is available on wonder and stripe and ceiling.
command	String	This channel sends a command directly to the device, it is available on all Yeelight Things.
backgroundColor	Color or Dimmer	This channel supports color control for the ambient light, it is available on ceiling4.
nightlight	Switch	This supports switching to nightlight mode, it is available on ceiling1 or ceiling4.

Full Example

Things:

Thing yeelight:stripe:1 [ deviceId="0x000000000321a1bc", duration=1000 ]

Items:

Color YeelightLEDColor { channel="yeelight:stripe:1:color" }
Switch YeelightLEDSwitch { channel="yeelight:stripe:1:color" }
String YeelightLEDCommand { channel="yeelight:stripe:1:command" }

Rules:

rule "Yeelight Custom Command"
when
        Time is noon
then
        YeelightLEDCommand.sendCommand("set_power;\"on\",\"smooth\",2000")
end

Note that set_power is the command, then a separator ; must be used. \"on\",\"smooth\",2000 are the parameters.

Full list of commands can be found here (opens new window).

Caught a mistake or want to contribute to the documentation? Edit this page on GitHub (opens new window)