Automatisches Absperren der Wasserzufuhr mit Home Assistant: Integrationsoptionen und Automationen

Dieser Leckdetektor mit Absperrventil wird über die Smart-Life-App gesteuert, die auf Tuya läuft. Tuya-Geräte sind genau die Geräte, für die Home Assistants offizielle Tuya-Integration ausgelegt ist. Damit gibt es einen dokumentierten Weg, Geräte dieser Art in Home Assistant einzubinden: Verknüpfen Sie dasselbe Smart-Life-Konto, und Home Assistant kann die darin registrierten Geräte erkennen. Nicht dokumentiert ist, ob alle Funktionen, die dieses Ventil in der App bietet – Durchflussüberwachung, Warnmeldungen und die Absperrfunktion selbst –, nach der Verknüpfung als nutzbare Entitäten verfügbar sind und ob eine lokale Alternative dieses konkrete Produkt und diese Firmware unterstützt. Beides sollten Sie prüfen, bevor Sie eine Automatisierung darauf aufbauen.

• Das Ventil wird über denselben „Powered by Tuya“-Mechanismus wie andere Smart-Life-Geräte in Home Assistant eingebunden, nicht über ein spezielles Plug-in für dieses Gerät. Daher ist die Kontoverknüpfung wichtiger als das einzelne Produkt.
• Die offizielle Tuya-Integration von Home Assistant nutzt die Tuya-Cloud, während ein separates Community-Projekt namens tuya-local unterstützte Geräte direkt im Heimnetzwerk steuert – und für diese beiden Wege gelten unterschiedliche Voraussetzungen und Einschränkungen.
• Eine Automatisierung in Home Assistant, die bei einem Leck das Ventil schließt, besteht aus einem Auslöser, einer optionalen Bedingung und einer Aktion. Der Entitätstyp „Ventil“ unterstützt die Befehle Öffnen, Schließen, Anhalten und Position einstellen.
• Der Hersteller dokumentiert einen wiederaufladbaren Akku als Notstromversorgung bei Stromausfällen, veröffentlicht aber nicht, welche Position das Ventil hält, wenn schließlich sowohl die Netzstromversorgung als auch der Akku erschöpft sind. Das ist wichtig, sobald eine Automatisierung hinzukommt.
• Nichts in diesem Artikel bestätigt, dass dieses Gerät intern mit Home Assistant getestet wurde. Betrachten Sie die folgenden Abschnitte als Beschreibung der grundsätzlichen Funktionsweise der Integration und nicht als Kompatibilitätsgarantie für genau dieses Gerät.

Wie dieses Ventil in ein Home-Assistant-System passt

Das Gerät wird über WLAN mit 2,4G oder 5G mit der Smart-Life-App gekoppelt – ein Detail, das wichtiger ist, als es zunächst scheint. Smart Life ist die Verbraucher-App von Tuya, und die Kennzeichnung „Powered by Tuya“ entscheidet darüber, ob ein Gerät überhaupt in Home Assistants offizielle Tuya-Integration eingebunden werden kann. Home Assistant verknüpft das Ventil nicht als namentlich aufgeführtes Produkt, sondern mit dem Tuya- oder Smart-Life-Konto, zu dem das Ventil hinzugefügt wurde, und liest anschließend die Geräte und Funktionen aus, die dieses Konto bereitstellt.

Deshalb sind die Kompatibilität auf Kontoebene und die Kompatibilität auf Funktionsebene zwei getrennte Fragen. Die erste ist nahezu sicher: Ein Tuya-basiertes Gerät, das zu Smart Life hinzugefügt wurde, entspricht dem Gerätetyp, für den die Integration gedacht ist. Die zweite hängt davon ab, welche Entitätsplattformen die Tuya-Integration von Home Assistant derzeit unterstützt. Sie deckt die meisten Gerätetypen ab, darunter Schalter und Ventile, lässt aber ausdrücklich einige Plattformen wie Schlösser und Fernbedienungen aus. Ob die spezifischen Messwerte dieses Ventils (Durchflussrate, Temperatur, Nutzungsverlauf) als Sensor-Entitäten verfügbar sind oder nur die Öffnen-/Schließen-Steuerung, lässt sich herausfinden, indem Sie das Konto verknüpfen und nachsehen – nicht anhand der Produktseite.

Zwei Möglichkeiten, ein Tuya-basiertes Ventil in Home Assistant einzubinden

Sobald Sie wissen, dass das Gerät auf Tuya basiert, gibt es zwei grundlegend unterschiedliche Möglichkeiten, es in Home Assistant einzubinden. Sie unterscheiden sich darin, wie bequem sie sind und wie viel Kontrolle sie bieten.

Die offizielle Tuya-Integration über die Cloud

Die in Home Assistant integrierte Tuya-Integration wird direkt in Home Assistant eingerichtet: Sie melden sich mit Ihrem Tuya-Smart- oder Smart-Life-Konto an, zu dem das Ventil bereits hinzugefügt wurde, und scannen anschließend einen QR-Code mit einem in der App generierten Benutzercode. Danach kann Home Assistant die verknüpften Geräte und ihre unterstützten Entitäten erkennen. Der Unterschied zeigt sich im täglichen Betrieb: Diese Integration ist als „Cloud Push“ klassifiziert. Das bedeutet, dass Befehle und Statusmeldungen normalerweise über die Cloud-Server von Tuya laufen, statt im Heimnetzwerk zu bleiben. Fällt Ihre Internetverbindung aus, wird auch die Verbindung zur Cloud unterbrochen – obwohl das Ventil selbst nur wenige Fuß vom Router entfernt ist.

Lokale Community-Integrationen und ihre Einschränkungen

Ein separates, von der Community gepflegtes Projekt namens tuya-local geht anders vor: Es kommuniziert direkt über das lokale Netzwerk mit unterstützten Geräten, auf denen Tuya-Firmware läuft, und verwendet dafür einen individuellen lokalen Schlüssel pro Gerät. So funktioniert die tägliche Steuerung auch ohne Internetverbindung weiter. Das Projekt ist inoffiziell und wird außerhalb des Home-Assistant-Kernprojekts gepflegt. In der eigenen Dokumentation wird ausdrücklich darauf hingewiesen, dass die Verwendung nicht verhindert, dass das Gerät im Hintergrund weiterhin Daten an die Tuya-Cloud sendet. Die beiden Verbindungen bestehen nebeneinander, statt einander zu ersetzen.

Der Haken: Lokale Projekte veröffentlichen eigene Listen unterstützter Geräte, die anhand bestimmter Produkte erstellt und getestet wurden. Unterschiede bei der Firmware von Geräten desselben Modells können beeinflussen, ob ein bestimmtes Gerät tatsächlich erkannt wird. Das muss für jedes Gerät anhand der aktuellen Liste geprüft werden und lässt sich nicht allein aufgrund des Produktnamens oder der Produktkategorie voraussetzen. Genau diese Prüfung wurde für dieses Ventil hier noch nicht durchgeführt.

Aus welchen Bestandteilen eine Leck-zu-Ventil-Automatisierung tatsächlich besteht

Sobald die Entitäten eines Geräts in Home Assistant sichtbar sind, folgt eine Automatisierung, die auf sie reagiert, demselben Grundprinzip wie jede andere Home-Assistant-Automatisierung: Sie besteht aus einem Auslöser, einer optionalen Bedingung und einer Aktion, die einen Dienst für eine Home Assistant bekannte Entität aufruft. Bei einem Leck ist der Auslöser in der Regel ein Sensor, dessen Status sich ändert – etwa ein Lecksensor, der aktiviert wird, oder ein Durchflusswert, der einen von Ihnen festgelegten Schwellenwert überschreitet. Die Aktion ruft dann einen Dienst für die Ventil-Entität auf.

Der Ventil-Entitätstyp von Home Assistant ist eine definierte Domäne mit eigenen Zuständen – offen, geschlossen, wird geöffnet, wird geschlossen, angehalten, nicht verfügbar und unbekannt – sowie eigenen unterstützten Aktionen, darunter Öffnen, Schließen, Anhalten und Position einstellen, außerdem Umschalten. So kann eine Bedingung abwarten, bis das Ventil tatsächlich den Zustand „geschlossen“ erreicht hat, bevor etwas anderes geschieht, statt einfach anzunehmen, dass der Schließbefehl ausgeführt wurde. Ein realistisches Muster kombiniert die Absperraktion mit einer separaten Benachrichtigungsaktion in derselben Automatisierung. So werden das Ventil geschlossen und der Haushalt benachrichtigt, beides durch denselben Auslöser, statt darauf zu vertrauen, dass das Ventil selbst etwas meldet. Denn eine Ventil-Entität kann von sich aus weder Push-Benachrichtigungen noch Anrufe senden. Das geschieht bereits unabhängig von Home Assistant über die eigene App und das Warnsystem des Herstellers.

Die Frage nach dem ausfallsicheren Zustand, die Sie vor jeder Automatisierung stellen sollten

In der Ventiltechnik bezeichnet ein „ausfallsicherer“ Zustand die Position, in die sich ein motorisiertes Ventil bei einem Strom- oder Steuersignalausfall bewegt oder in der es verbleibt: offen, geschlossen oder einfach in der aktuellen Position. Welcher Zustand als sicher gilt, hängt vollständig vom jeweiligen System ab. Bei der Wasserversorgung eines ganzen Hauses würden die meisten Menschen vermutlich „geschlossen“ als sicherere Voreinstellung ansehen. Für das tatsächliche Produkt muss diese Annahme aber trotzdem bestätigt werden und darf nicht einfach aus dem abgeleitet werden, was intuitiv klingt.

Für dieses Gerät dokumentiert der Hersteller einen wiederaufladbaren Akku, der das Gerät bei einem Stromausfall weiter betreibt – eine nützliche Information und ein echtes Konstruktionsmerkmal. Nicht veröffentlicht ist, in welcher Position das Ventil bleibt, wenn der Stromausfall so lange dauert, dass sowohl die Netzstromversorgung als auch der Akku erschöpft sind. Diese Lücke wird wichtiger, nicht unwichtiger, wenn eine Home-Assistant-Automatisierung das Gerät ergänzt. Denn eine Automatisierung, die davon ausgeht, „das Ventil schließt sich bei einem längeren Stromausfall einfach selbst“, setzt etwas voraus, das in der Dokumentation tatsächlich nicht bestätigt wird. Wenn Sie ein Ventil für etwas so Wichtiges wie die Wasserversorgung des ganzen Hauses einplanen, ist es sinnvoll, den Hersteller direkt zu fragen, statt zu raten.

Was Sie prüfen sollten, bevor Sie Ihre Planung auf dieses Ventil stützen

Keine der oben beschriebenen Funktionsweisen bestätigt die Kompatibilität genau dieses Produkts. Sie beschreiben allgemein den Weg von Tuya zu Home Assistant und verwenden dieses Ventil als Beispielgerät. Bevor Sie eine Automatisierung darauf aufbauen, sollten Sie einige Punkte der Reihe nach prüfen:

• Verknüpfen Sie das Smart-Life-Konto in der Tuya-Integration von Home Assistant und prüfen Sie, ob das Gerät tatsächlich als Ventil- oder Schalter-Entität angezeigt wird. Denn es ist nicht garantiert, dass jede in der App angezeigte Funktion auch über die Integration verfügbar ist.
• Wenn Ihnen eine lokale Steuerung wichtig ist – zum Beispiel, weil das Ventil auch bei einem Internetausfall reagieren soll –, prüfen Sie in der aktuellen Liste der unterstützten Geräte von tuya-local, ob genau dieses Produkt und diese Firmware-Version aufgeführt sind, bevor Sie davon ausgehen, dass es unterstützt wird.
• Nutzen Sie das manuelle Absperrventil im Haushalt und die appbasierten Warnmeldungen des Geräts (Push-Benachrichtigung, SMS, Anruf) weiterhin als wichtigste Sicherheitsebene. Betrachten Sie jede Home-Assistant-Automatisierung als zusätzliche Funktion, nicht als Ersatz dafür.

Wenn Sie das Ventil noch nicht installiert haben, lohnt es sich, zuerst die nötigen Vorbereitungen zu treffen: Die Installationsschritte und die Werkzeugliste für dieses Absperrventil werden separat beschrieben. So können Sie die Automatisierungen planen, bevor ein Gerät installiert ist, das noch gar nicht an der Leitung sitzt. Wenn Alexa oder Google Home besser zu Ihrem Haushalt passt als eine Hub-basierte Einrichtung, erfahren Sie unter Dieses Ventil mit Alexa und Google Home einrichten direkt mehr über diese Integrationen. Und falls das Gerät oder die App während der Einrichtung als offline angezeigt wird, lässt sich das meist mit den WLAN-Lösungen für ein in Smart Life als offline angezeigtes Gerät beheben. Setzen Sie sich ein Lesezeichen für diese Seite, denn eine cloudbasierte Automatisierung ist darauf angewiesen, dass die Verbindung bestehen bleibt.

Wie Sensor und Absperrventil grundsätzlich zusammenarbeiten, bevor eine Smart-Home-Plattform ins Spiel kommt, erfahren Sie unter So funktionieren intelligente Wasserleckdetektoren und automatische Absperrventile. Dort werden Erkennung und Absperrverhalten unabhängig von einer Plattform erklärt.

Kurz gesagt: Für dieses Ventil gibt es einen konkreten, dokumentierten Weg in Home Assistant über die offizielle Tuya-Integration und möglicherweise einen zweiten über eine lokale Community-Integration, wenn das jeweilige Gerät auf deren Liste unterstützter Produkte steht. Für dieses Produkt wurde bislang keiner der beiden Wege intern überprüft. Der ehrliche Ausgangspunkt ist daher, zunächst die Verknüpfung Ihres eigenen Kontos und die Liste der Entitäten zu prüfen und dann zu entscheiden, wie viel Ihrer Planung für den Fall eines Lecks eine Automatisierung übernehmen soll.