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

package/nodes/locales/de/knxUltimateHueController.json

@@ -0,0 +1,48 @@
+{
+  "common": {
+    "knx_gw": "KNX-Gateway",
+    "hue_bridge": "Hue Bridge"
+  },
+  "knxUltimateHueController": {
+    "device_function": "Gerätefunktion",
+    "legacy_node_notice": "Dieser Legacy-HUE-Knoten ist veraltet. Verwenden Sie für neue Flows den neuen HUE Controller-Knoten.",
+    "migration_button": "Legacy-HUE-Flow konvertieren",
+    "migration_button_title": "Einen Node-RED-Flow einfügen und seine Legacy-HUE-Knoten konvertieren",
+    "migration_title": "Legacy-HUE-Flow konvertieren",
+    "migration_privacy": "Fügen Sie einen exportierten Node-RED-Flow ein. Die Konvertierung erfolgt lokal und ändert den geöffneten Flow nicht.",
+    "migration_credentials_notice": "Node-RED schließt Schlüssel und Passwörter absichtlich aus exportierten Flows aus. Der Konverter kann sie weder lesen noch wiederherstellen.",
+    "migration_reuse_configs": "Vorhandene Hue- und KNX-Konfigurationsknoten wiederverwenden (empfohlen)",
+    "migration_reuse_configs_help": "Lassen Sie diese Option aktiviert, wenn Sie in dieselbe Node-RED-Installation importieren. Referenzierte Konfigurationsknoten werden aus dem Ergebnis entfernt, sodass ihre gespeicherten Zugangsdaten unverändert bleiben.",
+    "migration_input": "JSON des ursprünglichen Flows",
+    "migration_input_placeholder": "Vollständigen Node-RED-Flow-Export hier einfügen",
+    "migration_convert": "Konvertieren",
+    "migration_copy": "Konvertierten Flow kopieren",
+    "migration_output": "JSON des konvertierten Flows",
+    "migration_close": "Schließen",
+    "migration_summary": "{{count}} Legacy-HUE-Knoten konvertiert.",
+    "migration_summary_reused": "{{count}} referenzierte Konfigurationsknoten werden mit ihren vorhandenen Zugangsdaten wiederverwendet.",
+    "migration_configs_included_warning": "Konfigurationsknoten sind ohne exportierte Zugangsdaten enthalten; geben Sie Schlüssel und Passwörter nach dem Import erneut ein.",
+    "migration_none": "Keine Legacy-HUE-Knoten gefunden.",
+    "migration_invalid": "Ungültiges Flow-JSON:",
+    "migration_copy_success": "Konvertierter Flow kopiert.",
+    "migration_copy_failed": "Der Zugriff auf die Zwischenablage wurde blockiert. Das konvertierte JSON wurde markiert; kopieren Sie es manuell.",
+    "migration_unavailable": "Das HUE-Migrationswerkzeug ist nicht verfügbar. Starten Sie Node-RED nach der Paketaktualisierung neu.",
+    "types": {
+      "light": "Leuchte / Leuchtengruppe",
+      "plug": "Steckdose / Ausgang",
+      "button": "Taster",
+      "relative_rotary": "Tap dial",
+      "motion": "Bewegung",
+      "area_motion": "Bereichsbewegung",
+      "camera_motion": "Kamerabewegung",
+      "contact": "Kontakt",
+      "light_level": "Lichtstärke",
+      "temperature": "Temperatur",
+      "humidity": "Luftfeuchtigkeit",
+      "scene": "Szene",
+      "device_power": "Batterie",
+      "zigbee_connectivity": "Zigbee-Verbindung",
+      "device_software_update": "Geräte-Softwareupdate"
+    }
+  }
+}

package/nodes/locales/de/knxUltimateHueHumiditySensor.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueHumiditySensor">
+<p><strong>Veraltet:</strong> Dieser dedizierte HUE-Knoten bleibt für bestehende Flows verfügbar. Verwenden Sie <strong>HUE Controller</strong> für neue Projekte. Der Legacy-Knoten ist in der Palette und auf der Arbeitsfläche mit <code>(deprecated)</code> gekennzeichnet, verwendet eine hellere Farbe als HUE Controller und sein Editor zeigt oben einen Migrationshinweis. Der orange Migrationsbutton in diesem Editor öffnet denselben vollständigen Flow-Konverter wie HUE Controller.</p>
 <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.

package/nodes/locales/de/knxUltimateHueLight.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueLight">
+<p><strong>Veraltet:</strong> Dieser dedizierte HUE-Knoten bleibt für bestehende Flows verfügbar. Verwenden Sie <strong>HUE Controller</strong> für neue Projekte. Der Legacy-Knoten ist in der Palette und auf der Arbeitsfläche mit <code>(deprecated)</code> gekennzeichnet, verwendet eine hellere Farbe als HUE Controller und sein Editor zeigt oben einen Migrationshinweis. Der orange Migrationsbutton in diesem Editor öffnet denselben vollständigen Flow-Konverter wie HUE Controller.</p>
 <p>Dieser Node steuert HUE-Leuchten (einzeln oder gruppiert) und ordnet Befehle/Zustände KNX-Gruppenadressen zu.</p>
 
 **Allgemein**

package/nodes/locales/de/knxUltimateHueLightSensor.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueLightSensor">
+<p><strong>Veraltet:</strong> Dieser dedizierte HUE-Knoten bleibt für bestehende Flows verfügbar. Verwenden Sie <strong>HUE Controller</strong> für neue Projekte. Der Legacy-Knoten ist in der Palette und auf der Arbeitsfläche mit <code>(deprecated)</code> gekennzeichnet, verwendet eine hellere Farbe als HUE Controller und sein Editor zeigt oben einen Migrationshinweis. Der orange Migrationsbutton in diesem Editor öffnet denselben vollständigen Flow-Konverter wie HUE Controller.</p>
 <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.

package/nodes/locales/de/knxUltimateHueMotion.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueMotion">
+<p><strong>Veraltet:</strong> Dieser dedizierte HUE-Knoten bleibt für bestehende Flows verfügbar. Verwenden Sie <strong>HUE Controller</strong> für neue Projekte. Der Legacy-Knoten ist in der Palette und auf der Arbeitsfläche mit <code>(deprecated)</code> gekennzeichnet, verwendet eine hellere Farbe als HUE Controller und sein Editor zeigt oben einen Migrationshinweis. Der orange Migrationsbutton in diesem Editor öffnet denselben vollständigen Flow-Konverter wie HUE Controller.</p>
 <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.

package/nodes/locales/de/knxUltimateHuePlug.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHuePlug">
+<p><strong>Veraltet:</strong> Dieser dedizierte HUE-Knoten bleibt für bestehende Flows verfügbar. Verwenden Sie <strong>HUE Controller</strong> für neue Projekte. Der Legacy-Knoten ist in der Palette und auf der Arbeitsfläche mit <code>(deprecated)</code> gekennzeichnet, verwendet eine hellere Farbe als HUE Controller und sein Editor zeigt oben einen Migrationshinweis. Der orange Migrationsbutton in diesem Editor öffnet denselben vollständigen Flow-Konverter wie HUE Controller.</p>
 # Hue Steckdose / Plug
 
 ## Überblick

package/nodes/locales/de/knxUltimateHueScene.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueScene">
+<p><strong>Veraltet:</strong> Dieser dedizierte HUE-Knoten bleibt für bestehende Flows verfügbar. Verwenden Sie <strong>HUE Controller</strong> für neue Projekte. Der Legacy-Knoten ist in der Palette und auf der Arbeitsfläche mit <code>(deprecated)</code> gekennzeichnet, verwendet eine hellere Farbe als HUE Controller und sein Editor zeigt oben einen Migrationshinweis. Der orange Migrationsbutton in diesem Editor öffnet denselben vollständigen Flow-Konverter wie HUE Controller.</p>
 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

package/nodes/locales/de/knxUltimateHueTapDial.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueTapDial">
+<p><strong>Veraltet:</strong> Dieser dedizierte HUE-Knoten bleibt für bestehende Flows verfügbar. Verwenden Sie <strong>HUE Controller</strong> für neue Projekte. Der Legacy-Knoten ist in der Palette und auf der Arbeitsfläche mit <code>(deprecated)</code> gekennzeichnet, verwendet eine hellere Farbe als HUE Controller und sein Editor zeigt oben einen Migrationshinweis. Der orange Migrationsbutton in diesem Editor öffnet denselben vollständigen Flow-Konverter wie HUE Controller.</p>
 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

package/nodes/locales/de/knxUltimateHueTemperatureSensor.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueTemperatureSensor">
+<p><strong>Veraltet:</strong> Dieser dedizierte HUE-Knoten bleibt für bestehende Flows verfügbar. Verwenden Sie <strong>HUE Controller</strong> für neue Projekte. Der Legacy-Knoten ist in der Palette und auf der Arbeitsfläche mit <code>(deprecated)</code> gekennzeichnet, verwendet eine hellere Farbe als HUE Controller und sein Editor zeigt oben einen Migrationshinweis. Der orange Migrationsbutton in diesem Editor öffnet denselben vollständigen Flow-Konverter wie HUE Controller.</p>
 <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.

package/nodes/locales/de/knxUltimateHueZigbeeConnectivity.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueZigbeeConnectivity">
+<p><strong>Veraltet:</strong> Dieser dedizierte HUE-Knoten bleibt für bestehende Flows verfügbar. Verwenden Sie <strong>HUE Controller</strong> für neue Projekte. Der Legacy-Knoten ist in der Palette und auf der Arbeitsfläche mit <code>(deprecated)</code> gekennzeichnet, verwendet eine hellere Farbe als HUE Controller und sein Editor zeigt oben einen Migrationshinweis. Der orange Migrationsbutton in diesem Editor öffnet denselben vollständigen Flow-Konverter wie HUE Controller.</p>
 <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.

package/nodes/locales/de/knxUltimateHuedevice_software_update.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHuedevice_software_update">
+<p><strong>Veraltet:</strong> Dieser dedizierte HUE-Knoten bleibt für bestehende Flows verfügbar. Verwenden Sie <strong>HUE Controller</strong> für neue Projekte. Der Legacy-Knoten ist in der Palette und auf der Arbeitsfläche mit <code>(deprecated)</code> gekennzeichnet, verwendet eine hellere Farbe als HUE Controller und sein Editor zeigt oben einen Migrationshinweis. Der orange Migrationsbutton in diesem Editor öffnet denselben vollständigen Flow-Konverter wie HUE Controller.</p>
 <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.

package/nodes/locales/en/knxUltimateAI.html

@@ -92,9 +92,7 @@ All fields exposed in the KNX AI editor are listed below.
 - **Open KNX AI Web** button: Opens the full KNX AI web dashboard (`/knxUltimateAI/sidebar/page`).
 
 ### Capture
-- **Capture GroupValue_Write**: Capture write telegrams.
-- **Capture GroupValue_Response**: Capture response telegrams.
-- **Capture GroupValue_Read**: Capture read telegrams.
+KNX AI automatically listens to `GroupValue_Write`, `GroupValue_Response`, and `GroupValue_Read` telegrams. Pattern and anomaly analysis is always initialized with the built-in defaults, so no bus-event or detection setup is required.
 
 ### Analysis
 - **Analysis window (seconds)**: Main analysis window used for summaries/rates.
@@ -104,16 +102,6 @@ All fields exposed in the KNX AI editor are listed below.
 - **Max stored events**: Maximum number of telegrams kept in memory.
 - **Auto emit summary (seconds, 0=off)**: Periodic summary output interval.
 - **Top list size**: Number of top group addresses/sources in summary.
-- **Detect simple patterns (A -> B)**: Enable transition/pattern detection.
-- **Pattern max lag (ms)**: Max time gap for pattern transition matching.
-- **Pattern min occurrences**: Minimum occurrences before a pattern is reported.
-
-### Anomalies
-- **Rate window (seconds)**: Sliding time window for anomaly rate checks.
-- **Max overall telegrams/sec (0=off)**: Overall bus rate threshold.
-- **Max telegrams/sec per GA (0=off)**: Per-group-address rate threshold.
-- **Flap window (seconds)**: Time window for flapping/change-rate detection.
-- **Max changes per GA in window (0=off)**: Max allowed changes in flap window.
 
 ### AI Assistant
 - **Enable LLM assistant**: Enable Ask/chat assistant features.
@@ -122,37 +110,28 @@ All fields exposed in the KNX AI editor are listed below.
 - **API key**: API key (not required for local Ollama).
 - **Model**: Model ID/name.
 - **Chat model compatibility**: The selected model must support the configured Chat Completions endpoint. Legacy completion-only models such as `gpt-3.5-turbo-instruct` are excluded when the model list is refreshed. If the provider rejects a custom temperature or token-limit parameter, KNX AI retries after removing or replacing only that incompatible field.
-- **System prompt**: Global instruction for KNX analysis behavior (Advanced).
 - **Allow AI to read KNX states and control actuators**: Enables output 4 and is off by default. Exact ETS catalog objects may be read; writes are accepted only for objects classified as `command`. Unknown, DPT-mismatched, invalid, or excessive operations and writes to status/neutral objects are rejected locally.
 - **Ask for confirmation before sending KNX commands**: Enabled by default. Shows the validated changes first and emits no KNX command until the same chat session confirms them. Whenever commands are awaiting confirmation, the response always appends the exact confirmation/cancellation instructions in the language of the current request. Commands are validated again immediately before output.
-- **Adapter preset**: Loads an input/output mapping pair from the packaged chat-adapter file. Selecting a preset intentionally replaces both mapping text boxes; they remain editable afterwards.
-- **Input mapping (chat → KNX AI)**: Synchronous JavaScript applied before input command processing.
-- **Output mapping (KNX AI → chat)**: Synchronous JavaScript applied only to messages on output 3.
+- **Adapter preset**: Defaults to **No adapter**. The JavaScript mapping editors remain hidden until an adapter is selected; selecting a preset loads and reveals its editable input/output mapping pair.
+- **Input mapping (chat → KNX AI)**: Synchronous JavaScript applied before input command processing. It uses the green JavaScript editor.
+- **Output mapping (KNX AI → chat)**: Synchronous JavaScript applied only to messages on output 3. It uses the yellow JavaScript editor.
 - **Enable proactive home notifications**: Opt-in detector for reliably recognized open cover/window/door states; it never writes autonomously to KNX.
 - **Primary recipient / chat ID**: Optional destination for unsolicited chat messages; otherwise the most recent Ask session is remembered.
-- **Notify after open (minutes)**: Open-duration threshold before a proactive notification can be considered.
+- **Notify after open (minutes)**: Open-duration threshold before a proactive notification can be considered; 120 minutes by default.
 - **Quiet hours start / end**: Daily interval in which proactive messages are suppressed.
 - **AI Education**: User-only, authoritative guidance read by the AI and never modified by it.
-- **Repeat cooldown (minutes)**: Minimum interval before the same object may notify again.
+- **Repeat cooldown (minutes)**: Minimum interval before the same object may notify again; 360 minutes by default.
 - **Maximum home-memory file (KB)**: Hard size limit from 64 to 1,024 KB; 256 KB by default.
 - If disk archive is enabled, **Ask** uses the archive by default: explicit dates/ranges are honored, otherwise the assistant searches the last 24 hours plus current RAM events.
-- **Include raw payload hex**: Include raw telegram hex in prompt.
 - **Include Node-RED project inventory**: Include the whole Node-RED project inventory in the prompt, including KNX nodes and other useful nodes such as function/change/inject/template when they contain KNX-related logic or group addresses.
-- **Include documentation snippets (help/README/examples)**: Include docs context.
-- **Docs language**: Preferred language for docs snippets.
-- **Refresh** button: Query provider and load available model IDs.
+- Relevant help, README, and example snippets are always included automatically.
+- **Docs language**: Preferred language for the automatically included documentation snippets.
+- **Refresh** button: Queries the provider and loads available model IDs. Its icon spins while loading; successful completion is intentionally silent.
 
 ### Advanced
 - **Analysis window (seconds)**: Main analysis window used for summaries/rates.
 - **Max stored events**: Maximum number of telegrams kept in memory.
 - **Top list size**: Number of top group addresses/sources in summary.
-- **Pattern max lag (ms)**: Max time gap for pattern transition matching.
-- **Pattern min occurrences**: Minimum occurrences before a pattern is reported.
-- **Rate window (seconds)**: Sliding time window for anomaly rate checks.
-- **Max overall telegrams/sec (0=off)**: Overall bus rate threshold.
-- **Max telegrams/sec per GA (0=off)**: Per-group-address rate threshold.
-- **Flap window (seconds)**: Time window for flapping/change-rate detection.
-- **Max changes per GA in window (0=off)**: Max allowed changes in flap window.
 
 ### Ollama quick setup (local)
 - Choose **Provider = Ollama**.

package/nodes/locales/en/knxUltimateHueAreaMotion.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueAreaMotion">
+<p><strong>Deprecated:</strong> This dedicated HUE node remains available for existing flows. Use <strong>HUE Controller</strong> for new work. The legacy node is marked <code>(deprecated)</code> in the palette and on the canvas, uses a lighter color than HUE Controller, and its editor opens with a migration notice. The orange migration button in this editor opens the same full-flow converter available in HUE Controller.</p>
 <p>The Hue Motion Area node listens to MotionAware area motion events (Hue Bridge Pro) and mirrors the aggregated detected/not-detected state to KNX or your Node-RED flow.</p>
 
 Start typing in the GA field (name or Group Address) to link the KNX GA; devices appear while you type.
@@ -33,4 +34,3 @@ Start typing in the GA field (name or Group Address) to link the KNX GA; devices
 
 `msg.payload` carries the latest MotionAware area motion status (aggregated from the underlying sensors).
 </script>
-

package/nodes/locales/en/knxUltimateHueBattery.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueBattery">
+<p><strong>Deprecated:</strong> This dedicated HUE node remains available for existing flows. Use <strong>HUE Controller</strong> for new work. The legacy node is marked <code>(deprecated)</code> in the palette and on the canvas, uses a lighter color than HUE Controller, and its editor opens with a migration notice. The orange migration button in this editor opens the same full-flow converter available in HUE Controller.</p>
 <p>This node exposes the battery level of a Hue device to KNX and raises an event whenever the value changes.</p>
 
 Start typing the KNX device name or Group Address in the GA field; matching entries appear while you type. Use the refresh icon next to <q>Hue sensor</q> to reload the list from the Hue bridge after adding new devices.

package/nodes/locales/en/knxUltimateHueButton.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueButton">
+<p><strong>Deprecated:</strong> This dedicated HUE node remains available for existing flows. Use <strong>HUE Controller</strong> for new work. The legacy node is marked <code>(deprecated)</code> in the palette and on the canvas, uses a lighter color than HUE Controller, and its editor opens with a migration notice. The orange migration button in this editor opens the same full-flow converter available in HUE Controller.</p>
 <p>The Hue Button node maps Hue button events to KNX group addresses and exposes the same events on its flow output via <code>button.button_report.event</code>.</p>
 
 Start typing in the GA field (name or Group Address) to link the KNX GA; devices appear while you type.

package/nodes/locales/en/knxUltimateHueCameraMotion.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueCameraMotion">
+<p><strong>Deprecated:</strong> This dedicated HUE node remains available for existing flows. Use <strong>HUE Controller</strong> for new work. The legacy node is marked <code>(deprecated)</code> in the palette and on the canvas, uses a lighter color than HUE Controller, and its editor opens with a migration notice. The orange migration button in this editor opens the same full-flow converter available in HUE Controller.</p>
 <p>The Hue Camera Motion node listens to Philips Hue camera motion services and mirrors the detected/not detected state to KNX.</p>
 
 Start typing in the GA field (name or Group Address) to link the KNX GA; devices appear while you type.

package/nodes/locales/en/knxUltimateHueContactSensor.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueContactSensor">
+<p><strong>Deprecated:</strong> This dedicated HUE node remains available for existing flows. Use <strong>HUE Controller</strong> for new work. The legacy node is marked <code>(deprecated)</code> in the palette and on the canvas, uses a lighter color than HUE Controller, and its editor opens with a migration notice. The orange migration button in this editor opens the same full-flow converter available in HUE Controller.</p>
 <p>This node forwards events from a Hue contact sensor and maps them to KNX group addresses.</p>
 
 Start typing in the GA field, the name or group address of your KNX device, the avaiable devices start showing up while you're typing.