1. Название и модель
Компонент syssi/esphome-seplos-bms читает Seplos по UART, RS-485 или BLE. Модуль RS-485 автор просит питать от 3,3 В: от этого зависит уровень TTL.
На RJ45 по таблице T-568B контакт 1 — B, оранжево-белый, контакт 2 — A, оранжевый, контакт 3 — земля, зелёно-белый. Контакты 7 и 8 повторяют A и B. Цвета T-568A другие, README на это показывает картинку.
В esp32-example.yaml скорость 9600, и тут же комментарий: у части моделей 19200. TX GPIO16, RX GPIO17, буфер приёма 384 байта, таймаут 150 мс. Адрес 0x00, все восемь DIP выключены. protocol_version 0x20 для Seplos. Для Boqiang README ставит 0x26 и override_pack: 1.
ESPHome в README — от 2024.12.
2. Что даёт перепрошивка
- Ячейки, ток и заряд стойки без консоли Seplos
- Несколько пачек различают адресом DIP, не второй платой
- Прошивка BMS остаётся заводской
3. Что теряется
- Неверный protocol_version даёт мусор при живой шине
- Буфер 384 байта в примере не декоративный: короткий буфер режет кадр
- Питание MAX485 от 5 В поднимает TTL выше, чем ждёт ESP
4. Что понадобится
- ESP32 и модуль RS-485 на 3,3 В
- Кабель к RJ45 батареи
- Знание, Seplos это или Boqiang
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.
Стойку не вскрывают. Кабель в разъём RS-485. A и B берут с пинов 2 и 1, землю с пина 3.
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. Если на 9600 тишина, в комментарии файла прямо сказано поставить 19200 под свою модель. DIP все off — это адрес 0 только для одной пачки.
Базовый конфиг этой модели с карточки или из репозитория компонента. Wi-Fi, пароль и OTA задайте как в общем разделе выше. Пароли из исходника сюда не перенесены.
esp32:
board: wemos_d1_mini32
framework:
type: esp-idf
external_components:
- source: github://syssi/esphome-seplos-bms@main
uart:
id: uart_0
baud_rate: 9600
tx_pin: GPIO16
rx_pin: GPIO17
rx_buffer_size: 384
seplos_modbus:
id: modbus0
uart_id: uart_0
rx_timeout: 150ms
seplos_bms:
id: bms0
address: 0x00
protocol_version: 0x20
seplos_modbus_id: modbus0
update_interval: 10s
sensor:
- platform: seplos_bms
total_voltage:
name: Напряжение
current:
name: Ток
state_of_charge:
name: Заряд
7. Настройка в Home Assistant
Минимальную и максимальную ячейку смотрят вместе с дельтой. Скачок дельты на вольты — это потерянный множитель, не реальный разбаланс.
8. Известные баги и как их обойти
- 0x20 на Boqiang
- A и B с пинов 7 и 8 перепутаны с 1 и 2 на обжатом наизнанку кабеле
- Буфер приёма оставлен по умолчанию
9. Источники
- GitHub syssi/esphome-seplos-bms https://github.com/syssi/esphome-seplos-bms
- GitHub esp32-example.yaml https://github.com/syssi/esphome-seplos-bms/blob/main/esp32-example.yaml