ESP-helper

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

Buderus Logamatic, KM271

Buderus, модель Logamatic 2107. 4/5 · пайка. Модуль Wi-Fi говорит со вторым микроконтроллером.

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

the78mole/ESPhome-KM271-WiFi — прошивка приставки к масляным контроллерам Buderus вроде Logamatic 2107. Сам компонент лежит в the78mole/esphome_components. Как приставка садится на KM271, автор описывает на своём сайте, не в YAML.

В buderus-km271_en.yaml UART такой: TX GPIO2, RX GPIO4, 2400 бод, id шины uart_bus. Компонент объявлен как km271_wifi с id budoil. Светодиод этой платы на GPIO21, кнопка на GPIO27. На голой плате ESP32 этих деталей нет.

Файл ещё содержит точку доступа с паролем. В гайд он не перенесён. Для Home Assistant оставляют свой api, как в остальных конфигах сайта.

Датчики в том же файле длинные: подача и комната контуров, котёл, улица, выхлоп. В короткий пример попала подача первого контура, heating_circuit_1_flow_temperature.

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

  • Температуры контуров и котла в Home Assistant без сервисного пульта
  • Прошивка контроллера Buderus остаётся заводской, меняется только приставка

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

  • Нужна плата KM271-WiFi или повторение её обвязки. Одного ESP32 и двух проводов README не описывает
  • Репозиторий на GitHub в основном про сборку в Docker, протокол байтов там не разобран

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

  • Контроллер с разъёмом KM271, в тексте это Logamatic 2107 и похожие
  • Плата автора или её схема с его сайта
  • ESP32 на 4 или 8 МБ, в репозитории есть оба варианта прошивки

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.

Приставку ставят на контроллер по его инструкции. Пины GPIO2 и GPIO4 уже разведены на его плате, заново их на котёл не вешают.

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

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

Плату прошивают по USB. Компонент подключают как github://the78mole/esphome_components@main, в списке компонентов только km271_wifi.

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

uart:
  id: uart_bus
  tx_pin: GPIO2
  rx_pin: GPIO4
  baud_rate: 2400

external_components:
  - source: github://the78mole/esphome_components@main
    components: [km271_wifi]

km271_wifi:
  - id: budoil
    uart_id: uart_bus

sensor:
  - platform: km271_wifi
    heating_circuit_1_flow_temperature:
      name: Подача контура 1

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

Температура подачи первого контура берётся сенсором heating_circuit_1_flow_temperature. Остальные имена лежат в том же YAML на GitHub.

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

  • GPIO2 и GPIO4 перенесены на другую плату, где UART или светодиод уже заняты
  • В прошивку попал пароль точки доступа из примера
  • Ждут байтовый протокол в README репозитория, а там только ссылка на сайт автора

9. Источники