Automatische waterafsluiting met Home Assistant: integratieopties en automatiseringen

Deze lekdetector en afsluiter worden bediend via de Smart Life-app, die op het platform van Tuya draait, en Tuya-apparaten zijn precies waarvoor de officiële Tuya-integratie van Home Assistant is gebouwd. Dat betekent dat er een gedocumenteerde route is om dit type apparaat aan Home Assistant te koppelen: verbind hetzelfde Smart Life-account en Home Assistant kan de apparaten zien die eraan zijn gekoppeld. Niet gedocumenteerd is of elke functie die deze afsluiter in de app biedt - flowbewaking, meldingen en de afsluitfunctie zelf - na het koppelen als bruikbare entiteit beschikbaar komt, en of een alternatief dat alleen lokaal werkt dit specifieke product en de firmware ondersteunt. Het is verstandig om beide punten te controleren voordat je er een automatisering op baseert.

• De afsluiter wordt op dezelfde manier als andere Smart Life-apparaten aan Home Assistant gekoppeld via "Powered by Tuya", niet via een apparaatspecifieke plug-in. Daarom is de accountkoppeling belangrijker dan het afzonderlijke product.
• De officiële Tuya-integratie van Home Assistant werkt via de cloud van Tuya, terwijl een afzonderlijk communityproject met de naam tuya-local ondersteunde apparaten rechtstreeks op het thuisnetwerk bedient. Beide routes hebben andere vereisten en beperkingen.
• Een automatisering die bij een lek de afsluiter bedient, bestaat in Home Assistant uit een trigger, een optionele voorwaarde en een actie. Het entiteitstype voor afsluiters ondersteunt opdrachten om te openen, te sluiten, te stoppen en de positie in te stellen.
• De fabrikant documenteert een oplaadbare batterij als back-up bij stroomuitval, maar geeft niet aan in welke positie de afsluiter blijft staan als zowel de netvoeding als de batterij uiteindelijk leeg zijn. Dat is belangrijk zodra er een automatisering bovenop komt.
• Niets in dit artikel bevestigt dat dit apparaat intern met Home Assistant is getest. Beschouw de onderstaande informatie als een beschrijving van hoe de integratie in grote lijnen werkt, niet als garantie dat dit specifieke apparaat compatibel is.

Hoe deze afsluiter in een Home Assistant-installatie past

Het apparaat wordt via 2,4G- of 5G-wifi gekoppeld aan de Smart Life-app, en dat detail is belangrijker dan het misschien lijkt. Smart Life is de consumentenapp van Tuya, en het label "Powered by Tuya" bepaalt of een apparaat überhaupt kan worden toegevoegd aan de officiële Tuya-integratie van Home Assistant. Home Assistant koppelt de afsluiter niet als een product met een specifieke naam; het koppelt het Tuya- of Smart Life-account waaraan de afsluiter is toegevoegd en leest vervolgens de apparaten en mogelijkheden uit die dat account beschikbaar stelt.

Daarom zijn compatibiliteit op accountniveau en compatibiliteit op functieniveau twee verschillende vragen. Het eerste staat vrijwel vast: een Tuya-apparaat dat aan Smart Life is toegevoegd, is precies het soort apparaat waarvoor de integratie is ontworpen. Het tweede hangt af van welke entiteitsplatforms de Tuya-integratie van Home Assistant op dat moment ondersteunt. De integratie ondersteunt de meeste apparaattypen, waaronder schakelaars en afsluiters, maar sluit expliciet een paar platforms uit, zoals sloten en afstandsbedieningen. Of de specifieke metingen van deze afsluiter (debiet, temperatuur, gebruiksgeschiedenis) als sensorentiteiten beschikbaar komen, of alleen de bediening voor openen en sluiten, is iets wat je controleert door het account te koppelen en na te kijken - niet door de productpagina te lezen.

Twee manieren om een Tuya-afsluiter aan Home Assistant te koppelen

Als je weet dat het apparaat op Tuya is gebaseerd, zijn er twee manieren om het aan Home Assistant toe te voegen. Die verschillen structureel van elkaar en vormen een afweging tussen gemak en controle.

De officiële cloudgebaseerde Tuya-integratie

De ingebouwde Tuya-integratie van Home Assistant stel je in vanuit Home Assistant zelf: je meldt je aan met je Tuya Smart- of Smart Life-account, waaraan de afsluiter al is toegevoegd, en scant vervolgens een QR-code met een gebruikerscode die in de app is gegenereerd. Daarna kan Home Assistant de gekoppelde apparaten en de entiteiten die ze ondersteunen zien. De afweging zit in de dagelijkse werking: deze integratie is geclassificeerd als "Cloud Push", wat betekent dat opdrachten en statusupdates normaal gesproken via de cloudservers van Tuya lopen in plaats van via je thuisnetwerk. Als je internetverbinding wegvalt, valt ook die communicatie via de cloud weg, hoewel de afsluiter zelf maar een paar meter van je router staat.

Lokale community-integraties en hun beperkingen

Een afzonderlijk, door de community onderhouden project met de naam tuya-local werkt anders: het communiceert rechtstreeks met ondersteunde apparaten met Tuya-firmware op het lokale netwerk, met behulp van een lokale sleutel per apparaat. Daardoor blijft de dagelijkse bediening werken zonder internetverbinding. Het is een onofficieel project dat buiten het kernproject van Home Assistant wordt onderhouden. In de eigen documentatie staat uitdrukkelijk dat het gebruik ervan niet voorkomt dat het apparaat op de achtergrond ook gegevens naar de cloud van Tuya stuurt: beide routes bestaan naast elkaar en vervangen elkaar niet.

Het nadeel is dat projecten die alleen lokaal werken hun eigen lijsten met ondersteunde apparaten publiceren. Die zijn opgebouwd en getest aan de hand van specifieke producten, en verschillen in firmware tussen apparaten van hetzelfde model kunnen bepalen of een bepaald exemplaar wordt herkend. Je moet dit dus per apparaat controleren aan de hand van de actuele lijst; je kunt er niet van uitgaan op basis van de productnaam of -categorie. En precies die controle is hier voor deze afsluiter nog niet uitgevoerd.

Waaruit een automatisering bij een lek bestaat

Als de entiteiten van een apparaat zichtbaar zijn in Home Assistant, volgt een automatisering die erop reageert dezelfde basisopbouw als elke andere Home Assistant-automatisering: een trigger, een optionele voorwaarde en een actie die een service aanroept voor een entiteit die Home Assistant al kent. Bij een leksituatie is de trigger doorgaans een sensor die van status verandert - bijvoorbeeld een leksensor die wordt ingeschakeld of een debietmeting die een door jou ingestelde drempelwaarde overschrijdt - waarna de actie een service voor de afsluiter-entiteit aanroept.

Het entiteitstype voor afsluiters van Home Assistant is een vastgelegd domein met eigen statussen - open, gesloten, aan het openen, aan het sluiten, gestopt, niet beschikbaar en onbekend - en eigen ondersteunde acties, waaronder openen, sluiten, stoppen en de positie instellen, plus omschakelen. Daardoor kan een voorwaarde wachten tot de afsluiter daadwerkelijk de gesloten status heeft bereikt voordat er iets anders gebeurt, in plaats van ervan uit te gaan dat de opdracht om te sluiten is uitgevoerd. Een realistisch patroon combineert de afsluitactie met een afzonderlijke meldingsactie in dezelfde automatisering. Zo worden de afsluiter gesloten en de huisgenoten gewaarschuwd op basis van één trigger, in plaats van te verwachten dat de afsluiter zelf iets communiceert. Een afsluiter-entiteit kan namelijk zelf geen pushmelding of telefoontje versturen; dat gebeurt al via de eigen app en het meldingssysteem van de fabrikant, onafhankelijk van wat Home Assistant doet.

De vraag over de veilige stand die je moet stellen voordat je op een automatisering vertrouwt

Bij het ontwerp van afsluiters is de "veilige stand" de positie waar een gemotoriseerde afsluiter naartoe beweegt of waarin die blijft staan wanneer de stroomvoorziening of het besturingssignaal wegvalt: open, gesloten of gewoon de positie waarin de afsluiter al stond. Welke positie als veilig geldt, hangt volledig af van het systeem. Voor de watertoevoer van een hele woning zouden de meeste mensen "gesloten" als de veiligste standaardstand beschouwen, maar voor het daadwerkelijke product moet je dat nog steeds bevestigen en niet afleiden uit wat intuïtief klinkt.

Voor dit apparaat documenteert de fabrikant een oplaadbare batterij als back-up, zodat het apparaat tijdens een stroomuitval blijft werken. Dat is nuttige informatie en een echte ontwerpvoorziening. Niet gepubliceerd is in welke positie de afsluiter terechtkomt als de stroomuitval lang genoeg duurt om zowel de netvoeding als de batterij uit te putten. Die onduidelijkheid wordt belangrijker, niet minder belangrijk, wanneer er een Home Assistant-automatisering bovenop het apparaat komt. Een automatisering die ervan uitgaat dat "de afsluiter zichzelf wel sluit" tijdens een langdurige stroomuitval, gaat uit van iets wat de documentatie niet daadwerkelijk bevestigt. Als je een afsluiter inzet voor iets met zulke grote gevolgen als de watertoevoer van een hele woning, is het redelijk om dit rechtstreeks aan de fabrikant te vragen in plaats van te gokken.

Wat je moet controleren voordat je deze afsluiter als uitgangspunt neemt

Geen van de bovenstaande technische details vormt een bevestigde compatibiliteitsverklaring voor dit specifieke product. Ze beschrijven in algemene zin hoe de koppeling tussen Tuya en Home Assistant werkt, met deze afsluiter als het apparaat waar het om gaat. Voordat je er een automatisering omheen bouwt, is het verstandig om de volgende punten in deze volgorde te controleren:

• Koppel het Smart Life-account aan de Tuya-integratie van Home Assistant en controleer of het apparaat daadwerkelijk als een klep- of schakelaarentiteit verschijnt. Niet alle functies die de app weergeeft, zijn gegarandeerd beschikbaar via de integratie.
• Als lokale bediening belangrijk voor je is - bijvoorbeeld omdat je wilt dat de afsluiter blijft reageren tijdens een internetstoring - controleer dan in de actuele lijst met ondersteunde apparaten van tuya-local of dit specifieke product en deze firmwareversie worden ondersteund voordat je daarvan uitgaat.
• Houd de handmatige hoofdafsluiter van het huishouden en de meldingen via de eigen app van het apparaat (pushmelding, sms, telefoontje) als de primaire veiligheidslaag. Beschouw een Home Assistant-automatisering als extra gemak daarbovenop, niet als vervanging ervan.

Als je de afsluiter nog niet hebt geïnstalleerd, is het de moeite waard om eerst de voorbereidingen te treffen: de installatiestappen en gereedschapslijst voor deze afsluiter worden apart behandeld. Doe dat voordat je automatiseringen plant rond een apparaat dat nog niet op de leiding is aangesloten. Als Alexa of Google Home beter bij je huishouden past dan een hubgebaseerde installatie, vind je in deze afsluiter instellen met Alexa en Google Home meer informatie over die integraties. En als het apparaat of de app tijdens de installatie als offline wordt weergegeven, lossen de wifi-oplossingen voor een Smart Life-apparaat dat offline wordt weergegeven dit meestal op. Het is de moeite waard om die pagina te bewaren, want een cloudgebaseerde automatisering is afhankelijk van een werkende verbinding.

Wil je eerst weten hoe de sensor en afsluiter in de basis samenwerken, nog voordat een smart-homeplatform in beeld komt? In zo werken slimme waterlekdetectoren en automatische afsluiters wordt uitgelegd hoe de detectie en afsluiting zelf werken.

Kort gezegd: deze afsluiter heeft een echte, gedocumenteerde route naar Home Assistant via de officiële Tuya-integratie, en mogelijk een tweede route via een lokale community-integratie als het specifieke exemplaar op de lijst met ondersteunde apparaten staat. Voor dit product is nog geen van beide routes intern geverifieerd. Daarom begin je het beste met het controleren van je eigen accountkoppeling en entiteitenlijst en beslis je daarna welk deel van je plan om op een lek te reageren je door een automatisering wilt laten uitvoeren.