ESP-helper

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

EPEVER Tracer-AN

EPEVER, модель Tracer-AN и XTRA, 10–40 А. 3/5 · разборка. Модуль Wi-Fi говорит со вторым микроконтроллером.

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

Карточка проверялась на Tracer-AN и XTRA серий 10, 20, 30 и 40 А. ESP32 опрашивает контроллер по Modbus RTU. Это внешний прибор, штатную прошивку контроллера не стирают.

В примере UART: передача GPIO19, приём GPIO18, 115200, один стоп-бит. Адрес Modbus 0x1. Пауза между командами 200 мс. Линия управления направлением в примере закомментирована на GPIO23: её включают, только если переходник RS-485 требует DE/RE.

В on_boot карточки записаны пределы одной AGM-батареи автора: отключение при 15,0 В, float 13,6 В и остальные регистры с 0x9000. Это запись в контроллер. На другую батарею эти числа подавать нельзя. Ниже на странице только чтение.

Контроллер EPEVER Tracer-AN
Tracer-AN. ESP к нему подключают кабелем Modbus, корпус контроллера не прошивают. Фото: esphome/devices.esphome.io, GPL-3.0

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

  • Напряжение, ток и мощность панели и батареи в Home Assistant
  • Контроллер остаётся заводским, ESP только читает шину
  • Облако EPEVER для этих показаний не нужно

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

  • Кабель RS-485 или TTL надо провести самим
  • Запись регистров настроек может испортить заряд, если скопировать чужие вольты
  • Карточка огромная. Пакеты tracer-real-time.yaml и соседние лежат рядом с исходником, их не заменяет короткий пример

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

  • ESP32 и переходник к порту контроллера. Уровень линии сверьте с паспортом порта, часто это RS-485
  • Карточка EPEVER и файлы пакетов в том же каталоге репозитория
  • Паспорт своей батареи, если когда-нибудь будете писать регистры 0x9000

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 передаёт GPIO19 и принимает GPIO18. Земля общая. Пин GPIO23 — только если нужен flow control, в опубликованном примере он выключен.

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 как обычная плата. Блок on_boot с create_write_multiple_command на адреса 0x9000 и 0x906B из карточки в конфиг не переносите, пока не сверили каждый вольт с паспортом батареи. Чтение собирают из пакетов tracer-real-time.yaml, tracer-rated-datum.yaml и tracer-stats.yaml в репозитории карточки.

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

esp32:
  framework:
    type: arduino

uart:
  id: mod_bus
  tx_pin: 19
  rx_pin: 18
  baud_rate: 115200
  stop_bits: 1

modbus:
  # flow_control_pin: 23
  send_wait_time: 200ms
  id: mod_bus_epever

modbus_controller:
  - id: epever
    address: 0x1
    modbus_id: mod_bus_epever
    command_throttle: 200ms
    setup_priority: -10
    update_interval: 10s

# Пакеты tracer-real-time.yaml, tracer-rated-datum.yaml и tracer-stats.yaml
# лежат рядом с карточкой. Блок on_boot, который пишет регистры 0x9000, сюда не входит.

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

Энергию и мощность панели отдайте в энергетическую панель как есть, с state_class, который стоит в пакете. Второй шаблон, который ещё раз умножает вольты, даст в десять раз больше солнца, чем на дисплее контроллера.

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

  • Чужой on_boot записывает напряжения AGM в ваш контроллер
  • 9600 вместо 115200, шина молчит
  • Адрес не 1. Его смотрят в меню контроллера
  • Flow control на GPIO23 включают на переходнике, которому он не нужен, и ответы пропадают

9. Источники