node-red-contrib-knx-ultimate 6.2.2 → 6.2.3-beta.0

package/nodes/locales/de/knxUltimateHueController.html

@@ -0,0 +1,669 @@
+<script type="text/markdown" data-help-name="knxUltimateHueController">
+<p><a href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E" target="_blank" rel="noopener noreferrer"><strong>KNX-Ultimate video tutorials (YouTube playlist)</strong></a></p>
+<p><strong>HUE Controller</strong> ist der einheitliche Knoten für Hue-API-v2-Ressourcen.</p>
+<p>Wählen Sie die Gerätefunktion und konfigurieren Sie anschließend dieselbe KNX-Zuordnung und dasselbe Verhalten wie im bewährten dedizierten Hue-Knoten.</p>
+<p>Die Auswahl der Gerätefunktion verwendet ein Drittel der verfügbaren Breite, damit der Editor kompakt bleibt.</p>
+<p>KNX-Zuordnungszeilen halten GA, DPT und Name in einer Zeile. DPT-Auswahl und Namensfeld verwenden kompakte Breiten; das Namensfeld kann sich in schmalen Editoren weiter verkleinern, ohne den gespeicherten Text zu ändern.</p>
+<p>Unterstützt werden Leuchten und Leuchtengruppen, Steckdosen, Taster, Tap dial, Bewegungs- und Kamerabewegungsressourcen, Kontakte, Lichtstärke, Temperatur, Luftfeuchtigkeit, Szenen, Batterie, Zigbee-Verbindung und Softwareupdate.</p>
+<p>Wenn kein <strong>KNX-Gateway</strong> ausgewählt ist (einschließlich <code>none</code> und <em>Neu hinzufügen...</em>), werden die KNX-Zuordnungsfelder ausgeblendet; die Auswahl der Hue-Ressource und reine Flow-Optionen bleiben verfügbar.</p>
+<p>Bei einer einzelnen Leuchte richten sich die Bereiche <strong>Dimmen</strong>, <strong>Abstimmbares Weiß</strong>, <strong>RGB/HSV</strong> und native Effekte nach den Live-Fähigkeiten der ausgewählten Hue-API-v2-Ressource. Die zugehörigen KNX-Zuordnungen erscheinen automatisch, wenn die Leuchte <code>dimming</code>, <code>color_temperature</code> oder <code>color</code> bereitstellt.</p>
+<p>Während die Hue Bridge ihre Ressourcen lädt, zeigt der Leuchteneditor eine animierte Sanduhr und prüft die Bereitschaft alle 500 ms. Nach etwa 10 Sekunden wird der Editor freigegeben, die Zuordnungsregister bleiben verborgen und ein lokalisierter Fehler wird angezeigt. Speichern, Schließen oder ein Funktionswechsel beendet die ausstehende Wartezeit.</p>
+<p>Wenn ein Gateway ausgewählt ist, akzeptieren die Zuordnungsfelder eine KNX-Gruppenadresse oder einen importierten ETS-Namen; passende Datenpunkte werden von diesem Gateway geladen.</p>
+<p>Der Migrationsbutton wird nur angezeigt, wenn der Node-RED-Editor mindestens einen Legacy-HUE-Knoten in den aktuellen Flows erkennt. Derselbe orange Button steht auch direkt unter dem Deprecated-Hinweis in jedem Legacy-HUE-Editor bereit. Diese Prüfung ist schreibgeschützt; die Konvertierung verwendet weiterhin ausschließlich das vom Benutzer eingefügte JSON.</p>
+<p><strong>Legacy-HUE-Flow konvertieren</strong> akzeptiert einen vollständigen Node-RED-Flow-Export und liefert kopierbares JSON, in dem jeder unterstützte Legacy-HUE-Knoten durch HUE Controller ersetzt ist. Die Konvertierung erfolgt lokal und behält IDs, Konfigurationsreferenzen, Eigenschaften, Positionen und Verbindungen bei; der geöffnete Flow wird nicht verändert.</p>
+<p>Node-RED schließt Zugangsdaten absichtlich aus Flow-Exporten aus. Lassen Sie beim Import in dieselbe Installation <strong>Vorhandene Hue- und KNX-Konfigurationsknoten wiederverwenden</strong> aktiviert: Die referenzierten Konfigurationsobjekte werden ausgelassen, ihre IDs bleiben jedoch in den konvertierten Knoten erhalten, sodass vorhandene Schlüssel und Passwörter unverändert bleiben. Deaktivieren Sie die Option nur für eine andere Installation und geben Sie dort die Zugangsdaten nach dem Import erneut ein.</p>
+<p><strong>Konvertierten Flow kopieren</strong> verwendet die Clipboard API des Browsers und als Fallback ein temporäres Textfeld. Wenn beide Methoden blockiert werden, wird das Ausgabe-JSON für das manuelle Kopieren markiert.</p>
+<p>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 <code>deprecated</code> aus der Palette aus; vorhandene Instanzen bleiben bearbeitbar und einsatzfähig, verwenden eine hellere Farbe als HUE Controller, sind auf der Arbeitsfläche mit <code>(deprecated)</code> gekennzeichnet und zeigen oben im Editor einen Migrationshinweis.</p>
+
+<!-- HUE_CONTROLLER_PROFILE_HELP_START -->
+
+## Gerätefunktion
+
+- [Leuchte / Leuchtengruppe (`light`)](#hue-controller-help-light)
+- [Steckdose / Ausgang (`plug`)](#hue-controller-help-plug)
+- [Taster (`button`)](#hue-controller-help-button)
+- [Tap dial (`relative_rotary`)](#hue-controller-help-relative_rotary)
+- [Bewegung (`motion`)](#hue-controller-help-motion)
+- [Bereichsbewegung (`area_motion`)](#hue-controller-help-area_motion)
+- [Kamerabewegung (`camera_motion`)](#hue-controller-help-camera_motion)
+- [Kontakt (`contact`)](#hue-controller-help-contact)
+- [Lichtstärke (`light_level`)](#hue-controller-help-light_level)
+- [Temperatur (`temperature`)](#hue-controller-help-temperature)
+- [Luftfeuchtigkeit (`humidity`)](#hue-controller-help-humidity)
+- [Szene (`scene`)](#hue-controller-help-scene)
+- [Batterie (`device_power`)](#hue-controller-help-device_power)
+- [Zigbee-Verbindung (`zigbee_connectivity`)](#hue-controller-help-zigbee_connectivity)
+- [Geräte-Softwareupdate (`device_software_update`)](#hue-controller-help-device_software_update)
+
+<span id="hue-controller-help-light" data-hue-controller-type="light"></span>
+
+## Leuchte / Leuchtengruppe (`light`)
+
+<p>Dieser Node steuert HUE-Leuchten (einzeln oder gruppiert) und ordnet Befehle/Zustände KNX-Gruppenadressen zu.</p>
+
+**Allgemein**
+
+| Eigenschaft | Beschreibung |
+|--|--|
+| KNX-Gateway | Zu verwendendes KNX-Gateway |
+| Hue Bridge | Zu verwendende Hue Bridge |
+| Name | HUE-Leuchte oder -Gruppe (Autocomplete während der Eingabe) |
+
+<br/>
+
+**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.
+
+<br/>
+
+**Optionen**
+
+Hier verknüpfst du KNX-Gruppenadressen mit den verfügbaren HUE-Befehlen/Zuständen.<br/>
+Im GA-Feld Geräte-Name oder GA eingeben; Vorschläge erscheinen während der Eingabe.
+
+**Schalten**
+
+| Eigenschaft | Beschreibung |
+|--|--|
+| Control | KNX-GA zum Ein/Aus (Boolean true/false) |
+| Status | GA für Schalt-Status |
+
+<br/>
+
+**Dim**
+
+| Eigenschaft | Beschreibung |
+|--|--|
+| Control dim | Relatives Dimmen der Leuchte (Geschwindigkeit in **Behaviour** ) |
+| Control % | Absolute Helligkeit (0-100 %) |
+| Status % | GA für Helligkeits-Status |
+| Dim Speed (ms) | Dimmgeschwindigkeit in Millisekunden; gilt für Helligkeit und Tunable-White (Berechnung 0 %→100 %) |
+| Min Dim brightness | Untere Helligkeitsgrenze (Stoppt das Dimmen bei diesem %) |
+| Max Dim brightness | Obere Helligkeitsgrenze |
+
+<br/>
+
+**Tunable White**
+
+| Eigenschaft | Beschreibung |
+|--|--|
+| Control dim | Weißtemperatur relativ dimmen (DPT 3.007), Geschwindigkeit in **Behaviour** |
+| Control % | Weißtemperatur mit DPT 5.001; 0 = warm, 100 = kalt |
+| Status % | GA für Temperatur-Status (DPT 5.001; 0 = warm, 100 = kalt) |
+| Control kelvin | **DPT 7.600: ** Kelvin im KNX-Bereich 2000-6535 (Konvertierung nach HUE mirek).<br/>**DPT 9.002:** Kelvin im HUE-Bereich 2000-6535 K (Ambiance ab 2200 K). Kleine Abweichungen durch Konvertierung möglich |
+| Status kelvin | **DPT 7.600: ** Kelvin lesen (KNX-Bereich 2000-6535, konvertiert).<br/>**DPT 9.002:** Kelvin lesen (HUE-Bereich 2000-6535 K). Kleine Abweichungen möglich |
+| Invert dim direction | Dimmrichtung invertieren |
+
+<br/>
+
+**RGB/HSV**
+
+| Eigenschaft | Beschreibung |
+|--|--|
+| **RGB-Abschnitt** ||
+| Control rgb | Farbe setzen per RGB-Tripel (r,g,b), inkl. Gamut-Korrektur. Farb-Telegramm schaltet die Leuchte ein (Farbe/Helligkeit); r,g,b=0 schaltet aus |
+| Status rgb | GA für Farb-Status (RGB-Tripel) |
+| **HSV-Abschnitt** ||
+| Color H dim | Durch HSV-Farbkreis (Hue) dimmen (DPT 3.007), Geschwindigkeit in **Behaviour** |
+| Status H % | Status des Hue-Werts |
+| Control S dim | Sättigung dimmen (DPT 3.007), Geschwindigkeit in **Behaviour** |
+| Status S % | GA für Sättigungs-Status |
+| Dim Speed (ms) | Dimmgeschwindigkeit (unten→oben) |
+
+Hinweis: Die HSV-Helligkeit "V" wird über die Standard- **Dim** -Steuerung geregelt.
+
+<br/>
+
+**Effekte**
+
+_Nicht-Hue-Basiseffekte_
+
+| Eigenschaft | Beschreibung |
+|--|--|
+| Blink | _true_ = blinken, _false_ = stoppen. Lässt die Leuchte ein/aus blinken - ideal zum Signalisieren. Funktioniert mit allen HUE-Leuchten. |
+| Color Cycle | _true_ = Start, _false_ = Stopp. Zufälliger Farbwechsel in Intervallen (nur für farbfähige Leuchten). Der Effekt startet ca. 10 s nach dem Kommando. |
+
+_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).
+
+<br/>
+
+**Behaviour**
+
+| Eigenschaft | Beschreibung |
+|--|--|
+| Read status at startup | Beim Start/Voll-Deploy Status aus HUE lesen und an KNX ausgeben |
+| KNX brightness status | Verhalten der Helligkeits-Status-GA bei Ein/Aus (0 % senden und letzten Wert wiederherstellen vs. "as is") |
+| Lokalen Hue-Cache durch KNX-Bus-Schreibtelegramme aktualisieren | Erweiterte Option, standardmaessig aktiviert. Wenn aktiv, aktualisieren Schreibtelegramme vom KNX-Bus sofort auch den lokal gecachten Hue-Zustand des Nodes, ohne auf Feedback/Ereignisse der Hue Bridge zu warten. Das sorgt fuer schnellere lokale Reaktionen und konsistentere sofortige KNX-Leseantworten, besonders wenn Leuchte oder Gruppe AUS sind. Deaktivieren Sie die Option, wenn der Cache nur echten Rueckmeldungen/Ereignissen der Hue Bridge folgen soll. |
+| On behaviour | Verhalten beim Einschalten (Farbe wählen / Temperatur+Helligkeit wählen / none) |
+| Night lighting | Nacht-Profil (Farbe oder Temperatur/Helligkeit) |
+| Day/Night | GA zur Umschaltung Tag/Nacht (_true_ = Tag, _false_ = Nacht) |
+| Invert Day/Night | Wert der Tag/Nacht-GA invertieren |
+| Node I/O pins | Ein/Ausblenden der Eingangs/Ausgangs-Pins; Input folgt HUE API v2 (z. B. <code>msg.on = { on: true }</code>) |
+
+Hinweis: Start/Stop-Dimmen im KNX-Modus wird über die üblichen Start/Stop-Telegramme gesteuert.
+
+<br/>
+
+---
+
+<span id="hue-controller-help-plug" data-hue-controller-type="plug"></span>
+
+## 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
+
+|Feld|Beschreibung|
+|--|--|
+| KNX-Gateway | Verwendetes KNX-Gateway |
+| Hue Bridge | Konfigurierte Hue Bridge |
+| Name | Hue-Steckdose auswählen (Autocomplete) |
+| Befehl | KNX-GA für Ein/Aus (Boolean-DPT) |
+| Status | GA für die Rückmeldung des Hue-Ein/Aus-Zustands |
+| Power state | Optionale GA für den Hue-Parameter `power_state` (on/standby) |
+| Status beim Start lesen | Sendet beim Deploy den aktuellen Zustand |
+| Node I/O Pins | Aktiviert Node-RED-Ein/Ausgänge für eigene Hue-Payloads bzw. Ereignisse |
+
+#### 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.
+
+---
+
+<span id="hue-controller-help-button" data-hue-controller-type="button"></span>
+
+## Taster (`button`)
+
+<p>Der Hue-Taster-Node spiegelt Hue-Taster-Ereignisse auf KNX und den Flow-Ausgang und nutzt das Attribut <code>button.button_report.event</code>.</p>
+
+Tippen Sie im GA-Feld (Name oder Gruppenadresse), um die KNX-GA zu verknüpfen; passende Einträge erscheinen während der Eingabe.
+
+**Allgemein**
+
+|Eigenschaft|Beschreibung|
+|--|--|
+| KNX-Gateway | Zu verwendendes KNX-Gateway |
+| Hue Bridge | Zu verwendende Hue Bridge |
+| Hue-Taster | Zu verwendender Hue-Taster (Autovervollständigung) |
+
+**Schalten**
+
+|Eigenschaft|Beschreibung|
+|--|--|
+| Schalter | GA, die vom Ereignis <code>short\_release</code> ausgelöst wird (kurzer Druck). |
+| Status-GA | Optionale Rückmelde-GA, wenn <em>Werte toggeln</em> aktiv ist; hält den internen Zustand synchron. |
+
+**Dimmen**
+
+|Eigenschaft|Beschreibung|
+|--|--|
+| Dimmen | GA für <code>long\_press</code>/<code>repeat</code>-Ereignisse beim Dimmen (typischerweise DPT 3.007). |
+
+**Verhalten**
+
+|Eigenschaft|Beschreibung|
+|--|--|
+| Werte toggeln | Schaltet automatisch zwischen <code>true/false</code> und Dimmen hoch/runter. |
+| Schalt-Payload | Payload, der bei deaktiviertem Toggle an KNX/Flow gesendet wird. |
+| Dim-Payload | Richtung, die bei deaktiviertem Toggle an KNX/Flow gesendet wird. |
+
+##### 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.
+
+---
+
+<span id="hue-controller-help-relative_rotary" data-hue-controller-type="relative_rotary"></span>
+
+## 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
+
+| Eigenschaft | Beschreibung |
+|--|--|
+| KNX-Gateway | KNX-Gateway, das für die Autovervollständigung der GA verwendet wird. |
+| Hue Bridge | Hue Bridge, die das Tap Dial bereitstellt. |
+| Hue Tap Dial | Drehgerät, das gesteuert wird (Autocomplete; Refresh lädt die Liste neu). |
+
+##### Reiter Zuordnung
+
+| Eigenschaft | Beschreibung |
+|--|--|
+| Dreh-GA | KNX-GA für die Rotationsereignisse (DPT 3.007, 5.001 oder 232.600). |
+| Name | Beschreibung der GA. |
+
+##### Ausgänge
+
+|#|Port|Payload|
+|--|--|--|
+|1|Standardausgang|`msg.payload` (Objekt) Rohes Hue-Ereignis des Tap Dial.|
+
+> ℹ️ KNX-bezogene Steuerelemente erscheinen erst nach Auswahl eines KNX-Gateways; der Zuordnung-Reiter bleibt verborgen, bis sowohl Bridge als auch Gateway konfiguriert sind.
+
+---
+
+<span id="hue-controller-help-motion" data-hue-controller-type="motion"></span>
+
+## Bewegung (`motion`)
+
+<p>Dieser Node empfängt Bewegungsereignisse eines Hue-Bewegungssensors und leitet sie an KNX bzw. den Node-RED-Flow weiter.</p>
+
+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**
+
+| Eigenschaft | Beschreibung |
+|--|--|
+| KNX-Gateway | KNX-Gateway, das die Bewegungszustände erhält (erforderlich, damit die KNX-Optionen angezeigt werden). |
+| Hue Bridge | Hue Bridge, auf der der Sensor liegt. |
+| Hue-Bewegungssensor | Hue-Bewegungssensor (unterstützt Autovervollständigung und Refresh). |
+
+**Zuordnung**
+
+| Eigenschaft | Beschreibung |
+|--|--|
+| Bewegung | KNX-GA, die bei Bewegung `true` und sonst `false` erhält. Empfohlener DPT: <b>1.001</b>. |
+
+**Verhalten**
+
+| Eigenschaft | Beschreibung |
+|--|--|
+| Node-Ausgangspin | Node-RED-Ausgang ein-/ausblenden. Ohne KNX-Gateway bleibt der Ausgang aktiv, damit Hue-Ereignisse weiterhin den Flow erreichen. |
+
+> ℹ️ 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.
+
+---
+
+<span id="hue-controller-help-area_motion" data-hue-controller-type="area_motion"></span>
+
+## Bereichsbewegung (`area_motion`)
+
+<p>Der Hue Bewegungsbereich-Node lauscht auf MotionAware-Bereichsereignisse (Hue Bridge Pro) und spiegelt den aggregierten Bewegung / keine-Bewegung-Status nach KNX bzw. in Ihren Node-RED-Flow.</p>
+
+Geben Sie im GA-Feld (Name oder Gruppenadresse) die gewünschte KNX-GA ein; passende Einträge werden während der Eingabe vorgeschlagen.
+
+**Allgemein**
+
+|Eigenschaft|Beschreibung|
+|--|--|
+| KNX GW | Zu verwendendes KNX-Gateway, das den Bewegungsstatus erhält. |
+| Hue Bridge | Zu verwendende Hue Bridge Pro. |
+| Hue Bereich | Zu überwachender MotionAware-Bereich (Convenience oder Security, mit Autovervollständigung). |
+| Status beim Start auslesen | Liest beim Start/bei Wiederverbindung den aktuellen Wert und sendet ihn an KNX (Standard: ja). |
+
+**Zuordnung**
+
+|Eigenschaft|Beschreibung|
+|--|--|
+| Bewegung | KNX-GA für den Bewegungsstatus des Bereichs (Boolean). Empfohlener DPT: <b>1.001</b>. |
+
+**Verhalten**
+
+|Eigenschaft|Beschreibung|
+|--|--|
+| Node-Ausgangspin | Node-RED-Ausgang ein-/ausblenden. Ohne KNX-Gateway bleibt der Ausgang aktiv, damit MotionAware-Ereignisse weiterhin den Flow erreichen. |
+
+##### Ausgänge
+
+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.
+
+---
+
+<span id="hue-controller-help-camera_motion" data-hue-controller-type="camera_motion"></span>
+
+## Kamerabewegung (`camera_motion`)
+
+<p>Der Hue Camera Motion Node lauscht auf Bewegungsereignisse der Philips-Hue-Kameras und spiegelt den erkannt/nicht-erkannt-Status in KNX.</p>
+
+Geben Sie im GA-Feld (Name oder Gruppenadresse) den gewünschten Wert ein; passende Geräte werden während der Eingabe vorgeschlagen.
+
+**Allgemein**
+
+|Eigenschaft|Beschreibung|
+|--|--|
+| KNX Gateway | Zu verwendendes KNX-Gateway auswählen |
+| Hue Bridge | Zu verwendende Hue Bridge auswählen |
+| HUE Kamerabewegung | Hue-Kamera-Bewegungssensor (Autovervollständigung während der Eingabe) |
+| Status beim Start auslesen | Liest beim Start/bei Wiederverbindung den aktuellen Wert und sendet ihn an KNX (Standard: nein) |
+
+**Zuordnung**
+
+|Eigenschaft|Beschreibung|
+|--|--|
+| Bewegung | KNX-GA für die Kamerabewegung (Boolean). Empfohlener DPT: <b>1.001</b> |
+
+##### 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.
+
+---
+
+<span id="hue-controller-help-contact" data-hue-controller-type="contact"></span>
+
+## Kontakt (`contact`)
+
+<p>Dieser Node leitet Ereignisse eines HUE-Kontaktsensors weiter und ordnet sie KNX-Gruppenadressen zu.</p>
+
+Tippen Sie in das Feld GA, die Name oder die Gruppenadresse Ihres KNX -Geräts, die avabaren Geräte werden beim Eingeben angezeigt.
+
+**Allgemein**
+
+| Eigenschaft | Beschreibung |
+|-|-|
+|KNX-Gateway |Wählen Sie das zu verwendende KNX -Gateway |
+|Hue Bridge |Wählen Sie die zu verwendende Hue Bridge aus |
+| Hue-Kontaktsensor | Zu verwendender HUE-Kontaktsensor (Autocomplete) |
+
+|Eigenschaft |Beschreibung |
+|-------- |------------------------------------------------------------------------------------------------------------------ |
+| Kontakt | Bei Öffnen/Schließen senden: _true_ (aktiv/offen), sonst _false_ |
+
+##### Ausgänge
+
+1. Standardausgabe
+   : Nutzlast (Boolean): Die Standardausgabe des Befehls.
+
+##### Details
+
+`msg.payload` enthält das HUE-Ereignis (Boolean/Objekt) für eigene Logik.
+
+---
+
+<span id="hue-controller-help-light_level" data-hue-controller-type="light_level"></span>
+
+## Lichtstärke (`light_level`)
+
+<p>Dieser Node liest Lux-Ereignisse eines HUE-Lichtsensors und spiegelt sie nach KNX.</p>
+
+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**
+
+| Eigenschaft | Beschreibung |
+|-|-|
+|KNX-Gateway |Wählen Sie das zu verwendende KNX -Gateway |
+|Hue Bridge |Wählen Sie die zu verwendende Hue Bridge aus |
+| Hue Lichtsensor | Zu verwendender HUE-Lichtsensor (Autocomplete) |
+|Status bei Startup lesen |Lesen Sie den Status beim Start und geben Sie das Ereignis bei Startup/Wiederverbindung an den KNX -Bus aus.(Standard "nein") |
+
+**Zuordnung**
+
+| Eigenschaft | Beschreibung |
+|--|--|
+| Lux | KNX-GA, die den Lux-Wert erhält |
+
+##### Ausgänge
+
+1. Standardausgang
+   : payload (number): aktueller Lux-Wert
+
+##### Details
+
+`msg.payload` enthält den numerischen Lux-Wert.
+
+---
+
+<span id="hue-controller-help-temperature" data-hue-controller-type="temperature"></span>
+
+## Temperatur (`temperature`)
+
+<p>Dieser Node liest die Temperatur (°C) eines HUE-Temperatursensors und spiegelt sie nach KNX.</p>
+
+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**
+
+| Eigenschaft | Beschreibung |
+|--|--|
+| KNX-Gateway | Zu verwendendes KNX-Gateway |
+| Hue Bridge | Zu verwendende Hue Bridge |
+| Hue-Temperatursensor | HUE-Temperatursensor (Autocomplete während der Eingabe) |
+| Status beim Start lesen | Beim Start/Wiederverbindung aktuellen Wert lesen und auf KNX senden (Standard: nein) |
+
+**Mapping**
+
+| Eigenschaft | Beschreibung |
+|--|--|
+| Temperatur | KNX-GA für Temperatur in °C. Empfohlener DPT: <b>9.001</b> |
+
+##### Ausgänge
+
+1. Standardausgang
+   : `msg.payload` (number): aktuelle Temperatur in °C
+
+##### Details
+
+`msg.payload` enthält den numerischen Temperaturwert.
+
+---
+
+<span id="hue-controller-help-humidity" data-hue-controller-type="humidity"></span>
+
+## Luftfeuchtigkeit (`humidity`)
+
+<p>Dieser Knoten liest die relative Luftfeuchtigkeit (%) von einem HUE-Sensor und überträgt sie auf KNX.</p>
+
+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**
+
+|Eigenschaft|Beschreibung|
+|--|--|
+| KNX Gateway | Das zu verwendende KNX-Gateway auswählen |
+| Hue Bridge | Die zu verwendende Hue Bridge auswählen |
+| HUE Sensor | HUE-Luftfeuchtigkeitssensor (Auto-Vervollständigung beim Tippen) |
+| Status beim Start auslesen | Beim Start/Reconnect den aktuellen Wert lesen und auf KNX senden (Standard: Nein) |
+
+**Zuordnung**
+
+|Eigenschaft|Beschreibung|
+|--|--|
+| Luftfeuchtigkeit | KNX-GA für die relative Luftfeuchtigkeit %. Empfohlener DPT: <b>9.007</b> |
+
+##### Ausgänge
+
+1. Standardausgang
+   : `msg.payload` (Zahl): aktuelle relative Luftfeuchtigkeit in %
+
+##### Details
+
+`msg.payload` enthält den numerischen Luftfeuchtigkeitswert (Prozentangabe).
+
+---
+
+<span id="hue-controller-help-scene" data-hue-controller-type="scene"></span>
+
+## 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
+
+| Eigenschaft | Beschreibung |
+|--|--|
+| KNX-Gateway | KNX-Gateway mit dem Adresskatalog für das Autocomplete. |
+| Hue Bridge | Hue Bridge, die die Szenen bereitstellt. |
+| HUE Szene | Szene, die aufgerufen wird (Autocomplete; Refresh lädt den Bridge-Katalog neu). |
+
+##### Reiter Zuordnung
+
+| Eigenschaft | Beschreibung |
+|--|--|
+| GA Aufruf | KNX-GA zum Abrufen der Szene. Verwenden Sie DPT 1.xxx für boolsche Steuerung oder DPT 18.xxx für KNX-Szenennummern. |
+| DPT | Datapoint, der zusammen mit der Aufruf-GA genutzt wird (1.xxx oder 18.001). |
+| Name | Bezeichnung für die Aufruf-GA. |
+| # | Wird angezeigt, wenn ein KNX-Szenen-DPT gewählt ist; wählen Sie die zu sendende Szenennummer. |
+| Status-GA | Optionale boolsche GA, die anzeigt, ob die Szene aktiv ist. |
+
+##### Reiter Mehrfachszene
+
+| Eigenschaft | Beschreibung |
+|--|--|
+| GA Aufruf | KNX-GA (DPT 18.001), um Szenen anhand ihrer KNX-Nummer auszuwählen. |
+| Szenenliste | Bearbeitbare Liste, die KNX-Szenennummern Hue-Szenen und Abrufmodi zuordnet. Ziehen Sie die Griffe zum Umordnen. |
+
+> ℹ️ KNX-spezifische Bedienelemente erscheinen erst nach Auswahl eines KNX-Gateways. Die Mapping-Reiter bleiben verborgen, bis sowohl Bridge als auch Gateway konfiguriert sind.
+
+---
+
+<span id="hue-controller-help-device_power" data-hue-controller-type="device_power"></span>
+
+## Batterie (`device_power`)
+
+<p>Dieser Node spiegelt den Batteriestand eines Hue-Geräts nach KNX und löst Ereignisse aus, sobald sich der Wert ändert.</p>
+
+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**
+
+| Eigenschaft | Beschreibung |
+|--|--|
+| KNX-Gateway | KNX-Gateway, auf das der Batteriestand veröffentlicht wird (erforderlich, damit KNX-Felder angezeigt werden). |
+| Hue Bridge | Hue Bridge, auf der das Gerät eingebunden ist. |
+| Hue-Batteriesensor | Hue-Gerät/Sensor, das den Batteriestand liefert (unterstützt Autovervollständigung und Refresh). |
+
+**Zuordnung**
+
+| Eigenschaft | Beschreibung |
+|--|--|
+| Level | KNX-GA für den Batteriestand (0-100 %). Empfohlener DPT: <b>5.001</b>. |
+
+**Verhalten**
+
+| Eigenschaft | Beschreibung |
+|--|--|
+| Status beim Start lesen | Beim Deploy/Wiederverbinden aktuellen Wert lesen und an KNX senden. Standard: "ja". |
+| Node-Ausgangspin | Node-RED-Ausgang anzeigen/ausblenden. Ohne KNX-Gateway bleibt der Ausgang aktiv, damit Hue-Ereignisse weiterhin den Flow erreichen. |
+
+> ℹ️ Die KNX-Mapping-Felder bleiben ausgeblendet, bis ein KNX-Gateway gewählt wurde - ideal, wenn der Node nur als Hue → Node-RED Ereignisquelle dient.
+
+---
+
+<span id="hue-controller-help-zigbee_connectivity" data-hue-controller-type="zigbee_connectivity"></span>
+
+## Zigbee-Verbindung (`zigbee_connectivity`)
+
+<p>Dieser Node liest den Zigbee-Konnektivitätsstatus eines HUE-Geräts und spiegelt ihn nach KNX.</p>
+
+Gib im GA-Feld den Gerätenamen oder die Gruppenadresse ein; beim Tippen erscheinen Vorschläge.
+
+**Allgemein**
+
+| Eigenschaft | Beschreibung |
+|--|--|
+| KNX-Gateway | KNX-Gateway, auf das veröffentlicht wird. |
+| Hue Bridge | Zu verwendende Hue Bridge. |
+| Hue-Zigbee-Konnektivität | HUE-Sensor/Gerät mit Zigbee-Konnektivitätsinfo (Autocomplete). |
+
+**Zuordnung**
+
+| Eigenschaft | Beschreibung |
+|--|--|
+| Status | KNX-GA, die die Zigbee-Konnektivität abbildet. _true_ = verbunden, sonst _false_. |
+| Status beim Start lesen | Beim Start/bei Wiederverbindung Status lesen und an KNX ausgeben. Standard: "Ja". |
+
+##### Ausgänge
+
+1. Standardausgang
+   : payload (boolean): Konnektivitätszustand.
+
+##### Details
+
+`msg.payload` ist true/false.\
+`msg.status` ist Text: **connected, disconnected, connectivity\_issue, unidirectional\_incoming** .
+
+---
+
+<span id="hue-controller-help-device_software_update" data-hue-controller-type="device_software_update"></span>
+
+## Geräte-Softwareupdate (`device_software_update`)
+
+<p>Dieser Node überwacht, ob ein HUE-Gerät ein Software-Update hat, und spiegelt den Status nach KNX.</p>
+
+Geben Sie den Namen oder die Gruppenadresse Ihres KNX -Geräts im Feld GA ein.
+Sie tippen.
+
+**Allgemein**
+
+| Eigenschaft | Beschreibung |
+|-|-|
+|KNX-Gateway |Wählen Sie das zu verwendende KNX -Gateway |
+|Hue Bridge |Wählen Sie die zu verwendende Hue Bridge aus |
+| Hue-Gerät | Zu überwachendes HUE-Gerät (Autocomplete) |
+
+**Zuordnung**
+
+| Eigenschaft | Beschreibung |
+|--|--|
+| Status | KNX-GA für Update-Status: _true_, wenn verfügbar/bereit/in Installation, sonst _false_. |
+| Status beim Start lesen | Beim Start/Wiederverbindung lesen und an KNX ausgeben (Standard "Ja"). |
+
+##### Ausgänge
+
+1. Standardausgang
+   : payload (boolean): Update-Flag.
+   : status (string): **no\_update, update\_pending, ready\_to\_install, installing** .
+
+<!-- HUE_CONTROLLER_PROFILE_HELP_END -->
+</script>