ESP-helper

Обновлено 2026-09-22

Xiaomi Mijia Bedside Lamp 2

Xiaomi, модель Bedside Lamp 2. 4/5 · пайка. Периферия сидит на самом модуле, второго MCU нет.

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

Bedside Lamp 2 выпускает Yeelight под маркой Mijia. На борту ESP32, отдельного MCU команд нет. Сенсорная панель, ночник и основной свет описаны внешним компонентом mmakaay/esphome-xiaomi_bslamp2.

Каталог сложность не ставит и отправляет в репозиторий. Здесь 4/5: пайка к отладочным площадкам. Штатная LAN-интеграция Yeelight Xiaomi со временем ломала, локальная прошивка от этого не зависит.

Площадка 3,3 В на плате есть. Автор прошивки просит ею лампу не питать. Питание на время записи — штатное, логика переходника — 3,3 В.

Лампа Xiaomi Bedside Lamp 2
Bedside Lamp 2 снаружи. Разбор дна и площадки RX, TX, GND, GPIO0 — в flashing.md репозитория mmakaay. Фото: esphome/devices.esphome.io, GPL-3.0

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

  • Цвет, яркость и ночник локально, без облака Mijia
  • Ночник в нескольких цветах, у заводской прошивки он только тёплый белый
  • Подсветку кнопок и дорожки яркости можно забрать в автоматизации по отдельности
  • OTA после первой записи по проводам

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

  • Приложение Mi Home / Yeelight лампу не видит
  • Гарантия после снятия дна обычно заканчивается
  • Поведение кнопок по умолчанию меняется, если править пример под себя. Это уже ваш YAML

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

  • Шестигранник 2 мм или отвёртка T8
  • Паяльник, тонкие провода, USB–UART с уровнем 3,3 В
  • Репозиторий mmakaay, файл example.yaml и документ flashing.md

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.

Резиновые накладки снизу отгибают настолько, чтобы открылись четыре винта. До конца наклейки снимать не нужно. Винты выкручивают, дно стягивают с корпуса, оно сидит плотно.

Паяют четыре площадки: RX, TX, GND и GPIO0. На GPIO0 много припоя не кладут, рядом соседняя площадка. Переходник: земля к земле, TX лампы к RX переходника, RX лампы к TX переходника. GPIO0 на землю, пока лампа включается. После записи GPIO0 от земли отключают.

Если на переходнике одна земля, GPIO0 и GND лампы собирают на этой земле через макетку или временную перемычку. Варианты разобраны в flashing.md.

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

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

Сборку и запись автор описывает в репозитории, включая дамп и возврат заводской прошивки. Компонент подключают как внешний, пример — example.yaml в том же репозитории. Имя компонента в конфиге смотрите там: оно не совпадает со стандартным light.

Команда записи после сборки — обычный esphome run или Install в Dashboard, порт переходника, GPIO0 на земле в момент включения.

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

# example.yaml
# --------------------------------------------------------------------------
# Substitutions
#
# These are substitutions as used by the configuration packages from below.
# You can uncomment and update the ones that you want to modify.
# --------------------------------------------------------------------------

substitutions:
  name: bedside-lamp
  friendly_name: Bedside Lamp

  # Below are some default values as provided by the configuration packages.
  # You can uncomment these and change them if you do not like the defaults.
  # You can also take a look at the packages/* files directly, to find their
  # full list of customizable substitutions.

  #light_name: RGBWW Light
  #light_mode_text_sensor_name: Light Mode
  #night_light_tint_name: Night Light Tint
  #night_light_temperature_name: Night Light Temperature
  #night_light_level_name: Night Light Level

# --------------------------------------------------------------------------
# Load configuration packages
#
# These provide a convenient way to compose your device configuration from
# some functional building blocks. Pick and mix the blocks that you need.
#
# For customization you can override options in your config or you can
# copy the contents of these packages directly in your config file as
# an example for your own customizations.
#
# Available packages are:
# - core.yaml                        : core components & hardware setup
# - behavior_default.yaml            : default device behavior
# - night_light_calibration.yaml     : HA controls for night light calibration
# - ota_feedback.yaml                : enable visual feedback during OTA updates
# - activate_preset_svc.yaml         : 'activate_preset' service for Home Assistant
# --------------------------------------------------------------------------

packages:
  bslamp2:
    url: https://github.com/mmakaay/esphome-xiaomi_bslamp2
    ref: release/2026.5.0
    files:
      - packages/core.yaml
      - packages/behavior_default.yaml
      - packages/night_light_calibration.yaml
      - packages/ota_feedback.yaml
      - packages/activate_preset_svc.yaml
    refresh: 0s

# --------------------------------------------------------------------------
# Use your own preferences for these components.
# --------------------------------------------------------------------------

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

Лампа появится по API ESPHome. Ночник и основной свет могут быть разными сущностями, как в примере репозитория. Первую проверку делайте на небольшой яркости.

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

  • Питание платы от площадки 3,3 В автор явно не рекомендует
  • GPIO0 оставляют на земле, и лампа снова входит в загрузчик вместо света
  • Пять вольт на RX/TX
  • Конфиг Desk Lamp 1S эту панель не оживит
  • С ESPHome 2026 каталог custom_components больше не принимают. Компонент подключают через external_components, иначе сборка предупреждает и в следующих версиях отвалится. Это issue 151 и открытый issue 158
  • Тёплый белый в режиме color temperature у части прошивок не выставляется, issue 126. Это не обрыв GPIO

9. Источники