Home - BeGiBue/home-assistant-water-leak-guard GitHub Wiki

Wasserwächter – Projekt-Wiki

Wasserwächter (englisch: Water Leak Guard) ist eine Home-Assistant-Custom-Integration zur Erkennung auffälliger Wasserverbräuche und möglicher Leckagen.

Diese Repository-Wiki-Quellen dokumentieren den stabilen Stand 2.0.0 vom 15. Oktober 2026 (Karte 0.6.2). Die Aktualisierung der Quellen veröffentlicht das GitHub-Wiki nicht automatisch. F02, F08 und F04 V3 sind implementiert, externe Lecksensoren werden unterstützt (F04-FSR-H01 ist in 2.0.0 behoben). Die Release-Geschichte steht unter Entwicklung und Release.

Wichtig: Die technische Domain bleibt water_leak_detection. Der sichtbare Name ist auf Deutsch Wasserwächter.

Ziel des Projekts

Der Wasserwächter soll aus einem vorhandenen Durchflusssensor erkennen, ob ein Wasserverbrauch noch zu normalem Haushaltsverhalten passt oder ob ein mögliches Leck bzw. ein gefährlicher Wasserverlust vorliegt.

Dabei werden vier unterschiedliche Situationen bewusst getrennt behandelt:

  1. Slow Leak – sehr kleiner, kontinuierlicher Verlust
  2. Low Flow – moderater Durchfluss, der ungewöhnlich lange anhält
  3. High Flow – ungewöhnlich hoher, aber möglicherweise legitimer Verbrauch
  4. Burst Leak – massiver bzw. sehr plötzlich einsetzender Wasserverlust

Die Integration trennt außerdem strikt zwischen:

  • Erkennung – was ist physisch noch aktiv?
  • Alarmierung – wer soll informiert werden?
  • Quittierung – wer hat den Alarm gesehen bzw. für wen soll er verstummen?
  • Water Shut Off – soll eine externe Absperrung angefordert werden?

Diese Trennung ist eine der wichtigsten Sicherheitsentscheidungen des Projekts.

Wiki-Navigation

Einstieg und Architektur

Erkennung und Sicherheitslogik

Home Assistant

Entwicklung

Die fünf zentralen fachlichen Fragen

Dieses Wiki beantwortet insbesondere:

A) Was bedeutet welche Leckageklasse?

Die fachliche Definition der vier Klassen ist unter Leckageklassen und Erkennungslogik dokumentiert.

B) Wie wird entschieden, wie eine Leckage erkannt wird?

Für jede Klasse sind Messbereich, Zeitbedingungen, Resetbedingungen und die Begründung der gewählten Logik dokumentiert.

C) Welche Alarmstufen gibt es und wie funktionieren Quittierungen?

Siehe Alarmstufen und Quittierung. Dort werden persönliche Stummschaltung, globale Quittierung, Home-Zone-Prüfung und Rückkehr-nach-Hause-Verhalten erklärt.

D) Wie funktioniert Water Shut Off?

Siehe Water Shut Off. Der Shut-Off-Request ist bewusst nicht mit einer Quittierung gekoppelt.

E) Warum bleibt welcher Alarm stehen?

Jede aktive Erkennung endet nur durch ihre physische Resetbedingung. Eine Quittierung beendet niemals die Erkennung. Die konkreten Gründe und Resetbedingungen stehen sowohl bei den einzelnen Leckageklassen als auch unter Designentscheidungen.

Sicherheitsgrundsatz

Der Wasserwächter ist ein Erkennungs- und Entscheidungsbackend. Er kann das Risiko eines unbemerkten Wasserverlusts reduzieren, garantiert aber keine Schadensvermeidung.

Automatische physische Ventilsteuerung erfolgt derzeit nicht direkt durch die Integration. Stattdessen stellt sie eine unabhängige Absperranforderung bereit, die in Home Assistant gezielt mit einer bestehenden Ventil- oder Schaltentität automatisiert werden kann.

Alarm und Überwachung getrennt beurteilen

Hydraulische Überwachung zeigt Aktiv, Warte auf Messung oder Gesperrt. „Kein Alarm“ beweist keine funktionierende Messfreigabe; Gesperrt beendet keinen bereits ACTIVE bestätigten Alarm. Sensor und Attribute. Seit 2.0.0-beta.1 wird die Dashboard-Karte mit der Integration geladen. Sie zeigt Alarm und Überwachung getrennt und bietet gekoppelten Geräten die Alarmaktionen an, die das Backend gerade erlaubt. Am 14. Oktober 2026 bestätigte der Benutzer einen erfolgreichen Hydrus-Neustart mit installierter Beta.3: kein Fehlalarm/Repair, 11 Sekunden Gesperrt, anschließend automatisch Aktiv und verified_original_measurement. Kein Codex-Hardwaretest und keine garantierte Startdauer. Befund und Grenzen.