devolo Home Network Smart-Home-Integration, kostenlos und Open Source
PLC-Raten, WLAN, Gast-WLAN, LEDs, Firmware und WLAN-Anwesenheit deiner devolo-Adapter.
Veröffentlicht von guim31
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.1.0
- ★ 0
Überwache und steuere deine devolo-Powerline-Adapter (PLC) aus Gladys: devolo Magic, dLAN und WiFi Repeater. Die Integration spricht mit den Adaptern in deinem lokalen Netzwerk, über dieselbe API wie die App devolo Home Network: keine Cloud, kein Konto.
Ohne die Hardware entwickelt: Rückmeldungen sind willkommen. Das Protokoll stammt aus der Open-Source-Bibliothek von devolo und der Home-Assistant-Integration, die Tests laufen gegen ein simuliertes Netzwerk. Wenn etwas mit deinen Adaptern nicht funktioniert, eröffne ein Issue im GitHub-Repository.
Diese Integration ist nicht mit devolo verbunden.
Überblick
- Ein Gerät pro Adapter: online oder nicht, die PLC-Rate zu jedem anderen Adapter des Netzwerks, die Anzahl der verbundenen WLAN-Geräte, die Firmware-Version und ob devolo eine neuere anbietet.
- Befehle: Gast-WLAN an/aus, LEDs an/aus, „Identifizieren“ (der Adapter blinkt) und „Neu starten“, wenn du es in der Konfiguration erlaubst.
- Anwesenheit: die WLAN-Geräte deiner Wahl (Handys…) werden zu Anwesenheitssensoren: zu Hause, solange sie mit einem devolo-Adapter verbunden sind.
- Dashboard-Widget: der Zustand des PLC-Netzwerks auf einen Blick.
- Szenen: ein Auslöser, wenn sich ein nie gesehenes Gerät mit dem WLAN verbindet, und Aktionen, um das Gast-WLAN (für eine Zeit) ein- oder auszuschalten.
Voraussetzungen
- Gladys Assistant 5.1.0 oder neuer.
- devolo-Adapter mit der API von devolo Home Network: devolo Magic 1 und 2 (LAN und WiFi), dLAN 1200+/550+ WiFi und die devolo WiFi Repeater. Sehr alte dLAN-Adapter ohne diese API können nicht gelesen werden, erscheinen aber als Nachbarn der anderen (mit ihren Raten).
- Die Adapter im selben lokalen Netzwerk wie Gladys. Sind sie in einem anderen Netzwerk (VLAN, Subnetz), gib ihre Adressen in der Konfiguration ein.
- Das Gerätekennwort, wenn du in der App devolo Home Network eines festgelegt hast (Einstellungen des Adapters). Sonst lass das Feld leer.
Konfiguration
- Öffne in Gladys Integrationen → devolo Home Network → Konfiguration.
- Fülle die Felder bei Bedarf aus:
- Adressen der Adapter (optional): nur für Adapter, die die Suche nicht findet, durch Kommas
getrennt (z. B.
192.168.1.20, 192.168.1.21). Gib ihnen eine feste Adresse in deinem Router: Die Integration findet sie auch nach einem Adresswechsel wieder. - Gerätekennwort: das aus der App devolo Home Network, für alle Adapter gleich. Manche Firmwares erwarten es gehasht: Die Integration probiert beides.
- Aktualisierungsintervall: wie oft LEDs, Gast-WLAN und WLAN-Geräte gelesen werden (standardmäßig 30 Sekunden). Die PLC-Raten werden alle 5 Minuten gelesen, die Suche nach Firmware-Updates alle 6 Stunden.
- Abwesend nach: wie lange ein WLAN-Gerät fehlen darf, bevor es als abwesend gilt (standardmäßig 3 Minuten).
- Neustart der Adapter erlauben: standardmäßig aus. Eingeschaltet fügt es den Adaptern eine Schaltfläche „Neu starten“ hinzu (aktualisiere sie im Tab „Entdecken“).
- Sprache der Funktionsnamen: standardmäßig Französisch.
- Adressen der Adapter (optional): nur für Adapter, die die Suche nicht findet, durch Kommas
getrennt (z. B.
- Klicke auf Adapter suchen: Die Integration listet, was sie gefunden hat und ob jeder Adapter antwortet.
- Füge im Tab Entdecken die Adapter und die zu verfolgenden WLAN-Geräte hinzu.
Datenverkehr und Kontingente: Alles bleibt in deinem lokalen Netzwerk, devolo legt für diese API kein Kontingent fest. Die Integration sendet bei jeder Aktualisierung wenige kleine Anfragen pro Adapter, eine nach der anderen, wie Home Assistant. Nur die Suche nach Firmware-Updates lässt den Adapter alle 6 Stunden den Update-Server von devolo kontaktieren.
Geräte
devolo-Adapter
| Funktion | Typ | Was sie anzeigt |
|---|---|---|
| Online | Sensor | 1, wenn der Adapter antwortet, 0 nach zwei Fehlversuchen |
| PLC-Rate zu … / von … | Rate, Mbit/s | PHY-Rate der Powerline-Strecke zu und von einem anderen |
| WLAN-Geräte | Zähler | Geräte in seinem WLAN (Haupt- und Gast-WLAN) |
| Gast-WLAN | Schalter | schaltet das Gast-WLAN ein oder aus |
| LEDs | Schalter | schaltet die LEDs des Adapters ein oder aus |
| Firmware | Text | installierte Firmware-Version |
| Firmware-Update verfügbar | Sensor | 1, wenn devolo eine neuere Firmware anbietet |
| Identifizieren (blinken) | Taste | der Adapter blinkt eine Weile |
| Neu starten | Taste, optional | startet den Adapter neu (nur wenn erlaubt) |
Die Funktionen folgen dem, was jeder Adapter meldet: Ein Magic 2 LAN hat kein WLAN, ein WLAN-Repeater hat keine PLC-Raten. Die Raten gibt es für die Adapter des PLC-Netzwerks, die beim Hinzufügen des Geräts bekannt sind; kommt später ein Adapter dazu, bietet der Tab „Entdecken“ an, das Gerät zu aktualisieren. Firmware-Updates werden nicht aus Gladys installiert: Nutze die App devolo Home Network.
WLAN-Gerät
| Funktion | Typ | Was sie anzeigt |
|---|---|---|
| Anwesenheit | Anwesenheit (0/1) | 1, solange das Gerät mit einem devolo-Adapter verbunden ist |
Die Adapter liefern nur die MAC-Adresse eines WLAN-Geräts: Der Tab „Entdecken“ nennt es „WLAN-Gerät 00:00:5E:…“. Benenne es nach dem Hinzufügen um. Ein Handy mit zufälliger („privater“) WLAN-Adresse muss in deinem Netzwerk seine echte Adresse verwenden, damit die Anwesenheit funktioniert.
Widget
devolo-PLC-Netzwerk: wie viele Adapter online sind, wie viele WLAN-Geräte sie versorgen, die langsamste PLC-Strecke zum Adapter am Router (die, die das Internet eines Raums bremst), dann eine Zeile pro Adapter: seine Raten zum Router-Adapter (grün ab 100 Mbit/s, orange ab 30 Mbit/s, rot darunter), „Am Router“ oder „Offline“. Ein ausstehendes Firmware-Update wird in der Zeile vermerkt. Eine Schaltfläche schaltet das Gast-WLAN aller Adapter ein oder aus. Keine MAC-Adresse und kein Kennwort: Das Dashboard kann Besuchern gezeigt werden.
Szenen-Auslöser
Neues WLAN-Gerät: Ein nie gesehenes Gerät verbindet sich mit dem WLAN eines devolo-Adapters.
Die Geräte, die beim ersten Lesen eines Adapters verbunden sind, werden still gelernt, und die
Liste bleibt über Neustarts erhalten. Optionaler Filter: Haupt- oder Gast-WLAN. Variablen: mac,
adapter (der Adapter), network (main oder guest), band (2.4 GHz oder 5 GHz).
Szenen-Aktionen
- Gast-WLAN einschalten: auf einem Adapter oder auf allen Adaptern mit WLAN, optional für eine
Anzahl Minuten (höchstens 1440): Danach schaltet der Adapter es selbst aus. Ausgaben:
ssid(Name des Gast-WLANs) undpassword(Kennwort), um sie in einer Nachricht zu senden. - Gast-WLAN ausschalten: auf einem Adapter oder auf allen Adaptern mit WLAN.
Beispielszenen
- Gäste kommen: Schalte auf Tastendruck das Gast-WLAN für 240 Minuten ein und sende „WLAN {{ssid}}, Kennwort {{password}}“ in den Familien-Chat.
- Unbekanntes Gerät: Sende bei „Neues WLAN-Gerät“ im Haupt-WLAN eine Benachrichtigung mit der MAC-Adresse und dem Adapter.
- Niemand zu Hause: Wenn die Anwesenheit aller Handys auf 0 geht, schalte die LEDs der Adapter und das Gast-WLAN aus; schalte die LEDs wieder ein, wenn jemand heimkommt.
- Schwache Strecke: Bleibt die „PLC-Rate zu …“ des Büro-Adapters unter 50 Mbit/s, sende eine Benachrichtigung (eine Steckdosenleiste oder ein Ladegerät kann die Leitung stören).
Fehlerbehebung
- „Kein devolo-Adapter gefunden“: Prüfe, ob die Adapter im selben Netzwerk wie Gladys sind, starte „Adapter suchen“ erneut oder gib ihre Adressen in der Konfiguration ein.
- „hat das Kennwort abgelehnt“: Gib das Gerätekennwort aus der App devolo Home Network ein; lass das Feld leer, wenn keines festgelegt ist. Der Status nennt den ablehnenden Adapter.
- Ein Adapter „antwortet nicht“: Er ist ausgesteckt, im Standby oder hat eine neue Adresse. Die Integration sucht nach einigen Fehlversuchen erneut im Netzwerk.
- Keine Rate für einen Adapter: Die PLC-Raten kommen alle 5 Minuten; reine WLAN-Repeater haben keine.
- Ein WLAN-Gerät bleibt abwesend: Es ist vielleicht mit dem WLAN deines Routers statt mit einem devolo-Adapter verbunden oder nutzt eine zufällige WLAN-Adresse.
- Protokolle: Integrationen → devolo Home Network → Logs.
LOG_LEVEL=debugzeigt jedes Lesen.
Grenzen
- Die Anwesenheit sieht nur Geräte im WLAN eines devolo-Adapters, nicht im WLAN deines Routers oder eines anderen Access Points.
- Antwortet kein WLAN-Adapter, bleibt die Anwesenheit unverändert.
- Name und Kennwort des Gast-WLANs sind die aus der App devolo Home Network; sie lassen sich nicht aus Gladys ändern.
- Firmware-Updates, Pairing, WPS und WLAN-Einstellungen bleiben in der App devolo Home Network.
- devolo-Home-Control-Zentralen werden nicht unterstützt (sie sind keine Netzwerkadapter).
- Die Raten sind PHY-Raten, wie die Adapter sie melden, nicht der tatsächliche Durchsatz.
- Ohne die Hardware entwickelt: Das Verhalten mit echten Adaptern wurde noch nicht geprüft.
Konfigurationseinstellungen
Diese Einstellungen fragt devolo Home Network in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Deine devolo-Adapter | section | Nein | Gladys findet die Adapter (Magic, dLAN, WiFi Repeater) im Netzwerk: Starte „Adapter suchen“ und füge sie dann im Tab „Entdecken“ hinzu. Gib ihre Adressen nur ein, wenn sie in einem anderen Netzwerk sind, und das Gerätekennwort nur, wenn du eines in der App devolo Home Network festgelegt hast. |
| Adressen der Adapter (optional) | string | Nein | Nur für Adapter, die die Suche nicht findet. Mehrere Adressen: mit Kommas trennen. |
| Gerätekennwort | secret | Nein | Das in der App devolo Home Network festgelegte, für alle Adapter gleich. Leer: kein Kennwort. |
| Aktualisierungsintervall | select | Nein | Wie oft LEDs, Gast-WLAN und WLAN-Geräte gelesen werden. PLC-Raten: alle 5 Minuten. |
| Abwesend nach | select | Nein | Zeit, die ein WLAN-Gerät fehlen darf, bevor es als abwesend gilt. Handys im Ruhezustand verschwinden für einige Minuten. |
| Neustart der Adapter erlauben | boolean | Nein | Fügt den Adaptern eine Schaltfläche „Neu starten“ hinzu. Ein Neustart unterbricht das Netzwerk für etwa eine Minute. |
| Sprache der Funktionsnamen | select | Nein | Namen der Funktionen neuer Geräte und Sprache der Meldungen. |
So installierst du devolo Home Network in Gladys
- Öffne in Gladys Integrationen: devolo Home Network erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-devolo: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-devolo.
devolo Home Network 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
devolo Home Network 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