Nodos Victron en Node-RED

Paleta Victron

Node-RED tiene su propio conjunto básico de nodos. Venus OS Large añade los nodos Victron: la paleta node-red-contrib-victron, que viene instalada de fábrica. Los nodos funcionan mediante D-Bus, es decir, con los valores que Venus OS proporciona de los dispositivos conectados al GX. En el nodo se seleccionan el dispositivo y el parámetro; el editor convierte automáticamente las rutas con marcadores de posición, como {tracker}, en las opciones disponibles en los dispositivos conectados.

• Actualización de la paleta: solo junto con una nueva versión de Venus OS Large. La paleta no se puede actualizar desde el editor ni desde la línea de comandos. Si ya hay una paleta más reciente en internet, hay que esperar a la siguiente versión de Venus OS Large, que suele publicarse poco después de la actualización de la paleta.
• Descripción de los nodos: la wiki del proyecto en GitHub describe cada nodo y sus rutas (páginas Input nodes, Output nodes y Virtual devices). Las rutas y los valores de esta página proceden de esa wiki.
• Otras paletas: los nodos adicionales, como dashboard, se instalan desde internet en la partición de datos del GX, por lo que se conservan tras actualizar Venus OS. Espacio libre necesario: primera puesta en marcha.

Tipos de nodos

La wiki divide los nodos Victron en nodos de entrada, de control y dispositivos virtuales, y enumera por separado dos nodos personalizados (custom).

Lista completa de nodos de dispositivos

Los 33 nodos de entrada; 18 de ellos también tienen una versión de control (con el añadido «Control» en la wiki). Descripciones según la wiki.

Cuándo envía un mensaje el nodo

• Con cada cambio de valor — es el comportamiento básico del nodo de entrada.
• Con «only changes» marcado — solo cuando cambia el valor.
• Sin «only changes» — además, el nodo envía el valor actual cada 5 s, aunque no haya cambiado.
• Valor a intervalos fijos — guarda msg.payload en el contexto (flow. o global.) con un nodo change y léelo con un nodo inject a intervalos de tu elección. Así funciona el ejemplo integrado «Only Messages at Regular Intervals».
• Contexto tras un reinicio — por defecto, el contexto solo se almacena en RAM y se pierde al reiniciar el GX o si se interrumpe la alimentación. El almacenamiento en disco se activa en el archivo /data/home/nodered/.node-red/settings-user.js (almacén localfilesystem; el ejemplo del manual guarda cada 300 s). No guardes con demasiada frecuencia para evitar el desgaste de la memoria flash.

Cómo funciona el nodo de control

El nodo Control escribe en el dispositivo el valor de msg.payload. Los parámetros con una lista de valores (enum) se ajustan mediante un número: en los ejemplos de Victron, el nodo inject envía, por ejemplo, el número 3 al nodo Vebus Control para encender el inversor/cargador. Los valores de cada ruta figuran en la tabla siguiente y en la wiki.

• Programación horaria — el nodo inject puede enviar un valor a una hora fija, en días seleccionados o cada pocos minutos dentro de una franja horaria definida. Node-RED utiliza la zona horaria configurada en Remote Console; tras cambiarla, debes reiniciar Node-RED.
• Mantenimiento del estado — el ejemplo «Event Based Scheduling» conecta el nodo de entrada Vebus (/Mode) con el nodo de control para mantener el modo seleccionado en los horarios programados, incluso si alguien lo cambia por accidente.
• Programaciones especiales — para festivos, desfases aleatorios o el anochecer y el amanecer, Victron recomienda el nodo adicional node-red-big-timer (menú Manage palette → Install).

Rutas útiles

Cada parámetro tiene su propia ruta D-Bus. El editor sustituye los marcadores de las rutas por los valores disponibles en los dispositivos conectados:

Selección de rutas de la wiki — para automatizaciones según el estado de la batería, la producción FV y el modo del inversor:

Relés — qué configurar primero

Para que Node-RED pueda conmutar el relé, primero debes configurarlo para control manual, normalmente en VictronConnect. Después, el nodo Relay Control controla el relé: 1 cierra el contacto (Closed) y 0 lo abre (Open).

• Relé para el generador: se configura con la función «Generator» en la consola GX, y las órdenes de arranque y parada se envían mediante el nodo Generator Control (/Start: 1 Start, 0 Stop). El nodo Generator arranca los generadores Fischer Panda directamente a través de D-Bus.
• Interruptor en el dashboard: el ejemplo «Relay Switching» controla un relé desde el dashboard. Para que el interruptor refleje también los cambios realizados desde otro lugar, como el menú GX, conecta además el nodo de entrada Relay a la entrada del interruptor. Se necesita la paleta node-red-dashboard; consulta dashboard y acceso remoto.
• Flujo listo para usar: encendido y apagado de un relé según el estado de la batería: ejemplo paso a paso.

Dispositivos virtuales

Un dispositivo virtual permite conectar al GX equipos o fuentes de datos que Victron no admite. Una vez creado en Node-RED, aparece en el GX y se comporta como un dispositivo Victron real, también en el portal VRM. Ejemplos del manual: datos meteorológicos de una API como estación meteorológica virtual, consumo e inyección a la red calculados como contador de red virtual, posición de GPSd como GPS virtual y sensores LoRa o MQTT como depósito o sensor de temperatura virtual.

1. Venus OS actualizado. Actualiza el GX a la última versión.
2. Nodo Virtual Device. Añádelo al flujo y selecciona el tipo de dispositivo.
3. Datos. Conecta la fuente de datos o la lógica de control. Envía al nodo msg.payload como objeto: las claves son las rutas D-Bus sin la barra inicial y los valores son las lecturas, por ejemplo, {"Dc/0/Voltage": 48.2, "Dc/0/Current": 12.5, "Soc": 85}.

• Nombre en D-Bus: com.victronenergy.<tipo>.virtual_<id del nodo>.
• Desconexión y reconexión: msg.connected = false desconecta el dispositivo y libera el nombre del servicio en D-Bus; msg.connected = true lo vuelve a conectar.
• Salida: un puerto que transmite el mensaje original con msg.connected ajustado al estado actual de la conexión con D-Bus.

Interruptor virtual (Virtual Switch)

Crea un interruptor sin relé físico, por ejemplo, para un interruptor IoT con firmware Tasmota que el flujo controla según el estado de la batería. Según el manual, aparece en el panel de interruptores (Switch) de la nueva interfaz de Venus OS, se puede encender y apagar como un interruptor real y su estado se guarda en el GX y puede conservarse tras un reinicio.

• Control: {"SwitchableOutput/output_1/State": 1} lo enciende; {"SwitchableOutput/output_1/Dimming": 75} ajusta la intensidad al 75%. msg.connected = false desconecta el interruptor.
• 11 tipos: On/Off (0 apagado, 1 encendido), Dimmable (encendido/apagado y regulación de intensidad 0–100%), Temperature setpoint (deslizador del termostato en °C), Stepped, Basic slider, Dropdown, Numeric input, Three state (0 Off, 1 On, 2 Auto), RGB color wheel, CCT wheel y RGB+White dimmer.
• Salidas: el puerto 1 transmite el mensaje con msg.connected; el puerto 2 envía el nuevo estado cuando cambia; el puerto 3 envía el nuevo valor de intensidad o consigna (tipos con regulación de intensidad, pasos, valores numéricos y RGB).

Notificaciones y eventos

Ejemplos incluidos

En el editor: menú de la esquina superior derecha → Import (o Ctrl+I) → Examples → node-red-contrib-victron. Los mismos ejemplos están en la wiki, en la página Example Flows. Algunos requieren paletas adicionales, normalmente node-red-dashboard.

En qué difieren las fuentes

• Tipos de dispositivos virtuales. El manual de Venus OS Large (cap. 5.8) enumera 9: Battery, Generator, GPS, Grid meter, Meteo, Motor drive, PV inverter, Tank sensor y Temperature sensor. La wiki (Virtual devices) indica 14: añade AC Load, DC Load, Electric Vehicle, Energy meter y Pulse meter, y «Motor drive» aparece como E-drive (servicio com.victronenergy.motordrive). La lista de tipos del nodo Virtual Device muestra cuáles están disponibles en tu instalación.
• Dónde aparece el interruptor virtual. Manual: en el panel de interruptores de la nueva interfaz de Venus OS. Wiki: Venus OS lo detecta como un I/O extender Cerbo GX conectado, y la interfaz GX permite controlarlo.
• Con qué frecuencia llegan los mensajes. FAQ Q9 y ejemplo «Only Messages at Regular Intervals»: con cada cambio y, sin «only changes», también cada 5 s. Ejemplo «Event Based Scheduling»: por defecto cada 5 s, con envío inmediato de los cambios, «aproximadamente una vez por segundo».
• Horarios en «Trigger Based Scheduling». Descripción: activación a las 6:00 y desactivación a las 22:00. En el propio flujo, el nodo «Trigger 'ON' at 22:00» envía 3 (On) a las 22:00, y «Trigger 'OFF' at 6:00» envía 4 (Off) a las 6:00. Tras importarlo, comprueba los horarios y los valores de los nodos inject.
• Actualización de la paleta. Cap. 5.3 y FAQ Q2: la paleta Victron no se puede actualizar desde el editor ni desde la línea de comandos; solo mediante una nueva versión de Venus OS Large. El cap. 5.6 indica, en términos generales, que si se instala una versión de la paleta más reciente que la de fábrica, Node-RED utilizará la más reciente. Sobre la paleta Victron, el manual es explícito en Q2: solo mediante una nueva versión de Venus OS Large.
• Marcadores de posición. La leyenda de la wiki enumera {type}, {tracker}, {phase}, {day}, {input}, {channel} e {index}, pero en las descripciones de las rutas también aparecen {relay} (/Relay/{relay}/State), {line} (/Ac/Consumption/{line}/Power en el nodo System) y {historyDay} (/History/Daily/{historyDay}/Yield en el nodo Solarcharger).

Equipos afectados

Cerbo GXCentro de control del sistema y pasarela al portal VRM.Ekrano GXCentro GX con pantalla táctil integrada de 7″.

Fuentes

• Wiki de node-red-contrib-victron — Available nodesgithub.com · EN
• Wiki de node-red-contrib-victron — Input nodesgithub.com · EN
• Wiki de node-red-contrib-victron — Output nodesgithub.com · EN
• Wiki de node-red-contrib-victron — Virtual devicesgithub.com · EN
• Wiki de node-red-contrib-victron — Example Flowsgithub.com · EN
• Venus OS Large image: Signal K and Node-RED — cap. 2, 5.3–5.8, FAQ Q2, Q9, Q11victronenergy.com · EN