ESP-helper

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

Deye и Sunsynk по Modbus

Deye, модель однофазный гибрид, файл 1P. 3/5 · разборка. Модуль Wi-Fi говорит со вторым микроконтроллером.

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

Репозиторий slipx06/Sunsynk-Home-Assistant-Dash читает гибридные инверторы Deye, Sunsynk и Sol-Ark по Modbus RTU. Страница ниже опирается на файл однофазного инвертора ESPHome-1P-Sunsynk-Deye.yaml, а не на файл пары master-slave.

В однофазном файле UART: передача GPIO1, приём GPIO3, 9600, один стоп-бит. Направление RS-485 — GPIO16. Адрес 0x01. Журнал снят с UART, baud_rate: 0. Пауза между командами 100 мс.

Файл пары инверторов в том же репозитории использует другие ноги: передача GPIO17, приём GPIO16, направление GPIO4. Эти два файла не смешивают.

Полный YAML на тысячи строк пишет уставки и синхронизирует часы инвертора. Ниже только чтение батареи. Регистры времени в том файле — 22, 23 и 24, их в конфиг не переносите, пока не решили, что часы инвертора можно перезаписывать.

Порт RS-485 или BMS на инверторе часто рядом с силовыми клеммами. Кабель сажают при снятом переменном и постоянном напряжении, по схеме именно вашей модели.

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

  • Напряжение, ток, заряд и мощность батареи без облака Deye
  • Инвертор остаётся заводским, ESP только мастер Modbus
  • Адрес 1 и скорость 9600 совпадают у однофазного файла и у соседнего примера jacauc

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

  • Нужен переходник RS-485. Направление в этом файле обязательно, пин GPIO16
  • GPIO1 и GPIO3 заняты портом, журнал по ним не смотрят
  • Чужой файл master-slave молчит, если оставить пины однофазного файла

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

  • ESP32
  • Модуль RS-485 с пином направления
  • Файл ESPHome-1P-Sunsynk-Deye.yaml, если нужны остальные регистры

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.

Инвертор не разбирают. В однофазном примере ESP передаёт GPIO1 и принимает GPIO3, GPIO16 управляет DE/RE. Земля переходника общая с ESP. Куда на разъёме инвертора сидят 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. Скрипт синхронизации часов и кнопки записи уставок из полного файла в базовый конфиг не входят. Множители регистров оставлены как в файле: температура регистра 182 сдвигается на −1000 и умножается на 0,1, напряжение 183 и ток 191 умножаются на 0,01, мощность 190 — знаковое слово без множителя.

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

esp32:
  board: esp32dev

logger:
  baud_rate: 0

# Пины файла ESPHome-1P-Sunsynk-Deye.yaml. В файле master-slave другие: TX GPIO17, RX GPIO16, flow GPIO4.
uart:
  id: mod_bus
  tx_pin: GPIO1
  rx_pin: GPIO3
  baud_rate: 9600
  stop_bits: 1

modbus:
  id: inverter_modbus
  flow_control_pin: GPIO16

modbus_controller:
  - id: inverter
    address: 0x01
    modbus_id: inverter_modbus
    update_interval: 10s
    command_throttle: 100ms

sensor:
  - platform: modbus_controller
    modbus_controller_id: inverter
    name: Температура батареи
    register_type: holding
    address: 182
    unit_of_measurement: "°C"
    accuracy_decimals: 1
    value_type: U_WORD
    filters:
      - offset: -1000
      - multiply: 0.1
  - platform: modbus_controller
    modbus_controller_id: inverter
    name: Напряжение батареи
    register_type: holding
    address: 183
    unit_of_measurement: V
    accuracy_decimals: 1
    value_type: U_WORD
    filters:
      - multiply: 0.01
  - platform: modbus_controller
    modbus_controller_id: inverter
    name: Заряд батареи
    register_type: holding
    address: 184
    unit_of_measurement: "%"
    value_type: U_WORD
  - platform: modbus_controller
    modbus_controller_id: inverter
    name: Мощность батареи
    register_type: holding
    address: 190
    unit_of_measurement: W
    value_type: S_WORD
  - platform: modbus_controller
    modbus_controller_id: inverter
    name: Ток батареи
    register_type: holding
    address: 191
    unit_of_measurement: A
    accuracy_decimals: 1
    value_type: S_WORD
    filters:
      - multiply: 0.01

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

Датчики батареи придут через API. Суточную энергию из мощности лучше считать в Home Assistant, а не вторым шаблоном поверх уже посчитанного регистра, если такой регистр потом добавите из полного файла.

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

  • Пины master-slave (17, 16 и 4) вписаны в однофазный конфиг или наоборот
  • Журнал на GPIO1 при UART инвертора на тех же ногах
  • Адрес не 1
  • Скрипт часов из полного файла переписывает регистры 22–24

9. Источники