[Modul] Xiaomi Yeelight

[Nall-chan]

Symcon-Modul: Yeelight

Einbinden von Yeelight Geräten in IPS.

Inhaltsverzeichnis

• 1. Funktionsumfang
  • Yeelight Discovery:
  • Yeelight Gerät:
• 2. Voraussetzungen
• 3. Software-Installation
• 4. Einrichten der Instanzen in IP-Symcon
• 5. Anhang
  • 1. GUID der Module
  • 2. Hinweise
    • 1. LAN-Steuerung aktiveren
    • 2. Discovery-Instanzen erstellen
  • 3. Backlog
  • 4. Changelog
  • 4. Spenden
• 6. Lizenz

1. Funktionsumfang

Yeelight Discovery:

• Auflisten alle im Netzwerk vorhandenen Yeelight Geräte.
• Erstellen von neuen Yeelight Device-Instanzen in IPS.
• Funktioniert nicht in einem Docker Container welcher per NAT angebunden ist

Yeelight Gerät:

• Empfangen und visualisieren der aktuellen Zustände in IPS.
• Steuerung per WebFront und per PHP-Funktionen.
• Benötigt bei NAT eine Portweiterleitung von Port 1983 UDP ankommend

2. Voraussetzungen

• Symcon ab Version 8.1
• Yeelight Gerät ( ‚3th party local control‘ muss aktiviert werden, siehe hier)

3. Software-Installation

Über den ‚Module-Store‘ in IPS das Modul ‚Yeelight‘ hinzufügen.
Bei kommerzieller Nutzung (z.B. als Errichter oder Integrator) wenden Sie sich bitte an den Autor.

4. Einrichten der Instanzen in IP-Symcon

Die Discovery Instanz wird nach der Installation aus dem Store automatisch angelegt(* siehe Hinweise) und ermöglicht das einfache einbinden aller Geräte in IPS.

Eine manuelle Einrichtung der Geräte ist in der Yeelight Geräte Instanz beschrieben.

5. Anhang

1. GUID der Module

Modul	Typ	Prefix	GUID
Yeelight Discovery	Discovery	YeeLight	{7AABB3D2-3D24-4F2C-86CE-A56FB09D188A}
Yeelight Device	Device	YeeLight	{BF5D53BB-EB4E-45C0-8632-5DB4EF49FA9F}

2. Hinweise

1. LAN-Steuerung aktiveren

Nachdem die Geräte mit der Hersteller APP (Yeelight, nicht Xiaomi !) in das Netzwerk integriert wurden, muss die lokale Steuerung für jedes Gerät einzeln aktiviert werden.
Aktuelle Versionen der App fragen dies automatisch nach dem hinzufügen der Geräte ab, da dieses Protokoll auch für die lokale Google Home Anbindung benötigt wird.

2. Discovery-Instanzen erstellen

Nach der Installation über den ‚Modul-Store‘ fragt Symcon ob die enthaltende Discovery Instanz erstellt werden soll.
Wird Symcon allerdings unter Docker mit aktivem NAT betrieben, so kann diese Frage verneint werden.
Die Yeelight Geräte Instanzen müssen in dieser Konstellation per Hand angelegt und konfiguriert werden.

3. Backlog

siehe nächster Beitrag

4. Changelog

siehe nächster Beitrag

4. Spenden

Die Library ist für die nicht kommerzielle Nutzung kostenlos, Schenkungen als Unterstützung für den Autor werden hier akzeptiert:

6. Lizenz

IPS-Modul:
CC BY-NC-SA 4.0

[Nall-chan]

3. Backlog

• Aktionen und PHP-Befehle um Farbtemperatur und Helligkeit mit rotation durchschalten (Main und Hintergrund).
• Aktionen und PHP-Befehle um Farbe(HSV), Farbtemperatur und Helligkeit prozentual zu erhöhen oder zu verringern (Main und Hintergrund).
• Dokumentation der PHP-Befehlsreferenz vervollständigen.

4. Changelog

Version 2.15:

• Version für Symcon 8.1
• Parameter Licht sanft ändern wurde bei Farbe ignoriert.
• HSV Variable ergänzt.
• SetScene und SetBgScene als Instanz-Funktion ergänzt.
• Umstellung auf Darstellungen.
• Unterstützung für Kachel Visualisierung.

Version 2.14:

• Fix: Erkennung von Eigenschaften welche beim initialen SSDP Response fehlen.

Version 2.13:

• Instanz hat aktiven IO beim Neustart von Symcon nicht erkannt.

Version 2.10:

• Quata exceeded Fehlermeldungen lösen einen automatischen Reconnect aus.

Version 2.00:

• Betrieb der Geräte-Instanzen auch mit NAT (z.B. Docker) möglich.
• VariablenProfile werden beim löschen mit entfernt.
• Aktionen (inkl. Programmablauf) werden unterstützt.
• Debugausgaben waren unvollständig.
• Fehlermeldungen von Geräten wurden nicht berücksichtigt.
• Bessere Hinweise wenn es Probleme mit der Kommunikation gibt.
• RGB Farbwahl war defekt.
• UDP Kommunikation wird in Symcon ankommend auf Port 1983 erwartet.
• Prefix für PHP-Befehle wurde auf „YEELIGHT“ geändert.
• IPS 6.1 wird benötigt.

Version 1.80:

• Unnötigen Code aus Discovery entfernt.
• Discovery zeigt eine Meldung an, wenn keine Geräte gefunden wurden.

Version 1.70:

• YEELIGHT_SetMode schaltet Gerät immer an.
• Zweites Profil für die Farbtemperatur bei Modus ‚Weiß mit Nachtlicht‘.

Version 1.60:

• Erweiterung für den Nachtlicht-Modus

Version 1.50:

• Release für IPS 5.1 und den Module-Store

Version 1.00:

• Erstes offizielles Release

[someone]

Hallo,

ich bekomme seit dem letzten Update immer diesen Fehler, wenn ich die Instanz öffnen möchte

Auch ein steuern per Befehl ist derzeit nicht möglich. Muss ich bei der neuen Version etwas beachten?

Die Sockets laufen korrekt.

[Nall-chan]

Schau mal in das logfile, warum das Modul nicht geladen wird.
Michael

[someone]

Danke Michael,

durch Deinen Hinweis konnte ich sehen, dass es Probleme mit dem Webhook beim Start gab. Ich löschte daher die bestehenden und nach dem Restart kamen neue Webhooks und das Modul arbeitet wieder.

Ich erfreue mich weiterhin an dem tollen Modul

[Nall-chan]

Ah, ja mein Fehler. Habe das nicht dokumentiert.
Da kommt erst mit Symcon 8.2 ein fix welcher das Thema adressiert.
Michael