Externe Integration zum Steuern der TINECO-Wasch-Saugroboter wie dem S7 Strech
Die Integration existiert auf HA - GitHub - wheeller123/Tineco-Integration: Home Assistant custom integration for Tineco vacuum cleaners · GitHub
Datenstruktur (Decodierte Payload)
Der Rückgabestatus des Saugroboters enthält ein JSON-Objekt mit abgekürzten Schlüsseln:
wm (Arbeitsmodus) :
1 = Standby2 = Ladevorgang3 = In Betrieb8 = Selbstreinigung der Bürste9 = OTA-Aktualisierung13 = Heißlufttrocknung
e2 / e3 (Wasserbehälter-Warnbitmasken) :
- Schmutzwasserbehälter voll: Überprüft durch
e2 & 256 (oder e3 & 4096).
- Frischwasserbehälter leer: Überprüft durch
e2 & 64 (oder e3 & 8192).
battery : Verbleibender Batteriestand in Prozent.vs : Online-Status.ms / vl : Leiser Modus (ms: 0 oder 1) und Lautstärke (vl: 1 leise, 2 mittel, 3 laut).- Zusätzliche Steuerungen : Saugkraft (120W, 150W), Sprühdurchfluss, Bürstenbeleuchtung.
Ihr seid Maschinen, Jungs… 
Jetzt muss man jeden Abend eine Stunde einplanen, um die Liste der Integrationen durchzugehen und die Neuigkeiten zu sehen
Voilà, sie ist bereit. In einer Stunde im Store oder, wenn du es eilig hast, manuell: Build and publish image · gboulvin/Gladys-Tineco@ad8eee7 · GitHub
Und die passende Nachricht:
Die Integration verbindet Gladys mit den Geräten deines Tineco-Kontos (Floor One S3, S5, S7, S7 Flashdry, S7 Stretch, iFloor… alles, was die Tineco-App anzeigt), über die Tineco-Cloud, wie die offizielle App.
Was sie anzeigt
- Status (Standard-Gladys-Staubsauger) und detaillierte Aktivität: Reinigung, Selbstreinigung, Trocknung, Aufladen, Update, Standby, Offline
- Batterie und Ladevorgang
- Reinwasserbehälter (leer) und Schmutzwasserbehälter (voll)
- Lautstärke, Sprachnachrichten und Bürstenbeleuchtung (bei entsprechenden Modellen), steuerbar über Gladys
- Cloud / nicht erreichbar Badge, wenn das Gerät ausgeschaltet oder nicht mit Wi-Fi verbunden ist
Szenarien
- Auslöser: Reinigung gestartet, Reinigung beendet (mit Dauer), Selbstreinigung beendet (der ideale Zeitpunkt, um benachrichtigt zu werden, den Schmutzwasserbehälter zu leeren
), Behälteralarm
- Aktionen: Gerät lesen (Ausgaben nutzbar als Bedingung: Batterie, Aktivität, Behälter…), Lautstärke einstellen, Sprachnachrichten deaktivieren, Bürstenlicht an/aus
Dashboard-Widgets
- Tineco-Gerät: Batterieanzeige, Aktivität, Behälter, 24-Stunden-Batterieverlauf und „Aktualisieren“-Button
- Tineco-Übersicht: Eine Zeile pro Gerät, orange, wenn ein Behälter Aufmerksamkeit erfordert
Installation
- Installiere die Tineco-Integration aus dem Integrationskatalog.
- Gib die E-Mail, das Passwort und das Land deines Tineco-Kontos ein.
- Bei der ersten Anmeldung sendet Tineco einen Code per E-Mail: Gib ihn in „Bestätigungscode“ ein und speichere (einmalig).
- Erstelle deine Geräte über den Entdeckungs-Tab.
Die Integration ist auf Französisch, Englisch, Deutsch und Spanisch verfügbar.
Wissenswertes
Tineco veröffentlicht keine API: Die Integration basiert auf dem Protokoll der App, dokumentiert von der Community (Danke an den Autor von Tineco-HACS-Integration und der Dekodierung des Payloads, die in diesem Forum geteilt wurde). Nicht alle Modelle zeigen alle Werte an: Dein Feedback (Modell + was funktioniert/nicht funktioniert) ist willkommen, um sie zu verbessern!
Gutes Putzen! 
Ich habe sie installiert und mit meinem Konto verknüpft und den Bestätigungscode eingegeben.
Wenn ich die Verbindung teste, erhalte ich eine Meldung, dass die Verbindung in Ordnung ist, aber dass kein Gerät mit diesem Konto verknüpft ist. In der TINECO-App auf meinem Telefon habe ich jedoch Zugriff auf meinen S7-Saugwischer.
Hättest du ein Log für mich? In der Integration → Protokolle
[2026-10-16T20:07:46.731Z] [INFO] Starte die Tineco-Integration...
[2026-10-16T20:07:46.962Z] [INFO] [gladys-sdk] verbunden mit Gladys (http://172.30.0.1:80)
[2026-10-16T20:07:47.015Z] [ERROR] [tineco] Tineco: Tineco-E-Mail oder Passwort fehlt
[2026-10-16T20:09:46.311Z] [INFO] [tineco-session] Tineco-Verifizierungscode per E-Mail gesendet
[2026-10-16T20:09:46.311Z] [INFO] [tineco] Warten auf den Tineco-Verifizierungscode
[2026-10-16T20:10:24.835Z] [INFO] [tineco-session] Tineco-App-Gerät verifiziert
[2026-10-16T20:10:25.988Z] [INFO] [tineco-session] Tineco-Sitzung geöffnet, 0 Gerät(e)
[2026-10-16T20:10:28.482Z] [INFO] [tineco-session] Tineco-Sitzung geöffnet, 0 Gerät(e)
[2026-10-16T20:11:05.105Z] [INFO] [tineco-session] Tineco-Sitzung geöffnet, 0 Gerät(e)
[2026-10-16T20:11:24.663Z] [INFO] [tineco-session] Tineco-Sitzung geöffnet, 0 Gerät(e)
[2026-10-16T20:13:14.770Z] [INFO] [tineco-session] Tineco-Sitzung geöffnet, 0 Gerät(e)
Danke für das Feedback und das Log! Die Verbindung funktioniert: Es ist die Liste der Geräte, die von Tineco zurückgegeben wird, die leer ist. Könntest du bitte:
- die Integration auf v1.0.2 aktualisieren. Wenn du sie manuell installiert hast, musst du die vorherige löschen;
- überprüfen, ob das Land des Kontos das der Tineco-App ist (Profil > Einstellungen), dann speichern und auf Verbindung testen klicken;
- wenn immer noch keine Geräte angezeigt werden, mir die Zeile aus dem Log kopieren, die « Answer shape » enthält: Sie enthält keine persönlichen Daten und wird mir zeigen, wo Tineco eure Geräte speichert.
Ich habe in der App überprüft, dass mein Konto auf „Frankreich“ eingestellt ist.
[2026-10-16T20:29:39.539Z] [INFO] [tineco-session] Tineco-Sitzung geöffnet, 0 Gerät(e)
[2026-10-16T20:29:39.539Z] [WARN] [tineco-session] Kein Gerät in der Geräteliste der FR-Server. Überprüfen Sie das Land des Kontos. Antwortformat: { code: "0000", msg: "操作成功", time: number, data: [], success: boolean }
Gute Neuigkeiten!
Wir haben die Ursache gefunden: Die Integration hat die Liste der Geräte mit der falschen Benutzerkennung angefordert, und Tineco hat daher eine leere Liste zurückgegeben.
Das ist in der v1.0.3 behoben. Kannst du die Integration aktualisieren, auf Verbindung testen klicken und dann das Register Entdeckung öffnen? Dein S7 sollte angezeigt werden. Falls nicht, schicke mir bitte die neue Zeile „Answer shape“ aus dem Protokoll.
Entschuldige für die Hin- und Her-Kommunikation
Cool!
Achtung, wenn du sie « manuell » im Entwicklermodus installiert hast, wird in Zukunft kein Update für die Integration angeboten. Ich empfehle dir, den Store für Produktionszwecke zu nutzen
Ich würde sie sofort neu installieren, sobald sie auf der Integrationsseite erscheint.
