HUE Controller

KNX-Ultimate video tutorials (YouTube playlist)

Alles in einem Node

Ein konsistentes Controller-Erlebnis

• Eine geräteorientierte Hue-Ressourcensuche mit Autovervollständigung und Aktualisierung; die passende Funktion wird automatisch ermittelt.
• Ein Klick oder Fokus auf das Gerätefeld öffnet auch nach einer Auswahl immer die vollständige Hue-Liste; Tippen filtert sie.
• Fähigkeitsabhängige Leuchtenzuordnungen: Dimmen, abstimmbares Weiß, RGB/HSV und native Effekte folgen den Live-Eigenschaften dimming, color_temperature, color und effects der ausgewählten Hue-API-v2-Leuchtenressource.
• Begrenzte Bereitschaftsprüfung im Leuchteneditor: Während die Hue Bridge ihre Ressourcen lädt, erscheint eine animierte Sanduhr; die Prüfung erfolgt alle 500 ms und gibt den Editor nach etwa 10 Sekunden mit einer lokalisierten Fehlermeldung frei. Speichern, Schließen und Funktionswechsel beenden den Timer.
• Kompakte KNX-Zuordnungszeilen halten GA, DPT und Name in einer Zeile; DPT und Name verwenden reduzierte Breiten, wobei sich das Namensfeld in schmalen Editoren ohne Änderung des gespeicherten Werts weiter verkleinern kann. Gespeicherte DPT-Werte bleiben erhalten, während die Auswahloptionen asynchron geladen werden.
• Optionales KNX-Gateway: Gruppenadressen oder importierte ETS-Namen verwenden; passende Datenpunkte liefert das ausgewählte Gateway.
• Profildynamische Node-RED-Anschlüsse für validierte Hue-API-v2-Eingaben und Hue-Ereignisse, sofern unterstützt.
• Startabfrage, Hue→KNX-Statussynchronisation und Schleifenschutz in jedem privaten Profil.
• Vollständig lokale Migration aller fünfzehn veralteten Knotentypen mit anschließendem bearbeitbarem E-Mail-Entwurf, optionaler Unterstützungsschaltfläche in der Abschlussmeldung, lokaler Prüfung und manuellem Deploy.

Start in vier Schritten

1. Die Hue Bridge einmal konfigurieren.
2. HUE Controller hinzufügen und ein Hue-Gerät auswählen oder aktualisieren; der Gerätetyp wird automatisch eingetragen.
3. Ein KNX-Gateway auswählen und Befehle/Zustände zuordnen – oder none für reine Flow-Nutzung belassen.
4. Funktionsspezifisches Verhalten und Anschlüsse festlegen, deployen und den Live-Status prüfen.

Kein KNX-Gateway? Der Controller funktioniert weiterhin als Hue-zu-Node-RED-Integration. KNX-Felder werden ausgeblendet; die von der gewählten Funktion unterstützten Flow-Optionen bleiben verfügbar.

Die folgenden Abschnitte bilden die vollständige, aus den früheren dedizierten Nodes konsolidierte Funktionsreferenz.

Legacy-HUE-Knoten konvertieren

Der Migrationsbutton erscheint nur, wenn der Node-RED-Editor mindestens einen Legacy-HUE-Knoten in den aktuellen Flows erkennt. Ein Link zur Videoanleitung für die Migration auf YouTube steht unmittelbar vor demselben kontrastreichen orangefarbenen Button mit weißer Beschriftung in HUE Controller und jedem Legacy-HUE-Editor. Der Hinweis bestätigt, dass keine Flow- oder Knotendaten den Browser verlassen.

Klicken Sie auf Legacy-HUE-Knoten konvertieren und bestätigen Sie. Der Browser führt die gesamte Konvertierung lokal aus und sendet keinerlei Flow-, Knoten-, hue-config-, knxUltimate-config-, Gruppenadress-, Verbindungs-, Zugangs-, Namens-, Positions- oder Knoten-ID-Daten. Nach erfolgreicher Konvertierung öffnet er nur einen bearbeitbaren E-Mail-Entwurf an den Autor, ohne Node-RED zu verlassen. Der Entwurf enthält nur die Anzahl konvertierter Knoten und Platz für optionale Hinweise; Sie entscheiden über das Senden und automatisch gesendet wird er nie. Die abschließende Node-RED-Meldung bietet eine optionale Unterstützungsschaltfläche; die Spendenseite öffnet sich nur nach einem Klick darauf.

Exportieren Sie vor dem Start eine Sicherung Ihrer Flows. Der Browser schließt den aktuellen Knoteneditor und ändert ausschließlich die erkannten Legacy-HUE-Knoten in HUE-Controller-Instanzen. Gespeicherte Eigenschaften, Konfigurationsreferenzen, Positionen, Gruppenzugehörigkeit und Verbindungen bleiben unverändert. Der Arbeitsbereich wird als geändert markiert, aber nie automatisch deployt: Prüfen Sie das Ergebnis und klicken Sie selbst auf Deploy. Geänderte Knoten, gesperrte Flows oder lokale Konvertierungsfehler lassen den Arbeitsbereich unverändert. Sicherheitsprüfung: Prüfen Sie vor dem Deploy jeden geänderten HUE-Knoten einschließlich Funktion, Konfigurationsreferenzen, Ein-/Ausgangsanschlüssen und Verbindungen. Nach Abschluss bleibt eine feste Node-RED-Meldung sichtbar, bis Sie auf OK klicken.

Hue-Ereignisse bleiben Statusaktualisierungen und werden nicht zu neuen Hue-Befehlen. HUE Controller enthält private Profile für Runtime, Editor, Vorlagen und Übersetzungen und ist daher nicht vom Laden der veralteten Knotentypen abhängig. Der ursprüngliche Hue-Light-Knoten bleibt unverändert. Die dedizierten Hue-Knoten bleiben für bestehende Flows registriert, sind jedoch eingefroren und erhalten keine neuen Funktionen oder Wartungsupdates. Node-RED blendet ihre spezielle Kategorie deprecated aus der Palette aus; vorhandene Instanzen bleiben bearbeitbar und einsatzfähig, verwenden eine hellere Farbe als HUE Controller, sind auf der Arbeitsfläche mit (deprecated) gekennzeichnet und zeigen oben im Editor einen Migrationshinweis.

Gerätefunktion

• Leuchte / Leuchtengruppe (light)
• Steckdose / Ausgang (plug)
• Taster (button)
• Tap dial (relative_rotary)
• Bewegung (motion)
• Bereichsbewegung (area_motion)
• Kamerabewegung (camera_motion)
• Kontakt (contact)
• Lichtstärke (light_level)
• Temperatur (temperature)
• Luftfeuchtigkeit (humidity)
• Szene (scene)
• Batterie (device_power)
• Zigbee-Verbindung (zigbee_connectivity)
• Geräte-Softwareupdate (device_software_update)

Leuchte / Leuchtengruppe (light)

Dieser Node steuert HUE-Leuchten (einzeln oder gruppiert) und ordnet Befehle/Zustände KNX-Gruppenadressen zu.

Allgemein

Gerät lokalisieren

Die Schaltfläche Locate (Play-Symbol) startet eine Hue-Identify-Sitzung für die ausgewählte Ressource. Solange die Sitzung aktiv ist, wechselt der Button auf das Stoppsymbol und die Bridge lässt die Leuchte – oder alle Leuchten der Gruppe – einmal pro Sekunde blinken. Drücke den Button erneut, um sofort zu beenden; andernfalls stoppt die Sitzung automatisch nach 10 Minuten.

Optionen

Hier verknüpfst du KNX-Gruppenadressen mit den verfügbaren HUE-Befehlen/Zuständen.

Im GA-Feld Geräte-Name oder GA eingeben; Vorschläge erscheinen während der Eingabe.

Schalten

Dim

Tunable White

RGB/HSV

Hinweis: Die HSV-Helligkeit “V” wird über die Standard- Dim -Steuerung geregelt.

Effekte

Nicht-Hue-Basiseffekte

Hue-native Effekte

Die Tabelle Hue-native Effekte ordnet KNX-Werte den vom Bridge gemeldeten Effekten zu (z. B. candle, fireplace, prism). Jede Zeile verknüpft einen KNX-Wert (Boolean, Zahl oder Text - je nach Datenpunkt) mit einem Hue-Effekt. Du kannst:

• den gemappten Wert senden, um den Effekt zu aktivieren;
• optional eine Status-GA angeben: der Node liefert beim Effektwechsel den gemappten Wert zurück. Existiert keine Zuordnung, wird der reine Effektname gesendet (benötigt Text-Datenpunkte wie 16.xxx).

Behaviour

Hinweis: Start/Stop-Dimmen im KNX-Modus wird über die üblichen Start/Stop-Telegramme gesteuert.

Steckdose / Ausgang (plug)

Hue Steckdose / Plug

Überblick

Der Hue-Plug-Node verbindet eine Philips-Hue-Steckdose mit KNX-Gruppenadressen:

• Ein/Aus-Steuerung über den KNX-Bus
• Rückmeldung des Zustands direkt aus der Hue-Bridge
• Optionale Übertragung des Parameters power_state

Konfiguration

KNX-Hinweise

• Befehl und Status als DPT 1.xxx definieren.
• power_state auf eine boolesche GA mappen (true = on, false = standby) oder DPT 16.xxx für Klartext nutzen.
• Auf KNX-Leseanforderungen antwortet der Node mit dem letzten bekannten Hue-Wert.

Flow-Integration

Mit aktivierten Pins:

• Input: Hue v2 Payloads senden (z. B. { on: { on: true } }).
• Output: { payload, on, power_state, rawEvent } für jedes Hue-Ereignis.

Hue API

Die Kommunikation erfolgt über /resource/plug/{id}. Änderungen werden über den Event-Stream empfangen und für KNX beibehalten.

Taster (button)

Der Hue-Taster-Node spiegelt Hue-Taster-Ereignisse auf KNX und den Flow-Ausgang und nutzt das Attribut button.button_report.event.

Tippen Sie im GA-Feld (Name oder Gruppenadresse), um die KNX-GA zu verknüpfen; passende Einträge erscheinen während der Eingabe.

Allgemein

Schalten

Dimmen

Verhalten

Ausgänge

1. Standardausgang

   msg.payload enthält den boolean/dimm-Payload; msg.event die Hue-Ereignis-Zeichenfolge (z. B. short_release, repeat).

Details

msg.event entspricht button.button_report.event. Das originale Hue-Ereignis steht in msg.rawEvent. Nutzen Sie die optionale Status-GA, um den Toggle-Zustand mit anderen Schaltern zu synchronisieren.

Tap dial (relative_rotary)

Der Hue Tap Dial -Node verknüpft den Rotationsdienst des Tap Dial mit KNX und gibt das unveränderte Hue-Ereignis an Ihren Flow weiter. Nach dem Koppeln eines neuen Tap Dial verwenden Sie bitte das Refresh-Symbol neben dem Geräteeingabefeld.

Reiter

• Zuordnung - Wählen Sie GA und DPT für die Rotationsereignisse (unterstützt DPT 3.007, 5.001 und 232.600).
• Verhalten - Blendet den Node-RED-Ausgang ein oder aus. Ohne KNX-Gateway bleibt der Ausgang erzwungen aktiv, damit Hue-Ereignisse weiterhin den Flow erreichen.

Allgemeine Einstellungen

Reiter Zuordnung

Ausgänge

ℹ️ KNX-bezogene Steuerelemente erscheinen erst nach Auswahl eines KNX-Gateways; der Zuordnung-Reiter bleibt verborgen, bis sowohl Bridge als auch Gateway konfiguriert sind.

Bewegung (motion)

Dieser Node empfängt Bewegungsereignisse eines Hue-Bewegungssensors und leitet sie an KNX bzw. den Node-RED-Flow weiter.

Im GA-Feld den KNX-Gerätenamen oder die Gruppenadresse eingeben; beim Tippen erscheinen Vorschläge. Über das Aktualisieren-Symbol neben “Hue Sensor” lässt sich die Geräteliste der Hue-Bridge neu laden.

Allgemein

Zuordnung

Verhalten

ℹ️ Die KNX-Felder werden erst sichtbar, nachdem ein KNX-Gateway gewählt wurde - praktisch, wenn der Node nur als Hue → Node-RED Listener dient.

Ausgang

1. Standardausgang — msg.payload (boolean)

   true bei Bewegung, false sobald sie endet.

Bereichsbewegung (area_motion)

Der Hue Motion Area Node lauscht auf MotionAware-Bereichsereignisse (Hue Bridge Pro) und spiegelt den aggregierten Bewegungsstatus (Bewegung / keine Bewegung) nach KNX bzw. in Ihren Node-RED-Flow.

Geben Sie im GA-Feld den KNX-Gerätenamen oder die Gruppenadresse ein; passende Vorschläge erscheinen während der Eingabe.

Allgemein

Zuordnung

Verhalten

Ausgang

1. Standardausgang

   msg.payload (Boolean): true, wenn im Bereich Bewegung erkannt wird, sonst false.

Details

msg.payload enthält den von MotionAware gelieferten, aggregierten Bewegungsstatus des ausgewählten Bereichs.

Kamerabewegung (camera_motion)

Der Hue Camera Motion Node lauscht auf Bewegungsereignisse der Philips-Hue-Kameras und spiegelt den erkannt/nicht-erkannt-Status in KNX.

Geben Sie im GA-Feld (Name oder Gruppenadresse) den gewünschten Wert ein; passende Geräte werden während der Eingabe vorgeschlagen.

Allgemein

Zuordnung

Ausgaben

1. Standardausgang

   msg.payload (Boolean): true, wenn Bewegung erkannt wird, sonst false

Details

msg.payload enthält den zuletzt vom Hue-Kameraservice gemeldeten Bewegungsstatus.

Kontakt (contact)

Dieser Node leitet Ereignisse eines HUE-Kontaktsensors weiter und ordnet sie KNX-Gruppenadressen zu.

Tippen Sie in das Feld GA, die Name oder die Gruppenadresse Ihres KNX -Geräts, die avabaren Geräte werden beim Eingeben angezeigt.

Allgemein

Ausgänge

1. Standardausgabe

   Nutzlast (Boolean): Die Standardausgabe des Befehls.

Details

msg.payload enthält das HUE-Ereignis (Boolean/Objekt) für eigene Logik.

Lichtstärke (light_level)

Dieser Node liest Lux-Ereignisse eines HUE-Lichtsensors und spiegelt sie nach KNX.

Es wird die Umgebungshelligkeit (Lux) bei Änderungen ausgegeben. Im GA-Feld den KNX-Gerätenamen oder die GA eingeben (Autocomplete), um die GA zu verknüpfen.

Allgemein

Zuordnung

Ausgänge

1. Standardausgang

   payload (number): aktueller Lux-Wert

Details

msg.payload enthält den numerischen Lux-Wert.

Temperatur (temperature)

Dieser Node liest die Temperatur (°C) eines HUE-Temperatursensors und spiegelt sie nach KNX.

Beginnen Sie im GA-Feld (Name oder Gruppenadresse) zu tippen, um die KNX-GA zu verknüpfen; Geräte werden während der Eingabe vorgeschlagen.

Allgemein

Mapping

Ausgänge

1. Standardausgang

   msg.payload (number): aktuelle Temperatur in °C

Details

msg.payload enthält den numerischen Temperaturwert.

Luftfeuchtigkeit (humidity)

Dieser Knoten liest die relative Luftfeuchtigkeit (%) von einem HUE-Sensor und überträgt sie auf KNX.

Beginne im GA-Feld (Name oder Gruppenadresse) zu tippen, um die KNX-GA zu verknüpfen; während der Eingabe werden passende Geräte angezeigt.

Allgemein

Zuordnung

Ausgänge

1. Standardausgang

   msg.payload (Zahl): aktuelle relative Luftfeuchtigkeit in %

Details

msg.payload enthält den numerischen Luftfeuchtigkeitswert (Prozentangabe).

Szene (scene)

Der Hue Scene -Node stellt Hue-Szenen per KNX bereit und kann die Rohereignisse an Ihren Node-RED-Flow weitergeben. Das Feld “Hue Szene” besitzt Autovervollständigung; verwenden Sie nach dem Anlegen neuer Szenen das Aktualisierungssymbol, damit die Liste aktuell bleibt.

Überblick über die Reiter

• Zuordnung - Verknüpft KNX-Gruppenadressen mit der ausgewählten Hue-Szene. DPT 1.xxx sendet boolesche Werte, DPT 18.xxx überträgt eine KNX-Szenennummer.
• Mehrfachszene - Erstellt eine Liste von Regeln, die KNX-Szenennummern verschiedenen Hue-Szenen und Abrufarten (active, dynamic_palette, static) zuordnet.
• Verhalten - Blendet den Node-RED-Ausgang ein oder aus. Ohne konfiguriertes KNX-Gateway bleibt der Ausgang aktiv, damit Bridge-Ereignisse weiterhin im Flow landen.

Allgemeine Einstellungen

Reiter Zuordnung

Reiter Mehrfachszene

ℹ️ KNX-spezifische Bedienelemente erscheinen erst nach Auswahl eines KNX-Gateways. Die Mapping-Reiter bleiben verborgen, bis sowohl Bridge als auch Gateway konfiguriert sind.

Batterie (device_power)

Dieser Node spiegelt den Batteriestand eines Hue-Geräts nach KNX und löst Ereignisse aus, sobald sich der Wert ändert.

Im GA-Feld den KNX-Gerätenamen oder die Gruppenadresse eingeben; beim Tippen erscheinen Vorschläge. Über das Aktualisieren-Symbol neben “Hue Sensor” lässt sich die Geräteliste der Hue-Bridge neu laden.

Allgemein

Zuordnung

Verhalten

ℹ️ Die KNX-Mapping-Felder bleiben ausgeblendet, bis ein KNX-Gateway gewählt wurde - ideal, wenn der Node nur als Hue → Node-RED Ereignisquelle dient.

Zigbee-Verbindung (zigbee_connectivity)

Dieser Node liest den Zigbee-Konnektivitätsstatus eines HUE-Geräts und spiegelt ihn nach KNX.

Gib im GA-Feld den Gerätenamen oder die Gruppenadresse ein; beim Tippen erscheinen Vorschläge.

Allgemein

Zuordnung

Ausgänge

1. Standardausgang

   payload (boolean): Konnektivitätszustand.

Details

msg.payload ist true/false.
msg.status ist Text: connected, disconnected, connectivity_issue, unidirectional_incoming .

Geräte-Softwareupdate (device_software_update)

Dieser Node überwacht, ob ein HUE-Gerät ein Software-Update hat, und spiegelt den Status nach KNX.

Geben Sie den Namen oder die Gruppenadresse Ihres KNX -Geräts im Feld GA ein. Sie tippen.

Allgemein

Zuordnung

Ausgänge

1. Standardausgang

   payload (boolean): Update-Flag.

   status (string): no_update, update_pending, ready_to_install, installing .