Poděkování: Tento návod je založen na README dokumentaci a projektových datech, která autor projektu BatMON (batmon-ha) veřejně poskytl na GitHubu. Původnímu vývojáři výslovně děkujeme za poskytnutý technický obsah a data.

Zdroj projektu (GitHub): https://github.com/fl4p/batmon-ha

V tomto příspěvku je krok za krokem vysvětleno, jak se BatMON v Home Assistant instaluje, konfiguruje a provozuje, aby bylo možné číst data o baterii přes Bluetooth Low Energy (BLE) přímo z Battery-Management-System (BMS) a spolehlivě je zobrazovat v Home Assistant.

Popsané postupy se hodí zejména pro LiFePO₄ baterie s Bluetooth-BMS, jako na př. Lithink Bluetooth baterie, a jsou určeny pro použití v obytných vozech, ostrovních systémech a stacionárních úložištích energie.

Důležité upozornění: BatMON používá pro přenos dat Bluetooth Low Energy. V závislosti na podmínkách prostředí (vzdálenost, kovové stínění, rádiové rušení nebo Bluetooth hardware hostitele) může docházet ke krátkodobým výpadkům spojení. To obvykle neznamená závadu baterie ani BMS.

1) Co je BatMON a jakou funkci plní v Home Assistant?

BatMON je add-on vyvinutý speciálně pro Home Assistant pro monitorování bateriových systémů. Přes Bluetooth Low Energy (BLE) se naváže přímé spojení s Battery-Management-System (BMS), přes které se průběžně načítají provozní data.

Načtená data se přenášejí do Home Assistant přes MQTT a jsou tam zpřístupněna jako senzorové entity. Na tomto základě lze realizovat vizualizace, záznamy i automatizace.

Pro Lithink LiFePO₄ baterie s Bluetooth-BMS umožňuje BatMON obzvlášť úspornou systémovou architekturu, protože nejsou potřeba žádné další brány ani sériová rozhraní.

  • Přímé BLE spojení s bateriovým BMS
  • Sběr napětí baterie, proudu a stavu nabití (SoC)
  • Načítání napětí jednotlivých článků a teplot (podle BMS)
  • Podpora více baterií současně
  • MQTT Auto-Discovery pro Home Assistant
  • Integrace do dashboardů a přehledů energie

V praxi se BatMON osvědčil zejména v systémech v trvalém provozu, například v obytných vozech nebo ostrovních energetických systémech. U Lithink Bluetooth baterií jsou data poskytovaná BMS přímo převzata a zobrazena jako samostatné entity Home Assistant.

2) Požadavky

  1. Nainstalovaný Home Assistant s podporou Supervisoru.
  2. Podpora Bluetooth na hostitelském systému (interně nebo přes USB adaptér).
  3. Nainstalovaný MQTT broker, z. B. Mosquitto.
  4. Baterie s Bluetooth, eingeschaltet und in Reichweite, z. B. eine Lithink Bluetooth-LiFePO₄-Batterie.

U Lithink Bluetooth baterií je Bluetooth funkce z výroby aktivována. Není nutná žádná dodatečná aktivace ani úprava firmwaru. Během nastavování by baterie neměla být trvale současně připojena ke स्मार्टphone aplikaci.

3) Krok 1: Přidání repozitáře BatMON

  1. Otevřete Home Assistant.
  2. Přejděte na Supervisor → Add-on Store.
  3. Přes menu ⋮ → Repositories přidejte nový repozitář.
  4. Zadejte následující URL:
https://github.com/fl4p/home-assistant-addons

4) Krok 2: Instalace add-onu BatMON

  1. V Add-on Store vyberte BatMON.
  2. Klikněte na Install.
  3. Počkejte na dokončení instalace.

5) Krok 3: Instalace a konfigurace MQTT brokeru

  1. Nainstalujte add-on Mosquitto MQTT.
  2. Spusťte službu MQTT.
  3. Aktivujte MQTT integraci v Home Assistant.
  4. Správně nastavte uživatelské jméno a heslo.

6) Krok 4: Konfigurace BatMON (připojení Bluetooth baterie)

devices:
  - address: CC:44:8C:F7:AD:BB
    type: jk
    alias: lithink_battery
    pin: "12345"
    adapter: "hci0"
    debug: true
    current_calibration: 1.0

V systémech s více bateriemi lze definovat více zařízení, každé s vlastním alias. Každá Lithink Bluetooth baterie je poté vedena jako samostatná entita v Home Assistant.

7) Krok 5: Spuštění BatMON

  1. Spusťte add-on.
  2. Zkontrolujte logy.
  3. Ujistěte se, že existuje stabilní spojení s baterií a že se odesílají MQTT data.

8) Krok 6: Zobrazení dat z baterie v Home Assistant

Po úspěšném spuštění budou senzorová data automaticky integrována do Home Assistant přes MQTT Discovery. Zobrazené hodnoty odpovídají datům poskytnutým bateriovým BMS a shodují se s informacemi v aplikaci baterie.

9) Řešení problémů

Baterie se nezobrazuje nebo se nepřipojuje

  • Zkontrolujte MAC adresu.
  • Správně nakonfigurujte typ BMS.
  • Zmenšete vzdálenost mezi baterií a hostitelem.
  • Vyhodnoťte logy BatMON.
  • Zkontrolujte MQTT broker.

Spojení existuje, ale v Home Assistant nejsou vidět žádné entity

  • Je MQTT integrace aktivní?
  • Jsou přihlašovací údaje MQTT správné?
  • Jsou v logu přítomné MQTT publish zprávy?
  • Znovu načtěte MQTT integraci nebo restartujte Home Assistant.

Nestabilní Bluetooth spojení

  • Vyhněte se paralelním připojením přes aplikace v telefonu.
  • Omezte rádiové rušení.
  • Použijte externí USB Bluetooth adaptéry.
  • In stationären Systemen (z. B. Wohnmobil oder Off-Grid) empfiehlt sich eine einzelne, dauerhafte Bluetooth-Verbindung über Home Assistant, insbesondere bei Lithink Bluetooth-Batterien.

10) Poděkování & zdroj projektu

Tento návod je plně založen na veřejně dostupné README dokumentaci a projektových datech projektu BatMON. Původnímu vývojáři děkujeme za poskytnutí těchto technických informací.

Zdroj projektu: https://github.com/fl4p/batmon-ha

8 komentářů

8 komentářů

  • test'
    • test'
    • 24. 8. 2026 00:58

    test

  • test
    • test
    • 24. 8. 2026 00:58

    test

  • test
    • test
    • 24. 8. 2026 00:58

    test

Napiš komentář

Tento web je chráněn službou hCaptcha a vztahují se na něj Zásady ochrany osobních údajů a Podmínky služby společnosti hCaptcha.

Nejnovější Příběhy

Tato sekce momentálně neobsahuje žádný obsah. Přidejte obsah do této sekce pomocí postranního panelu.