HUE UltimateDocumentación

HUE Ultimate

Un Controller para cada dispositivo Hue

Controla luces, grupos, enchufes y escenas, o recibe eventos de botones y sensores de movimiento, contacto y ambiente. Selecciona un recurso Hue para ver sus funciones.

Los nodos funcionan directamente con mensajes Node-RED: msg.topic identifica la función y msg.payload contiene su valor. KNX Ultimate no es necesario.

Instalación

Esta beta pública está disponible para todos. Instala el paquete desde Gestionar paleta → Instalar y reinicia Node-RED. También puedes ejecutar el siguiente comando en la carpeta de usuario de Node-RED (normalmente ~/.node-red). Requiere Node.js 20.18.1 o posterior y Node-RED 3.1.1 o posterior. Instala node-red-contrib-knx-ultimate solo si necesitas la integración KNX.

npm install node-red-contrib-hue-ultimate

Uso con mensajes Node-RED

Activa los pines de entrada/salida e introduce nombres de topics en los campos de comando y estado. Deja vacío el gateway KNX; los campos DPT se ocultan porque no son necesarios. Usa topics distintos para comandos y estados. La coincidencia debe ser exacta; no se admiten comodines.

Modo KNX

También puedes usar este paquete con KNX Ultimate. La integración es nativa: instala node-red-contrib-knx-ultimate y selecciona su gateway para activar el Modo KNX. Los mismos campos usan entonces direcciones de grupo y DPT, con sugerencias del proyecto ETS importado. Comandos y estados pasan directamente por el bus; no hacen falta nodos Function intermedios para estas asignaciones.

Ajuste Mensajes Node-RED Modo KNX
Gateway KNX Déjalo vacío Selecciona el gateway existente
Campos de asignación Topics exactos, p. ej. living-room/on Direcciones de grupo, p. ej. 1/1/1
DPT Ocultos; no se utilizan Selecciona el tipo de dato correcto
Comandos y estados Mediante msg.topic y msg.payload Por el bus KNX

Al seleccionar un gateway, sustituye los topics guardados por direcciones de grupo reales y elige los DPT correctos. Si el gateway seleccionado está desconectado, el nodo permanece en Modo KNX. Para volver a los mensajes Node-RED, quita la selección del gateway y configura de nuevo los topics.

Migrar flows existentes

Haz una copia de toda la carpeta de usuario de Node-RED. Mantén KNX Ultimate 7, añade el paquete nuevo y reinicia. Elige Back up and convert, revisa el flow y pulsa Deploy antes de actualizar KNX Ultimate a la versión 8. Se conservan identificadores, conexiones y referencias de configuración. El JSON descargado no contiene credenciales protegidas.

Se convierten tanto los antiguos nodos Hue individuales como el Controller multimodal. Se conserva la función correspondiente y se convierte la configuración compartida Hue Bridge.