Diese Dokumentation beschreibt immer die neueste Version des Moduls, aktuell 1.1 im Kanal Beta. Im Kanal Stable liegt noch die Version 1.0.1. Dort können Funktionen fehlen, die hier beschrieben sind.
Dieses Modul stellt eine Verbindung zur der Philips HUE Bridge her, um HUE Geräte in IP-Symcon zu integrieren. Das Modul basiert auf der neuen API von Philips HUE, welches als Rückkanal SSE (Server-Sent Events) benutzt.
Inhaltverzeichnis
1. Voraussetzungen
- mindestens IPS Version 6.3
2. Enthaltene Module
- Bridge
- DeviceConfigurator
- DevicePower
- Discovery
- GroupedLight
- Light
- LightLevel
- Motion
- RoomConfigurator
- Temperature
- ZigbeeConnectivity
3. Installation
Über den IP-Symcon Module Store. (Beta Version Philips HUE V2)
4. Konfiguration in IP-Symcon
Nachdem das Modul installiert wurde muss eine Discovery Instanz angelegt werden. Die Discovery Instanz durchsucht das Netzwerk nach vorhanden Philip HUE Bridges. Nachdem die Suche abgeschlossen worden ist, kann über die Discovery Instanz der Konfigurator für das Modul angelegt werden. Der Konfigurator legt ein Gateway an, dieses muss nun geöffnet werden, dort muss die Philips HUE Bridge mit IP-Symcon gepairt werden, dazu muss auf der HUE Bridge der Button gedrückt werden. Nachdem der Button betätigt wurde, muss in der Bridge Instanz der Button “Registriere IP-Symcon” ausgeführt werden. Nun sollte IP-Symcon mit der Philips HUE Bridge gepairt sein und im Konfigurator sollten die Geräte & Resourcen zu finden sein.
5. Spenden
Dieses Modul ist für die nicht kommerzielle Nutzung kostenlos, Schenkungen als Unterstützung für den Autor werden hier akzeptiert:
6. Lizenz
Changelog
Alle Versionen dieses Moduls, die neueste oben.
Version 2.1
- Neu: Neue Variable "Farbe (xy)" (colorxy) bei Lampen und Gruppen: Die Farbe in CIE xy, wie sie die Bridge meldet, ohne Umrechnung. Sie ist steuerbar und eignet sich zum genauen Sichern und Wiederherstellen von Farben. Bestehende Instanzen zeigen die Variable nach dem Öffnen und Speichern der Instanz.
- Fix: PHUEsetColor begrenzt eine übergebene Helligkeit auf 0 bis 100, weil die Bridge die Anfrage sonst ablehnt und die Farbe nicht setzt.
- Fix: Lehnt die Bridge einen Befehl ab (Fehler 400), steht das jetzt als Warnung mit dem Grund im Log.
- Fix: Die Farbvariable von Lampen und Gruppen zeigt jetzt zuverlässig die Farbe der Bridge, auch wenn die Lampe außerhalb von Symcon geändert wurde (vorher Schwarz oder falsche Werte). Der Farbwert hängt nicht mehr von der Helligkeit ab (sie steht in der eigenen Variable), der Farbton wird nicht mehr durch Abschneiden einzelner Kanäle verfälscht. Hinweis: Die Konsole von Symcon zeigt die Zelle von „Farbe (xy)“ gelblicher als den Farbwert, weil sie die Farbe abschneidet. Zum genauen Sichern und Wiederherstellen von Farben dient „Farbe (xy)“.
- Fix: Bei Gruppen mit der Einstellung "Status für Farbe und Farbtemperatur simulieren" bekommen der Farbwert und die Farbe (xy) nach einer Aktion denselben Wert wie bei einer Meldung der Bridge.
Version 2.0.1
- Fix: PHUEsetColor begrenzt eine übergebene Helligkeit auf 0 bis 100, weil die Bridge die Anfrage sonst ablehnt und die Farbe nicht setzt.
- Fix: Lehnt die Bridge einen Befehl ab (Fehler 400), steht das jetzt als Warnung mit dem Grund im Log.
Version 2.0
- Neu: Das Modul nutzt die strikte Modul-Basis von Symcon. Achtung: Erforderlich ist jetzt Symcon 9.0 oder neuer.
- Neu: Die Variablen nutzen die nativen Darstellungen von Symcon statt Variablenprofilen. Achtung: Beim Übernehmen einer bestehenden Instanz ersetzt die Darstellung das bisherige Profil, eigene Anpassungen an der Darstellung bleiben erhalten. Die Temperatur wird mit zwei Nachkommastellen angezeigt.
- Neu: Die Szenenauswahl einer Gruppe wird beim Übernehmen der Instanz automatisch gefüllt.
- Neu: Die Konfiguratoren zeigen einen Hinweis, wenn die Bridge nicht verbunden ist.
- Neu: Alle Konfigurationsformulare enthalten den Spendenblock und sind vollständig übersetzt.
- Fix: Die Module werden unter aktuellen Symcon-Versionen wieder geladen.
- Fix: Die Debug-Ausgabe der Bridge zeigt den API-Schlüssel nicht mehr.
- Fix: Die Variable "Farbtemperatur Kelvin" hat jetzt einen deutschen Namen.
- Fix: Falsche deutsche Bezeichnungen sind korrigiert (Getrennt, Unidirektional eingehend, Im Uhrzeigersinn, Gegen den Uhrzeigersinn).
- Fix: Die Beispiele zu PHUEsetColor in der README sind korrigiert (Farbwert als Integer, Helligkeit bis 100).
- Fix: Die Variablenliste hat in allen Formularen eine Überschrift, und der Name der Variable "Status" beim Temperatursensor ist übersetzt.
- Fix: Die Einstellung der Bridge für Fehler 400 heißt jetzt „Fehler 400 im Debug protokollieren“, weil sie genau das tut (die Property bleibt unverändert).
Version 1.1 Beta
- Neu: Convenience Area Motion
- Neu: Farbtemperatur als Kelvin Variable
- Neu: Bridge Pro
- Neu: Tamper
- Neu: Contact
- Neu: Fehler 400 kann ignoriert werden.
- Fix: updateValues für PHP 8
- Fix: Nicht bekannte Geräte werden im Konfigurator nicht mehr als Type Motion zum Anlegen angeboten.
Version 1.0.1
- Neu: Service relativerotary
- Neu: Funktion getOwnerInfo bei groupedlight
- Neu: Funktion setAlert()
- Neu: Funktion getInfos()
- Fix: Bei mehreren Gruppen konnte es zu Problemen mit den Rückmeldungen geben.
- Fix: setColor schickte die Anfrage nicht an die Gruppe
- Fix: Duration für Ein- bzw. Ausschalten eingebaut
- Fix: Update des Szenenprofils wird nun nicht mit IPSSetVariableCustomProfile gesetzt
- Fix: RegisterServerEvents gegen GetConfigurationForParent getauscht, somit kann der IO nicht mehr per Hand geändert werden.
- Fix: Alias bei HUE Light Level angepasst
- Fix: Parent wird vom Modul über GetConfigurationForParent gesetzt.
- Fix: Neue Variablen werden nun über GetConfigurationForm der Liste hinzugefügt
Version 1.0
- Neu: Erste stabile Version.
Version 1.0 Beta
- Neu: Erste Version.