ESP-helper

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

Eastron SDM по Modbus

Eastron, модель SDM120, SDM230, SDM630. 3/5 · разборка. Модуль Wi-Fi говорит со вторым микроконтроллером.

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

Компонент sdm_meter читает счётчики Eastron SDM по Modbus поверх RS-485. Нужен переходник RS-485–UART. Отдельный блок modbus: документация для этого компонента не требует.

Пример в документации: приём на D1, передача на D2, 9600, один стоп-бит. D1 и D2 — подписи платы NodeMCU, в YAML их пишут так же. Адрес по умолчанию 1. Его задают на самом счётчике, если на шине их несколько.

Отдельная сноска документации: у SDM230M и SDM120M заводская скорость 2400. Либо в YAML ставят 2400, либо скорость меняют в меню счётчика. SDM630 в той же странице приведён как пример счётчика с фазами B и C: для него добавляют блоки phase_b и phase_c.

Счётчик стоит на линии 230 В. ESP к силовым клеммам не подключают, только к клеммам RS-485 через переходник.

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

  • Напряжение, ток, мощность и энергия локально, компонент уже в ESPHome
  • Один конфиг покрывает однофазные SDM120 и SDM230 и трёхфазный SDM630
  • Адрес и скорость видны в меню счётчика, угадывать регистр 30001 не нужно

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

  • Нужен переходник RS-485
  • Заводские 2400 у младших моделей легко промахнуться, если оставить 9600 из примера
  • Пример документации на NodeMCU. На ESP32 подписи D1 и D2 не существуют

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

  • ESP8266 с подписями D1 и D2 или правка пинов под свою плату
  • Переходник RS-485
  • Паспорт счётчика, чтобы сверить скорость и адрес

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.

Корпус счётчика не вскрывают. A и B переходника сажают на клеммы RS-485 счётчика, землю переходника — на землю ESP. В примере ESP принимает на D1 и передаёт на D2. Куда на клеммнике подписаны A и B, смотрят на наклейке своей модели.

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

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

ESP прошивают по USB. Для SDM120M и SDM230M строку скорости меняют на 2400, если меню счётчика не переведено на 9600. Фазы B и C в базовый конфиг не входят: их добавляют только на SDM630.

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

# D1 и D2 — подписи NodeMCU из примера документации, не номера GPIO.
esp8266:
  board: nodemcuv2

uart:
  rx_pin: D1
  tx_pin: D2
  baud_rate: 9600
  stop_bits: 1

sensor:
  - platform: sdm_meter
    address: 1
    update_interval: 60s
    phase_a:
      voltage:
        name: Напряжение L1
      current:
        name: Ток L1
      active_power:
        name: Мощность L1
    total_power:
      name: Мощность суммарная
    import_active_energy:
      name: Импорт
    export_active_energy:
      name: Экспорт

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

Энергию импорта и экспорта отдайте в энергетическую панель как счётчики. Мощность и энергию одновременно ещё раз интегрировать не нужно: компонент уже читает оба регистра.

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

  • 9600 на SDM120M или SDM230M, которые всё ещё на заводских 2400
  • Пины D1 и D2 на плате ESP32, где таких подписей нет
  • Адрес не 1, а в YAML оставлен умолчательный
  • A и B перепутаны, шина молчит

9. Источники