Geräteprofil · Licht

WiZ

Hinweis: WiZ veröffentlicht die lokale Schnittstelle nicht offiziell. Die Wertebereiche stammen aus der Firmware des Geräts.

Voraussetzungen

1. Ein WiZ-Gerät (Leuchtmittel A60/Filament/GU10, Lichtstreifen, Panel, Steckdose) im lokalen Netz, einmal mit der WiZ-App eingerichtet. Die App darf weiter benutzt werden.

2. Das Gerät antwortet auf UDP-Port 38899. Prüfen lässt sich das von einem Rechner im selben Netz:

   echo '{"method":"getPilot","params":{}}' | nc -u -w 1 <IP-des-Geräts> 38899
   

   Die Antwort beginnt mit {"method":"getPilot","env":"pro","result":{....

3. Ein nomos Controller mit einem Daemon, der RESOLVE_SYSVARS kennt (1.1.94 oder neuer) – das braucht die Farbsteuerung.

Einrichtung

1. Dem Gerät im Router eine feste IP-Adresse geben
2. Skills → Add-ons: Profil importieren
3. Gerät anlegen und die IP-Adresse eintragen; der Port 38899 ist fest

Datenbereich

Abgefragt wird alle 15 Sekunden der gesamte Zustand (getPilot); das Intervall lässt sich ändern.

• Ein/Aus (state, zusätzlich als active)
• Helligkeit (level) in Prozent
• Farbtemperatur (color-temperature): im System in Mired, 154–454, entsprechend 6500–2200 K
• Farbe (red, green, blue) 0–255; Weiß- und Warmweiß-Kanal ausgeblendet
• Szene (scene): die eingebaute Szene, mit Namen aus dem WiZ-Katalog
• Szenengeschwindigkeit, Verbindungsqualität (linkquality, aus der WLAN-Signalstärke), WLAN-Signal in dBm und MAC-Adresse (ausgeblendet)
• Erreichbarkeit (reachable): aus dem Erfolg der Abfragen

Schreibbar sind Ein/Aus, Helligkeit, Farbtemperatur, die drei Farbkanäle, die Szene und die Szenengeschwindigkeit.

Hinweise

• Helligkeit unter 10 % nimmt das Gerät nicht an. Die Firmware begrenzt dimming auf 10–100. Das Profil rechnet deshalb die Prozentanzeige 0–100 auf 10–100 um: 0 % in der App ist die kleinste Helligkeit, nicht aus. Zum Ausschalten den Ein/Aus-Schalter verwenden.
• Die Betriebsarten schließen sich gegenseitig aus. Im Farbmodus meldet das Gerät kein temp, im Weißmodus keine Farbwerte, und speed nur bei einer laufenden dynamischen Szene. Was gerade nicht gemeldet wird, behält in nomos seinen letzten Wert – die Anzeige friert also nicht ein, sie zeigt aber den Wert der zuletzt gemeldeten Betriebsart.
• Wie die Farbsteuerung funktioniert: WiZ setzt beim Senden eines einzelnen Farbkanals die anderen beiden auf 0. Deshalb schickt jeder der drei Befehle alle drei Kanäle mit; die beiden unveränderten kommen aus der letzten Abfrage, die sie in Hilfsvariablen ablegt (derselbe Weg wie beim Daikin-Profil). Daraus folgt:
  • Bis die erste Abfrage nach dem Start durch ist, fehlt der Bezugswert und die Farbe kann falsch werden.
  • Zwei Farbänderungen innerhalb etwa einer Sekunde können sich überschreiben.
  • Wird die Farbe gleichzeitig in der WiZ-App verstellt, arbeitet nomos bis zur nächsten Abfrage noch mit dem alten Stand.
• Der Farbtemperaturbereich ist mit 2200–6500 K angenommen, dem üblichen Produktbereich. Die Firmware selbst akzeptiert 1000–10000 K, und die Modelle unterscheiden sich; reine Dimm-Leuchtmittel haben überhaupt keine Farbtemperatur. Weicht Ihr Modell ab, stimmt die Skalierung an den Rändern nicht.
• Szenen: Die Liste enthält den vollständigen WiZ-Katalog. Ein Tunable-White- oder reines Dimm-Leuchtmittel kennt nur einen Teil davon und lehnt die übrigen ab. „Rhythm” und die zehn eigenen Modi (256–265) sind nicht in der Liste.
• Jedes Gerät bekommt einen eigenen lokalen UDP-Port (LOCALPORT: RANDOM). Sonst würde der Daemon den Geräteport 38899 lokal belegen, und ein zweites WiZ-Gerät könnte ihn nicht mehr öffnen.
• Nicht im Profil enthalten: Suche per Rundruf, die unaufgeforderten Meldungen des Geräts (syncPilot auf Port 38900) – nomos fragt stattdessen ab –, Modell- und Systeminfos, das Verhältnis bei Doppelkopf-Leuchten, eigene Modi, Neustart und Firmware-Update.