In diesem Beitrag binden wir Philips HUE Lampen in openHAB 2 ein, fassen sie in Gruppen zusammen und steuern mehrere Lampen gleichzeitig.

Voraussetzung

Die Philips HUE Lampen müssen bereits mit der HUE App eingerichtet sein:

Tutorial

Philips HUE installieren und einrichten – Schritt für Schritt

Demo-Wohnung

Für diesen Artikel habe ich folgende Lampen in der HUE App eingerichtet:

Schlafzimmer: Schlafzimmer-Lampe (White Ambiance)
Büro: Büro-Lampe (Color) & Büro-LED-Streifen
Wohn-Esszimmer: Esszimmer-Lampe & Wohnzimmer-Lampe

HUE Binding installieren

Im Paper UI von openHAB auf Bindings gehen und nach HUE suchen. Bei HUE Binding auf INSTALL klicken:

openHAB 2 HUE Binding – Binding installieren

Hinweis

Die Installation dauert manchmal etwas länger. Sollte sich nach 5 Minuten nichts geändert haben, Seite oben rechts aktualisieren.

Philips HUE Bridge verbinden

Unter Inbox die gefundene HUE Bridge mit dem blauen Haken bestätigen:

openHAB 2 HUE Binding – Bridge bestätigen

Namen vergeben und auf ADD AS THING klicken:

openHAB 2 HUE Binding – Bridge als Thing hinzufügen

Unter Configuration → Things ist die Bridge jetzt gelistet — aber noch offline:

openHAB 2 HUE Binding – Bridge in Things

Den Knopf auf der Bridge drücken — der Status wechselt innerhalb von Sekunden auf online:

openHAB 2 HUE Binding – Knopf auf der Bridge drücken

HUE Lampen hinzufügen

In der Inbox erscheinen nun alle gefundenen Lampen — ebenfalls mit dem blauen Haken bestätigen:

openHAB 2 HUE Binding – Lampen hinzufügen

Philips HUE Items erstellen

In Visual Studio Code unter Items eine neue Datei hue.items anlegen:

openHAB 2 HUE Binding – hue.items erstellen

Im openHAB VSCode-Addon unter Things die Lampen per Rechtsklick → Create Items from Channel automatisch erstellen lassen:

openHAB 2 HUE Binding – Create Items from Channel

Die Channel-Typen und unterstützten Funktionen findet ihr in der openHAB HUE Binding Dokumentation:

openHAB 2 HUE Binding – openHAB Homepage Channels Liste

Items umbenennen

Die Items werden mit den HUE-App-Namen erstellt. Ich passe diese an — englische Bezeichnungen, HUE_ als Präfix:

java

//Schlafzimmer HUE_Bedroom
Dimmer   HUE_Bedroom_ColorTemperature   "Farbtemperatur"   {channel="hue:0220:00178868dd57:4:color_temperature"}
Dimmer   HUE_Bedroom_Brightness         "Helligkeit"       {channel="hue:0220:00178868dd57:4:brightness"}
String   HUE_Bedroom_Alert              "Alarm"            {channel="hue:0220:00178868dd57:4:alert"}
Switch   HUE_Bedroom_Effect             "Farbeffekt"       {channel="hue:0220:00178868dd57:4:effect"}

//Büro HUE_Office
Color    HUE_Office_Color              "Farbe"            {channel="hue:0210:00178868dd57:8:color"}
Dimmer   HUE_Office_ColorTemperature   "Farbtemperatur"   {channel="hue:0210:00178868dd57:8:color_temperature"}
String   HUE_Office_Alert              "Alarm"            {channel="hue:0210:00178868dd57:8:alert"}
Switch   HUE_Office_Effect             "Farbeffekt"       {channel="hue:0210:00178868dd57:8:effect"}

Color    HUE_OfficeLED_Color              "Farbe"            {channel="hue:0210:00178868dd57:7:color"}
Dimmer   HUE_OfficeLED_ColorTemperature   "Farbtemperatur"   {channel="hue:0210:00178868dd57:7:color_temperature"}
String   HUE_OfficeLED_Alert              "Alarm"            {channel="hue:0210:00178868dd57:7:alert"}
Switch   HUE_OfficeLED_Effect             "Farbeffekt"       {channel="hue:0210:00178868dd57:7:effect"}

//Wohnzimmer HUE_LivingRoom
Color    HUE_LivingRoom_Color              "Farbe"            {channel="hue:0210:00178868dd57:3:color"}
Dimmer   HUE_LivingRoom_ColorTemperature   "Farbtemperatur"   {channel="hue:0210:00178868dd57:3:color_temperature"}
String   HUE_LivingRoom_Alert              "Alarm"            {channel="hue:0210:00178868dd57:3:alert"}
Switch   HUE_LivingRoom_Effect             "Farbeffekt"       {channel="hue:0210:00178868dd57:3:effect"}

//Esszimmer HUE_DiningRoom
Color    HUE_DiningRoom_Color              "Farbe"            {channel="hue:0210:00178868dd57:5:color"}
Dimmer   HUE_DiningRoom_ColorTemperature   "Farbtemperatur"   {channel="hue:0210:00178868dd57:5:color_temperature"}
String   HUE_DiningRoom_Alert              "Alarm"            {channel="hue:0210:00178868dd57:5:alert"}
Switch   HUE_DiningRoom_Effect             "Farbeffekt"       {channel="hue:0210:00178868dd57:5:effect"}

Ein/Aus Switch ergänzen

Lampen mit Color-Channel haben keinen eigenen Switch. Wir legen pro Lampe ein zusätzliches Switch-Item an:

java

Switch  HUE_Bedroom_On   "Ein/Aus"   {channel="hue:0220:00178868dd57:4:brightness"}
Switch  HUE_Office_On    "Ein/Aus"   {channel="hue:0210:00178868dd57:8:color"}
Switch  HUE_OfficeLED_On "Ein/Aus"   {channel="hue:0210:00178868dd57:7:color"}
Switch  HUE_LivingRoom_On "Ein/Aus"  {channel="hue:0210:00178868dd57:3:color"}
Switch  HUE_DiningRoom_On "Ein/Aus"  {channel="hue:0210:00178868dd57:5:color"}

Gruppen anlegen

Pro Lampe eine Gruppe — und der Gruppe den Raum aus der wohnung.items zuweisen:

java

Group   gHUE_Bedroom     "Schlafzimmer Lampe"   <light>  (W_Bedroom)
Switch  HUE_Bedroom_On                  "Ein/Aus"        (gHUE_Bedroom)   {channel="hue:0220:00178868dd57:4:brightness"}
Dimmer  HUE_Bedroom_ColorTemperature    "Farbtemperatur" (gHUE_Bedroom)   {channel="hue:0220:00178868dd57:4:color_temperature"}
Dimmer  HUE_Bedroom_Brightness          "Helligkeit"     (gHUE_Bedroom)   {channel="hue:0220:00178868dd57:4:brightness"}
String  HUE_Bedroom_Alert               "Alarm"          (gHUE_Bedroom)   {channel="hue:0220:00178868dd57:4:alert"}
Switch  HUE_Bedroom_Effect              "Farbeffekt"     (gHUE_Bedroom)   {channel="hue:0220:00178868dd57:4:effect"}

Group   gHUE_LivingRoom  "Wohnzimmer Lampe"    <light>  (W_LivingDining)
Group   gHUE_DiningRoom  "Esszimmer Lampe"     <light>  (W_LivingDining)

openHAB Control

Im Paper UI → Control können die Lampen jetzt bereits gesteuert werden:

openHAB 2 HUE Binding – Lampen im Control-Fenster steuern

Je nach Lampentyp stehen unterschiedliche Regler zur Verfügung. Die Schlafzimmer-Lampe (White Ambiance) hat keinen Farbregler:

openHAB 2 HUE Binding – Lampen ohne Farbeinstellungen

Admin-Sitemap

Da die Lampengruppen den Räumen untergeordnet wurden, erscheinen sie automatisch in der Admin-Sitemap:

User-Sitemap

Im zweiten Teil dieser Reihe erstellen wir die User-Sitemap mit raumübergreifenden Steuerungsmöglichkeiten.

Tutorial

openHAB 2 Philips HUE Binding Teil 2 – Schritt für Schritt

Video zur Anleitung

Häufige Fragen zum HUE Binding in openHAB

Warum bleibt die Bridge nach dem Hinzufügen offline?

Den Knopf auf der Philips HUE Bridge drücken, während die Bridge in openHAB als Thing geöffnet ist. Danach wechselt der Status innerhalb weniger Sekunden auf online.

Woher bekomme ich die Channel-IDs für meine Lampen?

Im VSCode openHAB-Addon unter Things die Lampen anzeigen und per Rechtsklick 'Create Items from Channel' die Items automatisch erstellen lassen. Die Channel-IDs werden dabei automatisch eingefügt.

Warum gibt es keinen Switch-Channel für manche Lampen?

Bei Color-Lampen ist der Ein/Aus-Schalter im Color-Channel integriert, bei White-Ambiance-Lampen im Brightness-Channel. Deshalb legen wir manuell ein Switch-Item an, das auf den jeweiligen Channel verweist.

Muss ich die Räume auch in der HUE App anlegen?

Nein, das ist optional. Ihr könnt die Lampen direkt in openHAB gruppieren. Die HUE App-Räume sind nur nützlich, wenn ihr die App weiterhin parallel nutzen möchtet.

openHAB 2 Philips HUE Binding Teil 1 – Schritt für Schritt

Inhaltsverzeichnis

Voraussetzung

Demo-Wohnung

HUE Binding installieren

Hinweis

Philips HUE Bridge verbinden

HUE Lampen hinzufügen

Philips HUE Items erstellen

Items umbenennen

Ein/Aus Switch ergänzen

Gruppen anlegen

openHAB Control

Admin-Sitemap

User-Sitemap

Video zur Anleitung

Häufige Fragen zum HUE Binding in openHAB