Zum Hauptinhalt springen

WiZ Smart-Home-Integration, kostenlos und Open Source

WiZ-Integration für Gladys Assistant

WiZ-Lampen, LED-Streifen und Steckdosen im lokalen Netzwerk: Farben, Weißtöne, WiZ-Szenen.

Auf GitHub ansehenAlle externen Integrationen

Steuere deine WiZ-Lampen und smarten Steckdosen aus Gladys, über dein lokales Netzwerk: Lampen, Filamentlampen, LED-Streifen, Leuchten und Steckdosen der Marken WiZ und Philips Smart LED Wi-Fi. Ein und aus, Helligkeit, Farbe, Weißtöne und die WiZ-Szenen (Ozean, Romantik, Sonnenuntergang, Party, Kamin…), mit einem Dashboard-Widget, einem Szenen-Auslöser und einer Szenen-Aktion. Kein Konto und keine Cloud: Gladys spricht direkt mit jedem Gerät, so wie die WiZ-App in deinem WLAN.

Ohne die Hardware entwickelt: Rückmeldungen willkommen. Diese Integration wurde mit echten Antworten von WiZ-Geräten, die das Projekt pywizlight aufgezeichnet hat, und mit einem simulierten Gerät gebaut und getestet, nicht mit einer echten Lampe. Wenn etwas nicht wie beschrieben funktioniert, sag es bitte im Gladys-Forum oder in den Issues.

Was du brauchst​

  • Gladys Assistant 5.1.0 oder neuer.
  • WiZ-Lampen oder -Steckdosen, die bereits in der WiZ-App eingerichtet und mit demselben Netzwerk wie Gladys verbunden sind.
  • In der WiZ-App unter Einstellungen → Sicherheit: Lokale Kommunikation zulassen (Allow local communication) aktiviert (ohne das ignorieren die Geräte Gladys).
  • Sonst nichts: kein WiZ-Konto, kein Schlüssel, kein Internetzugang.

Einrichtung​

  1. Installiere die Integration aus dem Gladys-Katalog.
  2. Öffne ihre Konfiguration. Nichts ist Pflicht; die Optionen sind:
    • IP-Adressen der WiZ-Geräte: nur für Geräte, die die automatische Erkennung nicht findet, durch Kommas getrennt (zum Beispiel 192.168.1.50, 192.168.1.51). Dein Router listet die Adresse jedes Geräts auf; die WiZ-App zeigt sie auch, in den Einstellungen des Geräts.
    • Aktualisierungsintervall: wie oft jedes Gerät gelesen wird, 5 bis 60 Sekunden (standardmäßig 15). So schnell sieht Gladys eine Änderung über die WiZ-App, eine Fernbedienung oder einen Wandschalter.
    • Sprache der Gerätenamen: Englisch, Französisch, Deutsch oder Spanisch (standardmäßig Französisch). Die Namen eines Geräts, seiner Funktionen und seiner WiZ-Szenen werden beim Hinzufügen vergeben.
  3. Öffne den Tab Entdecken: ein Gerät pro WiZ-Lampe oder -Steckdose. Klicke auf Hinzufügen, wähle einen Raum, speichere.
  4. Fehlt ein Gerät? Klicke in der Konfiguration auf WiZ-Geräte suchen: Die Meldung unter der Schaltfläche listet die gefundenen Geräte und die, die nicht antworten.

Gladys findet die Geräte, indem es das Netzwerk fragt: „Wer ist ein WiZ-Gerät?“ (ein Broadcast auf UDP-Port 38899, den Gladys selbst sendet; das ist die Berechtigung, nach der die Installation fragt), und spricht dann direkt mit jedem. Ein Gerät, das seine Adresse wechselt, wird spätestens nach 15 Minuten wiedergefunden, ohne neues Gerät in Gladys: Es wird an seiner MAC-Adresse erkannt.

Die Geräte in Gladys​

Jede Lampe oder Steckdose wird ein Gladys-Gerät, benannt nach ihrer Art und dem Ende ihrer MAC-Adresse, zum Beispiel WiZ Farbe 06033D, WiZ Weißtöne 5A067C, WiZ dimmbar 2054E3 oder WiZ Steckdose 9906B7. Benenne es um, wie du willst. Veröffentlicht wird nur, was das Modell kann:

FunktionWas es istGeräte
LichtEin / ausAlle Lampen
SteckdoseEin / ausSteckdosen
Helligkeit10 bis 100 %; 0 schaltet die Lampe ausAlle Lampen
FarbeDie Farbe einer FarblampeFarblampen und -streifen
FarbtemperaturDer Weißton in Kelvin, im Bereich des Modells (2200 bis 6500 K)Farblampen und Lampen mit Weißtönen
WiZ-SzeneDie laufende WiZ-Szene oder Keine; eine Auswahl startet sieLampen mit Szenen
SzenengeschwindigkeitTempo der bewegten Szenen, 10 bis 200 % (100 ist die normale Geschwindigkeit)Lampen mit Szenen
LeistungsaufnahmeWatt, die das angeschlossene Gerät aufnimmtSteckdosen mit Verbrauchsmessung
  • Eine Farblampe bietet die 37 WiZ-Szenen; eine Lampe mit Weißtönen die 17 Weiß-Szenen (Gemütlich, Aufwachen, Schlafenszeit, Warmweiß, Tageslicht, Fokus, Entspannung, Kerzenlicht…); eine Filamentlampe die 8, die sie kann (Nachtlicht, Aufwachen, Schlafenszeit, Kerzenlicht…). Die Liste folgt der Sprache der Konfiguration.
  • Eine Helligkeit, eine Farbe, einen Weißton oder eine Szene zu wählen, schaltet die Lampe auch ein. Keine in der Szenenliste bewirkt nichts: Um eine Szene zu verlassen, wähle eine Farbe oder einen Weißton.
  • Antwortet eine Lampe nicht mehr, zeigt Gladys sie aus, und ihr Badge meldet sie als nicht erreichbar: Meistens wurde ihr Wandschalter ausgeschaltet.

Dashboard-Widget​

Füge das Widget WiZ einem Dashboard hinzu und wähle in seinen Einstellungen ein Gerät. Es zeigt die Helligkeit (oder die Leistungsaufnahme einer Steckdose mit Messung), ob das Gerät an ist, was die Lampe zeigt (eine Szene, einen Weißton mit seiner Temperatur oder eine Farbe), und Schaltflächen:

  • bis zu drei Szenen-Schaltflächen, in den Widget-Einstellungen gewählt (standardmäßig Warmweiß, Entspannung und Nachtlicht). Nur die Szenen, die die Lampe kann, werden gezeigt; die laufende trägt ein Häkchen;
  • eine Schaltfläche Einschalten / Ausschalten, die das Gerät umschaltet, egal was das Widget gerade zeigte.

Szenen​

Auslöser​

WiZ-Gerät außerhalb von Gladys geschaltet: Eine WiZ-Lampe oder -Steckdose wurde ohne Gladys ein- oder ausgeschaltet. Filter:

  • WiZ-Gerät: ein Gerät oder beliebig;
  • Geschaltet: ein, aus oder beides;
  • Über: WiZ-App, Fernbedienung oder Zeitplan (die WiZ-App, eine WiZ-Fernbedienung, ein Zeitplan oder ein Rhythmus der App, ein Sprachassistent) oder Wandschalter oder Stromausfall (das Gerät hat aufgehört zu antworten, während es an war, oder antwortet wieder und leuchtet, wie es WiZ-Lampen tun, wenn sie Strom bekommen).

Die Variablen des Auslösers liefern den neuen Zustand (on oder off) und seinen Ursprung (wiz oder power). Ein Befehl von Gladys löst diesen Auslöser nie aus.

Aktion​

WiZ-Szene starten: Schaltet die Lampe ein und startet eine ihrer WiZ-Szenen, aus einer Liste gewählt, optional mit Helligkeit (10 bis 100 %) und Geschwindigkeit (10 bis 200 %). Die Aktion schlägt fehl, wenn die Lampe diese Szene nicht kann (zum Beispiel eine Party-Szene auf einer weißen Lampe). Nummer und Name der Szene gehen an die folgenden Aktionen.

Szenen-Ideen​

  • Der Wandschalter als Taster: WiZ-Gerät außerhalb von Gladys geschaltet auf der Wohnzimmerlampe, ein, über Wandschalter oder Stromausfall → die anderen Lampen des Raums einschalten oder WiZ-Szene starten „Gemütlich“ mit 40 %.
  • Sanftes Aufwachen: jeden Werktag um 6:45 Uhr → WiZ-Szene starten „Aufwachen“ auf der Schlafzimmerlampe.
  • Stromausfall-Alarm: WiZ-Gerät außerhalb von Gladys geschaltet auf der Steckdose der Gefriertruhe, aus, über Wandschalter oder Stromausfall → eine Nachricht senden: „Die Steckdose der Gefriertruhe antwortet nicht mehr“.
  • Gemütlicher Abend: bei Sonnenuntergang → WiZ-Szene starten „Kamin“, Helligkeit 60, Geschwindigkeit 80.

Fehlerbehebung​

  • Kein Gerät automatisch gefunden: Prüfe, ob die Geräte und Gladys im selben Netzwerk sind (gleiches WLAN oder gleiches VLAN; ein Gästenetz oder ein eigenes IoT-VLAN blockiert die Erkennung). Gib die IP-Adressen in der Konfiguration ein: Das funktioniert auch über Netzwerke hinweg, solange Gladys sie erreicht. Feste Adressen für die Geräte in deinem Router helfen auch.
  • Ein gefundenes Gerät antwortet nie: Prüfe Lokale Kommunikation zulassen in der WiZ-App (Einstellungen → Sicherheit).
  • „antwortet nicht“: Das Gerät ist am Wandschalter aus, ausgesteckt oder hat sein WLAN verloren. Es kommt von selbst zurück, sobald es wieder antwortet.
  • Die Farbe in Gladys weicht etwas von der in der WiZ-App gewählten ab: WiZ mischt farbige und weiße LEDs; Gladys zeigt die nächstliegende reine Farbe.
  • Die Integration protokolliert, was sie findet und was nicht antwortet: Öffne die Protokolle der Integration in der Gladys-Oberfläche.

Grenzen​

  • Änderungen außerhalb von Gladys (WiZ-App, Fernbedienung, Wandschalter) werden beim nächsten Lesen gesehen, innerhalb des Aktualisierungsintervalls. WiZ-Geräte können ihre Änderungen auch sofort senden, aber nur an eine Adresse in deinem Netzwerk, die die Integration nicht hat (sie läuft in ihrem eigenen isolierten Container): Gladys liest sie daher, mit einer kleinen lokalen Anfrage pro Gerät und Intervall (zwei für eine Steckdose mit Messung). Kein Kontingent, kein Internetverkehr.
  • Eine am Wandschalter ausgeschaltete Lampe wird nach zwei Lesevorgängen ohne Antwort erkannt (30 Sekunden mit dem Standardintervall). Ein WLAN-Ausfall sieht genauso aus, ebenso ein ausgestecktes Gerät.
  • Deckenventilatoren mit WiZ-Licht: Nur das Licht wird gesteuert, nicht der Ventilator. Lampen mit zwei Köpfen sind eine Lampe (die Aufteilung zwischen den Köpfen wird nicht angeboten). Der Rhythmus und die eigenen Modi der WiZ-App werden nicht angeboten. WiZ-Bewegungsmelder und -Fernbedienungen sind keine Gladys-Geräte.
  • Ohne echtes WiZ-Gerät entwickelt: Was nicht geprüft werden konnte, steht im README.

Diese Integration ist nicht mit WiZ, Signify oder Philips verbunden.

Konfigurationseinstellungen​

Diese Einstellungen fragt WiZ in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Deine WiZ-Geräte findensectionNeinWiZ-Lampen und -Steckdosen im selben Netzwerk wie Gladys werden automatisch gefunden: Öffne den Tab „Entdecken“. Lass sie in der WiZ-App eingerichtet, mit aktivierter „Lokale Kommunikation zulassen“. Fehlt eine, gib unten ihre IP-Adresse ein.
IP-Adressen der WiZ-GerätestringNeinOptional, durch Kommas getrennt. Nur für Geräte nötig, die die automatische Erkennung nicht findet.
AktualisierungsintervallselectNeinWie oft jedes Gerät gelesen wird, um Änderungen aus der WiZ-App, über eine Fernbedienung oder einen Wandschalter zu verfolgen.
Sprache der GerätenamenselectNeinNamen, die neuen Geräten, ihren Funktionen und der WiZ-Szenenliste gegeben werden (Licht, Helligkeit, Ozean…).

So installierst du WiZ in Gladys​

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

WiZ 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​

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

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 🙂
Zuletzt aktualisiert am