[Modul] Philips HUE V2 (Neue Push API)

Version Version License Check Style Tests

Philips HUE V2

Dieses Modul bindet die Philips HUE Bridge über die HUE API v2 in IP-Symcon ein. Als Rückkanal nutzt es SSE (Server-Sent Events), Änderungen an den Geräten kommen dadurch sofort in IP-Symcon an.

Funktionen

  • Bridges im Netzwerk finden und mit IP-Symcon koppeln
  • Lampen, Gruppen (Räume und Zonen) und Szenen steuern
  • Sensoren, Taster und Drehregler als Variablen abbilden
  • Geräte, Räume, Zonen und Szenen über Konfiguratoren anlegen
  • Statusänderungen der Bridge in Echtzeit übernehmen

Enthaltene Instanzen

  • Discovery: Sucht das Netzwerk nach HUE Bridges und legt den passenden Konfigurator an.
  • Bridge: Gateway zur HUE Bridge, hier wird IP-Symcon mit der Bridge gekoppelt.
  • DeviceConfigurator: Legt alle Geräte und Ressourcen der Bridge als Instanzen an.
  • RoomConfigurator: Legt die Räume der Bridge als Gruppen an.
  • ZoneConfigurator: Legt die Zonen der Bridge als Gruppen an.
  • SzenenConfigurator: Legt die Szenen der Bridge als Instanzen an.
  • Light: Stellt eine Lampe dar: Ein/Aus, Helligkeit, Farbe, Farbtemperatur und Übergangszeit.
  • GroupedLight: Stellt eine Gruppe von Lampen (Raum oder Zone) dar und steuert sie gemeinsam, einschließlich Szenenauswahl.
  • Scene: Aktiviert eine Szene der Bridge.
  • Button: Zeigt das letzte Ereignis eines Tasters.
  • RelativeRotary: Zeigt Aktion, Richtung, Schritte und Dauer eines Drehreglers (zum Beispiel Hue Tap Dial).
  • Motion: Zeigt die Bewegung eines Bewegungsmelders und lässt ihn aktivieren oder deaktivieren.
  • LightLevel: Zeigt die Helligkeit eines Sensors.
  • Temperature: Zeigt die Temperatur eines Sensors.
  • Contact: Zeigt den Zustand eines Kontaktsensors.
  • Tamper: Zeigt den Manipulationsstatus eines Geräts.
  • DevicePower: Zeigt den Batteriestand und Batteriezustand eines Geräts.
  • ZigbeeConnectivity: Zeigt den Zigbee-Verbindungsstatus eines Geräts.

Voraussetzungen

  • IP-Symcon 9.0 oder neuer
  • Philips HUE Bridge (HUE API v2) im selben Netzwerk
  • Zugriff auf die Taste der Bridge, um IP-Symcon einmalig zu koppeln

Installation

Die Installation erfolgt über den Module Store.

Dokumentation und Changelog

Die Konfiguration, die Variablen und die Funktionen stehen in der README auf GitHub.

Das Changelog steht im zweiten Beitrag dieses Threads.

Spenden

Dieses Modul ist für die nicht kommerzielle Nutzung kostenlos. Schenkungen als Unterstützung für den Autor werden gerne angenommen:

PayPal Amazon Wunschzettel

Wünsche und Rückmeldungen gerne hier im Thread. :slight_smile:

Grüße,
Kai

3 „Gefällt mir“

Changelog

25.10.2026 - Version 2.0.1

Fixes

  • PHUE_setColor begrenzt eine übergebene Helligkeit auf 0 bis 100, weil die Bridge die Anfrage sonst ablehnt und die Farbe nicht setzt.
  • Lehnt die Bridge einen Befehl ab (Fehler 400), steht das jetzt als Warnung mit dem Grund im Log.

19.10.2026 - Version 2.0

Neu

  • Das Modul nutzt die strikte Modul-Basis von IP-Symcon. Achtung: Erforderlich ist jetzt IP-Symcon 9.0 oder neuer.
  • Die Variablen nutzen die nativen Darstellungen von IP-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.
  • Die Szenenauswahl einer Gruppe wird beim Übernehmen der Instanz automatisch gefüllt.
  • Die Konfiguratoren zeigen einen Hinweis, wenn die Bridge nicht verbunden ist.
  • Alle Konfigurationsformulare enthalten den Spendenblock und sind vollständig übersetzt.

Fixes

  • Die Module werden unter aktuellen IP-Symcon-Versionen wieder geladen.
  • Die Debug-Ausgabe der Bridge zeigt den API-Schlüssel nicht mehr.
  • Die Variable „Farbtemperatur Kelvin“ hat jetzt einen deutschen Namen.
  • Falsche deutsche Bezeichnungen sind korrigiert (Getrennt, Unidirektional eingehend, Im Uhrzeigersinn, Gegen den Uhrzeigersinn).
  • Die Beispiele zu PHUE_setColor in der README sind korrigiert (Farbwert als Integer, Helligkeit bis 100).
  • Die Variablenliste hat in allen Formularen eine Überschrift, und der Name der Variable „Status“ beim Temperatursensor ist übersetzt.
  • 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).

28.11.2025 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.
20.06.2023 - Version 1.0.1
Neu: Service relative_rotary
Neu: Funktion getOwnerInfo bei grouped_light
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 IPS_SetVariableCustomProfile 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
15.12.2022 - Version 1.0 (Stable)

06.07.2022 - Version 1.0 (Beta)

Oh wie goil!
Werde morgen testen!
Vlt noch heute aber kann es nicht versprechen.

Dass die hue Tasten und Bewegungsmelder direkt senden ist mein Hauptbegehr weil es das dann auch außerhalb hue super nutzbar macht!

Danke fürs Tag/Nacht um die Ohren schlagen!

Cheers Seppm

Eine Frage

kann man Modul V1 und Modul V2 parallel laufen lassen?

Dann könnte man zug um zug umziehen.

Ja, das sollte gehen.

Grüße,
Kai

1 „Gefällt mir“

Hallo Kai,

danke für die Info.

Beim anlagen Discoverkommt der Fehle.

1 „Gefällt mir“

Kannst du den Fehler mal als Text posten?

Grüße,
Kai

Wenn Du mir sagst wie ich das kann?

Markieren und kopieren geht nicht?

Grüße,
Kai

Hallo Kai,
Herzlichen Dank für deine Mühe. Werde mir mal die V2 parallel zu V1 installieren.

LG
Stefan

Hast du bei der Discovery Instanz auch den Fehler?

Grüße,
Kai

Ich habe es noch nicht installiert, aber bei mir auf dem Proxmox Container gehen eh keine Discovery Instanzen. Nutze verschiedene IP Bereiche.

Nein funktioniert nicht leider

Jetzt sollte die Instanz funktionieren.

Grüße,
Kai

Man sollte den Dialog eigentlich kopieren können.

Grüße,
Kai

Hi Kai,
auf anderem Rechner geht es

Fehler noch da.

Warning: file_get_contents(C:\ProgramData\Symcon\modules\.store\info.schnittcher.ips.philipshue.v2\Discovery/../libs/vendor/SymconModulHelper/DebugHelper.php): failed to open stream: No such file or directory in C:\ProgramData\Symcon\modules\.store\info.schnittcher.ips.philipshue.v2\Discovery\module.php on line 4

Parse error: syntax error, unexpected end of file in C:\ProgramData\Symcon\modules\.store\info.schnittcher.ips.philipshue.v2\Discovery\module.php(4) : eval()'d code on line 1
Abort Processing during Fatal-Error: syntax error, unexpected end of file
   Error in Script C:\ProgramData\Symcon\modules\.store\info.schnittcher.ips.philipshue.v2\Discovery\module.php(4) : eval()'d code on Line 1 (Code: -32603)

noch ein Problem
beim Anlegen Discovery ist nicht ersichtlich welche Version man auswählen muss für V2
da beidei gleich bezeichnet sind.

Dann Frage habe jetzt 3 Discovery der Version 1 angelegt.
Kann ich die einfach wieder löschen?

Alles zurück, funkt jetzt.

Hatte vergessen zu aktualisieren.

Und funktioniert es?

Grüße,
Kai

Anlegen hat alles ohne Fehler funktioniert.
Einlesen habe vor nächste Woche keine Zeit da ich nicht vor Ort bin