Yeelight Binding

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

Supported Things

Device	Thing type ID	Device model
Yeelight LED Ceiling Light (opens new window)	ceiling	ceiling, ceiling3
Yeelight LED Ceiling Light (opens new window)	ceiling1	ceiling1, ceiling11, ceil26
Yeelight LED Ceiling Light (opens new window)	ceiling4	ceiling4
Yeelight LED Color Bulb (opens new window)	wonder	color, color4
Yeelight LED White Bulb (opens new window)	dolphin	mono
Yeelight LED White Bulb v2 (opens new window)	ct_bulb	ct_bulb
Yeelight LED Color Stripe (opens new window)	stripe	stripe, strip6
Yeelight Mi LED Desk Lamp (opens new window)	desklamp	desklamp

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)