esphome-yeelight-ceiling-light

esphome-yeelight-ceiling-light

ESPHome custom firmware for ESP32 based Yeelight Ceiling Lights.

Requirements

• ESPHome 2026.1.0 or higher. The Bluetooth remotes YLYK01YL and YLKG07YL require ESPHome 2026.11.0 or higher.
• TTL-to-USB module (FTDI/CH430/PL2303) and some wires to flash the device once

Supported devices

Flashing over UART

The per-model pinouts below say which pads to use. For what goes wrong once they are wired - grounding, powering the board, download mode, and reading esptool’s misleading errors - see docs/flashing-over-uart.md.

Flashing without opening the device

Every procedure in this repository flashes over UART. On ESP32 models running stock firmware there is a network-only route: the device’s own miIO.ota mechanism, relayed through the Xiaomi cloud, pointed at a file on your LAN. See docs/flashing-over-the-network.md and the helpers in tools/.

Confirmed on yeelink.light.lamp9 firmware 2.1.7_0031, yeelink.light.ceiling10 firmware 2.0.6_0049, yeelink.light.ceilc (Arwen 550C) firmware 2.0.6_0005 and yeelink.light.ceilb firmware 2.1.7_0011; the requirements differ between the two firmware generations. It writes only the application partition, so it cannot rescue a device that will not boot - that still needs UART.

More ESPHome + Yeelight projects

• Yeelight LED Screen Light Bar (YLTD001)
• Yeelight Ceiling Light YLXD41YL
• Xiaomi Mi Desk Lamp 1S (ESP32 based)
• Xiaomi Mi Desk Lamp (MJTD01YL, ESP8266 based)
• Xiaomi Philips Light
• Xiaomi Mijia Bedside Lamp 2
• How to flash a Yeelight 1S YLDD05Y Lightstrip

Features

yeelink.light.ceil26, yeelink.light.ceiling22, yeelink.light.ceila

• Light (CCWW)
  • Brightness
  • Color temperature (2700K-6500K)
• Nightlight (2700K)
  • Brightness
• Sensor
  • Power supply voltage (ESP32 VCC)

yeelink.light.ceiling10, yeelink.light.ceiling20, yeelink.light.ceilb, yeelink.light.ceilc

• Light (CCWW)
  • Brightness
  • Color temperature (2700K-6500K)
• Nightlight (2700K)
  • Brightness
• Ambient light (RGB)
  • Brightness
  • Color
• Sensor
  • ADC1
  • ADC2

yeelink.light.ceil29

• Light (CCWW)
  • Brightness
  • Color temperature (2700K-6500K)
• Nightlight (2700K)
  • Brightness
• Sensor
  • ADC1
  • ADC2

yeelink.light.ceil43

• Light (CCWW)
  • Brightness
  • Color temperature (2700K-6500K)
• Nightlight (untested)
  • Brightness
• Ambient light (RGB)
  • Brightness
  • Color
• Front light (RGB, 9 segments, untested)
  • Brightness
  • Color
  • Addressable effects

The front light is a chain of 9 SM16825E drivers (5 channels, 16 bit, 800 kbit/s) on GPIO13, driven by the sm16825 component of this repository.

yeelink.light.ceil49

• Light (CCWW)
  • Brightness
  • Color temperature (2700K-6500K)
• Ambient light (RGB, 10/15/20 segments)
  • Brightness
  • Color
  • Addressable effects
• Sensor
  • Mains frequency
• Flex switch (toggle the light by a short off/on of the wall switch)

Set the num_leds substitution to the size of the lamp: C400 = 10, C500 = 15, C600 = 20.

yeelink.light.ceiling15, yeelink.light.ceiling11

• Light (CCWW)
  • Brightness
  • Color temperature (2700K-6500K)
• Nightlight (2700K)
  • Brightness
• Sensor
  • ADC1
  • ADC2

yeelink.light.lamp9, yeelink.light.lampX

• Power button
• Light (CCWW)
  • Brightness
  • Color temperature (2700K-6500K)
• Nightlight (2700K)
  • Brightness

The Staria Pro (YLCT03YL) additionally has a Qi charger and its status LED. See yeelink_light_lamp9_pro.yaml and the hardware notes: the white channels need a PWM floor to dim without dropping out, and GPIO33 only enables the status LED rather than driving it.

yeelink.light.strip6

• Light strip (RGB)
  • Brightness
  • Color

yeelink.light.ceiling24

• Light (CCWW)
  • Brightness
  • Color temperature (2700K-6500K)
• Sensor
  • ADC1
  • ADC2

yilai.light.ceiling1

• Light (CCWW)
  • Brightness
  • Color temperature (2700K-6500K)

Known bugs

Bootloop when BLE Tracker configured. Luckily ESPHome goes into safe mode after 10 unsuccessful boot attempts by default. So the device can be flashed OTA nevertheless.

[11:59:23]ets Jun  8 2016 00:22:57
[11:59:23]
[11:59:23]rst:0xc (SW_CPU_RESET),boot:0x13 (SPI_FAST_FLASH_BOOT)
[11:59:23]configsip: 0, SPIWP:0xee
[11:59:23]clk_drv:0x00,q_drv:0x00,d_drv:0x00,cs0_drv:0x00,hd_drv:0x00,wp_drv:0x00
[11:59:23]mode:DIO, clock div:2
[11:59:23]load:0x3fff0018,len:4
[11:59:23]load:0x3fff001c,len:1044
[11:59:23]load:0x40078000,len:8896
[11:59:23]load:0x40080400,len:5828
[11:59:23]entry 0x400806ac
[11:59:23][I][logger:166]: Log initialized
[11:59:23][C][ota:366]: There have been 8 suspected unsuccessful boot attempts.
[11:59:23][I][app:029]: Running through setup()...
[11:59:23][C][power_supply:010]: Setting up Power Supply...
[11:59:23][C][light:097]: Setting up light 'unused_yeelight night light'...
[11:59:23][D][light:265]: 'unused_yeelight night light' Setting:
[11:59:23][D][light:278]:   Brightness: 100%
[11:59:23][C][light:097]: Setting up light 'unused_yeelight ceiling light'...
[11:59:23][D][light:265]: 'unused_yeelight ceiling light' Setting:
[11:59:23][D][light:278]:   Brightness: 100%
[11:59:23][D][light:282]:   Color Temperature: 1.0 mireds
[11:59:23][D][light:287]:   Red=100%, Green=100%, Blue=100%
[11:59:24][D][esp32_ble_tracker:148]: Starting scan...
[11:59:24][D][binary_sensor:034]: 'unused_yeelight Status': Sending initial state OFF
[11:59:24][C][adc:018]: Setting up ADC 'unused_yeelight power supply'...
[11:59:24][D][text_sensor:015]: 'unused_yeelight Esphome Version': Sending state '1.15.3 Feb 25 2021, 11:57:31'
[11:59:24][C][wifi:033]: Setting up WiFi...
[11:59:24][I][wifi:194]: WiFi Connecting to 'xxxxxxxx'...
[11:59:24][D][sensor:092]: 'unused_yeelight Uptime': Sending state 0.00001 days with 0 decimals of accuracy
[11:59:24][D][adc:056]: 'unused_yeelight power supply': Got voltage=3.90V
[11:59:24][D][sensor:092]: 'unused_yeelight power supply': Sending state 3.90000 V with 2 decimals of accuracy
[11:59:24][D][esp32_ble_tracker:544]: Found device 50:XX:XX:XX:XX:XX RSSI=-62
[11:59:24][D][esp32_ble_tracker:565]:   Address Type: PUBLIC
[11:59:24][D][esp32_ble_tracker:544]: Found device 49:XX:XX:XX:XX:XX RSSI=-91
[11:59:24][D][esp32_ble_tracker:565]:   Address Type: RANDOM
[11:59:29]E (6637) task_wdt: Task watchdog got triggered. The following tasks did not reset the watchdog in time:
[11:59:29]E (6637) task_wdt:  - IDLE0 (CPU 0)
[11:59:29]E (6637) task_wdt: Tasks currently running:
[11:59:29]E (6637) task_wdt: CPU 0: loopTask
[11:59:29]E (6637) task_wdt: Aborting.
[11:59:29]abort() was called at PC 0x400ea723 on core 0
[11:59:29]
[11:59:29]Backtrace: 0x40091698:0x3ffbe520 0x400918a9:0x3ffbe540 0x400ea723:0x3ffbe560 0x4008494e:0x3ffbe580 0x4000bfed:0x3ffcdb20 0x4008f135:0x3ffcdb30 0x4008e28f:0x3ffcdb50 0x400d8df1:0x3ffcdb90 0x401df9c9:0x3ffcdc30 0x401dfa95:0x3ffcdc50 0x400e0959:0x3ffcdc70 0x400e3632:0x3ffcdcc0 0x400e8973:0x3ffcdf50 0x4008e535:0x3ffcdf70
WARNING Found stack trace! Trying to decode it
WARNING Decoded 0x40091698: invoke_abort at /home/paul/src/esp32-arduino-lib-builder/esp-idf/components/esp32/panic.c:707
WARNING Decoded 0x400918a9: abort at /home/paul/src/esp32-arduino-lib-builder/esp-idf/components/esp32/panic.c:707
WARNING Decoded 0x400ea723: task_wdt_isr at /home/paul/src/esp32-arduino-lib-builder/esp-idf/components/esp32/task_wdt.c:252
WARNING Decoded 0x4008494e: _xt_lowint1 at /home/paul/src/esp32-arduino-lib-builder/esp-idf/components/freertos/xtensa_vectors.S:1154
WARNING Decoded 0x4008f135: vTaskExitCritical at /home/paul/src/esp32-arduino-lib-builder/esp-idf/components/freertos/tasks.c:3507
WARNING Decoded 0x4008e28f: xQueueGenericReceive at /home/paul/src/esp32-arduino-lib-builder/esp-idf/components/freertos/queue.c:2520
WARNING Decoded 0x400d8df1: esphome::esp32_ble_tracker::ESP32BLETracker::loop() at /home/sebastian/esphome/unused_yeelight/src/esphome/components/esp32_ble_tracker/esp32_ble_tracker.cpp:241
WARNING Decoded 0x401df9c9: esphome::Component::call_loop() at /home/sebastian/esphome/unused_yeelight/src/esphome/core/component.cpp:111
WARNING Decoded 0x401dfa95: esphome::Component::call() at /home/sebastian/esphome/unused_yeelight/src/esphome/core/component.cpp:111
WARNING Decoded 0x400e0959: esphome::Application::setup() at /home/sebastian/esphome/unused_yeelight/src/esphome/core/application.cpp:50 (discriminator 2)
WARNING Decoded 0x400e3632: setup() at /home/sebastian/esphome/unused_yeelight/src/main.cpp:360
WARNING Decoded 0x400e8973: loopTask(void*) at /home/sebastian/.platformio/packages/framework-arduinoespressif32@src-ff59aeb8b43c3669326fe991d70309ba/cores/esp32/main.cpp:14
WARNING Decoded 0x4008e535: vPortTaskWrapper at /home/paul/src/esp32-arduino-lib-builder/esp-idf/components/freertos/port.c:403
[11:59:29]
[11:59:29]Rebooting...

GPIOs

yeelink.light.ceil26

# Pinout of the pin header at the bottom of the LED driver board

   CW -->o o<-- WW
  3V3 -->o o<-- NC
  GND -->o o<-- NC
  STB -->o o<-- NC
 ADC1 -->o o<-- NL

Please use 3V3 and GND of the pin header to power the daugther board / the ESP32 if you flash the ESP32 the first time. The ESP32 will enter the serial bootloader when GPIO0 (test point TP3) is held low (GND) on reset / power.

yeelink.light.ceiling10

The ESP32 will enter the serial bootloader when GPIO0 (test point IO0 at the back) is held low (GND) on reset / power.

yeelink.light.ceiling11

see Yeelight Ceiling Light YLXD41YL The ESP32 will enter the serial bootloader when GPIO0 (test point IO0 at the back) is held low (GND) on reset / power.

yeelink.light.ceiling15

The ESP32 will enter the serial bootloader when GPIO0 (test point TP1 at the back) is held low (GND) on reset / power.

  ADC1 NL  WW GND           O  -- GND
   |   |   |   |            O  -- TXD
   8   6   4   2            O  -- RXD
   |   |   |   |           [O] -- 3V3
   o   o   o   o

   o   o   o   o
   |   |   |   |
   7   5   3   1
   |   |   |   |
  3V3 ADC2 CW GND

yeelink.light.ceiling22, yeelink.light.ceila

The ESP32 will enter the serial bootloader when GPIO0 (test point TP3 at the back) is held low (GND) on reset / power.

yeelink.light.ceiling20

The ESP32 will enter the serial bootloader when GPIO0 (test point IO0 at the back) is held low (GND) on reset / power.

yeelink.light.ceil43

The ESP32 will enter the serial bootloader when GPIO0 (IO0 pad) is held low (GND) on reset / power.

The stock firmware (2.1.7_0018) sends one frame of 9 x 80 bit plus the 32 bit current gain word 0x4A94A51F and maps the colors as OUTR = blue, OUTG = red, OUTB = green. It also limits R + G + B to 381 (of 765) per segment.

yeelink.light.ceil49

The ESP32 will enter the serial bootloader when GPIO0 (gpio0 pad) is held low (GND) on reset / power.

The module is soldered upright onto the LED board; to reach the pads it has to be desoldered. Only GPIO16, GPIO18, GPIO19, GPIO22, 3.3V and GND go to the LED board. The ESP32 is a single core variant (CONFIG_FREERTOS_UNICORE).

There is no power supply enable: GPIO22 follows the mains and is used to detect a short off/on of the wall switch.

yeelink.light.lamp9, yeelink.light.lampUNKNOWN

On the Pro (YLCT03YL), GPIO33 does not drive the charger status LED - it enables the LED’s supply rail through a transistor. The Qi charger drives the other half of the circuit and decides the pattern itself, so both must be active for the LED to light. Toggling GPIO33 with no phone on the charger does nothing, which is easily mistaken for a dead LED or a wrong pin. The ESP32 has no path to read charge state. Details in docs/yeelink-light-lamp9-staria-pro.md.

yeelink.light.ceiling24

The ESP32 will enter the serial bootloader when GPIO0 (IO0 pad) is held low (GND) on reset / power.

yilai.light.ceiling1

# Pinout of the pin header CON1 between the ESP32 board and the LED driver board

 IO21 -->o
 IO19 -->o
  GND -->o
  3V3 -->o

The pin header only carries GPIO19, GPIO21, GND and 3V3 (order of GND and 3V3 not verified). TXD, RXD and GPIO0 are not routed to it, so they have to be soldered to the pads of the ESP-WROOM-32D module. The ESP32 will enter the serial bootloader when GPIO0 is held low (GND) on reset / power.

There is no power supply enable and no night light on this board.

Disassembly

YLXD76YL

YLXD41YL

C2001C550

Remove the single safety screw on the back and rotate the cover counterclockwise.

YLDL01YL

The grey plastic frame can easily be removed with a credit card between the outer white body and the grey frame. It is just clipped into place. Kudos to @fhloston.

References, sources & inspiration:

• https://templates.blakadder.com/yeelight_YLDL01YL.html
• https://photos.app.goo.gl/T3F4aaXuYgvFXRmi7
• https://github.com/arendst/Tasmota/discussions/10762

YLXD42YL

Rotate the cover counterclockwise.

YLCT02YL

Remove the 4 screws under the foot. The lower shell is held by 8 clips and can be separated with a plastic card and some force.

YLXD50YL

Remove the cover counterclockwise, disconnect from the AC (be safe!), pull out the RGB - C - W connectors (mark one of the last two). Unscrew the 2 screws from the base, and you can remove the controller box. Pick a flat screwdriver/plastic card and remove the plastic base from the box. Sometimes its harder, because the thermalpad. Pull out the PCB from the box, and you can remove the ESP module. Maybe some cleaning required from the glue. The test points are in the back of the ESP’s PCB.

MJXDD01SYL

The disassembly process is almost, if not exactly the same, as with YLXD50YL. MJXDD01SYL seems a re-labled YLXD50YL.

Rotate the cover counterclockwise to remove the cover. Now you can see the outside of the board’s housing. Unscrew the screws and unplug the two connectors. Now you can detach the housing from the base. On the back of the housing you need to remove the cover. Now you can take out the PCB from the housing. Unplug the ESP32 from the socket. Maybe you need to remove a bit of the glue between the PCM and the ESP32.

The Test Points (TP) are on the back side of the ESP32 module. The font is very small, maybe you need a magnifying glass.

To solder some wires to the TPs you need a bit of experience. Since other components are located very close to the TPs.

YLXDD-0033

To disasemble the unit, use a prying tool to un-clip the top part. There are no screws nor glue, only clips all around the ceiling light.

When flashing the YLXDD-00xx series you’ll need an external 3.3V power supply and pull the enable (EN) pin to 3.3V.

YLXD62YI

Rotate the cover counterclockwise to remove the cover. Unscrew the 220VAC L and N Wires. Remove three screws on the transparent diffusor. Now the PCB is completely exposed and unmounted from the base. 3.3V, GND, TXD, RXD and IO0 Pads are clearly visible on the main PCB near ESP32 board. To flash ESP32 you need to solder the wires onto that test points.

YLPW13YL

Disconnect from power before removing the cover. The cover is held by multiple clips on two sides. Use something flat to completely unclip one side. The ESP32 is located on the main PCB and can be easily removed. Carefully remove the glue; this can be done with your fingers. The test points are on the back of the ESP32 module. You will need to solder some wires to the test points (TPs). Images are under images/ylpw13yl.

• Reported firmware was yeelink.light.ceila. No RGB, only CW and WW.
• Uses same module as yeelink.light.ceil20 or yeelink.light.ceiling22 (single-core ESP32-WROOM-32D).
• Configuration file is yeelink_light_ceila.yaml that behaves a lot like original (but no color temperature control yet). Remove remote config if you have problems with it, or don’t plan to use it.