Integración de Node-RED

Accediendo a Node-RED

HyperVisu incluye una potente integración de Node-RED que te permite crear automatizaciones personalizadas e integrarte con sistemas externos. Node-RED es una herramienta de programación basada en flujos que facilita la conexión de dispositivos de hardware, APIs y servicios en línea sin necesidad de amplios conocimientos de codificación.

Para acceder a la aplicación Node-RED:

1. Navega a la interfaz de administración de HyperVisu escribiendo la dirección IP de tu servidor en un navegador web.
2. Inicia sesión con tus credenciales de administración (nombre de usuario y contraseña).
3. Haz clic en el botón "Node-RED" en la página de administración del servidor.
4. Se abrirá una nueva pestaña del navegador con la página de inicio de sesión de Node-RED.
5. Usa el mismo nombre de usuario y contraseña que la interfaz de administración de HyperVisu para acceder a Node-RED.

Nota: El entorno de Node-RED se ejecuta en el mismo hardware que tu servidor HyperVisu, por lo que todas las integraciones son locales y no requieren servicios en la nube externos.

Usando Nodos de HyperVisu

HyperVisu amplía Node-RED añadiendo nodos personalizados que representan cada tipo de widget en tu sistema de automatización del hogar. Estos nodos te permiten interactuar con tus dispositivos KNX directamente desde Node-RED.

Estructura del Nodo

La integración de HyperVisu con Node-RED gira en torno a un nodo principal "HyperVisu" que gestiona la conexión con el servidor y proporciona acceso a todos los widgets, habitaciones y categorías. Este nodo central establece y mantiene:

• Comunicación con el servidor
• Actualizaciones en tiempo real de los valores de los widgets

Nodos personalizados adicionales representan cada tipo de widget disponible en HyperVisu:

• Botón de presión - Para botones de presión con retroalimentación de estado opcional
• Interruptor de luz - Para interruptores ON/OFF específicamente para iluminación
• Interruptor ON/OFF - Para interruptores generales ON/OFF (enchufes, etc.)
• Salida analógica - Para enviar valores analógicos dentro de un rango predefinido
• Persiana/Estor - Para controlar persianas y estores
• Controlador de temperatura - Para control de calefacción/refrigeración
• Atenuador - Para atenuadores de luz estándar
• Atenuador RGB - Para controlar luces RGB(W)
• Atenuador de blanco ajustable - Para ajustar la temperatura de color de las luces blancas
• Entrada analógica - Para mostrar valores analógicos con tendencia opcional
• Entrada digital - Para mostrar valores de estado digital

También están disponibles nodos de comando global:

• Luces globales - Para controlar todas las luces en una habitación o categoría
• Persianas globales - Para controlar todas las persianas en una habitación o categoría
• Escenario - Para activar escenarios predefinidos

Cada nodo muestra su nombre y la habitación o categoría asociada dentro del nodo para una fácil identificación.

Entradas y Salidas

Los nodos de widgets generalmente tienen múltiples entradas y salidas que corresponden a las funciones del widget. Por ejemplo:

Nodo de atenuador:

• Entradas: Alternar, Encendido, Apagado, Punto de ajuste (valor de atenuación)
• Salidas: Estado (estado encendido/apagado), Valor (nivel de brillo), Comando de encendido, Comando de apagado

Nodo de persiana/estor:

• Entradas: Arriba, Abajo, Parar, Punto de ajuste de persiana, Punto de ajuste de lamas
• Salidas: Moviendo hacia arriba, Moviendo hacia abajo, Posición de la persiana, Posición de las lamas, Arriba, Abajo, Parar

Cuando un nodo recibe o envía datos:

• La carga útil del mensaje contiene el valor de la salida o entrada
• Un campo de tema contiene el ID del objeto del widget
• Un campo de widget contiene el ID del widget

Estos formatos estandarizados facilitan el procesamiento de mensajes entre nodos y la construcción de automatizaciones complejas.

Construyendo Flujos

Node-RED utiliza un enfoque de programación visual donde conectas nodos para crear "flujos" de datos.

Conectando Nodos

Para construir un flujo en el editor de Node-RED:

1. Encuentra los nodos de HyperVisu en la paleta de nodos en el lado izquierdo.
2. Arrastra el tipo de nodo deseado al flujo.
3. Conecta nodos arrastrando líneas entre la salida de un nodo y la entrada de otro.
4. Los nodos procesan mensajes secuencialmente a medida que fluyen a través de las conexiones.

Los patrones de flujo básicos incluyen:

• Flujos de activación: Un nodo de activación (como un evento de entrada o de tiempo) provoca una acción a través de un nodo de salida.
• Flujos de transformación: Los datos pasan a través de nodos de función que modifican valores antes de que lleguen a los nodos de salida.
• Flujos de decisión: Los nodos de conmutación dirigen los mensajes de manera diferente según los valores recibidos.
• Flujos de integración: Nodos de diferentes sistemas (MQTT, HTTP, etc.) se conectan para intercambiar datos.

Configurando Nodos

Cada nodo de HyperVisu debe configurarse para conectarse a un widget específico en tu sistema:

1. Haz doble clic en un nodo para abrir su panel de configuración.
2. Usa el menú desplegable para seleccionar el widget al que debe conectarse.
   • Filtra opciones por habitación, categoría y tipo de widget para encontrar el widget correcto.
   • La lista muestra todos los widgets del mismo tipo disponibles en tu configuración de HyperVisu.
3. Habilita/deshabilita la publicación en el broker MQTT si es necesario (envía valores de widgets al broker MQTT integrado).
4. Haz clic en Listo para guardar la configuración.

Para widgets virtuales, puedes enviar valores directamente desde Node-RED para actualizar el estado del widget, permitiéndote integrar sensores o sistemas que no están directamente conectados a tu bus KNX.

Desplegando Flujos

Después de construir y configurar tus flujos:

1. Haz clic en el botón Desplegar en la esquina superior derecha de la interfaz de Node-RED.
2. Espera el mensaje de confirmación que indica un despliegue exitoso.
3. Tus flujos ahora están activos y comenzarán a procesar datos.

El entorno de Node-RED guarda tus flujos automáticamente, y se reiniciarán cuando se reinicie el servidor HyperVisu.

Puedes ver el estado del flujo en tiempo real:

• Las conexiones activas muestran indicadores de estado con valores.
• Los errores aparecen en el panel de depuración (accedido a través de la barra lateral derecha).
• Los datos pueden ser rastreados utilizando nodos de depuración colocados en el flujo.

Características Avanzadas

Integración de Comandos Globales

Los comandos globales te permiten controlar múltiples dispositivos simultáneamente:

1. Agrega un nodo de Luces Globales o Persianas Globales a tu flujo.
2. Configúralo para dirigirse a una habitación o categoría específica.
3. Envía un mensaje de "Encendido" o "Apagado" a la entrada del nodo para controlar todas las luces en esa habitación.
4. Para persianas, envía "Arriba" o "Abajo" para controlar todas las persianas.

Esto es particularmente útil para crear escenas o controles basados en el tiempo que afectan a múltiples dispositivos.

Activación de Escenarios

Los escenarios de HyperVisu (grupos predefinidos de estados de dispositivos) pueden ser activados directamente desde Node-RED:

1. Agrega un nodo de Escenario a tu flujo.
2. Configúralo para seleccionar el escenario específico de la lista de escenarios disponibles.
3. Conecta cualquier nodo de activación a su entrada.
4. Cuando se activa, el escenario se ejecutará como si se hubiera activado desde la aplicación móvil.

Esto te permite crear activaciones complejas para tus escenarios basadas en el tiempo, eventos externos o datos de sensores.

Integración de Dispositivos IoT

Una gran ventaja de la integración de Node-RED es conectar dispositivos IoT no-KNX a tu sistema HyperVisu:

Integrando Sensores Externos:

1. Crea un widget virtual en HyperVisu.
2. Agrega el nodo correspondiente de Node-RED (como Entrada Analógica).
3. Conecta una fuente de datos externa (MQTT, HTTP, etc.) a este nodo.
4. Cuando llegan datos, actualiza el widget virtual y aparece en la aplicación HyperVisu.

Controlando Dispositivos Externos:

1. Crea un widget de salida virtual en HyperVisu.
2. Agrega el nodo correspondiente de Node-RED (como Interruptor).
3. Conecta la salida a un nodo que controle tu dispositivo externo (solicitud HTTP, publicación MQTT, etc.).
4. Cuando controlas el widget virtual en HyperVisu, activa la acción externa.

El broker MQTT integrado se puede habilitar para cualquier widget, transmitiendo sus cambios de estado en temas que coinciden con el ID del objeto del widget. Esto facilita que otros dispositivos compatibles con MQTT respondan a eventos en tu hogar.

Ejemplos de Integración:

• Conectar APIs meteorológicas para mostrar condiciones exteriores en widgets virtuales.
• Controlar dispositivos inteligentes que utilizan diferentes protocolos.
• Registrar datos de consumo de energía de medidores inteligentes en InfluxDB.
• Construir lógica personalizada para automatizaciones avanzadas basadas en múltiples condiciones.

Al aprovechar esta integración de Node-RED, puedes extender HyperVisu más allá de sus capacidades nativas de KNX para crear una solución de hogar inteligente verdaderamente integral que integre todos tus sistemas.