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

package/nodes/locales/es/knxUltimateHueController.html

@@ -0,0 +1,672 @@
+<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> es el nodo unificado para recursos de Hue API v2.</p>
+<p>Selecciona la función del dispositivo y configura el mismo mapeo KNX y comportamiento del nodo Hue dedicado ya consolidado.</p>
+<p>El selector de función utiliza un tercio del ancho disponible para mantener compacto el editor.</p>
+<p>Las filas de mapeo KNX mantienen GA, DPT y Nombre en una sola línea. Los campos DPT y Nombre usan anchos compactos; Nombre puede reducirse aún más en editores estrechos sin modificar el texto guardado.</p>
+<p>Admite luces y grupos de luces, enchufes, botones, Tap dial, movimiento y movimiento de cámara, contactos, nivel de luz, temperatura, humedad, escenas, batería, conectividad Zigbee y actualización de software.</p>
+<p>Cuando no hay ningún <strong>Gateway KNX</strong> seleccionado (incluidos <code>none</code> y <em>Añadir nuevo...</em>), se ocultan los campos de mapeo KNX; la selección del recurso Hue y las opciones exclusivas del flujo siguen disponibles.</p>
+<p>Para una luz individual, las secciones <strong>Regulación</strong>, <strong>Blanco regulable</strong>, <strong>RGB/HSV</strong> y efectos nativos siguen las capacidades en vivo declaradas por el recurso Hue API v2 seleccionado. Los mapeos KNX correspondientes aparecen automáticamente cuando la luz expone <code>dimming</code>, <code>color_temperature</code> o <code>color</code>.</p>
+<p>Mientras Hue Bridge carga sus recursos, el editor de Luz muestra un reloj de arena animado y comprueba su disponibilidad cada 500 ms. Después de unos 10 segundos libera el editor, mantiene ocultas las pestañas de mapeo y muestra un error localizado. Guardar, cerrar o cambiar de función cancela la espera pendiente.</p>
+<p>Cuando hay un gateway seleccionado, los campos de mapeo aceptan una dirección de grupo KNX o un nombre importado de ETS; los datapoints compatibles se cargan desde ese gateway.</p>
+<p>El botón de migración solo aparece cuando el editor de Node-RED detecta al menos un nodo HUE legacy en los flujos actuales. El mismo botón naranja también está disponible bajo el aviso de obsolescencia de cada editor HUE legacy. Esta comprobación es de solo lectura; la conversión sigue usando exclusivamente el JSON pegado explícitamente por el usuario.</p>
+<p><strong>Convertir flujo HUE legacy</strong> acepta una exportación completa de un flujo Node-RED y devuelve JSON copiable donde cada nodo HUE legacy compatible se sustituye por HUE Controller. La conversión es local y conserva identificadores, referencias de configuración, propiedades, posiciones y conexiones; el flujo abierto nunca se modifica.</p>
+<p>Node-RED excluye deliberadamente las credenciales de los flujos exportados. Al importar en la misma instalación, mantén seleccionada la opción <strong>Reutilizar los nodos de configuración Hue y KNX existentes</strong>: se omiten los objetos de configuración referenciados, pero sus identificadores permanecen en los nodos convertidos para conservar las claves y contraseñas existentes. Desmarca la opción solo para otra instalación y vuelve a introducir allí las credenciales después de importar.</p>
+<p><strong>Copiar flujo convertido</strong> utiliza la API del portapapeles del navegador y una textarea temporal como alternativa. Si ambos métodos están bloqueados, se selecciona el JSON de salida para copiarlo manualmente.</p>
+<p>Los eventos Hue siguen siendo actualizaciones de estado y no se convierten en nuevos comandos Hue. HUE Controller contiene perfiles privados de runtime, editor, plantillas y traducciones, por lo que no depende de que se carguen los tipos de nodo obsoletos. El nodo Hue Light original permanece sin cambios. Los nodos Hue dedicados siguen registrados para los flujos existentes, pero quedan congelados y no recibirán nuevas funciones ni actualizaciones de mantenimiento. Node-RED oculta de la paleta su categoría especial <code>deprecated</code>; las instancias existentes siguen siendo editables y desplegables, usan un color más claro que HUE Controller, aparecen marcadas con <code>(deprecated)</code> en el lienzo y muestran un aviso de migración en la parte superior del editor.</p>
+
+<!-- HUE_CONTROLLER_PROFILE_HELP_START -->
+
+## Función del dispositivo
+
+- [Luz / grupo de luces (`light`)](#hue-controller-help-light)
+- [Enchufe / salida (`plug`)](#hue-controller-help-plug)
+- [Botón (`button`)](#hue-controller-help-button)
+- [Tap dial (`relative_rotary`)](#hue-controller-help-relative_rotary)
+- [Movimiento (`motion`)](#hue-controller-help-motion)
+- [Movimiento de área (`area_motion`)](#hue-controller-help-area_motion)
+- [Movimiento de cámara (`camera_motion`)](#hue-controller-help-camera_motion)
+- [Contacto (`contact`)](#hue-controller-help-contact)
+- [Nivel de luz (`light_level`)](#hue-controller-help-light_level)
+- [Temperatura (`temperature`)](#hue-controller-help-temperature)
+- [Humedad (`humidity`)](#hue-controller-help-humidity)
+- [Escena (`scene`)](#hue-controller-help-scene)
+- [Batería (`device_power`)](#hue-controller-help-device_power)
+- [Conectividad Zigbee (`zigbee_connectivity`)](#hue-controller-help-zigbee_connectivity)
+- [Actualización de software (`device_software_update`)](#hue-controller-help-device_software_update)
+
+<span id="hue-controller-help-light" data-hue-controller-type="light"></span>
+
+## Luz / grupo de luces (`light`)
+
+<p> Este nodo controla las luces de Hue Philips (single o agrupada) y mapea sus comandos/estados a KNX. </p>
+
+**General**
+
+| Propiedad | Descripción |
+|-|-|
+| KNX GW | Seleccione la puerta de enlace KNX para ser utilizada |
+| Hue Bridge | Seleccione la Hue Bridge que se utilizará |
+| Nombre | Luz de tono o luz agrupada para usar (autocompletar mientras escribe). |
+
+<br/>
+
+**Localizar dispositivo**
+
+El botón `Locate` (icono de reproducción) inicia una sesión de identificación Hue para el recurso seleccionado. Mientras la sesión está activa, el botón muestra el icono de parada y el bridge hace parpadear la luz — o todas las luces del grupo — cada segundo. Pulsa de nuevo el botón para detenerla al instante; en caso contrario finalizará automáticamente tras 10 minutos.
+
+<br/>
+
+**Opciones**
+
+Aquí puede vincular las direcciones del grupo KNX con los comandos/estados de tono disponibles. <br/>
+Comenzar a escribir en el campo GA (nombre o dirección de grupo); Aparecen sugerencias mientras escribe.
+
+**Cambiar**
+
+| Propiedad | Descripción |
+|-|-|
+| Control | Este GA se usa para encender/apagar la luz del tono a través de un valor booleano KNX verdadero/falso |
+| Estado | Enlace esto a la dirección de grupo de estado del interruptor de la luz |
+
+<br/>
+
+**Oscuro**
+
+| Propiedad | Descripción |
+|-|-|
+| Control Dim | Relativo tenue de la luz del tono. Puede establecer la velocidad de atenuación en la pestaña **Comportamiento** . |
+| Control % | Cambia el brillo de la luz del tono absoluto (0-100%) |
+| Estado % | Enlace esto al estado de brillo de la luz Dirección de grupo KNX |
+| Velocidad dim (MS) | Velocidad de atenuación en milisegundos. Se aplica tanto al brillo de la luz como a los puntos de datos de color blanco sintonizable. Calculado sobre el rango 0% → 100%. |
+| Min Dim brillo | El brillo mínimo que la lámpara puede alcanzar. Por ejemplo, si está atenuando la luz hacia abajo, la luz dejará de atenuar en el %de brillo especificado. |
+| Brillo dim en el máximo | El brillo máximo que la lámpara puede alcanzar. Por ejemplo, si está atenuando la iluminación, la luz dejará de atenuar en el %de brillo especificado. |
+
+<br/>
+
+**blanco sintonizable**
+
+| Propiedad | Descripción |
+|-|-|
+| Control Dim | Cambie la temperatura blanca usando DPT 3.007 atenuación. La velocidad se establece en la pestaña **comportamiento** . |
+| Control % | Cambie la temperatura blanca usando DPT 5.001. 0 = completo cálido, 100 = frío completo. |
+| Estado %| Estado de temperatura GA. DPT 5.001 Valor absoluto: 0 = completo cálido, 100 = frío completo. |
+| Control Kelvin | **DPT 7.600: ** Temperatura establecida en Kelvin usando el rango KNX 2000-6535 (convertido en Hue Mirek). <br/>**DPT 9.002:** Temperatura establecida usando el rango de Hue 2000-6535 K (la ambiente comienza a 2200 K). Las conversiones pueden introducir pequeñas desviaciones. |
+| Estado Kelvin | **DPT 7.600: ** Lea la temperatura en Kelvin usando el rango KNX 2000-6535 (convertido desde el tono). <br/>**DPT 9.002:** Temperatura de lectura usando el rango de Hue 2000-6535 K (la ambiente comienza en 2200 K). Las conversiones pueden introducir pequeñas desviaciones. |
+| Invertir la dirección tenue | Invierte la dirección tenue. |
+<br/>
+
+**RGB/HSV**
+
+| Propiedad | Descripción |
+|-|-|
+| **Sección RGB** ||
+| Control rgb | Cambie de color usando el triplete RGB (R, G, B). Se maneja la corrección de gama. Enviar un color enciende la luz y establece color/brillo (perceptual). Enviar R, G, B = 0 apaga la luz. |
+| Estado RGB | Dirección de grupo de estado de color de la luz. DataPoint aceptado es RGB Triplet (R, G, B) |
+| **Sección HSV** ||
+| Color H Dim | Ciclo a través de HSV Hue usando DPT 3.007 Dimming. La velocidad se establece en la pestaña **comportamiento** . |
+| Estado H %| Estado del círculo cromático HSV. |
+| Control s dim | Cambia la saturación de color de la luz, utilizando DPT 3.007 atenuado. Puede establecer la velocidad de atenuación en la pestaña **_ comportamiento _** |
+| Estado s %| La dirección de grupo de estado de saturación de color de luz. |
+| Velocidad dim (MS) | La velocidad de atenuación, en milisegundos, de escala de abajo hacia arriba. |
+
+Para controlar el HSV "V" (brillo), use los controles estándar en la pestaña **Dim** .
+
+<br/>
+
+**Efectos**
+
+_Non-Hue Efectos básicos_
+
+| Propiedad | Descripción |
+|-|-|
+| Parpadeo | _true_ parpadear la luz, _false_ deja de parpadear. Parpadea la luz encendida y apagada. Útil para la señalización. Funciona con todas las luces de tono. |
+| Ciclo de color | _true_ ciclo de inicio, _false_ ciclo de detención. Cambia aleatoriamente el color de la luz del tono a intervalo regular. Funciona con todas las luces de tono que tienen capacidades de color. El efecto de color comenzará 10 segundos después del conjunto. |
+
+_Extos efectos nativos_
+
+Use la tabla **Hue Native Effects** para asignar sus valores de KNX a los efectos respaldados por la luz seleccionada (por ejemplo, `vela`,` chimenea`, `prism`). Cada fila vincula un valor KNX (booleano, numérico o textual, dependiendo del punto de datos que elija) con un efecto de tono. En el lado de KNX puedes:
+
+- Envíe el valor asignado para activar ese efecto;
+- Opcionalmente, proporcione una dirección de grupo de estado: el nodo emite el valor asignado cada vez que el puente HUE informa un cambio de efecto; Si no existe mapeo, se envía el nombre del efecto sin procesar (requiere un DPT textual como 16.xxx).
+
+<br/>
+
+**Comportamiento**
+
+| Propiedad | Descripción |
+| ----------------------------------------- | --------------------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------------------- |
+| Leer el estado al inicio | Lea el estado de la luz del tono en la inicio de nodo-rojo o el despliegue completo de Node-Red, y envíe ese estado al bus KNX |
+| Estado de brillo KNX | Actualiza el estado de la dirección del grupo de brillo KNX, siempre que la lámpara de tono se encienda/apague. Las opciones son **cuando la luz del tono está apagada, envíe 0%. Cuando se enciende, restaure el valor anterior (comportamiento de KNX predeterminado) ** y**dejar como es (comportamiento de tono predeterminado) ** . Si tiene KNX Dimmer con estado de brillo, como MDT, la opción sugerida es _**cuando la luz del tono está apagada, envíe 0%. Cuando se enciende, restaure el valor anterior (comportamiento predeterminado KNX)** _ |
+| Actualizar el estado local en caché de Hue a partir de escrituras del bus KNX | Opcion avanzada, activada por defecto. Si esta activa, las escrituras que llegan desde el bus KNX tambien actualizan inmediatamente el estado local en cache de Hue del nodo, sin esperar al feedback/evento del bridge Hue. Esto da reacciones locales mas rapidas y respuestas inmediatas de lectura KNX mas coherentes, especialmente cuando la luz o el grupo estan apagados. Desactivela si prefiere que la cache siga solo el feedback/evento real del bridge Hue. |
+| Encender el comportamiento | Establece el comportamiento de sus luces cuando se enciende. Puede elegir entre diferentes comportamientos. <br/> **Seleccione Color: ** La luz se encenderá con el color de su elección. Para cambiar el color, simplemente haga clic en el selector de color (debajo del control de color_select). <br/>**Seleccione la temperatura y el brillo: ** La luz se encenderá con la temperatura (Kelvin) y el brillo (0-100) de su elección. <br/>**Ninguna:** La luz retendrá su último estado. En caso de que haya habilitado la iluminación nocturna, después de finalizar la noche, la lámpara reanudará el estado de color/temperatura/brillo establecido durante el día. |
+| Iluminación nocturna | Permite establecer un color/brillo de luz particular por la noche. Las opciones son las mismas que el día. Puede seleccionar una temperatura/brillo o color. Una temperatura acogedora de 2700 Kelvin, con un brillo del 10% o 20%, es una buena opción para la luz nocturna del baño. |
+| Día/noche | Seleccione la dirección de grupo utilizada para establecer el comportamiento diurno/nocturno. El valor de la dirección de grupo es _true_ if Daytime, _false_ si nocturno. |
+| Invertir valor día/noche | Invierta los valores de la dirección de grupo _day/noche_. El valor predeterminado está **sin control** . |
+| Leer el estado al inicio | Lea el estado en el inicio y emita el evento al autobús KNX al inicio/reconexión. (Predeterminado "no") |
+| Forzar el modo diurno | Puede forzar el modo diurno cambiando manualmente la luz como se describe aquí: **Cambie al modo de día apagando rápidamente la lighia y luego (solo esta luz) ** hace lo que describe y actúa solo en esta luz.**Cambie al modo diurno apagando rápidamente la lighia y luego (aplique todos los nodos de luz)** Actúa a todos los nodos de luz, configurando la dirección del grupo diurno/nocturno en el modo de día. |
+| Pins de entrada/salida de nodo | Ocultar o mostrar los pines de entrada/salida. Los pines de entrada/salida permiten que el nodo acepte la entrada MSG del flujo y envíe la salida MSG al flujo. La entrada MSG debe seguir los estándares de HUE API v.2. Este es un mensaje de ejemplo, que enciende la luz: <code> msg.on = {"on": true} </code>. Consulte la [página oficial de la API de Hue](https://developers.meethue.com/develop/hue-api-v2/api-reference/#resource_light__id__put) |
+
+##### Nota
+
+La función de atenuación funciona en el modo **KNX `Start` y`stop` ** . Para comenzar a atenuar, envíe solo un telegrama de "inicio" KNX. Para dejar de atenuar, envíe un telegrama de "parar" KNX.**Recuerde que** , cuando configura las propiedades de su pared Swiches.
+
+<br/>
+
+---
+
+<span id="hue-controller-help-plug" data-hue-controller-type="plug"></span>
+
+## Enchufe / salida (`plug`)
+
+### Enchufe / salida de tono
+
+#### Descripción general
+
+El nodo de enchufe de Hue enlaza un enchufe inteligente Philips Hue (servicio `plug``) con direcciones de grupo KNX para que pueda controlar la alimentación y rastrear el estado directamente desde el bus.
+
+- Admite **Control de encendido/apagado** y **Comentarios de estado**.
+- Mapeo opcional del tono `power_state` (en / en espera).
+- Puede exponer los pines de entrada/salida de Node-Red para reenviar eventos de HUE a flujos o enviar cargas útiles de API avanzadas.
+
+#### Configuración
+
+| Campo | Descripción |
+|-|-|
+|KNX GW |KNX Gateway utilizado para telegramas |
+|Hue Bridge |Hue Bridge configurada |
+|Nombre |Seleccione el enchufe de tono de la lista de autocompletar |
+|Control |KNX GA para comandos de encendido/apagado (DPT booleano) |
+|Estado |GA para la retroalimentación de encendido/apagado proveniente de Hue |
+|Estado de poder |Hue opcional GA de reflejo `power_state` (boolean/text) |
+|Leer el estado al inicio |Cuando está habilitado, el nodo emite el estado de enchufe actual en la implementación/conexión |
+|Pins de E/S de nodo |Habilite los pasadores de entrada/salida de nodo-rojo.La entrada espera cargas útiles de API de tono (por ejemplo, `{en: {on: true}}`).Salir reenvía cada evento de Hue.|
+
+#### consejos de mapeo KNX
+
+- Use un punto de datos booleano (por ejemplo, DPT 1.001) para el comando y el estado.
+- Si expone `power_state`, asigna a un ga booleano (true =` on`, false = `en espera`).
+- Para solicitudes de lectura (`groupValue_read`) El nodo devuelve el último valor de tono en caché.
+
+#### Integración de flujo
+
+Cuando _node I/o Pins_ están habilitados:
+
+- **Entrada:** Enviar cargas útiles de Hue V2 para realizar acciones avanzadas (por ejemplo, `msg.on = {on: true}`).
+- **Salida:** Recibe un objeto de evento `{carga útil: boolean, on, power_state, rawevent}` cada vez que Hue informa un cambio.
+
+#### Referencia de API de Hue
+
+El nodo usa `/recurse/plug/{id}` sobre https.Los cambios de estado se entregan a través de la transmisión de eventos HUE y se almacenan en caché para las respuestas de lectura de KNX.
+
+---
+
+<span id="hue-controller-help-button" data-hue-controller-type="button"></span>
+
+## Botón (`button`)
+
+<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.
+
+**General**
+
+| Propiedad | Descripción |
+|-|-|
+|KNX GW |Seleccione la puerta de enlace KNX para ser utilizada |
+|Hue Bridge |Seleccione la Hue Bridge que se utilizará |
+|Botón de tono |Botón Hue para ser utilizado (automáticamente mientras escribe) |
+
+**Cambiar**
+
+| Propiedad | Descripción |
+|-|-|
+|Interruptor |GA activado por <code> Short \ _Release </code> (Press/versión rápida).|
+|Estado GA |Comentarios opcionales GA Cuando <em> Toggle Values ​​</em> está habilitado para mantener el estado interno de alternancia alineado con otros actuadores.|
+
+**Oscuro**
+
+| Propiedad | Descripción |
+|-|-|
+|Atenúa |GA utilizado durante <code> long \ _press </code>/<code> repetir </code> eventos para atenuar (típicamente DPT 3.007).|
+
+**Comportamiento**
+
+| Propiedad | Descripción |
+|-|-|
+|Valores de al revés |Si está habilitado, el nodo alterna entre <código> True/False </code> y ACT/Down Dimmting Life cargas.|
+|Cambiar carga útil |La carga útil enviada a KNX/Flow cuando los valores de alternar están deshabilitados.|
+|Dim carga útil |La dirección enviada a KNX/Flow cuando los valores de alternar están deshabilitados.|
+
+##### salidas
+
+1. Salida estándar
+: `msg.payload` lleva el booleano (o objeto DIM) enviado a KNX;`msg.event` es la cadena de eventos de Hue (por ejemplo,` short_release`, `repetir`).
+
+##### Detalles
+
+`msg.event` espejos` button.button_report.event`.El evento de tono original está expuesto en `msg.rawevent`.Use el estado opcional GA para mantener el estado de alternar en sincronización con interruptores de pared u otros controladores.
+
+---
+
+<span id="hue-controller-help-relative_rotary" data-hue-controller-type="relative_rotary"></span>
+
+## Tap dial (`relative_rotary`)
+
+El nodo **TAP TAP** mapea el servicio rotativo del dial de toque de tono a KNX y reenvía los eventos de tono bruto a su flujo.Use el icono de actualización junto al campo del dispositivo después de combinar un nuevo dial en el puente.
+
+Pestañas ###
+
+- **Mapeo** - Seleccione KNX GA y DPT utilizados para los eventos de rotación.Puntos de datos compatibles: DPT 3.007 (DIM relativo), DPT 5.001 (nivel absoluto 0-100%) y DPT 232.600 (control de color del proveedor).
+- **Comportamiento** - Mostrar u ocultar el pin de salida de nodo -rojo.Cuando no se configura la puerta de enlace KNX, la salida se mantiene habilitada para que los eventos de tono aún alcancen el flujo.
+
+##### Configuración general
+
+| Propiedad | Descripción |
+|-|-|
+|KNX GW |KNX Gateway utilizada para GA Autocomplete.|
+|Hue Bridge |Hue Bridge aloja el dial de grifo.|
+|Dial de toque de tono |Dispositivo rotativo para controlar (automáticamente; el botón de actualización vuelve a cargar la lista).|
+
+Pestaña de mapeo ###
+
+| Propiedad | Descripción |
+|-|-|
+|Rotar GA |KNX GA recibe eventos de rotación (admite DPT 3.007, 5.001, 232.600).|
+|Nombre |Etiqueta amistosa para la GA.|
+
+##### salidas
+
+|#| Puerto | carga útil |
+|-|-|-|
+| 1 | Salida estándar | `msg.payload` (objeto) Evento de tono sin procesar emitido por el dial de toque. |
+
+> ℹ️ Los widgets específicos de KNX aparecen solo después de seleccionar una puerta de enlace KNX;La pestaña de mapeo permanece oculta hasta que se configuran tanto el puente como la puerta de enlace.
+
+---
+
+<span id="hue-controller-help-motion" data-hue-controller-type="motion"></span>
+
+## Movimiento (`motion`)
+
+<p> Este nodo escucha un sensor de movimiento de tono y refleja los eventos para KNX y/o su flujo de nodo-rojo. </p>
+
+Comience a escribir el nombre del dispositivo KNX o la dirección de grupo en el campo GA;Aparecen sugerencias mientras escribe.Presione el botón Actualizar junto a "Sensor Hue" para volver a cargar la lista de dispositivos desde el puente si agrega nuevos sensores.
+
+**General**
+
+| Propiedad | Descripción |
+|-|-|
+|KNX GW |KNX Gateway que recibe las actualizaciones de movimiento (requeridas antes de que aparezcan los campos de mapeo KNX).|
+|Hue Bridge |Hue Bridge para la consulta.|
+|Sensor de movimiento de tono |Sensor de movimiento de Hue (admite autocompletar y actualizar).|
+
+**Cartografía**
+
+| Propiedad | Descripción |
+|-|-|
+|Movimiento |KNX GA que recibe `verdadero` cuando se detecta el movimiento y` falso 'cuando el área está clara.DPT recomendado: <b> 1.001 </b>.|
+
+**Comportamiento**
+
+| Propiedad | Descripción |
+|-|-|
+|Pin de salida del nodo |Mostrar u ocultar la salida de nodo-rojo.Cuando no se selecciona la puerta de enlace KNX, el pin de salida permanece habilitado para que los eventos de movimiento de tono aún alcancen su flujo.|
+
+> ℹ️ Los widgets KNX permanecen ocultos hasta que seleccione una puerta de enlace KNX, lo que facilita el uso del nodo puramente como un oyente rojo de nodo.
+
+##### Producción
+
+1. Salida estándar - `msg.payload` (boolean)
+: `True` on Motion,` False` cuando termina el movimiento.
+
+---
+
+<span id="hue-controller-help-area_motion" data-hue-controller-type="area_motion"></span>
+
+## Movimiento de área (`area_motion`)
+
+<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.
+
+**General**
+
+|Propiedad|Descripción|
+|--|--|
+| KNX GW | Pasarela KNX que recibe el estado de movimiento del área. |
+| HUE Bridge | Puente Hue Pro que se utilizará. |
+| HUE Area | Área MotionAware (convenience o security) que se va a supervisar (autocompletar al escribir). |
+| Leer estado al inicio | Al iniciar/reconectar lee el valor actual y lo envía a KNX (por defecto: sí). |
+
+**Mapeo**
+
+|Propiedad|Descripción|
+|--|--|
+| Movimiento | GA KNX para el estado de movimiento del área (booleano). DPT recomendado: <b>1.001</b>. |
+
+**Comportamiento**
+
+|Propiedad|Descripción|
+|--|--|
+| Pin de salida del nodo | Muestra u oculta la salida de Node-RED. Sin pasarela KNX el pin permanece activo para que los eventos MotionAware sigan llegando al flujo. |
+
+##### Salidas
+
+1. Salida estándar
+   : `msg.payload` (booleano): `true` cuando se detecta movimiento en el área, `false` en caso contrario. |
+
+##### Detalles
+
+`msg.payload` contiene el último estado de movimiento agregado que proporciona el servicio MotionAware del área seleccionada.
+
+---
+
+<span id="hue-controller-help-camera_motion" data-hue-controller-type="camera_motion"></span>
+
+## Movimiento de cámara (`camera_motion`)
+
+<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.
+
+**General**
+
+| Propiedad | Descripción |
+|-|-|
+|KNX GW |Seleccione la puerta de enlace KNX para ser utilizada |
+|Hue Bridge |Seleccione la Hue Bridge que se utilizará |
+|Movimiento de la cámara de tono |Sensor de movimiento de la cámara de tono (autocompletar mientras se escribe) |
+|Leer el estado al inicio |En Startup/Reconnect, lea el valor actual y envíelo a KNX (predeterminado: no) |
+
+**Cartografía**
+
+| Propiedad | Descripción |
+|-|-|
+|Movimiento |KNX GA para el movimiento de la cámara (booleano).DPT recomendado: <b> 1.001 </b> |
+
+##### salidas
+
+1. Salida estándar
+: `msg.payload` (boolean):` true` cuando se detecta el movimiento;de lo contrario `falso '
+
+##### Detalles
+
+`msg.payload` conlleva el último estado de movimiento informado por el servicio de cámara Hue.
+
+---
+
+<span id="hue-controller-help-contact" data-hue-controller-type="contact"></span>
+
+## Contacto (`contact`)
+
+<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.
+
+**General**
+
+| Propiedad | Descripción |
+|-|-|
+|KNX GW |Seleccione la puerta de enlace KNX para ser utilizada |
+|Hue Bridge |Seleccione la Hue Bridge que se utilizará |
+|Sensor de contacto de tono |Sensor de contacto de Hue para ser utilizado (autocompletar mientras se escribe). |
+
+|Propiedad |Descripción |
+|-|-|
+|Contacto |Cuando el contacto se abre/cierra, envíe el valor de KNX: _true_ en activo/abierto, de lo contrario _false_.|
+
+##### salidas
+
+1. Salida estándar
+: carga útil (boolean): la salida estándar del comando.
+
+##### Detalles
+
+`msg.payload` lleva el evento de tono bruto (booleano/objeto).Úselo para una lógica personalizada si es necesario.
+
+---
+
+<span id="hue-controller-help-light_level" data-hue-controller-type="light_level"></span>
+
+## Nivel de luz (`light_level`)
+
+<p> Este nodo lee eventos de Lux de un sensor de luz de tono y los mapea a KNX. </p>
+
+Emite la iluminancia ambiental (lux) cada vez que cambia.Comience a escribir en el campo GA (nombre o dirección de grupo) para vincular el KNX GA;Los dispositivos aparecen mientras escribe.
+
+**General**
+
+| Propiedad | Descripción |
+|-|-|
+|KNX GW |Seleccione la puerta de enlace KNX para ser utilizada |
+|Hue Bridge |Seleccione la Hue Bridge que se utilizará |
+|Sensor de luz de tono |Sensor de luz Hue para usar (autocompletar mientras escribe). |
+|Leer el estado al inicio |Lea el estado en el inicio y emita el evento al autobús KNX al inicio/reconexión.(Predeterminado "no") |
+
+**Cartografía**
+
+|Propiedad |Descripción |
+|-|-|
+|Lux |KNX GA que recibe el valor de Lux.|
+
+##### salidas
+
+1. Salida estándar
+: carga útil (número): valor de lux actual.
+
+##### Detalles
+
+`msg.payload` lleva el valor numérico de lux.Úselo para una lógica personalizada si es necesario.
+
+---
+
+<span id="hue-controller-help-temperature" data-hue-controller-type="temperature"></span>
+
+## Temperatura (`temperature`)
+
+<p> Este nodo lee la temperatura (° C) de un sensor de temperatura del tono y lo asigna 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.
+
+**General**
+
+| Propiedad | Descripción |
+|-|-|
+|KNX GW |Seleccione la puerta de enlace KNX para ser utilizada |
+|Hue Bridge |Seleccione la Hue Bridge que se utilizará |
+|Sensor de temperatura del tono |Sensor de temperatura del tono (autocompletado mientras se escribe) |
+|Leer el estado al inicio |En Startup/Reconext, lea el valor actual y envíelo a KNX (predeterminado: no) |
+
+**Cartografía**
+
+| Propiedad | Descripción |
+|-|-|
+|Temperatura |KNX GA para la temperatura en Celsius.DPT recomendado: <b> 9.001 </b> |
+
+##### salidas
+
+1. Salida estándar
+: `msg.payload` (número): temperatura actual en ° C
+
+##### Detalles
+
+`msg.payload` lleva el valor de temperatura numérica.
+
+---
+
+<span id="hue-controller-help-humidity" data-hue-controller-type="humidity"></span>
+
+## Humedad (`humidity`)
+
+<p> Este nodo lee la humedad relativa (%) de un sensor de humedad de tono y lo asigna 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.
+
+**General**
+
+| Propiedad | Descripción |
+|-|-|
+|KNX GW |Seleccione la puerta de enlace KNX para ser utilizada |
+|Hue Bridge |Seleccione la Hue Bridge que se utilizará |
+|Sensor de tono |Sensor de humedad de tono (autocompletado mientras se escribe) |
+|Leer el estado al inicio |En Startup/Reconext, lea el valor actual y envíelo a KNX (predeterminado: no) |
+
+**Cartografía**
+
+| Propiedad | Descripción |
+|-|-|
+|Humedad |KNX GA para la humedad relativa %.DPT recomendado: <b> 9.007 </b> |
+
+##### salidas
+
+1. Salida estándar
+: `msg.payload` (número): humedad relativa actual en %
+
+##### Detalles
+
+`msg.payload` lleva el valor de humedad numérica (porcentaje).
+
+---
+
+<span id="hue-controller-help-scene" data-hue-controller-type="scene"></span>
+
+## Escena (`scene`)
+
+La escena **Hue** nodo expone escenas de tono a KNX y puede reenviar los eventos de tono bruto a un flujo de rojo de nodo.El campo de la escena admite autocompletar;Use el icono de actualización después de agregar escenas en el puente para que la lista se mantenga actualizada.
+
+##### pestañas de un vistazo
+
+- **Mapeo** - Enlace las direcciones de grupo KNX a la escena del tono seleccionada.DPT 1.xxx realiza un retiro booleano, mientras que DPT 18.xxx envía un número de escena KNX.
+- **Multi Scene** - Cree una lista de reglas que asocie los números de escena KNX con diferentes escenas de tono y elige si cada escena se recuerda como _Active_, _Dynamic \ _palette_ o _static_.
+- **Comportamiento** - Alternar el pin de salida de nodo -rojo.Cuando no se configura la puerta de enlace KNX, el PIN permanece habilitado para que los eventos del puente aún alcancen el flujo.
+
+##### Configuración general
+
+| Propiedad | Descripción |
+|-|-|
+|KNX GW |KNX Gateway que suministra el catálogo de direcciones utilizado para autocompletar.|
+|Hue Bridge |Hue Bridge que alberga las escenas.|
+|Escena de tono |Escena para recuperar (Autocompletar; Refresh Button Recargue el catálogo del puente).|
+
+Pestaña de mapeo ###
+
+| Propiedad | Descripción |
+|-|-|
+|Recordar |Dirección del grupo KNX que recuerda la escena.Use DPT 1.xxx para el control booleano o DPT 18.xxx para transmitir un número de escena KNX.|
+|DPT |DataPoint utilizado con el GA de recuperación (1.xxx o 18.001).|
+|Nombre |Etiqueta amistosa para el retiro GA.|
+|# |Aparece cuando se elige una escena KNX DPT;Seleccione el número de escena KNX para enviar.|
+|Estado GA |GA booleano opcional que refleja si la escena está actualmente activa.|
+
+##### Pestaña de escena múltiple
+
+| Propiedad | Descripción |
+|-|-|
+|Recordar |KNX GA (DPT 18.001) que selecciona escenas por número.|
+|Selector de escenas |Lista editable que mapea los números de escena KNX a las escenas de Hue con el modo de recuperación deseado.Arrastres maneja entradas de reorden.|
+
+> ℹ️ Los widgets específicos de KNX solo aparecen después de que se selecciona una puerta de enlace KNX.Las pestañas de mapeo permanecen ocultas hasta que se configuran tanto el puente como la puerta de enlace.
+
+---
+
+<span id="hue-controller-help-device_power" data-hue-controller-type="device_power"></span>
+
+## Batería (`device_power`)
+
+<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.
+
+**General**
+
+| Propiedad | Descripción |
+|-|-|
+|KNX GW |KNX Gateway solía publicar el nivel de la batería (requerido antes de que aparezcan los campos de mapeo KNX).|
+|Hue Bridge |Hue Bridge que aloja el dispositivo.|
+|Sensor de batería de tono |Dispositivo/sensor de tono que proporciona el nivel de la batería (admite autocompletar y actualizar).|
+
+**Cartografía**
+
+| Propiedad | Descripción |
+|-|-|
+|Nivel |KNX GA para el porcentaje de batería (0-100%).DPT recomendado: <b> 5.001 </b>.|
+
+**Comportamiento**
+
+| Propiedad | Descripción |
+|-|-|
+|Leer el estado al inicio |En implementar/reconectar, lea el valor actual de la batería y publíquelo en KNX.Valor predeterminado: "Sí".|
+|Pin de salida del nodo |Mostrar u ocultar la salida de nodo-rojo.Cuando no se selecciona la puerta de enlace KNX, la salida permanece habilitada, por lo que los eventos de tono continúan alcanzando el flujo.|
+
+> ℹ️ KNX Mapping Widgets permanece oculto hasta que se selecciona una puerta de enlace KNX.Esto mantiene el editor ordenado cuando el nodo se usa solo para reenviar los eventos de Hue en Node-Red.
+
+---
+
+<span id="hue-controller-help-zigbee_connectivity" data-hue-controller-type="zigbee_connectivity"></span>
+
+## Conectividad Zigbee (`zigbee_connectivity`)
+
+<p> Este nodo recupera el estado de conectividad Zigbee de un dispositivo de tono y lo expone a KNX. </p>
+
+Comience a escribir el nombre del dispositivo KNX o la dirección de grupo en el campo GA;Aparecen sugerencias mientras escribe.
+
+**General**
+
+| Propiedad | Descripción |
+|-|-|
+|KNX GW |KNX Gateway solía publicar el estado.|
+|Hue Bridge |Hue Bridge para la consulta.|
+|Conectividad de tono zigbee |Sensor/dispositivo de tono que proporciona la información de conectividad Zigbee.Autocompletar mientras se escribe.|
+
+**Cartografía**
+
+| Propiedad | Descripción |
+|-|-|
+|Estado |Dirección de grupo KNX que refleja la conectividad Zigbee.Se convierte en _true_ cuando está conectado, de lo contrario _false_.|
+|Leer el estado al inicio |Lee el estado actual en el editor inicial/reconexión y emite a KNX.Valor predeterminado: "Sí".|
+
+##### salidas
+
+1. Salida estándar
+: carga útil (boolean): estado de conectividad.
+
+##### Detalles
+
+`msg.payload` lleva el estado booleano (verdadero/falso). \
+`msg.status` contiene un estado textual: uno de **conectado, desconectado, conectividad \ _SISMO, unidireccional \ _Incoming** .
+
+---
+
+<span id="hue-controller-help-device_software_update" data-hue-controller-type="device_software_update"></span>
+
+## Actualización de software (`device_software_update`)
+
+<p> Este nodo monitorea si un dispositivo de Hue seleccionado tiene una actualización de software disponible y publica el estado a KNX. </p>
+
+Comience a escribir el nombre o la dirección de grupo de su dispositivo KNX en el campo GA, los dispositivos avaiables comienzan a aparecer mientras
+Estás escribiendo.
+
+**General**
+
+| Propiedad | Descripción |
+|-|-|
+|KNX GW |Seleccione la puerta de enlace KNX para ser utilizada |
+|Hue Bridge |Seleccione la Hue Bridge que se utilizará |
+|Dispositivo para tonos |Dispositivo de Hue para monitorear las actualizaciones de software (autocompletar mientras escribe). |
+
+**Cartografía**
+
+|Propiedad |Descripción |
+|-|-|
+|Estado |KNX GA refleja el estado de actualización._true_ Si una actualización está disponible/lista/está instalada, de lo contrario _false_.|
+|Leer el estado al inicio |Lea el estado actual al inicio/reconexión y emita a KNX (predeterminado "sí").|
+
+##### salidas
+
+1. Salida estándar
+: carga útil (boolean): indicador de actualización.
+: status (string): uno de **no \ _Update, actualizar \ _pending, listo \ _to \ _install, instalación** .
+
+<!-- HUE_CONTROLLER_PROFILE_HELP_END -->
+</script>