Yeelight-Vera

A plugin for Vera Home Automation Controllers to control Yeelight bulbs and fixtures.

Installation

To install this plugin:

Download a release package from the Github repository;
Unzip the files;
Upload the files to your Vera using the uploader at Apps > Develop apps > Luup files
If this is the first time installing the plugin, create the master device:
- Go to Apps > Develop apps > Create device
- Enter Yeelight Plugin in the Description field;
- Enter D_Yeelight1.xml in the Upnp Device Filename field;
- Enter I_Yeelight1.xml in the Upnp Implementation Filename field;
- Leave all other fields blank (you may set the room if you wish), and press the Create device button.
- Go to Apps > Develop apps > Test Luup code (Lua) and enter luup.reload() and run it.
- Hard-refresh/reload your browser (with cache flush). You should now see the Yeelight Plugin master device.

Additional Instructions for openLuup

openLuup does not have some of Vera's "native" service files and device type declarations used by this plugin. To get this plugin working under openLuup, you will need to download D_DimmableRGBLight1.json and D_DimmableRGBLight1.xml (uncompressed, not the compressed .lzo versions) and put them in your openLuup installation directory.

Finding Devices

The Yeelight plugin does discovery of devices using Yeelight's twist on SSDP. Before launching discovery, however, you have to use the Yeelight application (Android, iOS, etc.) to enable "LAN Control" on each device. To do this:

Open the Yeelight application;
Register any new devices you may have added but are not yet shown in the app;
Go into each device...
Click the icon that looks like a media eject button
Click the "LAN Control" icon
Turn LAN control ON.

To discover your controllable devices, go to the Yeelight Plugin master device control panel, and click the Run Discovery button. Discovery will then launch, and takes about 15 seconds. It will create child devices for any Yeelight device that responds (see caution below).

Controlling Devices

Controlling discovered devices uses the Vera-standard "RGB Dimmable Light" services and user interface (so don't blame me). From this interface, you can control on/off, brightness, color temperature, and RGB color.

Different products have different limits for these values, and Vera has its own limits; not everything that is possible for the device may be possible through the interface, and not everything that the interface can do may be possible on the bulb. The most notable is color temperature, where the Yeelight API allows temperatures down to 1600°K, but Vera's lower limit is 2000; and Vera's upper limit is 9000K, where Yeelight's API maximum is 6500K.

If a device is controlled using interfaces other than plugin, there may be a noticeable delay before the plugin shows the device status. Updates are not immediate; the API has to be polled, and the default polling interval is 300 seconds (5 minutes). If this proves inconvenient, you can change the UpdateInterval state variable on the bulb, or to change it for all bulbs, on the master device. Keep in mind, however, that very small intervals (less than 60 seconds), may increase the load on your Vera (for likely very little average benefit).

License and Warranty