ESP-helper

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

JK-BMS по UART

Jikong, модель Jikong, порт GPS. 3/5 · разборка. Модуль Wi-Fi говорит со вторым микроконтроллером.

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

Компонент syssi/esphome-jk-bms читает Jikong BMS по UART-TTL порта, который на корпусе подписан GPS или RS485. Разъём JST на 4 контакта с шагом 1,25 мм. Порядок в README: земля, RX, TX, VBAT. VBAT — это напряжение батареи, его к ESP не сажают.

Прошивка BMS не стирается. ESP только слушает порт. Скорость 115200, поэтому README просит аппаратный UART. Пример ESP32: передача GPIO16, приём GPIO17, буфер приёма 384 байта. Пример ESP8266 в том же репозитории: передача GPIO4, приём GPIO5, и журнал обязательно с baud_rate: 0.

Issue 884 просит не переносить порт на GPIO1 и GPIO3 классического ESP32: это UART журнала и USB. Там же написано, что в меню BMS порт должен стоять в режиме UART или RS485, а не GPS и не 4G. Чужой протокол даёт тот же симптом, что и перепутанные провода: Invalid header: 0x4E 0x40.

Выключатели зарядки и разрядки в примере реально командуют MOSFET BMS. Их не нажимают, пока не ясно, кто ещё сидит на батарее.

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

  • Напряжение, ток, заряд и ячейки в Home Assistant без приложения JK
  • BMS остаётся заводской
  • На ESP8266 опубликован отдельный пример с GPIO4 и GPIO5

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

  • Кабель к порту GPS делают сами
  • Неверный протокол в меню BMS выглядит как обрыв провода
  • Полный пример репозитория огромен. Ниже короткий набор датчиков, не все защиты

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

  • ESP32. ESP8266 тоже описан, но на других пинах
  • Кабель JST 1,25 мм на 4 контакта
  • В меню BMS порт GPS переключён на UART

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.

Корпус BMS не вскрывают. На разъёме:

  • земля — на землю ESP
  • RX — на передачу ESP, в примере ESP32 это GPIO16
  • TX — на приём ESP, в примере GPIO17
  • VBAT не подключают

Подписи RX и TX на корпусе — со стороны BMS. Линия скрещивается: RX BMS принимает то, что ESP передаёт.

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. Компонент берут строкой github://syssi/esphome-jk-bms@main. Датчик пароля из полного примера сюда не перенесён. Выключатели зарядки и разрядки перенесены, потому что без них страница не показывает, что компонент умеет разомкнуть батарею.

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

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

external_components:
  - source: github://syssi/esphome-jk-bms@main

uart:
  - id: uart_0
    baud_rate: 115200
    rx_buffer_size: 384
    tx_pin: GPIO16
    rx_pin: GPIO17

jk_modbus:
  - id: modbus0
    uart_id: uart_0
    rx_timeout: 50ms

jk_bms:
  - id: bms0
    jk_modbus_id: modbus0
    update_interval: 5s

sensor:
  - platform: jk_bms
    total_voltage:
      name: Напряжение
    current:
      name: Ток
    state_of_charge:
      name: Заряд
    min_cell_voltage:
      name: Минимальная ячейка
    max_cell_voltage:
      name: Максимальная ячейка
    power:
      name: Мощность

switch:
  - platform: jk_bms
    charging:
      name: Заряд разрешён
    discharging:
      name: Разряд разрешён

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

Напряжение, ток и заряд придут через API. Заряд и разряд — это выключатели, они пишут в BMS. Пока линия не проверена на чтении, автоматизации на них не вешают.

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

  • VBAT посажен на питание ESP
  • GPIO1 и GPIO3 вместо GPIO16 и GPIO17 на классическом ESP32
  • В меню BMS оставлен протокол GPS, в журнале Invalid header
  • На ESP8266 забыт logger.baud_rate: 0, если порт сидит на UART0

9. Источники