Zum Hauptinhalt springen

TCL Home Smart-Home-Integration, kostenlos und Open Source

TCL Home-Integration für Gladys Assistant

Steuere deine TCL-Klimageräte, Entfeuchter und Luftreiniger über die TCL-Home-Cloud.

Diese Integration verbindet Gladys mit deinem TCL-Home-Konto und steuert die dort hinzugefügten TCL-Geräte: Klimageräte, Luftentfeuchter und Breeva-Luftreiniger.

Bevor du beginnst​

  • Gladys 5.3 oder neuer ist erforderlich.
  • Deine Geräte müssen zuerst in der mobilen TCL-Home-App funktionieren: Füge sie dort hinzu, Gladys koppelt sie nicht.
  • Dies ist eine Cloud-Integration: Gladys geht über die TCL-Home-Cloud, wie die App. Gladys braucht Internet, und nichts funktioniert, solange die TCL-Cloud ausgefallen ist. TCL-Geräte bieten keine lokale Steuerung.

TCL veröffentlicht keine offizielle API: Diese Integration macht, was die TCL-Home-App macht. TCL kann das jederzeit ändern. Sie ist nicht mit TCL verbunden.

Konfiguration​

Öffne in Gladys Integrationen → TCL Home → Konfiguration:

FeldWas eintragen
TCL-Home-E-MailDie E-Mail-Adresse, mit der du dich in der TCL-Home-App anmeldest
TCL-Home-PasswortDas Passwort dieses Kontos
Aktualisierungsintervall (s)Wie oft jedes Gerät gelesen wird, in Sekunden (60 bis 3600, standardmäßig 60)

Speichere und drücke dann Verbindung testen: Es listet die gefundenen Geräte auf, wie viele online sind, und die TCL-Geräte, die diese Integration nicht steuert (zum Beispiel einen Fernseher).

Öffne dann den Reiter Entdecken der Integration und füge deine Geräte hinzu.

Tipp: Lege ein zweites TCL-Home-Konto an, teile dein Zuhause in der App mit ihm und gib dieses Konto an Gladys. So bleibt dein eigenes Passwort bei dir.

Geräte und Funktionen​

Eine Funktion erscheint nur, wenn dein Gerät sie meldet: Ein Modell ohne horizontale Lamellenbewegung bekommt keine Steuerung dafür.

Klimageräte​

Split-, Fenster-, mobile, Kanal-, Säulen- und Frischluftgeräte.

FunktionIn Gladys
Ein/AusEin / aus
ModusAutomatik, Kühlen, Entfeuchten, Lüften, Heizen (je nach Gerät)
Solltemperatur16 bis 31 °C, in ganzen Grad
LüfterstufeAutomatik, leise, niedrig, mittel-niedrig, mittel, mittel-hoch, hoch, Turbo
Vertikale / horizontale LamellenAus, schwenken oder eine von 5 festen Positionen
InnentemperaturVom Gerät gemessen
Temperatur des AußengerätsWenn das Gerät sie meldet
Eco, Schlaf, Gesundheit, Schimmelschutz-Trocknung, Anzeige, SignaltonEin-/Aus-Schalter

Bei einem mobilen Gerät gibt es den Automatikmodus und die Lüfterstufe nur bei Modellen mit Schwenklamelle.

Luftentfeuchter​

Ein/Aus und Raumfeuchtigkeit.

Breeva-Luftreiniger​

Ein/Aus, PM2.5, Anzeige und Kindersicherung.

Aktualisierung​

Gladys liest jedes Gerät im gewählten Intervall. Nach einem Befehl liest die Integration das Gerät wenige Sekunden später erneut, damit Gladys zeigt, was es wirklich getan hat.

Ein Gerät, das offline ist, zeigt ein Abzeichen nicht erreichbar; online ein Abzeichen Cloud.

Szenen​

Auslöser​

AuslöserWannVariable
TCL-Gerät online / offlineEin Gerät verliert oder findet seine Verbindungstatus: online oder offline
Fehler eines TCL-GerätsEin Gerät meldet einen neuen Fehlercodecode: der/die Code(s), durch Komma getrennt

Beide lassen sich auf ein Gerät beschränken. Sie lösen bei einer Änderung aus: Ein Gerät, das beim Start von Gladys schon offline ist, oder ein schon vorhandener Fehler löst sie nicht aus.

Aktionen​

AktionWas sie tutAusgabe
TCL-Klimagerät einstellenSchaltet das Gerät ein, mit gewähltem Modus, Temperatur und Lüfterstufe (leer: unverändert)applied (wahr/falsch)
Alle TCL-Geräte ausschaltenSchaltet alle eingeschalteten TCL-Geräte auscount
TCL-Selbstreinigung startenStartet den Selbstreinigungszyklus des Geräts (es schaltet ab), wenn das Modell einen hatstarted (wahr/falsch)

Ein Gerät, das offline ist, hält die Szene nicht an: Die Ausgabe ist false, nutze sie bei Bedarf in einer Bedingung.

Beispiel: „Wenn ich das Haus verlasse, alle TCL-Geräte ausschalten“ oder „Im Sommer um 18 Uhr das Wohnzimmergerät auf Kühlen mit 24 °C stellen“.

Dashboard-Widget​

Füge das Widget TCL Home zu einem Dashboard hinzu. Es zeigt:

  • den Zustand des TCL-Home-Kontos und dann jedes Gerät: aus, offline oder Modus und Solltemperatur;
  • die Live-Innentemperatur der ersten Klimageräte;
  • die Schaltflächen Klimagerät einstellen (Gerät, Modus, Temperatur, Lüfter), Alles ausschalten und Aktualisieren.

Fehlerbehebung​

Meldung oder SymptomWas tun
„TCL Home lehnt die E-Mail-Adresse oder das Passwort ab“Prüfe sie, indem du dich in der TCL-Home-App anmeldest. Ein mit Google oder Apple angelegtes Konto hat kein Passwort: Lege in der App eines fest oder nutze ein zweites Konto.
„TCL Home ist nicht erreichbar“Prüfe den Internetzugang von Gladys. Die Integration versucht es alle 5 Minuten selbst erneut.
Ein Gerät fehltIst es in der TCL-Home-App, im selben Konto? „Verbindung testen“ listet die nicht unterstützten auf.
Ein Befehl scheitert mit „is offline“Das Gerät ist nicht mit der TCL-Cloud verbunden: Prüfe sein WLAN in der TCL-Home-App.
Der Zustand ändert sich verspätetDie Cloud wird im Aktualisierungsintervall gelesen: Verringere es (mindestens 60 s).

Setze die Protokollstufe auf debug (Umgebungsvariable LOG_LEVEL), um jeden Aufruf zu sehen. Passwörter und Tokens werden nie in die Protokolle geschrieben.

Datenschutz​

  • Das Passwort wird von Gladys in einem geheimen Feld gespeichert und nur an TCL gesendet, als MD5-Hash, wie es die App tut.
  • Die TCL-Tokens und die temporären AWS-Zugangsdaten bleiben im Speicher, nichts wird auf die Festplatte geschrieben.
  • Die Integration spricht nur mit TCL (*.tcl.com, *.tcljd.com) und Amazon Web Services (*.amazonaws.com), über HTTPS.

Konfigurationseinstellungen​

Diese Einstellungen fragt TCL Home in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Erste SchrittesectionNeinDiese Integration nutzt die TCL-Home-Cloud, wie die mobile App: Deine Geräte müssen zuerst in der TCL-Home-App hinzugefügt werden. Gib unten die E-Mail-Adresse und das Passwort dieses Kontos ein. Gladys liest die Geräte dann jede Minute (oder im gewählten Intervall) und sendet deine Befehle über die Cloud: Eine Internetverbindung ist erforderlich.
TCL-Home-E-MailstringJaDie E-Mail-Adresse, mit der du dich in der TCL-Home-App anmeldest.
TCL-Home-PasswortsecretJaDas Passwort dieses Kontos. Es wird nur an TCL gesendet und nie protokolliert.
Aktualisierungsintervall (s)numberNeinWie oft jedes Gerät aus der Cloud gelesen wird, in Sekunden (60 bis 3600).

So installierst du TCL Home in Gladys​

  1. Öffne in Gladys Integrationen: TCL Home erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/prohand/gladys-tclhome:0.0.1) 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/prohand/gladys-tclhome.

TCL Home benötigt Gladys >=5.3.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.

Über externe Integrationen​

TCL Home 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 prohand 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 🙂