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

Integrationen
1

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. Integrationen → Benutzerdefinierte Repositories → https://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

3 „Gefällt mir“
Automatische Batterie-Überwachung in Home Assistant: Benachrichtigungen bei niedrigen Batterieständen, Erinnerungen nach 2 Tagen und eine Dashboard-Integration
2

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

3

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.

4

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“
5

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

6

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“
7

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

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

1 „Gefällt mir“
8

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“