HUE Controller

KNX-Ultimate video tutorials (YouTube playlist)

Todo desde un único nodo

Una experiencia Controller coherente

• Un selector Hue orientado al dispositivo con autocompletado y actualización; la función correspondiente se obtiene automáticamente.
• Al hacer clic o enfocar el campo del dispositivo siempre se abre la lista Hue completa, incluso después de una selección; al escribir se filtra.
• Mapeos de luz según capacidades: regulación, blanco regulable, RGB/HSV y efectos nativos siguen las propiedades en vivo dimming, color_temperature, color y effects del recurso de luz Hue API v2 seleccionado.
• Espera de disponibilidad limitada en el editor de Luz: aparece un reloj de arena animado mientras Hue Bridge carga sus recursos, con comprobaciones cada 500 ms y liberación tras unos 10 segundos junto con un error localizado. Guardar, cerrar o cambiar de función cancela el temporizador.
• Las filas KNX compactas mantienen GA, DPT y Nombre en una sola línea; DPT y Nombre usan anchos reducidos, y Nombre puede contraerse en editores estrechos sin modificar el valor guardado. Los valores DPT guardados se conservan mientras las opciones del selector se cargan de forma asíncrona.
• Gateway KNX opcional: usa direcciones de grupo o nombres ETS importados; los datapoints compatibles proceden del gateway seleccionado.
• Puertos Node-RED dinámicos para entradas Hue API v2 validadas y eventos Hue, cuando sean compatibles.
• Lectura inicial, sincronización de estado Hue→KNX y protección contra bucles conservadas en cada perfil privado.
• Migración totalmente local de los quince tipos obsoletos, seguida de un borrador de correo editable, un botón de apoyo opcional en el mensaje final, revisión local y Deploy manual.

Empieza en cuatro pasos

1. Configura una vez el Bridge Hue.
2. Añade HUE Controller y elige o actualiza un Dispositivo Hue; el Tipo de dispositivo se completa automáticamente.
3. Selecciona un Gateway KNX y mapea comandos/estados, o deja none para usarlo solo en el flujo.
4. Configura el comportamiento y los puertos propios de la función, despliega y comprueba el estado live del nodo.

¿Sin gateway KNX? El Controller sigue funcionando como integración Hue–Node-RED. Los campos KNX se ocultan y permanecen disponibles las opciones de flujo compatibles con la función elegida.

Las secciones siguientes forman la referencia completa por función, consolidada desde los antiguos nodos dedicados.

Convertir nodos HUE legacy

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. Un enlace al vídeo explicativo de la migración en YouTube aparece inmediatamente antes del mismo botón naranja de alto contraste con texto blanco en HUE Controller y en cada editor HUE legacy. El aviso confirma que ningún dato del flujo ni de los nodos sale del navegador.

Pulsa Convertir nodos HUE legacy y confirma. El navegador realiza toda la conversión localmente y no envía ningún dato de flujo, nodo, hue-config, knxUltimate-config, dirección de grupo, conexión, credencial, nombre, posición ni ID. Tras la conversión solo abre un borrador de correo editable dirigido al autor sin abandonar Node-RED. El borrador contiene únicamente el número de nodos convertidos y espacio para notas opcionales; tú decides si lo envías y nunca se manda automáticamente. El mensaje final de Node-RED ofrece un botón de apoyo opcional; la página de donación solo se abre al pulsarlo.

Antes de empezar, exporta una copia de seguridad de tus flujos. El navegador cierra el editor del nodo actual y transforma únicamente los nodos HUE legacy detectados en instancias de HUE Controller. Las propiedades guardadas, referencias de configuración, posiciones, grupos y conexiones permanecen intactos. El espacio de trabajo se marca como modificado, pero la herramienta nunca lo despliega automáticamente: revisa el resultado y pulsa Deploy personalmente. Un nodo modificado, un flujo bloqueado o un error de conversión local deja el espacio de trabajo sin cambios. Comprobación de seguridad: antes del Deploy, revisa cada nodo HUE modificado y comprueba su función, referencias de configuración, puertos de entrada/salida y conexiones. Al finalizar el proceso, un mensaje fijo de Node-RED permanece visible hasta que pulses OK.

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 deprecated; las instancias existentes siguen siendo editables y desplegables, usan un color más claro que HUE Controller, aparecen marcadas con (deprecated) en el lienzo y muestran un aviso de migración en la parte superior del editor.

Función del dispositivo

• Luz / grupo de luces (light)
• Enchufe / salida (plug)
• Botón (button)
• Tap dial (relative_rotary)
• Movimiento (motion)
• Movimiento de área (area_motion)
• Movimiento de cámara (camera_motion)
• Contacto (contact)
• Nivel de luz (light_level)
• Temperatura (temperature)
• Humedad (humidity)
• Escena (scene)
• Batería (device_power)
• Conectividad Zigbee (zigbee_connectivity)
• Actualización de software (device_software_update)

Luz / grupo de luces (light)

Este nodo controla las luces de Hue Philips (single o agrupada) y mapea sus comandos/estados a KNX.

General

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.

Opciones

Aquí puede vincular las direcciones del grupo KNX con los comandos/estados de tono disponibles.

Comenzar a escribir en el campo GA (nombre o dirección de grupo); Aparecen sugerencias mientras escribe.

Cambiar

Oscuro

blanco sintonizable

RGB/HSV

Para controlar el HSV “V” (brillo), use los controles estándar en la pestaña Dim .

Efectos

Non-Hue Efectos básicos

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).

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) ** ydejar 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. 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). **Seleccione la temperatura y el brillo: ** La luz se encenderá con la temperatura (Kelvin) y el brillo (0-100) de su elección. **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: msg.on = {"on": true} . Consulte la página oficial de la API de Hue |

Nota

La función de atenuación funciona en el modo KNX Start ystop ** . 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.

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

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.

Botón (button)

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 Botton.button_report.event .

Comience a escribir en el campo GA (nombre o dirección de grupo) para vincular el KNX GA;Los dispositivos aparecen mientras escribe.

General

Cambiar

Oscuro

Comportamiento

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.

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

Pestaña de mapeo ###

salidas

ℹ️ 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.

Movimiento (motion)

Este nodo escucha un sensor de movimiento de tono y refleja los eventos para KNX y/o su flujo de nodo-rojo.

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

Cartografía

Comportamiento

ℹ️ 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.

Movimiento de área (area_motion)

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.

Empiece a escribir en el campo GA (nombre o dirección de grupo) para vincular la GA KNX; las sugerencias aparecen mientras escribe.

General

Mapeo

Comportamiento

Salida

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.

Movimiento de cámara (camera_motion)

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.

Comience a escribir en el campo GA (nombre o dirección de grupo) para vincular el KNX GA;Los dispositivos aparecen mientras escribe.

General

Cartografía

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.

Contacto (contact)

Este nodo reenvía los eventos desde un sensor de contacto de tono y los asigna a las direcciones de grupo KNX.

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

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.

Nivel de luz (light_level)

Este nodo lee eventos de Lux de un sensor de luz de tono y los mapea a KNX.

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

Cartografía

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.

Temperatura (temperature)

Este nodo lee la temperatura (° C) de un sensor de temperatura del tono y lo asigna a KNX.

Comience a escribir en el campo GA (nombre o dirección de grupo) para vincular el KNX GA;Los dispositivos aparecen mientras escribe.

General

Cartografía

salidas

1. Salida estándar

   msg.payload (número): temperatura actual en ° C

Detalles

msg.payload lleva el valor de temperatura numérica.

Humedad (humidity)

Este nodo lee la humedad relativa (%) de un sensor de humedad de tono y lo asigna a KNX.

Comience a escribir en el campo GA (nombre o dirección de grupo) para vincular el KNX GA;Los dispositivos aparecen mientras escribe.

General

Cartografía

salidas

1. Salida estándar

   msg.payload (número): humedad relativa actual en %

Detalles

msg.payload lleva el valor de humedad numérica (porcentaje).

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

Pestaña de mapeo ###

Pestaña de escena múltiple

ℹ️ 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.

Batería (device_power)

Este nodo expone el nivel de batería de un dispositivo HUE a KNX y plantea un evento cada vez que cambia el valor.

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

Cartografía

Comportamiento

ℹ️ 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.

Conectividad Zigbee (zigbee_connectivity)

Este nodo recupera el estado de conectividad Zigbee de un dispositivo de tono y lo expone a KNX.

Comience a escribir el nombre del dispositivo KNX o la dirección de grupo en el campo GA;Aparecen sugerencias mientras escribe.

General

Cartografía

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 .

Actualización de software (device_software_update)

Este nodo monitorea si un dispositivo de Hue seleccionado tiene una actualización de software disponible y publica el estado a KNX.

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

Cartografía

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 .