Yeelight Wifi Bulb

The yeelight light platform allows you to control your Yeelight Wifi bulbs with Home Assistant.

Example configuration

To enable those lights, add the following lines to your configuration.yaml file:

# Example configuration.yaml entry
  - platform: yeelight
        name: Living Room
        transition: 1000
        use_music_mode: True #(defaults to False)
        save_on_change: False #(defaults to True)
        name: Front Door

Configuration variables:

  • ip (Required): IP(s) of your Wifi bulbs
  • name (Optional): A friendly name for the device.
  • transition (Optional, default 350): Smooth transitions over time (in ms).
  • use_music_mode (Optional, default False): Enable music mode.
  • save_on_change (Optional, default True): Saves the bulb state when changed from Home Assistant.

Music mode

Per default the bulb limits the amount of requests per minute to 60, a limitation which can be bypassed by enabling the music mode. In music mode the bulb is commanded to connect back to a socket provided by the component and it tries to keep the connection open, which may not be wanted in all use-cases. Also note that bulbs in music mode will not update their state to “unavailable” if they are disconnected, which can cause delays in Home Assistant.

Initial setup

Before trying to control your light through Home Assistant, you have to setup your bulb using Yeelight app. ( Android, IOS ). In the bulb property, you have to enable “LAN Mode” (previously called “Developer mode”). LAN mode may only be available with the latest firmware installed on your bulb. Firmware can be updated in the application after connecting the bulb. Determine your bulb IP (using router, software, ping …). Information on how to enable “LAN Mode” can be found here.

This component is tested to work with the following models. If you have a different model and it is working please let us know.

  • YLDP01YL: LED Bulb (White)
  • YLDP02YL: LED Bulb (Color)
  • YLDP03YL: LED Bulb (Color) - E26
  • YLDP06YL: LED Bulb (Color) II
  • YLDD01YL: Lightstrip (Color)
  • YLDD02YL: Lightstrip (Color)
  • MJCTD01YL: Xiaomi Mijia Bedside Lamp - WIFI Version!
  • MJTD01YL: Xiaomi Mijia Smart LED Desk Lamp (autodiscovery isn’t possible because the device doesn’t support mDNS due to the small amount of RAM)
  • YLXD02YL: Yeelight Ceiling Light 4 (Jiaoyue 650)
  • YLXD01YL: Yeelight Smart LED Ceiling Light - Youth Version

Platform Services

Service light.yeelight_set_mode

Set an operation mode.

Service data attribute Optional Description
entity_id yes Only act on a specific yeelight. Else targets all.
mode no Operation mode. Valid values are ‘last’, ‘normal’, ‘rgb’, ‘hsv’, ‘color_flow’, ‘moonlight’.