Tineco Smart-Home-Integration, kostenlos und Open Source

Tineco-Nasssauger (Floor One, iFloor…): Status, Tanks, Akku und Szenen.

• Veröffentlicht von gboulvin
• Geräte
• Version 1.0.3
• Erfordert Gladys >=5.1.0
• ★ 0

Auf GitHub ansehenAlle Integrationen

Verbindet die Nasssauger Ihres Tineco-Kontos (Floor One S3, S5, S7, S7 Flashdry, S7 Stretch, iFloor… — alle Modelle, die die Tineco-App anzeigt) mit Gladys: Akku, Aktivität, Wassertanks, Sprachansagen und Bürstenbeleuchtung, dazu Szenen-Auslöser, Szenen-Aktionen und Dashboard-Widgets.

Die Integration läuft wie die App über die Tineco-Cloud: Das Gerät muss in der Tineco-App eingerichtet und mit dem WLAN verbunden sein.

Einrichtung

1. Installieren Sie in Gladys die Integration Tineco und öffnen Sie den Tab Konfiguration.
2. Geben Sie E-Mail und Passwort Ihres Tineco-Kontos sowie das bei der Kontoerstellung gewählte Land ein. Speichern.
3. Bei der ersten Verbindung behandelt Tineco Gladys wie ein neues Telefon und sendet Ihnen einen Bestätigungscode per E-Mail. Geben Sie ihn unter Bestätigungscode ein und speichern Sie erneut. Das passiert nur einmal. Keine E-Mail? Nutzen Sie Neuen Bestätigungscode senden (automatisch wird höchstens eine E-Mail pro Viertelstunde gesendet).
4. Verbindung testen listet die gefundenen Geräte auf.
5. Öffnen Sie den Tab Erkennung und legen Sie Ihre Geräte an.

Einstellung	Zweck
Land des Kontos	Wählt die Tineco-Server Ihres Kontos.
Sprache der Gerätenamen	Sprache der Geräte- und Funktionsnamen beim Anlegen.
Aktualisierungsintervall	Sekunden zwischen zwei Abfragen jedes Geräts (mindestens 30).

Funktionen

Funktion	Werte
Zustand	Standard-Saugerzustand: gestoppt, läuft, lädt, in der Station
Aktivität	Reinigung, Selbstreinigung, Trocknung, lädt, Aktualisierung, Bereitschaft, offline
Akku	0–100 %
Lädt	Ja / nein
Frischwassertank	Normal / niedrig (leer)
Schmutzwassertank	Normal / hoch (voll)
Sprachlautstärke	1 (leise) bis 3 (laut), steuerbar
Sprachansagen	An / aus, steuerbar
Bürstenbeleuchtung	An / aus, steuerbar — nur bei Modellen mit Beleuchtung

Antwortet ein Gerät nicht (ausgeschaltet, außerhalb der WLAN-Reichweite — ein Handgerät verbindet sich nur während der Nutzung), wechselt sein Abzeichen auf nicht erreichbar, seine Aktivität auf offline, und die letzten Werte bleiben erhalten.

Szenen

Auslöser

• Reinigung gestartet — Variable: Akku.
• Reinigung beendet — Variablen: Dauer (Minuten), Akku.
• Selbstreinigung beendet — der Moment, den Schmutzwassertank zu leeren.
• Wassertank-Warnung — Schmutzwassertank voll oder Frischwassertank leer; Filter auf die Warnung, Variable: Warnung.

Jeder Auslöser lässt sich auf ein Gerät filtern.

Aktionen

• Tineco-Gerät auslesen — liest es sofort aus; Ausgaben: online, Aktivität, Akku, Schmutzwassertank voll, Frischwassertank leer (für die Bedingungen der folgenden Aktionen).
• Sprachlautstärke einstellen, Sprachansagen ein- oder ausschalten, Bürstenbeleuchtung ein- oder ausschalten — Ausgabe: Befehl angenommen.

Ein Gerät, das offline ist, lässt nie eine Szene scheitern: Die Ausgaben zeigen es an.

Dashboard-Widgets

• Tineco-Gerät — Akkuanzeige, Aktivität, Wassertanks, Akkuverlauf über 24 Std. und eine Schaltfläche Aktualisieren. Wählen Sie das Gerät in den Widget-Einstellungen (sonst das erste).
• Tineco-Übersicht — eine Zeile pro Gerät, orange, wenn ein Tank Aufmerksamkeit braucht.

Einschränkungen

• Tineco veröffentlicht keine API: Die Integration nutzt das Protokoll der App, das Tineco ändern kann. Nicht jedes Modell meldet jeden Wert; die Bürstenbeleuchtung erscheint nur bei Modellen, die sie melden.
• Eine Reinigung aus der Ferne zu starten ist nicht möglich: Ein Nasssauger wird von Hand geschoben.
• Konten aus Festlandchina (SMS-Anmeldung) werden nicht unterstützt.

Fehlerbehebung

• „Tineco hat die Anmeldung abgelehnt“: Prüfen Sie E-Mail, Passwort und vor allem das Land des Kontos.
• „Tineco hat den Bestätigungscode abgelehnt“: Codes laufen ab; nutzen Sie Neuen Bestätigungscode senden und geben Sie den neuen ein.
• „Tineco listet kein Gerät“: Die Liste kommt von den Tineco-Servern des gewählten Landes. Wählen Sie das Land, das die Tineco-App anzeigt (Profil > Einstellungen), speichern Sie und testen Sie erneut. Immer noch leer? Teilen Sie die Zeile „Answer shape“ der Logs (sie enthält keine persönlichen Daten) in einem Issue.
• Integrationsprotokolle: Gladys → Integrationen → Tineco → Logs. Passwörter und Token werden nie protokolliert.

Konfigurationseinstellungen

Diese Einstellungen fragt Tineco in seinem Konfigurationsbildschirm in Gladys ab.

Einstellung	Typ	Pflichtfeld	Beschreibung
Ihr Tineco-Konto	section	Nein	Verwenden Sie E-Mail und Passwort der Tineco-App und das bei der Kontoerstellung gewählte Land. Bei der ersten Verbindung sendet Tineco einen Bestätigungscode per E-Mail: Geben Sie ihn unten ein und speichern Sie.
E-Mail	string	Ja
Passwort	secret	Ja
Land des Kontos	select	Ja
Bestätigungscode	string	Nein	Nur bei der ersten Verbindung: der Code, den Tineco per E-Mail gesendet hat.
Sprache der Gerätenamen	select	Nein
Aktualisierungsintervall (s)	number	Nein	Wie oft die Geräte gelesen werden, in Sekunden (mindestens 30).

So installierst du Tineco in Gladys

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

Tineco 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.

Über externe Integrationen

Tineco 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 gboulvin veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

• Alle Integrationen durchsuchen, native und aus der Community
• Deine eigene externe Integration bauen und veröffentlichen
• Quellcode auf GitHub — Quelle dieser Dokumentation

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 🙂