OeeGoo CLB035

1. Название и модель

CLB035 — потолочный светильник 100–240 В, центр 2700–6500 K и кольцо RGB. Внутри модуль Tuya WB3L. ESPHome его не прошивает, модуль выпаивают и ставят ESP32-C3F. Сложность в каталоге 5/5.

После замены отдельного MCU нет: красный, зелёный, синий, холодный и тёплый каналы — это ШИМ нового ESP. Автор мерил максимальную скважность осциллографом.

Линия RESET на плате светильника не подключена, и ESP32-C3 не стартует. Между RESET и землёй ставят конденсатор 0,1 мкФ, корпус 0805.

2. Что даёт перепрошивка

• Яркость и температура центра локально
• Кольцо RGB без приложения Tuya
• OTA после того, как модуль уже прошит на столе и впаян

3. Что теряется

• Заводской WB3L после выпаивания обычно не возвращают
• Приложение Tuya свет больше не видит
• Гарантия заканчивается при разборе

4. Что понадобится

• Отвёртка, фен или медная перемычка, чтобы прогреть все стороны модуля сразу
• ESP32-C3F, в карточке Sparkleiot, прошитый заранее на тестовой плате
• Конденсатор 0,1 мкФ 0805
• Карточка CLB035

5. Разборка и пины

Программатор USB–UART подключают к модулю, который прошивают, крест-накрест:

• Земля переходника (GND) — на землю платы. Этот провод обязателен.
• TX переходника — на RX модуля. На плате площадка часто подписана RX, RXD или RXD0.
• RX переходника — на TX модуля. На плате это TX, TXD или TXD0.
• Питание логики — 3,3 В. Пять вольт на эти площадки не подают. Если плату уже кормит её блок, линию 3,3 В с переходника не подключают вторым источником.
• Для входа в загрузчик ESP8266 и ESP32 площадку GPIO0 (IO0, BOOT) замыкают на землю и в этот момент подают питание. После старта записи землю с GPIO0 снимают.

Если у этой модели в тексте ниже другие имена площадок, прямой порядок TX–TX или прошивка по USB, делайте как написано там. Общая схема выше — для обычного модульного UART.

Корпус на крестовых винтах. WB3L снимают, прогревая стороны. Лезвие помогает приподнять уже прогретый край. Новый модуль паяют на те же площадки.

Каналы на ESP32-C3, как в карточке: красный GPIO10, зелёный GPIO3, синий GPIO4, холодный GPIO18, тёплый GPIO5.

6. Прошивка

Готового файла «прошивка именно этой модели» на этом сайте нет. Её собирает ESPHome из текстового конфига YAML: туда входят Wi-Fi, пины и команды второго чипа. Чужой .bin из интернета почти наверняка собран с чужим паролем сети.

Какую программу ставить

• ESPHome Dashboard — дополнение в Home Assistant или программа на компьютере. В ней пишут YAML, нажимают Install, и она сама собирает прошивку. Установка: дополнение для Home Assistant или команда pip install esphome.
• ESPHome Web, сайт web.esphome.io, — загрузчик в браузере Chrome или Edge. Им записывают уже собранный .bin на ESP8266 и ESP32 через USB–UART. На BK72xx он не рассчитан.
• esptool — программа Espressif, чтобы снять заводскую копию флеша и записать .bin, если браузер порт не видит. Репозиторий: espressif/esptool.
• ltchiptool — то же самое для чипов Beken BK72xx (модули WB3S, WBR3, CB3S и похожие). ESPHome для них собирается через LibreTiny. Программа: libretiny-eu/ltchiptool, описание платы: компонент bk72xx.

Как собрать конфиг

1. В Dashboard нажмите New Device и выберите чип, который стоит на плате: ESP8266, ESP32 или BK72xx. Имя — латиницей, без пробелов.
2. Пароль Wi-Fi уберите в файл secrets.yaml рядом с конфигом. В YAML оставьте ssid: !secret wifi_ssid и password: !secret wifi_password.
3. Блок UART, модель и скорости из раздела ниже вставьте в этот файл. Полный пример, если он длинный, берите по ссылке в источниках внизу страницы, а не из гайда соседней модели.
4. Строки api: и ota: оставьте. Без api: Home Assistant устройство не увидит. Ключ шифрования Dashboard предлагает сам, его потом спросит интеграция ESPHome.

Как залить первый раз

1. Подключите USB–UART, как в разделе «Разборка и пины»: земля переходника на землю платы, TX переходника на RX модуля, RX переходника на TX модуля. Логика 3,3 В. Имена площадок на конкретной плате — там же.
2. Для ESP8266 и ESP32 замкните GPIO0 (IO0, BOOT) на землю и в этот момент подайте питание. Для BK72xx ltchiptool сам просит перезапустить чип, обычно кратким отключением земли.
3. В Dashboard: Install → Plug into this computer, выберите порт переходника. Либо Install → Manual download, сохраните .bin и откройте его на web.esphome.io. Из терминала то же самое делает esphome run имя-устройства.yaml.
4. Когда в логе появится IP-адрес, GPIO0 от земли отпустите, провода можно отпаять. Следующие обновления идут по Wi-Fi, пункт OTA, паяльник больше не нужен.

Дальше — только то, чем эта модель отличается от общей схемы.

Модуль прошивают до установки, режимом flash qio, фреймворк Arduino, как проверял автор. Конфиг света — rgb на трёх ШИМ и cwww на холодном и тёплом, температуры 6500 K и 2700 K. Полный файл в карточке: там ещё ограничение скважности, которое автор снял осциллографом. Без этих чисел каналы могут упираться в 100 % раньше, чем светодиод.

Базовый конфиг этой модели с карточки или из репозитория компонента. Wi-Fi, пароль и OTA задайте как в общем разделе выше. Пароли из исходника сюда не перенесены.

substitutions:
  device_name: masterlight
  friendly_name: "Master Bedroom Overhead"

esphome:
  name: ${device_name}
  friendly_name: ${friendly_name}

esp32:
  variant: esp32c3

# Enable logging
logger:

# Enable Home Assistant API
time:
  - platform: sntp
    id: my_time

# General Config
text_sensor:
  - platform: version
    name: "${device_name} Version"
  - platform: wifi_info
    ip_address:
      name: "${device_name} IP Address"
    ssid:
      name: "${device_name} SSID"
    bssid:
      name: "${device_name} BSSID"

sensor:
  - platform: wifi_signal
    name: "${device_name} WiFi Signal"
    update_interval: 60s
    filters:
      - delta: 0.01
      - throttle: 300s
  - platform: uptime
    name: "${device_name} Uptime"
    filters:
      - throttle: 300s

light:
  # RGB Mood Light
  - platform: rgb
    name: "RGB Light"
    red: output_pwm1
    green: output_pwm2
    blue: output_pwm3
    restore_mode: RESTORE_DEFAULT_OFF
  # Temperature controlled light
  - platform: cwww
    name: "Room Light"
    cold_white: output_pwm4
    warm_white: output_pwm5
    cold_white_color_temperature: 6500 K
    warm_white_color_temperature: 2700 K
    constant_brightness: True
    restore_mode: RESTORE_DEFAULT_ON

output:
  # Red PWM
  - platform: ledc
    id: output_pwm1
    pin: GPIO10
    zero_means_zero: True
  # Green PWM
  - platform: ledc
    id: output_pwm2
    pin: GPIO3
    max_power: 70%
    zero_means_zero: True
  # Blue PWM
  - platform: ledc
    id: output_pwm3
    pin: GPIO4
    max_power: 75%
    zero_means_zero: True
  # Cool PWM
  - platform: ledc
    id: output_pwm4
    pin: GPIO18
    zero_means_zero: True
  # Warm PWM
  - platform: ledc
    id: output_pwm5
    pin: GPIO5
    zero_means_zero: True

7. Настройка в Home Assistant

Две сущности света: центр и кольцо. Первое включение делайте на малой яркости, пока не сверите цвета с карточкой.

8. Известные баги и как их обойти

• Без конденсатора на RESET модуль молчит, хотя прошивка записана
• GPIO3 на C3 часто занят UART. Журнал на этот пин гасит зелёный канал
• Конфиг обычной лампы Tuya с datapoint сюда не подходит: после замены модуля протокола Tuya уже нет

9. Источники

• Каталог OeeGoo CLB035 на devices.esphome.io https://devices.esphome.io/devices/OeeGoo-12-inch-30W-Smart-Ceiling-Light-CLB035/
• GitHub Исходник карточки https://github.com/esphome/esphome-devices/blob/main/src/docs/devices/OeeGoo-12-inch-30W-Smart-Ceiling-Light-CLB035/index.md