Podziękowania: Ten samouczek opiera się na udostępnionych publicznie przez autora projektu BatMON (batmon-ha) dokumentacjach README i danych projektowych na GitHubie. Wyraźnie dziękujemy pierwotnemu deweloperowi za udostępnione treści techniczne i dane.
Źródło projektu (GitHub): https://github.com/fl4p/batmon-ha
W tym wpisie krok po kroku wyjaśniono, jak BatMON w Home Assistant zainstalować, skonfigurować i uruchomić, aby odczytywać dane akumulatora bezpośrednio z Battery-Management-System (BMS) przez Bluetooth Low Energy (BLE) i niezawodnie wyświetlać je w Home Assistant.
Opisane procedury są szczególnie odpowiednie dla akumulatorów LiFePO₄ z Bluetooth BMS, jak np. akumulatory Lithink Bluetooth, i są przeznaczone do zastosowań w kamperach, systemach off-grid oraz stacjonarnych magazynach energii.
Ważna informacja: BatMON używa Bluetooth Low Energy do transmisji danych. W zależności od warunków otoczenia (odległość, ekranowanie metalowe, zakłócenia radiowe lub sprzęt Bluetooth hosta) mogą wystąpić krótkotrwałe przerwy w połączeniu. Zazwyczaj nie oznacza to usterki akumulatora ani BMS.
1) Czym jest BatMON i jaką funkcję pełni w Home Assistant?
BatMON to dodatek opracowany specjalnie dla Home Assistant do monitorowania systemów akumulatorowych. Przez Bluetooth Low Energy (BLE) nawiązywane jest bezpośrednie połączenie z systemem zarządzania akumulatorem (BMS), z którego na bieżąco odczytywane są dane eksploatacyjne.
Odczytane dane są przekazywane do Home Assistant przez MQTT i udostępniane tam jako encje sensorów. Na tej podstawie można tworzyć wizualizacje, rejestrację danych i automatyzacje.
W przypadku akumulatorów Lithink LiFePO₄ z Bluetooth BMS BatMON umożliwia szczególnie prostą architekturę systemu, ponieważ nie są wymagane dodatkowe bramki ani interfejsy szeregowe.
- Bezpośrednie połączenie BLE z BMS akumulatora
- Odczyt napięcia akumulatora, prądu i stanu naładowania (SoC)
- Odczyt napięć ogniw i temperatur (zależnie od BMS)
- Obsługa wielu akumulatorów równocześnie
- MQTT Auto-Discovery dla Home Assistant
- Integracja z pulpitami i widokami energii
W praktyce BatMON sprawdza się szczególnie w systemach pracujących stale, na przykład w kamperach lub systemach energetycznych poza siecią. W przypadku akumulatorów Lithink Bluetooth dane udostępniane przez BMS są przejmowane bezpośrednio i odwzorowywane jako osobne encje Home Assistant.
2) Wymagania
- Zainstalowany Home Assistant z obsługą Supervisor.
- Obsługa Bluetooth na systemie hosta (wewnętrzna lub przez adapter USB).
- Zainstalowany broker MQTT, z. B. Mosquitto.
- Akumulator z obsługą Bluetooth, włączone i w zasięgu, np. bateria Lithink Bluetooth-LiFePO₄.
W przypadku akumulatorów Lithink Bluetooth funkcja Bluetooth jest aktywna fabrycznie. Dodatkowa aktywacja ani modyfikacja firmware nie są potrzebne. Podczas konfiguracji akumulator nie powinien być stale połączony równolegle z aplikacją na smartfonie.
3) Krok 1: dodanie repozytorium BatMON
- Otwórz Home Assistant.
- Przejdź do Supervisor → Add-on Store.
- Przez menu ⋮ → Repositories dodaj nowe repozytorium.
- Wpisz następujący adres URL:
https://github.com/fl4p/home-assistant-addons4) Krok 2: instalacja dodatku BatMON
- W Add-on Store wybierz BatMON.
- Kliknij Install.
- Poczekaj na zakończenie instalacji.
5) Krok 3: instalacja i konfiguracja brokera MQTT
- Zainstaluj dodatek Mosquitto MQTT.
- Uruchom usługę MQTT.
- Włącz integrację MQTT w Home Assistant.
- Poprawnie skonfiguruj nazwę użytkownika i hasło.
6) Krok 4: konfiguracja BatMON (podłączenie akumulatora Bluetooth)
devices:
- address: CC:44:8C:F7:AD:BB
type: jk
alias: lithink_battery
pin: "12345"
adapter: "hci0"
debug: true
current_calibration: 1.0W systemach z wieloma akumulatorami można zdefiniować kilka urządzeń, każde z własnym alias. Każdy akumulator Lithink Bluetooth jest następnie prowadzony jako osobna encja w Home Assistant.
7) Krok 5: uruchomienie BatMON
- Uruchom dodatek.
- Sprawdź logi.
- Upewnij się, że połączenie z akumulatorem jest stabilne i że dane MQTT są wysyłane.
8) Krok 6: wyświetlanie danych akumulatora w Home Assistant
Po pomyślnym uruchomieniu dane sensorów są automatycznie integrowane w Home Assistant przez MQTT Discovery. Wyświetlane wartości odpowiadają danym dostarczanym przez BMS akumulatora i są zgodne z informacjami z aplikacji akumulatora.
9) Rozwiązywanie problemów
Akumulator nie jest widoczny lub nie łączy się
- Sprawdź adres MAC.
- Poprawnie skonfiguruj typ BMS.
- Zmniejsz odległość między akumulatorem a hostem.
- Przeanalizuj logi BatMON.
- Sprawdź broker MQTT.
Połączenie istnieje, ale w Home Assistant nie widać żadnych encji
- Integracja MQTT aktywna?
- Dane logowania MQTT poprawne?
- W logu są komunikaty MQTT Publish?
- Załaduj ponownie integrację MQTT lub uruchom ponownie Home Assistant.
Niestabilne połączenie Bluetooth
- Unikaj równoległych połączeń z aplikacjami na smartfonie.
- Ogranicz zakłócenia radiowe.
- Użyj zewnętrznych adapterów USB Bluetooth.
- W systemach stacjonarnych (np. kamper lub off-grid) zaleca się jedno, stałe połączenie Bluetooth przez Home Assistant, szczególnie w przypadku akumulatorów Lithink Bluetooth.
10) Podziękowania i źródło projektu
Ten samouczek opiera się w całości na publicznie dostępnych dokumentacjach README i danych projektowych projektu BatMON. Dziękujemy pierwotnemu deweloperowi za udostępnienie tych informacji technicznych.
Źródło projektu: https://github.com/fl4p/batmon-ha
Udostępnij:
Victron Venus OS: integracja baterii Lithink przez Bluetooth i wyświetlanie danych baterii
Przyczyny i rozwiązania spadku napięcia przy uruchamianiu falownika
8 komentarzy
*
test
test
test’
test