Den Tuya-Zoo bändigen und chinesische Clouds vergessen

Angenommen, Sie haben einen smarten Heizstrahler, eine Glühbirne oder einen Wasserleck-Sensor gekauft. Auf der Verpackung prangt stolz das Tuya- oder SmartLife-Logo. Sie verbinden das Gerät, installieren die App und alles scheint zu funktionieren. Aber sobald das Internet schwächelt oder Chinas Server sich unwohl fühlen, verwandelt sich Ihr „smartes" Zuhause in einen Kürbis. Eine vertraute Geschichte?

Viele von uns kommen zu Home Assistant, um die Kontrolle über unsere Häuser den Fängen von Cloud-Diensten zu entreißen. Aber Tuya hatte schon immer einen Haken: Die offizielle Integration funktioniert über ihre API, die entweder kostenpflichtig ist, eine begrenzte Testphase hat oder einfach langsam ist. Das Projekt tuya-local löst dieses Problem radikal – es sorgt dafür, dass Geräte direkt über das lokale Netzwerk mit Ihrem Server kommunizieren.

Worum geht es bei diesem Projekt

Um es kurz zu machen: Es ist eine benutzerdefinierte Komponente für Home Assistant, mit der Sie Tuya-Geräte über WLAN ohne Zwischenhändler steuern können.

Das Haupt-Highlight hier ist nicht nur die Geschwindigkeit (obwohl die Reaktion tatsächlich nahezu sofortig wird). Der Kernwert liegt darin, dass die Integration Funktionen „hervorholen" kann, die die offizielle Cloud überhaupt nicht anzeigt. Zum Beispiel spezifische Betriebsmodi von Klimageräten oder detaillierte Energieverbrauchsstatistiken, die die Chinesen in der App versteckt haben, aber nicht über die API bereitgestellt haben.

Übrigens unterstützt das Projekt nicht nur WLAN-Geräte. Wenn Sie ein Tuya-Gateway haben, können Sie darüber Zigbee-Peripheriegeräte anschließen, obwohl der Autor ehrlich warnt: Die Hub-Fähigkeiten für gleichzeitige lokale Verbindungen sind stark eingeschränkt.

Was tuya-local kann

Das Repository behauptet, über tausend Geräte zu unterstützen. Es geht nicht nur um „An/Aus" – es ist ein vollwertiger Betrieb mit komplexen Entitäten.

1. Klima und Heizung. Smarte Konvektoren, Klimaanlagen und Luftbefeuchter funktionieren mit all ihren Sensoren und Voreinstellungen.
2. Beleuchtung. Die Unterstützung verschiedener Protokolle (von 3.1 bis 3.5) ermöglicht es, sogar wählerische Lampen lokal zum Laufen zu bringen, die zuvor nicht kooperieren wollten.
3. Sicherheit. Es gibt Unterstützung für einige Schlossmodelle. Es implementiert ein cleveres Schema zum Abfangen von Entsperrschlüsseln, was für Open-Source-Integrationen generell selten ist.
4. Haushaltsgeräte. Von Futterautomaten für Haustiere (mit Fütterungsplan-Unterstützung) bis zu IR-Blastern, die Befehle direkt aus der Home-Assistant-Oberfläche erlernen können.

Wie Sie das zum Laufen bringen, ohne sich den Rücken zu brechen

Früher war die Einrichtung von lokalem Tuya einem Dämonen-Beschwörungsritual ähnlich: Sie mussten ein Entwicklerkonto erstellen, local_key über die Konsole extrahieren und leiden. Bei tuya-local wurde der Prozess erheblich vereinfacht.

Die Integration hat zwei Einrichtungswege. Der erste ist der „Cloud-Assistent". Sie melden sich einmal mit Ihrem SmartLife-Konto an, die Integration zieht automatisch die Geräteliste und ihre geheimen Schlüssel ein und arbeitet dann nur noch lokal damit. Das erspart Ihnen, alle sechs Monate die Testphase im Tuya IoT-Portal erneuern zu müssen.

Der zweite Weg ist manuell. Wenn Sie ein paranoider Hardcore-Nutzer sind, der bereits alle IDs und Schlüssel selbst beschafft hat, geben Sie diese einfach in die Gerätekarte ein.

Fallstricke und Stolperfallen

Es gibt natürlich Nuancen. Tuya ist kein einzelner Standard – es ist eher ein Flickenteppich verschiedener Firmware-Versionen.

Erstens halten viele Geräte nur eine aktive lokale Verbindung. Wenn Sie die App auf Ihrem Telefon geöffnet haben oder eine andere Integration läuft (zum Beispiel das alte localtuya), kann die neue einfach nicht die Hardware erreichen.

Zweitens funktionieren batteriebetriebene Geräte (Tür- oder Rauchmelder) ohne Hub nicht lokal. Sie gehen in den Schlafmodus, um Energie zu sparen, und wachen nur auf, um Daten an die Cloud zu „pingen". Sie können die Physik hier nicht überlisten – für diese ist es besser, Zigbee-Versionen mit einem proper Stick zu verwenden.

Drittens verhalten sich manche Hardware seltsam, wenn Sie ihren Internetzugang auf dem Router vollständig blockieren. Sie können in eine Endlosschleife aus Neustarts geraten. Der Autor empfiehlt in solchen Fällen, nicht nur TCP-, sondern auch DNS-Anfragen vom Gerät zu blockieren.

Warum dies besser ist als Alternativen

Es gibt eine beliebte Alternative – localtuya. Ich habe beide ausprobiert. localtuya ist flexibler, wenn es um die manuelle Konfiguration jedes einzelnen Datenpunkts (DP) geht, aber das ist auch sein Untergang: Die Konfiguration eines komplexen Thermostats wird zu einer Stunde Fummelei mit Tabellen.

tuya-local geht den Weg der fertigen Konfigurationen. Wenn Ihr Gerät auf der unterstützten Liste steht, wählen Sie einfach seinen Typ aus, und alle Sensoren/Schaltflächen erscheinen von selbst. Das spart eine Menge Zeit. Wenn Ihr Gerät nicht unterstützt wird, können Sie dem Projekt helfen, indem Sie Logs mit einem Daten-Dump senden – die Community dort ist sehr aktiv.

Wenn Ihr Zuhause nach und nach von Tuya-Geräten überrannt wird, ist die Installation dieser Integration ein Muss. Wenn schon allein wegen der Tatsache, dass Lichter sofort angehen, anstatt eine Sekunde, nachdem das Signal eine Rundreise nach Frankfurt oder Shanghai und zurück gemacht hat.

Das Projekt ist ausgereift, mit einer soliden Gerätedatenbank und einer vernünftigen Konfigurationslogik. Ja, Tuya ist immer noch ein „Zoo", aber mit diesem Werkzeug in der Hand haben Sie zumindest eine richtige Peitsche und eine Tasche voller Leckerlis.

Es lohnt sich, es zu versuchen, wenn:

• Sie Cloud-API-Verzögerungen leid sind.
• Sie ein bestimmtes Tuya-Gerät haben, das sich nicht gut in HA mit Standardmethoden portieren lässt.
• Sie möchten, dass Automatisierungen auch dann funktionieren, wenn Ihr ISP ausfällt.

Sie finden das Projekt in HACS unter dem Namen oder direkt auf GitHub: make-all/tuya-local.