Zum Hauptinhalt springen

Tuya Smart-Home-Integration, kostenlos und Open Source

Tuya-Integration für Gladys Assistant

Tuya / Smart Life: Steckdosen, Zähler, Klimageräte, Heizungen, Kameras, Sauger (Cloud + LAN).

Auf GitHub ansehenAlle Integrationen

Steuern Sie Ihre Tuya / Smart Life Geräte aus Gladys, über die Cloud und, wenn möglich, direkt über Ihr lokales Netzwerk (LAN) — schneller und unabhängig vom Internet.

Unterstützte Geräte​

  • Smarte Stecker und Steckdosen (einschließlich LSC Power Plug FR mit Energiemessung): Ein/Aus, Kindersicherung, Leistung, Spannung, Strom, Energie.
  • Energiezähler (auch dreiphasig): Leistung, Spannung, Strom, bezogene/eingespeiste Energie.
  • Klimageräte: Ein/Aus, Modus (Auto / Kühlen / Heizen / Entfeuchten / Lüften), Solltemperatur, Raumtemperatur, Lüfterstufe und beide Schwenkachsen. Modelle mit eigenem Vokabular werden ebenfalls unterstützt (z. B. das Camping-Klimagerät MEDION P502: Modi in Großbuchstaben, zweistufiger Lüfter, Schwenken ein/aus).
  • Fil-pilote-Thermostate (französische Steuerleitung, RP5-Familie, Konyks eCosy): Heizmodus, Solltemperatur, Raumtemperatur, Kindersicherung, Energie.
  • Kameras (einschließlich LSC): Privatsphäre-Modus, Bewegungserkennung, Sirene, Bewegungsverfolgung, Personenfilter, Aufnahme, Bilddrehung und ein in Szenen nutzbarer Bewegungssensor. Schwenk-/Neigekameras (PTZ): Schwenken/Neigen vom Dashboard (Gladys 4.86.1 oder neuer). Einstellungen als Listen: Nachtsicht, Bewegungs- und Geräuschempfindlichkeit, Geräuscherkennung, Aufnahmemodus, Flimmerschutz, Zeitstempel im Bild. Live-Bild: Das Kamerabild ist ein Einzelbild des Live-Streams, alle 5 Minuten und auf Anfrage aktualisiert (Dashboard, „Zeig mir die Kamera“, Szenen); dafür wird der API-Dienst IoT Video Live Stream in Ihrem Tuya-Cloud-Projekt benötigt, sonst wird das Bild nur bei einer Bewegung / einem Klingeln aktualisiert. Live-Video (WebRTC): Mit einem Gladys, das es unterstützt (GladysAssistant/Gladys#3215), öffnet die Wiedergabe-Taste des Kamera-Widgets das Live-Video, direkt von der Tuya-Cloud in Ihren Browser (H264-Kameras; reine HEVC-Modelle sind im Browser nicht abspielbar).
  • Video-Türklingeln: Klingeln (eigene Türklingel-Funktion), Schnappschuss des Besuchers, Bewegungserkennung, Aufnahme, Status-LED.
  • Futterautomaten: Füttern auf Abruf, zuletzt ausgegebene Menge, langsames Füttern, Licht, Batterie (Prozent oder Rohspannung plus Schwach-Flag, je nach Modell), geplante Mahlzeiten.
  • Ventilatoren und Lüftungsgeräte (Kategorie fs, z. B. das Wärmerückgewinnungsgerät AV-TTW5-W): Ein/Aus, Stufe (die eigenen Stufen des Geräts, z. B. 1 bis 3), Licht, Kindersicherung, Luftstromrichtung, horizontales/vertikales Schwenken, Raumtemperatur, wenn das Gerät eine misst.
  • Luftentfeuchter (Kategorie cs, z. B. Qlima D825A): Ein/Aus, aktuelle Luftfeuchtigkeit, Temperatur, Lüfterstufe, Timer und Restzeit, Modus, Ziel-Luftfeuchtigkeit (wenn in Stufen angeboten), Kindersicherung. Stufen, Timer-Dauern und Modi listen genau die Werte, die Ihr Modell angibt.
  • Temperatur- und Feuchtigkeitssensoren (Kategorie wsdcg, z. B. Konyks Termo): Temperatur, Luftfeuchtigkeit, Batterie-schwach-Flag (und Batterieprozent bei den Modellen, die es messen). Batteriegeräte schlafen zwischen zwei Meldungen: sie werden über die Cloud bedient, nicht über das LAN.
  • Wasserfilter / Umkehrosmoseanlagen (Kategorie js, z. B. The Box): TDS am Ein- und Ausgang (ppm), Restlebensdauer jeder Filterstufe (PP, CTO, RO) in Prozent und in Tagen, Betriebszustand. Das Zurücksetzen nach einem Filterwechsel bleibt in der Tuya-App (ein Fehlklick würde den tatsächlichen Verschleiß des Filters löschen).
  • Wasserventile / Bewässerungssteuerungen (Kategorie sfkzq, z. B. R2601): Öffnen/Schließen, Ventilzustand (Wasser fließt oder nicht), momentaner Wasserdurchfluss, Batterie, Kindersicherung, Bewässerungsmodus (Auto/Manuell), Dauer der manuellen Bewässerung. Batteriegeräte: über die Cloud bedient. Die Bewässerungsprogramme bleiben in der Tuya-App.
  • Drehstromzähler / Stromzangen (Kategorie zndb, z. B. Power Clamp): Leistung, Stromstärke, Spannung und verbrauchte Energie jeder Phase, Gesamtleistung, Gesamtstromstärke und Gesamtenergie, interne Temperatur der Zange. Cloud oder lokal.
  • Bewegungsmelder (Kategorie pir, z. B. Zigbee-„Luminance Motion sensor“ hinter einem Tuya-Gateway): Bewegung (in Szenen nutzbar), Helligkeit, Batterie, Empfindlichkeit und Haltezeit als Listen. Über die Cloud bedient (Zigbee-Geräte laufen über ihr Gateway). Das Zigbee-Gateway selbst hat nichts zu steuern: Es bleibt ohne Funktionen.
  • Saugroboter (Honiture Q6 Pro): Start/Stopp, Pause, zur Ladestation, Reinigungszustand, Batterie, Saugleistung, Wasserstand, Teppich-Boost, benutzerdefinierter (Raum-)Modus, Y-Wischen, Häufigkeit der Staubabsaugung, Restlebensdauer der Haupt-/Seitenbürste. Hinweis: bei diesem Produkt startet das Ausschalten von Pause bei vollständig gestopptem Roboter auch einen neuen Reinigungszyklus — es ist kein reiner Pause-Schalter.
  • Schalter, Lampen und Rollläden über die generischen Zuordnungen.

Kameras und Türklingeln liefern ihre Schnappschüsse, keinen Live-Videostream: Tuya stellt keinen stabilen lokalen RTSP/ONVIF-Endpunkt bereit.

Das Klingeln der Türklingel sowie Lüfterstufe / Schwenken des Klimageräts erfordern Gladys 4.84.2 oder neuer. Saugleistung / Wasserstand / Häufigkeit der Staubabsaugung des Saugroboters erfordern Gladys 4.86.1 oder neuer. Auf einem älteren Gladys funktioniert die Integration weiter, ohne diese Funktionen.

Neuinstallationen aus dem Store erfordern Gladys 4.86.1 oder neuer; eine bereits installierte Integration wird auf jeder Gladys-Version weiter aktualisiert.

Jedes Gerät zeigt ein Abzeichen Lokal oder Cloud, damit Sie immer wissen, wie es kommuniziert.

1. Ein Tuya-IoT-Cloud-Projekt erstellen​

Die Integration benötigt ein (kostenloses) Tuya-IoT-Cloud-Projekt, um Ihre Geräte zu erreichen.

  1. Öffnen Sie die Tuya IoT Platform und melden Sie sich an (legen Sie bei Bedarf ein Konto an).
  2. Öffnen Sie Cloud → Development und klicken Sie auf Create Cloud Project.
    • Geben Sie einen beliebigen Namen ein.
    • Industry / Development method: Standardwerte beibehalten (Smart Home).
    • Data Center: wählen Sie die Region, die Ihnen am nächsten liegt (z. B. Central Europe für Deutschland). Merken Sie sich diese Wahl — Sie wählen dieselbe Region in Gladys.
  3. Öffnen Sie das erstellte Projekt. Notieren Sie im Reiter Overview die Access ID / Client ID und das Access Secret / Client Secret.
  4. Öffnen Sie den Reiter Service API und prüfen Sie, dass IoT Core autorisiert ist (abonnieren Sie es sonst — es ist kostenlos). Kameras: autorisieren Sie auch IoT Video Live Stream (Live-Bilder).

⚠️ Die Testphase von IoT Core läuft ab. Tuya stellt diesen Dienst als kostenlose Testphase bereit (ein Monat, danach kostenlos um jeweils sechs Monate verlängerbar). Ist sie abgelaufen, lehnt Tuya jeden API-Aufruf Ihres Projekts ab und alle Ihre Geräte sind in Gladys offline, mit der Meldung "IoT Core service subscription has expired".

Zum Verlängern: Cloud → Development → Ihr Projekt → Service API (oder Cloud → Cloud Services → IoT Core), dann Extend Trial Period. Das ist kostenlos und sofort wirksam. Stellen Sie sich eine Erinnerung — die Verlängerung ist alle sechs Monate nötig.

2. Ihr Smart Life / Tuya App-Konto verknüpfen​

Ihre Geräte müssen zu einem Tuya-App-Konto gehören, das das Projekt sehen kann.

  1. Öffnen Sie im Projekt Devices → Link Tuya App Account → Add App Account.
  2. Scannen Sie den QR-Code mit Ihrer Smart Life- oder Tuya Smart-App (Ich → Scan-Symbol oben rechts).
  3. Öffnen Sie auf der Plattform wieder Devices → Link Tuya App Account: Ihre Geräte erscheinen jetzt.
  4. Notieren Sie Ihre App account UID (neben dem verknüpften Konto angezeigt).

3. Die Konfiguration in Gladys ausfüllen​

Füllen Sie im Konfigurationsbildschirm der Integration aus:

FeldWo Sie es finden
EndpointDie in Schritt 1 gewählte Data-Center-Region
Client IDProjekt-Overview → Access ID / Client ID
Client SecretProjekt-Overview → Access Secret / Client Secret
App-Konto-UIDDevices → Link Tuya App Account → UID des verknüpften Kontos

Speichern Sie. Der Status Verbindung unten auf dem Bildschirm sollte auf Verbunden wechseln. Bei einem Fehler sagt die Meldung, was zu korrigieren ist (falsche Zugangsdaten, falsche Region…).

4. Ihre Geräte entdecken​

Öffnen Sie den Reiter Entdecken, lassen Sie Gladys Ihre Tuya-Geräte auflisten und erstellen Sie die gewünschten. Jedes Gerät erscheint mit seinen Funktionen und einem Lokal/Cloud-Abzeichen.

Lokaler Modus (LAN)​

Die lokale Steuerung ist schneller und funktioniert auch ohne Internet. Sie wird über den Schalter „Lokale (LAN) Verbindung bevorzugen, wenn verfügbar“ aktiviert (standardmäßig an).

  • Wenn er an ist, versucht Gladys jedes Gerät in Ihrem Netzwerk zu erreichen; gelingt das, zeigt das Gerät ein Abzeichen Lokal und sein Zustand aktualisiert sich sofort. Andernfalls weicht das Gerät automatisch auf die Cloud aus.
  • Die lokale Steuerung erfordert, dass Gladys IP-Adresse und Protokoll jedes Geräts kennt. Die meisten Geräte werden beim Entdecken automatisch vom Netzwerkscan gefunden.
  • Ein Gerät, das lokal laufen könnte (IP bekannt und Präferenz aktiv), aber gerade über die Cloud läuft, behält ein Abzeichen Cloud mit einem orangen Punkt — fahren Sie mit der Maus darüber, um den Grund zu sehen (Gerät nach Fehlern geparkt, LAN-Daten unvollständig…). Ein reines Cloud-Gerät bleibt ein einfaches blaues Cloud-Abzeichen.
  • Ein lokales Gerät wird alle 10 s über das LAN gelesen; was es nur über die Cloud meldet (Funktionen ohne lokale Zuordnung, oder alles, solange das LAN ausfällt), wird höchstens alle 30 s aktualisiert, um das Kontingent der Tuya-Cloud zu schonen.

Zigbee-Geräte hinter einem Tuya-Gateway laufen lokal über ihr Gateway: Die Integration öffnet eine einzige LAN-Sitzung zum Gateway (seine IP, sein Protokoll und sein lokaler Schlüssel) und spricht darin jedes Zigbee-Gerät an, sodass ihre Meldungen (Bewegung, Temperatur …) sofort ankommen. Das Gateway wird vom LAN-Scan gefunden; andernfalls führen Sie Lokales Protokoll erkennen für das Gateway (oder eines seiner Geräte) mit der IP des Gateways aus: Alle seine Geräte werden auf einmal aktualisiert. Starten Sie danach eine Suche und klicken Sie bei den bereits erstellten Zigbee-Geräten auf Aktualisieren.

Ein Gerät bleibt in der Cloud, obwohl es in Ihrem LAN ist​

Manche Geräte findet der automatische Scan nicht (anderes Subnetz, während des Scans im Ruhezustand…). Solange ein angelegtes, lokal steuerbares Gerät keine IP hat, wiederholt die Integration alle 15 Minuten von selbst einen LAN-Scan und schaltet es auf lokal um, sobald es antwortet — ein Gerät, das nur im Ruhezustand war, braucht nichts weiter. Für ein Gerät in einem anderen Subnetz (für den Scan nie erreichbar) fügen Sie es von Hand hinzu:

  1. Öffnen Sie den Bildschirm Konfiguration → Aktion Lokales Protokoll erkennen (manuelle IP).
  2. Wählen Sie das Gerät in der Liste (oder, falls es noch nicht in Gladys angelegt ist, geben Sie seinen Namen oder seine Tuya-ID ein) und geben Sie seine IP-Adresse ein.
  3. Führen Sie sie aus. Bei Erfolg wechselt das Gerät im nächsten Zyklus auf lokal.

Tipp: Geben Sie Ihren Tuya-Geräten in Ihrem Router eine feste IP (DHCP-Reservierung), damit sie erreichbar bleiben.

Echtzeit-Cloud-Ereignisse (Pulsar) — optional​

Für Geräte, die über die Cloud genutzt werden, kann Gladys deren Zustandsänderungen sofort (in ~1–2 s) empfangen, statt auf die nächste Abfrage zu warten. Dafür wird der Tuya Message Service (auch Pulsar genannt) verwendet. Lokal gesteuerte Geräte erhalten bereits eine sofortige Rückmeldung und brauchen dies nicht.

Zwei Schritte zur Aktivierung:

  1. Auf der Tuya IoT Platform: öffnen Sie Ihr Projekt → Service API → abonnieren Sie Message Service (kostenlos). Ohne dieses Abonnement wird die Verbindung abgelehnt und Gladys protokolliert eine eindeutige Meldung.
  2. In Gladys: aktivieren Sie in der Konfiguration den Schalter „Echtzeit-Cloud-Ereignisse (Pulsar)“ und speichern Sie.

Ein Gerät meldet über Pulsar nur, was es tatsächlich an die Tuya-Cloud sendet: manche ihren vollständigen Zustand, manche nur einen Teil (z. B. Ein/Aus), manche nichts — diese behalten einfach die normale Cloud-Aktualisierung. Das ist ein Verhalten des Geräts/der Firmware, keine Einschränkung von Gladys.

Ein nicht unterstütztes Gerät melden​

Ein Gerät, das ohne Funktion (oder mit nur einer) erstellt wird, meldet Tuya-Codes, die die Integration noch nicht kennt — häufig bei Varianten desselben Modells.

Führen Sie in der Konfiguration der Integration die Aktion Gerätediagnose aus, wählen Sie das Gerät in der Liste (oder geben Sie seinen Namen oder seine Tuya-ID ein, falls es nicht in Gladys angelegt ist) und kopieren Sie das Ergebnis in ein GitHub-Issue. Der Bericht listet jeden Code, den das Gerät meldet, seinen Wert und was die Integration damit macht. Er enthält weder lokalen Schlüssel noch IP-Adresse noch Tuya-Geräte-ID: er kann so wie er ist öffentlich eingefügt werden.

Namen der Funktionen (Sprache) — optional​

Die automatisch erzeugten Funktionsnamen dieser Integration (z. B. „Dock“, „Suction power“) und Optionsbezeichnungen sind standardmäßig Englisch, gemäß der Konvention aller unterstützten Gerätetypen — ein tatsächlich vom Gerät selbst gelesener Name (selten) bleibt unabhängig von dieser Einstellung unverändert. Mit der Konfigurationsoption „Namen der Funktionen“ können Sie neu entdeckte Geräte stattdessen auf Französisch, Deutsch oder Spanisch umstellen, übersetzt über ein kleines eingebautes Wörterbuch.

Funktionsnamen ändern sich nur bei neu entdeckten Geräten. Das Ändern dieser Option benennt bereits in Gladys erstellte Funktionen nicht um — benennen Sie sie dort bei Bedarf von Hand um, oder löschen Sie das Gerät und fügen Sie es über den Reiter Entdecken neu hinzu, um die neue Sprache zu übernehmen. Optionsbezeichnungen sind die Ausnahme: bei einem bestehenden Gerät folgen die Bezeichnungen der Listen (z. B. die Saugleistung des Saugroboters) bei der nächsten Erkennung der neuen Sprache, da Gladys dann die Optionen jedes Geräts neu synchronisiert. Ein Name/eine Bezeichnung, für die die Integration noch keine Übersetzung hat, bleibt in jedem Fall Englisch, nie geraten.

Dashboard-Widgets​

Ab Gladys 5.1: In einem Dashboard bietet die Tuya-Integration unter Bearbeiten → Box hinzufügen → Integrations-Widgets fünf Widgets an (das Gerät wird in den Widget-Einstellungen gewählt):

  • Tuya-Kamera: das Live-Bild einer Kamera (jede Minute aktualisiert, solange das Dashboard offen ist), Privatmodus, Bewegungserkennung und Aufnahme, die vier PTZ-Pfeile bei einer schwenkbaren Kamera (das Bild wird nach der Bewegung aktualisiert) oder eine Privatmodus- und eine Aktualisieren-Taste bei einer festen Kamera.
  • Tuya-Stromzähler: für einen Drehstromzähler, einen Zähler oder eine Steckdose mit Leistungsmessung — eine Leistungsanzeige (ihr Maximum ist eine Widget-Einstellung), die Leistung jeder Phase in Echtzeit, Strom, Energie, die Leistungskurve der letzten 24 Stunden, Spannung und Strom jeder Phase.
  • Tuya-Geräte: wie viele Geräte online, lokal oder über die Cloud laufen, die auffälligen (offline, lokal nicht erreichbar), die Cloud-Verbindung, der lokale Modus und die Echtzeit-Ereignisse sowie eine Suchtaste.
  • Tuya-Saugroboter: Zustand, Batterie, Bürstenverschleiß, Saugleistung und Wassermenge, Start-/Pause-/Station-Tasten.
  • Tuya-Wasserfilter: die Restlebensdauer jeder Filterstufe, TDS am Ein- und Ausgang, die Resttage (orange unter 15 Tagen).

Nützliche Aktionen​

  • Lokales Protokoll erkennen (manuelle IP): aktiviert den lokalen Modus für ein Gerät, das der Scan nicht gefunden hat (siehe oben).
  • Gerätediagnose: erstellt den Bericht über das, was ein Gerät bereitstellt (siehe oben).
  • Von der Tuya-Cloud trennen: beendet die Kommunikation mit der Cloud, bis Sie die Konfiguration erneut speichern.

Fehlerbehebung​

  • Die Verbindung zeigt einen Fehler → prüfen Sie die vier Zugangsdaten und dass der Endpoint dem Data Center Ihres Projekts entspricht.
  • Ein Gerät hat keinen Zustand / keine Steuerung → prüfen Sie sein Abzeichen. In der Cloud ohne Rückmeldung ist das Gerät in der Tuya-App möglicherweise offline.
  • Die Echtzeit-Cloud-Ereignisse starten nicht → prüfen Sie, dass Message Service in Ihrem Tuya-Projekt abonniert ist (ein 401 in den Logs bedeutet, dass es das nicht ist).
  • Logs finden Sie im Reiter Protokolle der Integration.

Konfigurationseinstellungen​

Diese Einstellungen fragt Tuya in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Erste SchrittesectionNeinDiese Integration kommuniziert über ein Tuya-IoT-Cloud-Projekt mit Ihren Geräten. Erstellen Sie (kostenlos) eines auf der Tuya IoT Platform, abonnieren Sie den Dienst "IoT Core", verknüpfen Sie Ihr Smart Life / Tuya App-Konto und übertragen Sie dann die vier Werte unten. Die vollständige Schritt-für-Schritt-Anleitung finden Sie über den Dokumentationslink oben.
EndpointselectJaRegion des Tuya-Rechenzentrums Ihres Cloud-Projekts.
Client IDstringJaAccess ID / Client ID Ihres Tuya-IoT-Cloud-Projekts.
Client SecretsecretJaAccess Secret / Client Secret Ihres Tuya-IoT-Cloud-Projekts.
App-Konto-UIDstringJaUID des mit Ihrem Cloud-Projekt verknüpften Smart Life / Tuya App-Kontos.
Echtzeit-Cloud-Ereignisse (optional)sectionNeinFür Geräte, die über die Cloud genutzt werden, kann Gladys deren Zustandsänderungen sofort empfangen, statt auf die nächste Abfrage zu warten. Dazu muss der "Message Service" in Ihrem Tuya-IoT-Projekt abonniert und dann der Schalter unten aktiviert sein. Lokal gesteuerte Geräte erhalten bereits eine sofortige Rückmeldung und brauchen dies nicht.
Echtzeit-Cloud-Ereignisse (Pulsar)booleanNeinSofortige Cloud-Zustandsrückmeldung über den Tuya Message Service. Erfordert einen aktivierten 'Message Service' in Ihrem Tuya-IoT-Projekt.
Namen der FunktionenselectNeinGilt für die Namen neu erkannter Geräte. Die Funktionsnamen dieser Integration werden standardmäßig auf Englisch erzeugt (Konvention des Repos) — übersetzen Sie die, die die Integration kennt, ins Französische, Deutsche oder Spanische, oder behalten Sie Englisch. Bei einem bereits angelegten Gerät folgen die Optionsbezeichnungen der neuen Sprache bei der nächsten Erkennung, die Namen jedoch nicht. Eine Funktion, die nicht im Wörterbuch steht, behält in jedem Fall ihren englischen Namen; Sie können jede Funktion danach jederzeit in Gladys umbenennen.

So installierst du Tuya in Gladys​

  1. Öffne in Gladys Integrationen: Tuya erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/terdious/gladys-tuya:1.31.2) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/Terdious/gladys-tuya.

Tuya benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Passende Ratgeber​

Über externe Integrationen​

Tuya ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von Terdious veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂
Zuletzt aktualisiert am