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

Компонент syssi/esphome-apc-ups говорит со Smart-UPS командами из одной буквы. В журнале README видны Y, Q, B, F, L, O и P. Список проверенных: SU420INET, SUVS420I, SUA1000I, SUA1500MRI2U, SUA2200I, с номерами прошивок прямо в README. Нужен ESPHome от 2024.12.

Порт RS-232, переходник MAX3232. Таблица разъёма: пин 1 RX на DOUT1, пин 2 TX на RIN1, пин 9 земля. Пины 3–8 в таблице пустые. ESP32: TX GPIO16 на DIN1, RX GPIO17 на ROUT1. ESP8266 в той же таблице — GPIO4 и GPIO5. Скорость в примере 2400.

В файле есть кнопки самопроверки и имитации пропажи сети. В базовый конфиг они не скопированы: это действия над выходом ИБП, их включают отдельно и только на своей установке.

Сетевой карте AP9619 этот кабель не замена. Речь про последовательный порт самого ИБП.

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

Напряжение батареи, сеть и нагрузка без PowerChute
Видно, сидит ИБП на сети или уже на батарее
Прошивка ИБП остаётся заводской

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

Новые ИБП с другим разъёмом в список README не входят
Пин 9 как земля верен для этой таблицы. Чужой кабель DB9 часто ждёт землю на пине 5
Кнопка имитации аварии из полного примера снимает выход, если её нажать

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

ESP32 и MAX3232
ИБП из списка или тот, что отвечает на те же буквы
ESPHome от 2024.12

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.

ИБП не вскрывают. Кабель в последовательный порт. Пин 1, пин 2 и пин 9 — по таблице README.

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

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

Плату прошивают по USB. Скорость 2400. Если в логе нет строк Decode, сначала меняют местами пины 1 и 2 на разъёме.

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

esp32:
  board: wemos_d1_mini32
  framework:
    type: esp-idf

external_components:
  - source: github://syssi/esphome-apc-ups@main

uart:
  - id: uart_0
    baud_rate: 2400
    tx_pin: GPIO16
    rx_pin: GPIO17

apc_ups:
  - id: ups0
    uart_id: uart_0

binary_sensor:
  - platform: apc_ups
    apc_ups_id: ups0
    on_line:
      name: От сети
    on_battery:
      name: От батареи

sensor:
  - platform: apc_ups
    apc_ups_id: ups0
    battery_voltage:
      name: Напряжение батареи
    grid_voltage:
      name: Напряжение сети
    ac_output_load:
      name: Нагрузка

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

«От батареи» и напряжение батареи приходят разными сущностями. Нагрузка в примере — проценты, не ватты.

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

Земля взята с пина 5, а таблица этого репозитория указывает пин 9
Скорость 9600
MAX485 на порту RS-232

9. Источники

GitHub syssi/esphome-apc-ups https://github.com/syssi/esphome-apc-ups
GitHub esp32-example.yaml https://github.com/syssi/esphome-apc-ups/blob/main/esp32-example.yaml