Автономний моніторинг та керування JK BMS на базі ESP32 (без Home Assistant, із Telegram-ботом та сценаріями)

OlexandrBy

Tier3
Реєстрування
4 Лис 2025
Дописи
15
Бали
3
Сонячні панелі
-
Інвертор
MUST PV18-3224 PRO
Вітаю спільноту! Хочу поділитися досвідом реалізації проєкту повністю автономного моніторингу та керування платою JK BMS на базі мікроконтролера ESP32 у середовищі ESPHome. Я тільки починаючий на цьому ресурсі, тому якщо це дуже банальний проект, прошу сильно не сварити та може все ж комусь буде цікаво, можливо побачите як можливо це допрацювати ти поправити.

Дисклеймер: більшість коду було написано за допомогою claude.ai, з деякими ручними допрацюваннями, та я не ручаюсь за за правильність на надійність, всі дії які ви можете зробити з цього посту, суто є вашим рішенням та автор (тобто я) не несе відповідальності. Всім добра
Головна фішка цього рішення — відсутність потреби у виділеному сервері (Raspberry Pi, міні-ПК з Home Assistant тощо). Уся логіка, локальний веб-інтерфейс, сценарії автоматизації та повноцінний двосторонній Telegram-бот крутяться безпосередньо на самій платі ESP32
Ще одною з проблем яку мав на меті вирішити постійний підзаряд акумулятора інверторам (MUSP 3224 PRO) хоч і підключений по кабелю але після заряду да 100% SOC просідала до 98-99% і постійно підзаряджала до 100%, і так по колу. І те що в налаштуванні інвертора немає можливості вистасити % максимального заряду акумулятора (зменшувати вольтаж не був варіантом). Більш детально розпишу далі.

1. Архітектура та «залізо»​

Зв'язок із BMS відбувається бездротовим шляхом через Bluetooth Low Energy (BLE), тож жодних дротів до самої плати BMS паяти чи підключати не потрібно.
1794764154684.png
Що використано:
  • Мікроконтролер: класичний двоядерний ESP32 (наприклад, Wemos D1 Mini32 або ESP32 DevKit V1).
    • Важливо: плати серії ESP8266 не підійдуть через відсутність BLE, а ESP32-S2/S3/C3 потребують додаткових танців із бібліотеками. Найкраще брати класичний ESP32-WROOM-32 (або версію 32U із зовнішньою антеною (яка у мене і використовувалвсь), якщо АКБ стоїть у металевій шафі).
  • Батарея та BMS: збірка 8S LiFePO4 (314 Ah) під керуванням інверторної JK BMS (протокол JK02_32S, актуально для версій заліза v11+ / v19 / серії JK-PB).
  • Програмна база: прошивка зібрана в ESPHome із використанням перевіреного зовнішнього компонента syssi/esphome-jk-bms.

2. Локальний веб-інтерфейс та резервний доступ​

На самій ESP32 піднято вбудований веб-сервер (web_server v2) із захистом за логіном та паролем (auth з типом digest).
  • Перейшовши у браузері за адресою [http://jk-bms.local](http://jk-bms.local) (або за IP-адресою плати), ви отримуєте дашборд у реальному часі: напруги всіх 8 комірок, дельту, струм, SOC %, температури, а також кнопки й тумблери керування (увімкнення/вимкнення заряду, розряду, активного балансира, підігріву).
  • Резервна точка доступу (Emergency AP): якщо зникне світло й домашній Wi-Fi роутер вимкнеться, ESP32 автоматично підніме власну Wi-Fi мережу. Підключившись до неї напряму зі смартфона, можна зайти на [http://192.168.4.1] і перевірити стан батареї навіть у повному офлайні.

3. Двосторонній Telegram-бот без зовнішнього сервера​

Замість того щоб піднімати проміжний сервер або орендувати, ESP32 напряму спілкується із серверами Telegram по HTTPS через вбудований компонент http_request.

Що вміє бот:
  1. Інтерактивне меню з кнопками (Inline Keyboard):
    • «Статус» — миттєва зведена інформація: SOC %, загальна напруга, поточний струм і потужність, мін/макс напруга комірок та дельта.1794764692750.png
    • «Вся інформація» — розгорнутий звіт по кожній із 8 комірок, усіх температурних датчиках (T1–T4, MOSFET) та лічильниках добової енергії (заряджено/розряджено в Вт·год та А·год).
      1794764736410.png
    • «Керування» — меню перемикання режимів BMS (Заряд, Розряд, Балансир, Підігрів), скидання добових лічильників енергії та перезавантаження самої ESP32. Для безпеки кожна критична дія має двоетапне підтвердження («⚠️ Підтвердіть дію: ВИМКНУТИ розряджання?»).
    • 1794764865547.png
  2. Періодичні звіти: щогодини бот надсилає тихий (беззвучний) звіт про стан батареї, щоб не відволікати звуком повідомлень.
1794764936656.png

4. Сценарії автоматизації та система сповіщень​

Уся логіка сценаріїв написана всередині YAML-конфігурації за допомогою тригерів on_value_range, on_press/on_release та lambda-скриптів на C++:
  • Контроль порогів заряду (SOC): автоматичні сповіщення при досягненні 100%, 70%, 50%, 30% та тривожне сповіщення при розряді нижче 15%. Також реалізовано окремий режим «Сповіщення 55%» (зручно, коли потрібно зарядити або розрядити батарею до рівня зберігання — бот сповістить один раз і сам вимкне тригер).
1794765440029.png
  • Аварійні тригери безпеки:
    • Перегрів комірок (> 45 °C) або ключів MOSFET (> 70 °C).
    • Заряджання на морозі (попередження, якщо пішов струм заряду при температурі комірок нижче 0–10 °C).
    • Розбаланс комірок (якщо delta_cell_voltage перевищує 0.10 В) та вихід напруги будь-якої комірки за межі 2.82 В – 3.60 В.
    • Тривале високе навантаження (> 2.8–3 кВт).
  • Діагностика зв'язку:
    • Якщо ESP32 втрачає Bluetooth-зв'язок із BMS (із фільтром delayed_off: 60s, щоб ігнорувати секундні перешкоди в ефірі), бот одразу пише про втрату зв'язку, а після відновлення — про повернення в онлайн.
    • При появі живлення або перезавантаженні плати після підключення до Wi-Fi бот надсилає повідомлення « СИСТЕМА ОНЛАЙН» із зазначенням причини останнього ребуту.
  • Визначення режимів роботи (гістерезис): окремий алгоритм відстежує перехід батареї в режим заряду, розряду або очікування (відсікаючи дрібні коливання струму в режимі байпасу інвертора).
1794765538060.png 1794765538066.png1794765565500.png
  • Добові звіти:
1794765749262.png

5. Рішення проблеми з постійним дозарядом інвертора MUST 3224 PRO​

Автообмеження вікна заряду/розряду (скрипт /limit) та калібрувальні цикли:
Оскільки при з'єднанні інвертора із JK BMS по CAN-шині інвертор ігнорує власні ліміти відсотків і намагається постійно дозаряджати LiFePO4 до 98–100%, на ESP32 реалізовано власний програмний контролер вікна заряду (limit_cmd).
  • Гнучке керування з Telegram: прямо в чаті бота можна задати будь-який проміжок роботи командою формату /limit 90 85 — ESP32 автоматично вимкне зарядний ключ (Charge FET), коли батарея досягне 90%, і знову дозволить заряджання, коли заряд опуститься до 85%. Також доступні команди /limit on, /limit off (заряд до максимуму), /limit (перевірка поточних порогів) та /help із підказками по всіх командах.
1794766860682.png
Сповіщення про досягнення ліміту заряду та підрахунок циклів лімітованих зарядів (описано нижче)
1794766896413.png
Сповіщення про відновлення заряджання
1794766963849.png
  • Автоматичне балансування кожного 10-го циклу: щоб комірки не розбалансувалися, а шунт BMS не накопичував похибку при тривалій роботі в буферному коридорі (наприклад, 80–90%), у флеш-пам'яті ведеться лічильник підзарядів (charge_cycle_cnt). Кожен 10-й цикл скрипт тимчасово ігнорує верхній ліміт, проводить повний заряд до 100% для вирівнювання комірок активним балансиром та калібрування SOC, після чого сам повертається у щадний режим.

6. Підводні камені та оптимізація пам'яті (RAM)​

Під час розробки зіткнувся з головним ворогом таких проєктів — браком оперативної пам'яті (Heap) на ESP32. Одночасна робота стеку Bluetooth, Wi-Fi, локального веб-сервера та постійного опитування Telegram по HTTPS (через важке TLS-шифрування) швидко забиває пам'ять і призводить до перезавантажень.
Що допомогло досягти залізобетонної стабільності (залишок вільної RAM ~90 КБ):
  1. Перехід на фреймворк esp-idf замість стандартного arduino та увімкнення динамічних буферів mbedTLS (CONFIG_MBEDTLS_DYNAMIC_BUFFER: "y" тощо) — це критично економить пам'ять під час HTTPS-запитів до Telegram.
  2. Відключення перезавантаження при втраті HA: у блоці api: обов'язково потрібно прописати reboot_timeout: 0s, інакше без підключеного Home Assistant прошивка ESPHome за замовчуванням перезавантажуватиме плату кожні 15 хвилин.
  3. Оптимізація опитування Telegram: запити getUpdates виконуються з інтервалом 5–15 секунд із параметром limit=1, а під час оновлення прошивки по повітрю (OTA) Bluetooth примусово ставиться на паузу, щоб звільнити пам'ять і радіоканал.
  4. Бережне ставлення до Flash-пам'яті: для збереження лічильників добової енергії виставлено flash_write_interval: 10min, щоб не зношувати пам'ять постійним записом.

7. Зручна штучка яку теж накодив claude.ai​

Захотілось все це моніторити під час роботи, так як пк при роботі дуже прожерливий. Зробив токого індикатора в панелі пуск з % заряду та при при наведенні показує BMS 87% | 27.4V | -12.3A | -337W
Виявилось дуже зручно
1794768995883.png 1794769010466.png

​

 

Вкладення

  • 1794765514263.png
    1794765514263.png
    10,5 Кб · Перегляди: 1
  • JK BMS - ESP32 .txt
    75,7 Кб · Перегляди: 2

Підсумок та розвиток проєкту:​

У результаті за вартістю однієї плати ESP32 вийшла повністю автономна система телеметрії та керування акумулятором. Крім того, архітектура легко масштабується: на цю ж ESP32 через модуль RS485-TTL можна завести дані з інвертора (наприклад, MUST це майбутня ідея) для спільних сценаріїв або додати другу плату ESP32-S3 з OLED/TFT-екраном або прикрутити стару читалку як дисплей на робочьому столі, яка забиратиме показники по локальному HTTP JSON.
Якщо когось зацікавить — в описі жодано YAML-конфіг для більшості функцій є помітки, що за що відповідає та де які данні треба прописувіати, більшість паролів та данних внесені через !secret в ESPHome.
Відкритий до конструктивної критики. Всім тихих днів та ночей.
 
Вся ця система розрахована на 8 комірок, чи можна підключити й на 16?
Скільки буде коштувати готова налаштована плата, якщо замовити у Вас?
 
Вся ця система розрахована на 8 комірок, чи можна підключити й на 16?
Скільки буде коштувати готова налаштована плата, якщо замовити у Вас?
Вітаю, ні її можна адаптувати під будьяку кулькість комірок, по суті esp32 зчитує всі данні з Вашої bms.
На рахунок купівлі, поки не впевнений, так як поки багато нюансів з налаштуванням, так як деякі данні треба вносити перед прошивкою модуля (логін та пароль від вайфаю, MAC адресу bms, id телегрвму та бота)
Це поки тестовий зразок але вже стабільний. Можливо як буде час спробую зробити можливість вности ці всі данні та покрокову інструкцію, тоді буде сенс робити для продажу.
 
Вся ця система розрахована на 8 комірок, чи можна підключити й на 16?
Скільки буде коштувати готова налаштована плата, якщо замовити у Вас?
Але з чатом GPT або claud зможете і самі зробити, просто дайте йому мій файл та попросіть покрокову інструкцію
 
Назад
Угорі