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

Desk Lamp Pro — старшая настольная лампа Xiaomi на ESP32. Отдельного MCU протокола нет: ручка, кнопка и два канала света сидят на GPIO модуля. Это не Desk Lamp 1S и не старая MJTD01YL, хотя пины света похожи на 1S.

Каталог сложность не проставил. Здесь 4/5: нужна пайка к площадкам. Питание логики при записи — 3 В, его подключают последним.

В примере карточки вшит пароль запасной точки доступа. В свой файл его не копируйте. Пароли только из secrets.yaml.

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

Яркость и температура локально, без Mi Home
Ручка: поворот меняет яркость, поворот с нажатием — температуру
После первой записи обновления по OTA

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

Mi Home лампу больше не видит
Гарантия после снятия ножек обычно заканчивается
Конфиг 1S может включить свет, но ручка и коррекция цвета на Pro другие. Берите файл Pro

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

Паяльник и USB–UART 3,3 В
Отвёртка под винты в ножках
esptool, если нужен заводской дамп
Карточка Mi-Desklamp-Pro

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.

Лампу отключают от сети. Резиновые ножки отгибают, под ними четыре винта. На фото карточки отмечено, какие именно.

Площадки программатора — на втором фото карточки. Три вольта подают последними. Земля, TX и RX — как у обычного ESP32, крест-накрест. GPIO0 на землю только на время входа в загрузчик.

Винты Desk Lamp Pro под резиновыми ножками — Ножки отгибают, под ними винты. Лампа при этом выключена из розетки. Фото: esphome/devices.esphome.io, GPL-3.0

Площадки прошивки Desk Lamp Pro — Площадки программатора. Три вольта подключают последними. Пять вольт на плату не подают. Фото: esphome/devices.esphome.io, GPL-3.0

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.

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

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

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

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

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

Дамп на 4 МБ, как в карточке:

python3 -m esptool -b 115200 --port /dev/ttyUSB0 read_flash 0x00000 0x400000 desk-lamp-pro.bin

Порт замените на свой. Каналы света из того же конфига: холодный GPIO2, тёплый GPIO4, разрешение драйвера GPIO12, энкодер GPIO26 и GPIO27, кнопка GPIO33. Это тот же набор, что у 1S, но файл берут из карточки Pro, включая cwww и температуры 4800 K / 2500 K.

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

substitutions:
  friendly_name: Mi Desk Lamp Pro
  device_name: mi-desklamp-pro

# Basic Config
esphome:
  name: ${device_name}
  friendly_name: ${devicename_friendly}
  comment: ${friendly_name}

esp32:
  variant: esp32
  framework:
    type: esp-idf
    sdkconfig_options:
      CONFIG_FREERTOS_UNICORE: y
    advanced:
      ignore_efuse_mac_crc: true
      # See https://github.com/esphome/issues/issues/6333
      ignore_efuse_custom_mac: true

logger:

# Enable captive portal (fallback AP)
time:
  - platform: homeassistant
    id: homeassistant_time

# Text sensors with general information
text_sensor:
  - platform: version
    name: "Version"
    icon: mdi:cube-outline

  - platform: wifi_info
    ip_address:
      name: "IP Address"
      icon: mdi:lan

sensor:
  # Uptime sensor
  - platform: uptime
    name: "Uptime"
    update_interval: 60s
    icon: mdi:clock-outline

  # WiFi Signal sensor
  - platform: wifi_signal
    name: "WiFi Signal"
    update_interval: 60s
    icon: mdi:wifi

  # Knob
  - platform: rotary_encoder
    id: rotation
    pin_a: GPIO26
    pin_b: GPIO27
    resolution: 2
    on_value:
      then:
        - if:
            condition:
              # Check if Button is pressed while rotating
              lambda: "return id(button).state;"
            then:
              # If Button is pressed, change CW/WW
              - lambda: |-
                  auto min_temp = id(light1).get_traits().get_min_mireds();
                  auto max_temp = id(light1).get_traits().get_max_mireds();
                  auto cur_temp = id(light1).current_values.get_color_temperature();
                  auto new_temp = max(min_temp, min(max_temp, cur_temp + (x*10)));
                  auto call = id(light1).turn_on();
                  call.set_color_temperature(new_temp);
                  call.perform();
            else:
              # If Button is not pressed, change brightness
              - light.dim_relative:
                  id: light1
                  relative_brightness: !lambda |-
                    return x / 25.0;
        # Reset Rotation to 0
        - sensor.rotary_encoder.set_value:
            id: rotation
            value: 0

binary_sensor:
  # Knob push-button
  - platform: gpio
    id: button
    pin:
      number: GPIO33
      inverted: True
      mode: INPUT_PULLDOWN
    on_click:
      then:
        - light.toggle:
            id: light1
            transition_length: 0.2s
    filters:
      - delayed_off: 5ms

number:
  - id: freq1
    name: "Flicker Frequency"
    icon: "mdi:sine-wave"
    unit_of_measurement: "Hz"
    platform: template
    min_value: 0
    max_value: 100000
    initial_value: 100000
    mode: box
    step: 1
    set_action:
      - output.ledc.set_frequency:
          id: output_cw
          frequency: !lambda return x;
      - output.ledc.set_frequency:
          id: output_ww
          frequency: !lambda return x;

output:
  - platform: ledc
    pin: GPIO2
    id: output_cw
    power_supply: power
    frequency: 100000Hz

  - platform: ledc
    pin: GPIO4
    id: output_ww
    power_supply: power
    frequency: 100000Hz

power_supply:
  - id: power
    pin: GPIO12
    enable_time: 0s
    keep_on_time: 0s

light:
  - platform: cwww
    id: light1
    name: "Light"
    default_transition_length: 0s
    constant_brightness: true
    cold_white: output_cw
    warm_white: output_ww
    cold_white_color_temperature: 4800 K
    # 2500k is the original value of the lamp. To correct binning for 2700k to look more like 2700k use 2650k instead
    warm_white_color_temperature: 2500 K
    restore_mode: RESTORE_DEFAULT_OFF
    gamma_correct: 1

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

Свет появится как обычная лампа ESPHome. Ручка работает на самом модуле и в Home Assistant отдельно не обязательна. Датчик Wi-Fi на первые дни оставьте, потом спрячьте.

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

Пароль из чужого YAML карточки попадает в вашу сеть, если скопировать файл целиком
Путаница с 1S и со старой лампой syssi. Свет есть, ручка едет не туда
Пять вольт на площадки
3 В, поданные раньше земли и UART, иногда не дают загрузчику стартовать. Карточка просит подключить их последними

9. Источники

Каталог Desk Lamp Pro на devices.esphome.io https://devices.esphome.io/devices/Mi-Desklamp-Pro/
GitHub Исходник карточки https://github.com/esphome/esphome-devices/blob/main/src/docs/devices/Mi-Desklamp-Pro/index.md
Документация esptool https://github.com/espressif/esptool