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

package/nodes/locales/en/knxUltimateHueController.json

@@ -0,0 +1,48 @@
+{
+  "common": {
+    "knx_gw": "KNX GW",
+    "hue_bridge": "Hue Bridge"
+  },
+  "knxUltimateHueController": {
+    "device_function": "Device function",
+    "legacy_node_notice": "This legacy HUE node is deprecated. Use the new HUE Controller node for new flows.",
+    "migration_button": "Convert legacy HUE flow",
+    "migration_button_title": "Paste a Node-RED flow and convert its legacy HUE nodes",
+    "migration_title": "Convert legacy HUE flow",
+    "migration_privacy": "Paste an exported Node-RED flow. Conversion happens locally and does not modify the open flow.",
+    "migration_credentials_notice": "Node-RED deliberately excludes keys and passwords from exported flows. The converter cannot read or recreate them.",
+    "migration_reuse_configs": "Reuse existing Hue and KNX config nodes (recommended)",
+    "migration_reuse_configs_help": "Keep this selected when importing back into the same Node-RED installation. Referenced config nodes are omitted from the result, so their stored credentials remain untouched.",
+    "migration_input": "Original flow JSON",
+    "migration_input_placeholder": "Paste the complete Node-RED flow export here",
+    "migration_convert": "Convert",
+    "migration_copy": "Copy converted flow",
+    "migration_output": "Converted flow JSON",
+    "migration_close": "Close",
+    "migration_summary": "{{count}} legacy HUE nodes converted.",
+    "migration_summary_reused": "{{count}} referenced config nodes will be reused with their existing credentials.",
+    "migration_configs_included_warning": "Config nodes are included without exported credentials; enter their keys and passwords after import.",
+    "migration_none": "No legacy HUE nodes were found.",
+    "migration_invalid": "Invalid flow JSON:",
+    "migration_copy_success": "Converted flow copied.",
+    "migration_copy_failed": "Clipboard access was blocked. The converted JSON has been selected; copy it manually.",
+    "migration_unavailable": "The HUE migration tool is unavailable. Restart Node-RED after updating the package.",
+    "types": {
+      "light": "Light / grouped light",
+      "plug": "Plug / outlet",
+      "button": "Button",
+      "relative_rotary": "Tap dial",
+      "motion": "Motion",
+      "area_motion": "Area motion",
+      "camera_motion": "Camera motion",
+      "contact": "Contact",
+      "light_level": "Light level",
+      "temperature": "Temperature",
+      "humidity": "Humidity",
+      "scene": "Scene",
+      "device_power": "Battery",
+      "zigbee_connectivity": "Zigbee connectivity",
+      "device_software_update": "Device software update"
+    }
+  }
+}

package/nodes/locales/en/knxUltimateHueHumiditySensor.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueHumiditySensor">
+<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 reads relative humidity (%) from a Hue humidity sensor and maps it 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/knxUltimateHueLight.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueLight">
+<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 controls Philips Hue lights (single or grouped) and maps their commands/states to KNX.</p>
 
 **General**

package/nodes/locales/en/knxUltimateHueLightSensor.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueLightSensor">
+<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 reads lux events from a Hue Light Sensor and maps them to KNX.</p>
 
 It emits the ambient illuminance (lux) each time it changes. Start typing in the GA field (name or Group Address) to link the KNX GA; devices appear while you type.

package/nodes/locales/en/knxUltimateHueMotion.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueMotion">
+<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 listens to a Hue motion sensor and mirrors the events to KNX and/or your Node-RED flow.</p>
 
 Start typing the KNX device name or Group Address in the GA field; suggestions appear while you type. Hit the refresh button next to "Hue sensor” to reload the device list from the bridge if you add new sensors.

package/nodes/locales/en/knxUltimateHuePlug.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHuePlug">
+<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>
 # Hue Plug / Outlet
 
 ## Overview

package/nodes/locales/en/knxUltimateHueScene.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueScene">
+<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>
 The **Hue Scene** node exposes Hue scenes to KNX and can forward the raw Hue events to a Node-RED flow. The scene field supports autocomplete; use the refresh icon after adding scenes on the bridge so the list stays up to date.
 
 ### Tabs at a glance

package/nodes/locales/en/knxUltimateHueTapDial.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueTapDial">
+<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>
 The **Hue Tap Dial** node maps the rotary service of the Hue Tap Dial to KNX and forwards the raw Hue events to your flow. Use the refresh icon beside the device field after pairing a new dial on the bridge.
 
 ### Tabs

package/nodes/locales/en/knxUltimateHueTemperatureSensor.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueTemperatureSensor">
+<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 reads temperature (°C) from a Hue temperature sensor and maps it 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/knxUltimateHueZigbeeConnectivity.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueZigbeeConnectivity">
+<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 retrieves the Zigbee connectivity status from a Hue device and exposes it to KNX.</p>
 
 Start typing the KNX device name or Group Address in the GA field; suggestions appear while you type.

package/nodes/locales/en/knxUltimateHuedevice_software_update.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHuedevice_software_update">
+<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 monitors whether a selected Hue device has a software update available and publishes the status to KNX.</p>
 
 Start typing the name or group address of your KNX device in the GA field, the avaiable devices start showing up while

package/nodes/locales/es/knxUltimateAI.html

@@ -87,10 +87,7 @@ Aquí tienes todos los campos tal como se muestran en el editor de KNX AI.
 - **Topic**: topic base usado en las salidas del nodo.
 - Botón **Open KNX AI Web**: abre el dashboard web (`/knxUltimateAI/sidebar/page`).
 
-### Capture
-- **Capture GroupValue_Write**: captura telegramas Write.
-- **Capture GroupValue_Response**: captura telegramas Response.
-- **Capture GroupValue_Read**: captura telegramas Read.
+KNX AI escucha automáticamente los telegramas `GroupValue_Write`, `GroupValue_Response` y `GroupValue_Read`. El análisis de patrones y anomalías siempre se inicializa con los valores predeterminados internos, por lo que no es necesario configurar los eventos del bus ni la detección.
 
 ### Analysis
 - **Analysis window (seconds)**: ventana principal para resumen/rate.
@@ -100,16 +97,6 @@ Aquí tienes todos los campos tal como se muestran en el editor de KNX AI.
 - **Max stored events**: número máximo de telegramas en memoria.
 - **Auto emit summary (seconds, 0=off)**: intervalo periódico de resumen.
 - **Top list size**: cantidad de group addresses/fuentes en el top.
-- **Detect simple patterns (A -> B)**: habilita detección de transiciones/patrones.
-- **Pattern max lag (ms)**: diferencia temporal máxima para correlación.
-- **Pattern min occurrences**: ocurrencias mínimas antes de reportar patrón.
-
-### Anomalies
-- **Rate window (seconds)**: ventana deslizante para controles de rate.
-- **Max overall telegrams/sec (0=off)**: umbral en el bus global.
-- **Max telegrams/sec per GA (0=off)**: umbral por group address.
-- **Flap window (seconds)**: ventana para detectar flapping/cambios rápidos.
-- **Max changes per GA in window (0=off)**: cambios máximos permitidos en ventana.
 
 ### Asistente IA
 - **Enable LLM assistant**: habilita funciones Ask/chat.
@@ -118,37 +105,28 @@ Aquí tienes todos los campos tal como se muestran en el editor de KNX AI.
 - **API key**: clave API (no requerida con Ollama local).
 - **Model**: ID/nombre de modelo.
 - **Compatibilidad del modelo de chat**: el modelo seleccionado debe admitir el endpoint Chat Completions configurado. Los modelos antiguos disponibles solo mediante completions, como `gpt-3.5-turbo-instruct`, se excluyen al actualizar la lista. Si el proveedor rechaza un valor personalizado de temperatura o el parámetro de límite de tokens, KNX AI vuelve a intentarlo eliminando o sustituyendo únicamente el campo incompatible.
-- **System prompt**: instrucción global para análisis KNX (Advanced).
 - **Permitir que la IA lea estados KNX y controle actuadores**: habilita la salida 4 y está desactivado por defecto. Los objetos exactos del catálogo ETS se pueden leer; solo se aceptan escrituras hacia objetos clasificados como `command`. Las operaciones desconocidas, con DPT distinto, inválidas o excesivas, y las escrituras hacia objetos de estado o neutrales, se rechazan localmente.
 - **Pedir confirmación antes de enviar comandos KNX**: activado por defecto. Muestra primero los cambios validados y no emite comandos hasta que la misma sesión de chat los confirme. Cuando hay comandos pendientes, la respuesta añade siempre las instrucciones exactas para confirmar o cancelar en el idioma de la solicitud actual. Los comandos se validan de nuevo justo antes de la salida.
-- **Preajuste del adaptador**: carga una pareja de mapeos entrada/salida desde el archivo de adaptadores de chat incluido. La selección sustituye intencionadamente ambos cuadros de texto; el código sigue siendo editable.
-- **Mapeo de entrada (chat → KNX AI)**: JavaScript síncrono aplicado antes de procesar el comando de entrada.
-- **Mapeo de salida (KNX AI → chat)**: JavaScript síncrono aplicado solo a los mensajes de la salida 3.
+- **Preajuste del adaptador**: usa **Sin adaptador** por defecto. Los editores JavaScript permanecen ocultos hasta seleccionar un adaptador; entonces se cargan y muestran los mapeos editables de entrada y salida.
+- **Mapeo de entrada (chat → KNX AI)**: JavaScript síncrono aplicado antes de procesar el comando de entrada en el editor JavaScript verde.
+- **Mapeo de salida (KNX AI → chat)**: JavaScript síncrono aplicado solo a los mensajes de la salida 3 en el editor JavaScript amarillo.
 - **Activar notificaciones proactivas del hogar**: detector opcional de estados abiertos de persiana/ventana/puerta reconocidos de forma fiable; nunca escribe de manera autónoma en KNX.
 - **Destinatario principal / ID de chat**: destino opcional de mensajes espontáneos; de lo contrario se recuerda la última sesión Ask.
-- **Avisar después de abierta (minutos)**: umbral de duración antes de considerar una notificación proactiva.
+- **Avisar después de abierta (minutos)**: umbral de duración antes de considerar una notificación proactiva; 120 minutos por defecto.
 - **Inicio / fin de horas silenciosas**: intervalo diario en el que se suprimen los mensajes proactivos.
 - **Educación de la IA**: instrucciones vinculantes gestionadas solo por el usuario, leídas por la IA y nunca modificadas.
-- **Tiempo de espera de repetición (minutos)**: intervalo mínimo antes de que el mismo objeto pueda volver a avisar.
+- **Tiempo de espera de repetición (minutos)**: intervalo mínimo antes de que el mismo objeto pueda volver a avisar; 360 minutos por defecto.
 - **Archivo máximo de memoria del hogar (KB)**: límite estricto de 64 a 1.024 KB; 256 KB por defecto.
 - Si el archivo en disco esta activo, **Ask** lo usa por defecto: respeta fechas/rangos explicitos y, si no los indicas, busca en las ultimas 24 horas mas los eventos actuales en RAM.
-- **Include raw payload hex**: incluye payload hex raw en el prompt.
 - **Incluir inventario del proyecto Node-RED**: incluye en el prompt el inventario de todo el proyecto Node-RED, con nodos KNX y otros nodos utiles como function/change/inject/template cuando contienen logica KNX o direcciones de grupo.
-- **Include documentation snippets (help/README/examples)**: incluye contexto de documentación.
-- **Docs language**: idioma preferido de snippets documentación.
-- Botón **Refresh**: consulta el provider y carga modelos disponibles.
+- Los fragmentos pertinentes de la ayuda, README y ejemplos se incluyen siempre de forma automática.
+- **Docs language**: idioma preferido para los fragmentos de documentación incluidos automáticamente.
+- Botón **Refresh**: consulta el provider y carga los modelos disponibles. El icono gira durante la carga; una finalización correcta no muestra ningún mensaje.
 
 ### Advanced
 - **Analysis window (seconds)**: ventana principal para resumen/rate.
 - **Max stored events**: número máximo de telegramas en memoria.
 - **Top list size**: cantidad de group addresses/fuentes en el top.
-- **Pattern max lag (ms)**: diferencia temporal máxima para correlación.
-- **Pattern min occurrences**: ocurrencias mínimas antes de reportar patrón.
-- **Rate window (seconds)**: ventana deslizante para controles de rate.
-- **Max overall telegrams/sec (0=off)**: umbral en el bus global.
-- **Max telegrams/sec per GA (0=off)**: umbral por group address.
-- **Flap window (seconds)**: ventana para detectar flapping/cambios rápidos.
-- **Max changes per GA in window (0=off)**: cambios máximos permitidos en ventana.
 
 ### Configuración rápida de Ollama (local)
 - Selecciona **Provider = Ollama**.

package/nodes/locales/es/knxUltimateHueAreaMotion.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueAreaMotion">
+<p><strong>Obsoleto:</strong> este nodo HUE dedicado sigue disponible para los flujos existentes. Usa <strong>HUE Controller</strong> para proyectos nuevos. El nodo legacy aparece marcado con <code>(deprecated)</code> en la paleta y en el lienzo, usa un color más claro que HUE Controller y su editor muestra arriba un aviso de migración. El botón naranja de migración de este editor abre el mismo convertidor de flujo completo disponible en HUE Controller.</p>
 <p>El nodo Hue Motion Area escucha los eventos de movimiento agregados de un área MotionAware (Hue Bridge Pro) y refleja el estado detectado/no detectado hacia KNX o hacia su flujo de Node-RED.</p>
 
 Empiece a escribir en el campo GA (nombre o dirección de grupo) para vincular la GA KNX; las sugerencias aparecen mientras escribe.
@@ -33,4 +34,3 @@ Empiece a escribir en el campo GA (nombre o dirección de grupo) para vincular l
 
 `msg.payload` contiene el último estado de movimiento agregado que proporciona el servicio MotionAware del área seleccionada.
 </script>
-

package/nodes/locales/es/knxUltimateHueBattery.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueBattery">
+<p><strong>Obsoleto:</strong> este nodo HUE dedicado sigue disponible para los flujos existentes. Usa <strong>HUE Controller</strong> para proyectos nuevos. El nodo legacy aparece marcado con <code>(deprecated)</code> en la paleta y en el lienzo, usa un color más claro que HUE Controller y su editor muestra arriba un aviso de migración. El botón naranja de migración de este editor abre el mismo convertidor de flujo completo disponible en HUE Controller.</p>
 <p> Este nodo expone el nivel de batería de un dispositivo HUE a KNX y plantea un evento cada vez que cambia el valor. </p>
 
 Comience a escribir el nombre del dispositivo KNX o la dirección de grupo en el campo GA;Las entradas coincidentes aparecen mientras escribe.Use el icono de actualización junto al sensor de Hue </Q> para recargar la lista desde el puente HUE después de agregar nuevos dispositivos.

package/nodes/locales/es/knxUltimateHueButton.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueButton">
+<p><strong>Obsoleto:</strong> este nodo HUE dedicado sigue disponible para los flujos existentes. Usa <strong>HUE Controller</strong> para proyectos nuevos. El nodo legacy aparece marcado con <code>(deprecated)</code> en la paleta y en el lienzo, usa un color más claro que HUE Controller y su editor muestra arriba un aviso de migración. El botón naranja de migración de este editor abre el mismo convertidor de flujo completo disponible en HUE Controller.</p>
 <P> Los mapas del nodo del botón Hue Eventos del botón Hue a las direcciones de grupo KNX y exponen los mismos eventos en su salida de flujo a través de <code> Botton.button_report.event </code>. </p>
 
 Comience a escribir en el campo GA (nombre o dirección de grupo) para vincular el KNX GA;Los dispositivos aparecen mientras escribe.

package/nodes/locales/es/knxUltimateHueCameraMotion.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueCameraMotion">
+<p><strong>Obsoleto:</strong> este nodo HUE dedicado sigue disponible para los flujos existentes. Usa <strong>HUE Controller</strong> para proyectos nuevos. El nodo legacy aparece marcado con <code>(deprecated)</code> en la paleta y en el lienzo, usa un color más claro que HUE Controller y su editor muestra arriba un aviso de migración. El botón naranja de migración de este editor abre el mismo convertidor de flujo completo disponible en HUE Controller.</p>
 <P> El nodo de movimiento de la cámara Hue escucha a Philips Hue Camera Motion Services y refleja el estado detectado/no detectado a KNX. </p>
 
 Comience a escribir en el campo GA (nombre o dirección de grupo) para vincular el KNX GA;Los dispositivos aparecen mientras escribe.

package/nodes/locales/es/knxUltimateHueContactSensor.html

@@ -1,4 +1,5 @@
 <script type="text/markdown" data-help-name="knxUltimateHueContactSensor">
+<p><strong>Obsoleto:</strong> este nodo HUE dedicado sigue disponible para los flujos existentes. Usa <strong>HUE Controller</strong> para proyectos nuevos. El nodo legacy aparece marcado con <code>(deprecated)</code> en la paleta y en el lienzo, usa un color más claro que HUE Controller y su editor muestra arriba un aviso de migración. El botón naranja de migración de este editor abre el mismo convertidor de flujo completo disponible en HUE Controller.</p>
 <p> Este nodo reenvía los eventos desde un sensor de contacto de tono y los asigna a las direcciones de grupo KNX. </p>
 
 Comience a escribir en el campo GA, el nombre o la dirección de grupo de su dispositivo KNX, los dispositivos avaiables comienzan a aparecer mientras está escribiendo.