Подяка: Цей посібник ґрунтується на документації README та даних проєкту, які автор проєкту BatMON (batmon-ha) опублікував на GitHub. Висловлюємо особливу подяку розробнику проєкту за надані технічні матеріали та дані.
Джерело проєкту (GitHub): https://github.com/fl4p/batmon-ha
У цій статті покроково пояснюється, як BatMON встановити, налаштувати та використовувати в Home Assistant, щоб зчитувати дані акумулятора через Bluetooth Low Energy (BLE) безпосередньо із системи керування акумулятором (BMS) та надійно відображати їх у Home Assistant.
Описані способи особливо підходять для акумуляторів LiFePO₄ з Bluetooth-BMS, наприклад акумуляторів Lithink з Bluetooth, і призначені для використання в автобудинках, автономних системах і стаціонарних накопичувачах енергії.
Важлива примітка: BatMON використовує Bluetooth Low Energy для передачі даних. Залежно від умов навколишнього середовища (відстані, екранування металом, радіоперешкод або Bluetooth-обладнання хоста) можливі короткочасні розриви з'єднання. Зазвичай це не свідчить про несправність акумулятора або BMS.
1) Що таке BatMON і яку функцію він виконує в Home Assistant?
BatMON - це доповнення для моніторингу акумуляторних систем, розроблене спеціально для Home Assistant. Через Bluetooth Low Energy (BLE) встановлюється пряме з'єднання із системою керування акумулятором (BMS), через яке постійно зчитуються робочі дані.
Зчитані дані передаються через MQTT до Home Assistant і стають доступними як сутності датчиків. На їх основі можна створювати візуалізації, вести журнали та налаштовувати автоматизації.
Для акумуляторів Lithink LiFePO₄ з Bluetooth-BMS BatMON забезпечує особливо просту архітектуру системи, оскільки додаткові шлюзи або послідовні інтерфейси не потрібні.
- Пряме з'єднання BLE з BMS акумулятора
- Збір даних про напругу, струм і рівень заряду акумулятора (SoC)
- Зчитування напруги комірок і температури (залежить від BMS)
- Підтримка одночасної роботи з кількома акумуляторами
- Автоматичне виявлення MQTT для Home Assistant
- Інтеграція в інформаційні панелі та огляди енергоспоживання
На практиці BatMON особливо добре зарекомендував себе в системах, що працюють безперервно, наприклад в автобудинках або автономних енергосистемах. Для акумуляторів Lithink з Bluetooth дані, надані BMS, отримуються безпосередньо та відображаються як окремі сутності Home Assistant.
2) Передумови
- Встановлений Home Assistant з підтримкою Supervisor.
- Підтримка Bluetooth на хост-системі (вбудована або через USB-адаптер).
- Встановлений брокер MQTT, наприклад Mosquitto.
- Акумулятор з підтримкою Bluetooth, увімкнений і в зоні дії, наприклад акумулятор Lithink LiFePO₄ з Bluetooth.
В акумуляторах Lithink з Bluetooth функцію Bluetooth активовано на заводі. Додаткова активація або зміна прошивки не потрібна. Під час налаштування акумулятор не має бути постійно підключений паралельно до застосунку на смартфоні.
3) Крок 1: Додавання репозиторію BatMON
- Відкрийте Home Assistant.
- Перейдіть до Supervisor → магазин доповнень.
- Через меню ⋮ → Репозиторії додайте новий репозиторій.
- Введіть таку URL-адресу:
https://github.com/fl4p/home-assistant-addons
4) Крок 2: Встановлення доповнення BatMON
- У магазині доповнень виберіть BatMON.
- Натисніть Встановити.
- Дочекайтеся завершення встановлення.
5) Крок 3: Встановлення та налаштування брокера MQTT
- Встановіть доповнення Mosquitto MQTT.
- Запустіть службу MQTT.
- Активуйте інтеграцію MQTT у Home Assistant.
- Правильно налаштуйте ім'я користувача та пароль.
6) Крок 4: Налаштування BatMON (підключення акумулятора через Bluetooth)
devices:
- address: CC:44:8C:F7:AD:BB
type: jk
alias: lithink_battery
pin: "12345"
adapter: "hci0"
debug: true
current_calibration: 1.0
У системах із кількома акумуляторами можна визначити кілька пристроїв, кожен із власним alias. Після цього кожен акумулятор Lithink з Bluetooth відображатиметься в Home Assistant як окрема сутність.
7) Крок 5: Запуск BatMON
- Запустіть доповнення.
- Перевірте записи журналу.
- Переконайтеся, що з'єднання з акумулятором стабільне, а дані MQTT надсилаються.
8) Крок 6: Відображення даних акумулятора в Home Assistant
Після успішного запуску дані датчиків автоматично додаються до Home Assistant через MQTT Discovery. Відображені значення відповідають даним, які надає BMS акумулятора, і збігаються з інформацією в застосунку акумулятора.
9) Усунення несправностей
Акумулятор не відображається або не підключається
- Перевірте MAC-адресу.
- Правильно налаштуйте тип BMS.
- Зменште відстань між акумулятором і хостом.
- Перевірте журнали BatMON.
- Перевірте брокер MQTT.
З'єднання встановлено, але сутності не відображаються в Home Assistant
- Чи активна інтеграція MQTT?
- Чи правильні облікові дані MQTT?
- Чи є в журналі повідомлення про публікацію MQTT?
- Перезавантажте інтеграцію MQTT або перезапустіть Home Assistant.
Нестабільне з'єднання Bluetooth
- Уникайте паралельних з'єднань із застосунками на смартфоні.
- Зменште радіоперешкоди.
- Використовуйте зовнішні USB-адаптери Bluetooth.
- У стаціонарних системах (наприклад в автобудинку або автономній системі) рекомендується використовувати одне постійне з'єднання Bluetooth через Home Assistant, особливо для акумуляторів Lithink з Bluetooth.
10) Подяка та джерело проєкту
Цей посібник повністю ґрунтується на загальнодоступній документації README та даних проєкту BatMON. Дякуємо розробнику проєкту за надання цієї технічної інформації.
Джерело проєкту: https://github.com/fl4p/batmon-ha


Поділитися:
Victron Venus OS: підключення акумуляторів Lithink через Bluetooth і відображення даних акумулятора
Причини та способи усунення падіння напруги під час запуску інвертора
8 коментарів
*
test
test
test’
test