TP-Link Deco Smart-Home-Integration, kostenlos und Open Source
TP-Link Deco Mesh-WLAN: Anwesenheit, Status der Decos, Gast-WLAN und Neustarts.
Veröffentlicht von guim31
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.1.0
- ★ 0
Bringt dein TP-Link Deco Mesh-WLAN in Gladys: wer zu Hause ist (die Handys im WLAN), der Zustand jedes Deco im Netzwerk und zwei Befehle für deine Szenen: das Gast-WLAN und der Neustart eines Deco. Alles bleibt in deinem lokalen Netzwerk: Die Integration spricht direkt mit dem Haupt-Deco, nie mit der TP-Link-Cloud.
Keine Verbindung zu TP-Link. Ohne die Hardware entwickelt: Rückmeldungen willkommen — die Integration wird gegen ein simuliertes Deco getestet, das das echte verschlüsselte Protokoll spricht und aus veröffentlichten Antworten echter Decos gebaut ist, noch nicht gegen ein echtes.
Überblick
- Anwesenheit: Jedes Handy, jeder Laptop und jedes Gerät im Mesh-Netzwerk kann ein Anwesenheitssensor werden, mit einer Abwesenheitsverzögerung, damit ein Handy im Standby nicht alle paar Minuten „geht“.
- Ein Gerät pro Deco: online, Internet, verbundene Clients, Gast-Clients, Rolle (Haupt-Deco oder Satellit), Firmware-Version und bei einem Satelliten die Rate seiner Verbindung zum Mesh-Netzwerk.
- Szenen-Auslöser: Ein unbekanntes Gerät verbindet sich mit dem Netzwerk, ein Deco geht offline.
- Befehle (standardmäßig aus): das Gast-WLAN ein- oder ausschalten, ein Deco neu starten.
- Dashboard-Widget: Clients, Gäste, der Zustand jedes Deco und wer zu Hause ist.
Modelle: die Deco-Reihe, die die Deco-App verwaltet und die eine lokale Webseite hat (X20, X50, X55, X60, X68, M4, M5, M9 Plus, BE65, BE85…). Gladys 5.1 oder neuer.
Voraussetzungen
- Ein mit der Deco-App eingerichtetes Deco-Netzwerk und die IP-Adresse des Haupt-Deco — das,
das an deinem Internet-Router hängt. Die Deco-App zeigt sie: Netzwerk → das Haupt-Deco →
IP-Adresse (oft
192.168.68.1im Router-Modus). Im Access-Point-Modus ist es die Adresse, die dein Router ihm gegeben hat. - Das Passwort der TP-Link-ID, der das Netzwerk in der Deco-App gehört: Die lokale Web-API des Deco
nimmt nur das Besitzer-Konto an, mit dem Benutzernamen
admin, kein Manager-Konto. - Das Deco erlaubt nur eine Admin-Sitzung zur selben Zeit. Die Integration meldet sich für jedes Auslesen an und sofort wieder ab, aber während sie liest, beendet eine Anmeldung anderswo eine der beiden Sitzungen. TP-Link empfiehlt eine zweite TP-Link-ID, die du in der Deco-App als Manager hinzufügst, für deine eigene Nutzung der App.
Konfiguration
In Gladys Integrationen → Von GitHub installieren mit der Adresse dieses Repositorys, dann Integrationen → TP-Link Deco → Konfiguration:
| Feld | Was du einträgst |
|---|---|
| Adresse des Haupt-Deco | Seine IP-Adresse, z. B. 192.168.68.1. Füge https:// nur hinzu, wenn http nicht antwortet. |
| Passwort der Deco-App | Das Passwort der Besitzer-TP-Link-ID. Nie angezeigt, nie protokolliert. |
| Netzwerk-Clients in „Entdecken“ anbieten | Standardmäßig an: Die Clients, die online sind, erscheinen im Tab „Entdecken“. |
| Abwesenheitsverzögerung (Minuten) | Standardmäßig 5: wie lange ein Client weg sein muss, bevor er als abwesend gilt (0 bis 120). |
| Aktualisierungsintervall | Standardmäßig 1 Minute; 30 Sekunden, 2 oder 5 Minuten. Jedes Auslesen ist eine Anmeldung. |
| Steuerung des Gast-WLANs erlauben | Standardmäßig aus. Fügt dem Haupt-Deco den Schalter des Gast-WLANs hinzu. |
| Neustarts erlauben | Standardmäßig aus. Erlaubt die Aktion und die Szenen-Aktion „Ein Deco neu starten“. |
| Sprache der Funktionsnamen | Standardmäßig Französisch; Englisch, Deutsch oder Spanisch. Beim Hinzufügen festgelegt. |
Starte dann Verbindung testen (Konfigurationsseite): Der Test meldet sich an, zählt die Decos und die Clients und meldet sich ab. Das Deco zählt falsche Passwörter und sperrt die Anmeldung nach mehreren davon: Ein abgelehntes Passwort pausiert das Auslesen, bis du es korrigierst, damit die Integration dein Konto nie sperrt.
Wie oft das Deco ausgelesen wird: im gewählten Intervall, von der Integration selbst (Gladys 5.2 fragt externe Geräte nicht zuverlässig ab). Ein Auslesen ist eine Sitzung: die Schlüssel, die Anmeldung, die Liste der Decos, eine Client-Liste pro Deco, das Gastnetzwerk, wenn seine Steuerung erlaubt ist, und die Abmeldung — etwa zehn kleine Anfragen. Das Deco hat kein veröffentlichtes Kontingent; einmal pro Minute ist das Tempo der Home-Assistant-Integration (dort 30 Sekunden). Ein Dashboard zu öffnen liest das Deco nie aus.
Geräte
Geh zu Integrationen → TP-Link Deco → Entdecken und füge hinzu, was du verfolgen willst.
Ein Deco (ein Gerät pro Deco des Netzwerks):
| Funktion | Wert |
|---|---|
| Online | 1, wenn das Deco zum Mesh-Netzwerk gehört, 0, wenn es ausgefallen ist. |
| Internet | 1, wenn das Deco das Internet erreicht. |
| Verbundene Clients | Die Clients, die über dieses Deco verbunden sind (WLAN und Kabel). |
| Gast-Clients | Die davon im Gastnetzwerk. |
| Rolle | Haupt-Deco oder Satellit. |
| Firmware-Version | Wie das Deco sie meldet, z. B. 1.8.0 Build 25102213 Rel. 43970. |
| Verbindungsrate | Nur Satelliten: die Rate der Verbindung zum Mesh-Netzwerk, in Mbit/s (WLAN oder Ethernet). |
| Gast-WLAN | Nur Haupt-Deco, sobald „Steuerung des Gast-WLANs erlauben“ an ist: ein Schalter. |
Ein Netzwerk-Client (ein Handy, ein Computer…): eine Funktion Anwesenheit, 1, wenn der Client mit dem Netzwerk verbunden ist (oder vor weniger als der Abwesenheitsverzögerung ging), sonst 0. Ein zu Gladys hinzugefügter Client bleibt in der Liste „Entdecken“, wenn er abwesend ist.
Nachdem du „Steuerung des Gast-WLANs erlauben“ eingeschaltet hast, öffne den Tab „Entdecken“ und klicke beim Haupt-Deco auf Aktualisieren: Der Schalter wird ihm hinzugefügt.
Widget
Füge das Widget Deco-Netzwerk zu einem Dashboard hinzu. Es zeigt drei Kacheln (verbundene Clients, Gäste, Decos online), die Clients, die du zu Gladys hinzugefügt hast, mit Zu Hause oder Abwesend, und den Zustand jedes Deco: seine Anzahl an Clients, Kein Internet oder Offline. Es wird aus dem letzten Auslesen des Deco gebaut und kostet es nichts.
Szenen-Auslöser
| Auslöser | Wann | Variablen |
|---|---|---|
| Unbekanntes Gerät verbunden | Ein Gerät, das noch nie im Netzwerk war, tritt ihm bei. Filter: Verbindung, Gastnetzwerk. | Name, MAC-Adresse, IP-Adresse, Verbindung, WLAN-Band, verbunden mit |
| Deco offline | Ein Deco fällt aus dem Netzwerk: ausgesteckt, außer Reichweite, beim Neustart. Filter: Deco. | Name des Deco, Modell |
Das erste Auslesen lernt nur die Geräte, die schon da sind: Die Integration zu installieren oder neu zu
starten löst nichts aus. Die gesehenen Geräte werden in /data gespeichert (nur MAC-Adressen).
Befehle
Beide sind standardmäßig aus: Schalte zuerst ihre Option in der Konfiguration ein.
- Gast-WLAN: Der Schalter des Haupt-Deco schaltet das Gastnetzwerk auf jedem Band, das eines hat, ein oder aus. Das Gastnetzwerk muss existieren (leg es in der Deco-App an). Nutze ihn in einer Szene wie jeden Schalter.
- Ein Deco neu starten: eine Aktion der Konfigurationsseite und eine Szenen-Aktion, nie ein Schalter. Der Bereich dieses Deco verliert das WLAN für ein paar Minuten; ein Neustart des Haupt-Deco unterbricht das ganze Netzwerk, Gladys eingeschlossen, wenn es darüber läuft.
Szenen-Beispiele
- Willkommen: Wenn die „Anwesenheit“ eines Handys nach 18 Uhr auf 1 geht, schalte das Licht im Flur ein.
- Eindringling im Netzwerk: Bei „Unbekanntes Gerät verbunden“ mit Gastnetzwerk „Nein“ eine Nachricht mit Name und MAC-Adresse des Geräts senden.
- Gäste: Jeden Samstag um 14 Uhr das Gast-WLAN einschalten, um 23 Uhr aus.
- Wöchentlicher Neustart: Jeden Montag um 4 Uhr „Ein Deco neu starten“ für einen Satelliten, der gern langsamer wird.
Fehlerbehebung
- „Passwort abgelehnt“: Prüfe das Passwort der Besitzer-TP-Link-ID (kein Manager). Das Auslesen pausiert: Korrigiere das Passwort oder starte „Verbindung testen“.
- „Anmeldung abgelehnt“: Das Deco sperrt die Anmeldung nach falschen Passwörtern eine Weile. Warte ein paar Minuten.
- „Die Sitzung wurde von einer anderen Anmeldung übernommen“: Jemand hat sich während eines Auslesens auf der Webseite des Deco angemeldet. Das nächste Auslesen meldet sich neu an; schließ die Webseite, wenn du fertig bist.
- Die Deco-App meldet dich ab: Das Besitzer-Konto der App und die Integration teilen sich denselben Administrator. Nutze in der App ein Manager-Konto, wie TP-Link es empfiehlt.
- „Keine Antwort“: Prüfe die IP-Adresse des Haupt-Deco (Deco-App) und dass Gladys es erreicht.
Manche Firmwares antworten nur über
https://: Die Integration folgt dieser Weiterleitung selbst. - „Antwortet nicht wie das Haupt-Deco“: Die Adresse ist nicht die des Haupt-Deco, oder die Firmware nutzt eine ältere Anmeldung (Deco S7, manche alten Firmwares), die die Integration nicht unterstützt.
- Protokolle: Integrationen → TP-Link Deco → Protokolle;
LOG_LEVEL=debugzeigt jedes Auslesen.
Grenzen
- Ohne die Hardware entwickelt: Das Protokoll folgt der Home-Assistant-Integration
tplink_deco; melde jeden Unterschied mit deinem Modell. - Das Deco erlaubt eine Admin-Sitzung: Die Integration und die Webseite des Deco unterbrechen einander, während eine von beiden liest.
- Die Firmwares mit der älteren verschlüsselten Anmeldung (HTTP 401 bei den Schlüsseln, Deco S7) werden nicht unterstützt.
- Der Ausfall des Haupt-Deco selbst erscheint als „Haupt-Deco nicht erreichbar“ bei der Integration, nicht als Auslöser „Deco offline“: Die Satelliten werden nur über es gesehen.
- Die Anwesenheit hängt davon ab, dass das Handy im WLAN bleibt: Handys, die ihre MAC-Adresse wechseln, brauchen für dieses Netzwerk eine feste Adresse (private Adresse aus).
- Keine Cloud: Das Deco muss im lokalen Netzwerk erreichbar sein; die TP-Link-Cloud wird nie genutzt.
Konfigurationseinstellungen
Diese Einstellungen fragt TP-Link Deco in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Haupt-Deco | section | Nein | Das Deco, das mit deinem Internet-Router verbunden ist. Seine lokale Web-API erlaubt nur eine Admin-Sitzung zur selben Zeit: Die Integration meldet sich nach jedem Auslesen ab, und eine Anmeldung auf der Webseite des Deco unterbricht die Integration. |
| Adresse des Haupt-Deco | string | Ja | Seine IP-Adresse in deinem Netzwerk, sichtbar in der Deco-App (Netzwerk > das Haupt-Deco). Füge https:// nur hinzu, wenn http nicht antwortet. |
| Passwort der Deco-App | secret | Ja | Das Passwort der TP-Link-ID, der das Netzwerk in der Deco-App gehört (der Besitzer, kein Manager). Das Deco sperrt die Anmeldung nach mehreren falschen Passwörtern. |
| Anwesenheit und Aktualisierung | section | Nein | Die Clients, die online sind, erscheinen im Tab „Entdecken“: Füge die Handys hinzu, die du verfolgen willst, jedes wird ein Anwesenheitssensor. |
| Netzwerk-Clients in „Entdecken“ anbieten | boolean | Nein | |
| Abwesenheitsverzögerung (Minuten) | number | Nein | Wie lange ein Client weg sein muss, bevor er als abwesend gilt (Handys im Standby verlassen das WLAN eine Weile). |
| Aktualisierungsintervall | select | Nein | Jedes Auslesen ist eine Anmeldung am Deco. Alle 30 Sekunden für eine schnelle Anwesenheit; alle 2 oder 5 Minuten schont das Deco. |
| Befehle (standardmäßig aus) | section | Nein | Ein Neustart schaltet das WLAN seines Bereichs für ein paar Minuten ab, beim Haupt-Deco das ganze Netzwerk: Aktiviere nur, was deine Szenen brauchen. Der Schalter des Gast-WLANs erscheint am Haupt-Deco, sobald erlaubt (Entdecken > Aktualisieren). |
| Steuerung des Gast-WLANs erlauben | boolean | Nein | |
| Neustarts erlauben | boolean | Nein | |
| Sprache der Funktionsnamen | select | Nein | Gilt auch für die Meldungen der Integration. Die Namen werden beim Hinzufügen eines Geräts festgelegt. |
So installierst du TP-Link Deco in Gladys
- Öffne in Gladys Integrationen: TP-Link Deco erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-deco:1.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-deco.
TP-Link Deco 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
TP-Link Deco 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 guim31 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