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

Компонент pylontech читает батарею через порт Console. Порты CAN и RS-485, которыми батарея говорит с инвертором, не занимают. Уровни консоли — RS-232, не TTL. Между батареей и ESP ставят приёмопередатчик, документация проверяла MAX3232.

Кабель сажают на мастер стойки. Остальные модули по консоли не отвечают.

Номер GPIO в документации компонента не задан. В YAML ниже передача GPIO17 и приём GPIO16: это UART2 классического ESP32, журнал остаётся на GPIO1 и GPIO3. Это выбор платы, не распиновка батареи. Если у вас другой UART, меняют только эти две строки.

Консоль и силовой выход батареи — разные разъёмы. Плюс и минус батареи на MAX3232 не сажают.

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

Напряжение, ток и заряд модуля без облака и без занятия шины инвертора
Компонент уже в ESPHome
CAN и RS-485 к инвертору продолжают работать

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

Нужен MAX3232, прямой TTL с консоли документация запрещает
Читается мастер, не каждый модуль отдельным кабелем
GPIO в документации не зафиксирован, пример на странице привязан к UART2 ESP32

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

ESP32 и модуль MAX3232
Кабель RJ45 для US2000C, US3000C и US5000 или RJ11 для US2000 и US2000B
Доступ к порту Console мастера, не к порту инвертора

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.

Батарею не разбирают. Для RJ45, расцветка T568B:

контакт 3, бело-зелёный — передача батареи, через приёмопередатчик на RX ESP
контакт 6, зелёный — приём батареи, через приёмопередатчик на TX ESP
контакт 8, коричневый — земля

В расцветке T568A контакт 3 бело-оранжевый, контакт 6 оранжевый, земля та же коричневая.

Для RJ11 у US2000 и US2000B: контакт 2 — приём батареи на TX ESP, контакт 3 — передача батареи на RX ESP, контакт 4 — земля. Все три линии через MAX3232, кроме земли, которую документация соединяет напрямую.

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

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

ESP прошивают по USB. Скорость 115200 проверяется кодом компонента. Датчики напряжения, тока и заряда (coulomb) в примере документации задают для battery: 1. Второй модуль стойки — это battery: 2 в таком же блоке, его добавляют, только если модуль реально есть.

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

# GPIO16 и GPIO17 — UART2 классического ESP32, чтобы не занять журнал на GPIO1/GPIO3.
# В документации компонента номер GPIO не задан. Распиновка батареи — в тексте страницы.
uart:
  id: pylon_uart
  tx_pin: GPIO17
  rx_pin: GPIO16
  baud_rate: 115200

pylontech:
  - id: pylontech0
    uart_id: pylon_uart

sensor:
  - platform: pylontech
    pylontech_id: pylontech0
    battery: 1
    voltage:
      name: Напряжение
    current:
      name: Ток
    coulomb:
      name: Заряд

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

Напряжение, ток и заряд придут через API. Мощность документация собирает шаблоном из напряжения и тока. В базовый конфиг шаблон не входит, чтобы не плодить вторую мощность рядом с датчиком инвертора, если он уже есть.

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

Кабель в порту CAN или RS-485 вместо Console
TTL без MAX3232
Контакты 3 и 6 перепутаны
GPIO1 и GPIO3 заняты и журналом, и батареей

9. Источники

Документация Компонент Pylontech https://esphome.io/components/pylontech/