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

Mi Desk Lamp 1S — лампа с поворотной ручкой: поворот меняет яркость, поворот с нажатием меняет температуру, короткое нажатие включает свет. В конфиге каталога всем этим управляет сам ESP32. Отдельного MCU протокола нет.

Сложность в пайке к площадкам прошивки и в том, чтобы не взять YAML от предыдущей лампы. Репозиторий syssi esphome-mi-desk-lamp — это MJTD01YL на ESP8285, другая плата и другие пины.

Карточка 1S предупреждает про нестандартный MAC: в esp32 оставляют ignore_efuse_mac_crc и ignore_efuse_custom_mac, иначе часть модулей не стартует. Ссылка на обсуждение есть в конфиге каталога.

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

Яркость и цветовая температура в Home Assistant без Mi Home
Ручка на корпусе продолжает работать: энкодер и кнопка описаны в YAML
Локальные автоматизации «приглушить вечером» без облачных сцен Xiaomi
OTA после первой кабельной прошивки

Каналы света — это холодный GPIO2 и тёплый GPIO4, ШИМ около 40 кГц. Силовая часть драйвера включается GPIO12 через power_supply, чтобы выход не шимил в выключенную лампу.

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

Mi Home, голосовые сценарии аккаунта Xiaomi и связки внутри их облака
Заводская калибровка «как было в приложении». Температуру в конфиге задают миреды и кельвины холодного/тёплого канала, их иногда подправляют на глаз
Гарантия после вскрытия
Чужой конфиг от MJTD01YL. Он прошьётся не в ту модель или оживёт неправильными пинами

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

USB–UART на 3,3 В
Паяльник и пять проводов: 3,3 В, земля, TX, RX, GPIO0 (на программаторе это часто подпись D0)
ESPHome
Конфиг именно Desk Lamp 1S с карточки devices.esphome.io, а не файл MJTD01YL

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.

Лампа разбирается до модуля. Практический отчёт по 1S (zorruno) описывает пайку к питанию, земле, TX, RX и D0. GPIO0 на корпусе кнопкой не выведен: провод с D0 сажают на землю и перезапускают модуль питанием переходника, иначе загрузчик не открывается.

Подключение обычное для ESP:

земля к земле
3,3 В к 3,3 В, не 5 В
TX переходника на RX модуля и наоборот
GPIO0 на землю только на время входа в загрузчик

Плата MJTD01YL устроена иначе: там в разборах фигурируют площадки по краю модуля ESP8285 (питание на контакте 8, UART на 17 и 18, GPIO0 на контакте 4). Если у вас такая нумерация по периметру маленького модуля, это не 1S и этот гайд вам не подходит.

Схема проводов программатора для Xiaomi Mi Desk Lamp 1S — Схема проводов первой прошивки, не фото модуля. GPIO0 держат на земле только в момент сброса. Каналы света GPIO2 и GPIO4 к этим площадкам не относятся. Схема по карточке devices.esphome.io и отчёту zorruno

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, паяльник больше не нужен.

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

Рабочие линии 1S из карточки каталога:

энкодер: GPIO27 и GPIO26
кнопка ручки: GPIO33, инвертирована, с подтяжкой вниз
холодный канал: LEDC GPIO2
тёплый канал: LEDC GPIO4
разрешение питания драйвера: GPIO12
свет: платформа cwww, постоянная яркость при смене температуры

Поворот без кнопки в полном конфиге меняет яркость, поворот с зажатой кнопкой — температуру. Этот скрипт лучше взять целиком с карточки: в нём легко ошибиться в знаке шага энкодера.

После первой успешной записи кабель отпаивают или изолируют, дальше обновления идут по OTA.

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

substitutions:
  friendly_name: Mi Desk Lamp 1S
  device_name: mi-desklamp-1s

# 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

# WiFi connection
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: GPIO27
    pin_b: GPIO26
    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

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

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

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: 0

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

Лампа приезжает одной сущностью света с яркостью и температурой. Ручку при этом не отключают: локальные нажатия и повороты остаются в прошивке.

Карточка света в панели Home Assistant закрывает повседневное управление. Отдельно имеет смысл вывести только датчик Wi-Fi и uptime на время обкатки, потом их можно спрятать в диагностику.

Если тёплый канал кажется зеленее, чем в Mi Home, в конфиге как раз для этого комментарий про коррекцию warm_white_color_temperature. Меняют число, а не пины.

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

Файл от MJTD01YL (syssi и старые разборы Tasmota) — про другую лампу. Симптом: модуль прошился, света нет или ручка на других GPIO
Загрузчик не входит без GPIO0 на земле в момент сброса. Одной пайки TX/RX мало
MAC в efuse у части модулей кривой. Без двух флагов ignore_efuse_* прошивка может не стартовать, хотя запись прошла
5 В с переходника убивает логику. Лампа от сети этот урок не отменяет: программатору всё равно нужен 3,3 В
Энкодер, подключённый наоборот, крутит яркость не в ту сторону. Лечится сменой GPIO26 и GPIO27 местами, а не новым компонентом
power_supply на GPIO12 обязателен. Прямой ШИМ без него оставляет драйвер в неверном состоянии на выключенном свете

9. Источники

Каталог Xiaomi Mi Desk Lamp 1S на devices.esphome.io https://devices.esphome.io/devices/mi-desklamp-1s/
GitHub Исходник карточки в esphome-devices https://github.com/esphome/esphome-devices/blob/main/src/docs/devices/Mi-Desklamp-1S/index.md
Обсуждение Практический отчёт о прошивке 1S https://zorruno.com/2024/flashing-a-mi-home-1s-led-desk-lamp-with-esphome/
GitHub Не этот репозиторий: старая MJTD01YL https://github.com/syssi/esphome-mi-desk-lamp