HA Battery Status Monitor - Schwellwert und Verlustrate aller Battery-Entitäten monitoren

Hallo zusammen, ich habe (Vibecoding sei Dank) eine Integration fertig, die endlich meine Bedürfnisse abdeckt um den Ladestand (aller) Batterieentitäten zu überwachen. Es gibt dafür zwar schon andere Lösungen, aber keine deckte im Detail ab was ich haben wollte. Darf gerne getestet werden, bei mir liefen die ersten Tests sehr gut, aber wir sind definitv noch in der Beta-Phase. Man kann nichts in HA kaputt machen, die Integration ist ausschließlich lesend.

Zusätzlich zum reinen “schicke mir eine Nachricht, wenn ein Ladezustand unter X% fällt”, habe ich noch die Möglichkeit integriert benachrichtigt zu werden, falls der Status einer Batterie innerhalb von X Stunden um Y% fällt, man kann auswählen an welchen Tagen und zwischen welchen Uhrzeiten Benachrichtigungen kommen dürfen, man kann sich erinnern lassen, falls sich der Zustand einer Batterie nicht wieder gebessert hat etc.

Im weiteren kopiere ich hier mal von meinem GitHub Repo:

Eine HACS-Integration für Home Assistant, die Batteriezustände überwacht und Benachrichtigungen sendet.

Funktionen

  • Flexible Überwachung: Alle Batterieentitäten, Auswahl nach Gerät oder Auswahl nach einzelnen Entitäten

  • Schwellenwert-Benachrichtigungen: Benachrichtigung, wenn ein Akku unter einen konfigurierbaren Schwellenwert fällt (z. B. unter 20%)

  • Verlustrate-Benachrichtigungen: Benachrichtigung, wenn ein Akku innerhalb eines konfigurierbaren Zeitraums stark entladen wird (z. B. mehr als 20% in 24 Stunden)

  • Erinnerungsfunktion: Automatische Erinnerung, falls ein Akku weiterhin unter dem Schwellenwert liegt – damit nichts vergessen wird (Opt-In, konfigurierbares Intervall)

  • Zeitfenster: Benachrichtigungen nur innerhalb einer konfigurierbaren Uhrzeit senden (z. B. 08:00–20:00), inkl. Übernacht-Fenster

  • Wochentage: Frei wählbar, an welchen Wochentagen Benachrichtigungen gesendet werden sollen

  • Alle HA-Benachrichtigungsdienste: Unterstützung aller in Home Assistant konfigurierten notify-Dienste

  • Persistenz: Verlaufs- und Benachrichtigungsdaten werden über Neustarts hinweg gespeichert

  • Nachkonfigurierbar: Einstellungen können jederzeit über die Integrationsseite angepasst werden

Installation via HACS

  1. HACS in Home Assistant öffnen

  2. IntegrationenBenutzerdefinierte Repositorieshttps://github.com/OleSint/ha-battery-status-manager, Kategorie: Integration

  3. Nach der Integration suchen: HA - Battery Status Manager

  4. Installation bestätigen und Home Assistant neu starten

  5. Unter Einstellungen → Integrationen → Integration hinzufügen nach „Battery Status Manager" suchen

Konfiguration

Der Setup-Assistent führt durch vier Schritte:

1. Überwachungsbereich

Option Beschreibung
Alle Batterieentitäten Überwacht automatisch alle erkannten Batteriesensoren
Auswahl nach Gerät Wähle gezielt Geräte aus; alle Batterieentitäten dieser Geräte werden überwacht
Auswahl nach Entität Wähle einzelne Batterieentitäten aus einer Liste (alle vorausgewählt)

2. Schwellenwerte

  • Niedrig-Schwellenwert: Benachrichtigung, wenn Ladestand unter diesen Wert fällt (Standard: 20%)

  • Verlustrate-Erkennung: Benachrichtigung, wenn Ladestand um mehr als X% in Y Stunden sinkt (Standard: 20% in 24 h, Zeitfenster bis 168 h konfigurierbar)

3. Benachrichtigungen

  • Benachrichtigungsdienste: Alle konfigurierten notify.*-Dienste als Mehrfachauswahl

  • Titel: Frei anpassbarer Betreff der Benachrichtigung

  • Zeitfenster: Optional – Benachrichtigungen nur zwischen zwei Uhrzeiten senden (Übernacht-Fenster wie 22:00–06:00 werden unterstützt)

  • Wochentage: Optional – Benachrichtigungen nur an bestimmten Tagen senden (Standard: alle Tage)

  • Erinnerung: Optional – erneute Benachrichtigung, wenn der Ladestand nach X Stunden immer noch unter dem Schwellenwert liegt (Standard: 24 h)

Benachrichtigungsbeispiele

⚠️ Türsensor Eingang: Batteriestand bei 15% (Schwelle: 20%)
📉 Bewegungsmelder Garten: Batteriestand um 25% innerhalb von 24h gesunken (aktuell: 55%)

Funktionsweise

  • Batteriezustände werden stündlich geprüft

  • Niedrig-Benachrichtigungen haben eine Hysterese von 5%: nach dem Versenden wird die Benachrichtigung erst zurückgesetzt, wenn der Ladestand wieder auf Schwellenwert + 5% steigt

  • Erinnerungen werden nur gesendet, wenn die Batterie noch immer unter dem Schwellenwert liegt – nach Erholung startet der Zähler zurück

  • Benachrichtigungen außerhalb des konfigurierten Zeitfensters oder an inaktiven Wochentagen werden zurückgehalten und beim nächsten erlaubten Check nachgeholt

  • Verlustrate-Benachrichtigungen haben einen Cooldown in Höhe des konfigurierten Zeitfensters

  • Die Integration ist rein lesend – sie kann nichts in deiner HA-Konfiguration verändern oder beschädigen

Anforderungen

  • Home Assistant 2023.6.0 oder neuer

  • Mindestens ein konfigurierter notify-Dienst

4 „Gefällt mir“

Bislang habe ich noch keinerlei Bugs bzw. Probleme feststellen können.

Ich hatte gerade, kurz nach Installation, meine erste Meldung, daß der Batteriestand eines meiner Shelly BLU 1 innerhalb von 24h rapide abgesunken sein soll, ich weiß, der stand zuletzt auf 51%, schaue bei BT-Home rein, stehen dort 100%, schaue aufs Dashbord, dort standen 58% und kurz darauf springt auch dort der Wert auf 100%. Jetzt steht er bei 59%. Woher kommt dieses seltsame Verhalten?

Eben kurz wieder bei 100% und jetzt bei 61%. Vor der Installation der Integration hab es dieses Verhalten nicht, zumindest ist es mir nicht aufgefallen.

Gut, liegt wahrscheinlich an dem Teil selbst, wenn ich mir den Verlauf so anschaue, springt der schon ne Weile hin und her, alle paar Sekunden wird neu gemeldet, während der zweite von dem stupide bei 100% steht, aber die Batterie genausolange drin ist, nur ist der nicht aktiv in Benutzung.

An der Integration kann es nicht liegen. Die ist ausschließlich lesend und arbeitet dann nur mit diesen Werten.

Vielleicht half die ja schon eine defekte Batterie zu finden :wink:

1 „Gefällt mir“

Ja, ich tausch die jetzt auch aus. :grin:

Ich habe Version 1.0 veröffentlicht.
Zum bisherigen Stand hat sich verändert, dass man sich auch benachrichtigen lassen kann, wenn ein konfiguriertes Gerät seit 12 oder 24 Stunden (nach Wahl) gar nicht mehr erreichbar ist.

Das kann dann zum Tragen kommen, wenn die Batterie z.B. defekt ist, also nicht ungewöhnlich viel Ladung verliert, sondern gleich ganz aussteigt. Dieser Fall war vorher noch nicht berücksichtig.

1 „Gefällt mir“

Schickes Ikon - Schickes Ikon - Schickes Ikon! :+1:t2:

(3x, weil ein Beitrag mindestens 20 Zeichen lang sein muß :roll_eyes:)

1 „Gefällt mir“

Jetzt werden auch Homematic-IP Nutzer abgeholt.
Ich hab soeben v1.0.4 veröffentlicht. Bisher wurden nur Batterieentitäten mit numerischen Zuständen berücksichtigt. Homematic-IP hat aber nur “low Battery” on/off.
Volle Releasenotes:

What’s changed

New: Binary battery sensor support

Devices that report battery state as on/off instead of a percentage
are now fully supported — including Homematic IP devices using LOW_BAT.

Supported features for binary sensors:

  • :warning: Warning notification when LOW_BAT is active (on)
  • :bell: Reminder at configurable intervals
  • :white_check_mark: Recovery tracking when LOW_BAT clears (off)
  • :no_mobile_phones: Unavailable detection

Not applicable for binary sensors:

  • Depletion forecast (no percentage available)
  • Rapid drain detection
  • Critical threshold

Binary sensors are shown in the entity selection list with (LOW_BAT)
when the battery is currently reporting low.

Closes #1 — thanks to @csoscd for the report!

1 „Gefällt mir“

Hmm, hatte heute Nacht eine Phantomauslösung um 02:21:44 Uhr von meinem einzigen Fingerbot (bekam eine Nachricht dazu) und bei der Ursachenforschung habe ich festgestellt, daß der Batteriestand 1% beträgt, vom Battery Status Monitor kam jedoch keinerlei Warnung, weder für die eingestellte 10% Schwelle, die 5% Schwelle, noch für den rapiden Abfall der Kapazität. Die letzten Tage war der Stand noch bei über 80% (laut Verlauf) und exakt zusammen mit der Phantomauslösung dann auch auf 1% gefallen.
Der Connection Observer hat sich bislang auch noch nicht dazu gemeldet, “Zuletzt gesehen” für den Bot liegt jetzt bei 9h.

Edith sagt: Jetzt kam eine Benachrichtigung, nachdem ich einige Male nochmal durch die Einstellungen gegangen bin, um zu schauen, ob alles stimmt, nochmal verändert habe ich dabei aber nichts.

1 „Gefällt mir“

Gute Beobachtung, wie der Zufall so will hatte ich das auch gestern erst beobachtet.
Ist bereits gefixt und das Update ist raus, wurd dir nur vielleicht noch nicht angezeigt.
Hatte nen bug im Battery Manager was das Zusammenspiel mit HA angeht. Jetzt sollte es korrekt laufen.
Mit dem Connection Observer schau ich. Wurd der wirklich unavailable? Ansonsten muss ich für die Domain auch noch andere Status hinzufügen, dass die verlorene Verbindung erkannt wird.

1 „Gefällt mir“

Super, danke dir!

Ne, der steht immernoch auf “Zuletzt gesehen”, von daher kann der Connection Observer wohl auch noch garnichts dazu sagen. Generell scheinen Geräte mit leeren Batterien in HA immer nur auf dem letzten Stand hängen zu bleiben und garnicht auf “Nicht verfügbar” zu gehen. :thinking:

Aktualisierung ist, nach manueller Prüfung, jetzt installiert. Ich finde die Beschreibungen Klasse, was behoben wurde und auch den Einblick, was da nicht korrekt funktioniert hat + Zusammenhänge. :+1:t2:

1 „Gefällt mir“

Irgendwas funktioniert leider immernoch nicht richtig, ich habe die Warnungswiederholung auf 3h eingestellt, passiert aber nix, erst wenn ich nochmal durch die Einstellungen gehe und etwas ändere, kommt nach Klick aufs finale “Ok” erneut eine Meldung.

Ebenso scheint

Benachrichtigung wenn Gerät nicht mehr erreichbar -
Meldet Geräte, die keinen Akkustand mehr senden – ein starkes Zeichen für eine leere Batterie.

nicht zu greifen, der Fingerbot ist mittlerweile bei “Zuletzt gesehen: Gestern”, sendet also definitiv nix mehr, aber keine Benachrichtigung, eingestellt sind 12h Standard.

Nach der gestrigen Aktualisierung habe ich auch, wie kürzlich von dir empfohlen, komplett den Raspi neugestartet.

1 „Gefällt mir“

Bin dran. Tatsächlich gab es einen error im
Zusammenspiel mit HA, aber HA hat den Fehler still geschluckt. Entsprechend taucht das in keinem Log oder so auf… Danke dafür ^^
Ich rechne damit, dass ich das irgendwann heute releasen kann.

1 „Gefällt mir“

Danke, aber keinen Stress, ist schließlich Sonntag!

1 „Gefällt mir“

1.0.6 ist trotzdem freigegeben :wink:

1 „Gefällt mir“

Sooo, heute Nacht kam um 3:35 Uhr die Meldung, der Fingerbot ist nicht verfügbar, laut Batterieverlauf erreichte er diesen Zustand um 22:35 Uhr, das war auch genau der Zeitpunkt des HA Neustarts nach der Aktualisierung auf v1.0.6., macht genau 5h Verzögerung, womit auch immer diese komische Verzögerung zusammenhängt, egal, Meldung kam. :+1:t2:

Batteriewarnmeldungen kamen seit Neustart dann logischerweise keine mehr und da heute neue Batterien (CR2) für den Fingerbot kamen, kann ich jetzt leider nichts dazu sagen, ob die Warnungswiederholungen jetzt funktionieren, muß ich wohl erst bis zur nächsten, leeren Batterie warten. :laughing:

Vielen Dank nochmal für deine Bemühungen!

1 „Gefällt mir“

Bin ich blind, oder geht es nicht sich alle Batterien mit Problemen (niedrige Prozent, nicht erreichbar,…) in einem Dashboard anzuzeigen?

1 „Gefällt mir“

Deine Augen sind in Ordnung.

Aktuell ist das nicht möglich. Die Integration legt bewusst keine eigenen HA-Entities an, sie arbeitet nur intern und verschickt Notifications. Es gibt also keine Sensor-Entity wie “Batterien mit Problemen”, die man in einem Dashboard anzeigen könnte.

Das wäre ein neues Feature: z.B. ein Sensor sensor.battery_status_manager_problems mit der Anzahl/Liste der betroffenen Batterien als Attribut, den man dann in einer Dashboard-Karte (z.B. als Markdown oder Liste) anzeigen kann.

Ich selbst brauche das nicht und bisher hat niemand Bedarf dafür geäußert, Du bekommst ja per Notification eine Übersicht welche Geräte betroffen sind als Übersicht.

Seit dem Mai-2026-Release (2026.5) gibt es ein neues Maintenance Dashboard, das sowieso fest in Home Assistant integriert ist:

  • Erkennt automatisch alle Batterie-Entities im Haushalt
  • Gruppiert sie nach Bereich (Area)
  • Hebt niedrige Batterien optisch hervor
  • Zu finden unter Einstellungen → Dashboards → Integriert → Maintenance

Zusätzlich gibt es seit 2026.4 ein natives Battery-System mit Automation-Triggern/-Bedingungen für battery- und battery_charging-Device-Classes (für binary sensors, sensors und number entities).

Meine Integration ergänzt das gut um die Notification-Logik (Hysterese, Drop-Erkennung, Unavailable-Detection), die das Maintenance Dashboard nicht hat — beide ergänzen sich.

1 „Gefällt mir“

Danke für die Antwort und die zusätzlichen Hinweise.

Im Protokoll finde ich seit geraumer Zeit sowas hier:

Dieser Fehler stammt von einer benutzerdefinierten Integration

Logger: custom_components.battery_status_manager.coordinator
Quelle: custom_components/battery_status_manager/coordinator.py:312
Integration: HA - Battery Status Manager (Dokumentation, Probleme)
Erstmals aufgetreten: 05:47:53 (37 Vorkommnisse)
Zuletzt protokolliert: 05:47:53

Monitored entity 'sensor.flur_sb_lock_ultra_batterie' not found in Home Assistant. It may have been renamed or removed. Please reconfigure the integration.
Monitored entity 'sensor.wz_pm1_battery' not found in Home Assistant. It may have been renamed or removed. Please reconfigure the integration.
Monitored entity 'sensor.flur_bt_schlussel_2_batterie' not found in Home Assistant. It may have been renamed or removed. Please reconfigure the integration.
Monitored entity 'sensor.flur_bt_schlussel_1_batterie' not found in Home Assistant. It may have been renamed or removed. Please reconfigure the integration.
Monitored entity 'sensor.ku_pm_battery' not found in Home Assistant. It may have been renamed or removed. Please reconfigure the integration.

Bin immer wieder mal durch die Konfiguration der Integration gegangen, krieg die Meldung trotzdem nicht weg.

Ansonsten funktioniert mittlerweile alles bestens, nach der letzten Aktualisierung. :low_battery::+1:t2:

1 „Gefällt mir“