Cómo activar Node-RED en Cerbo GX

Qué necesitas

• Un dispositivo GX con Venus OS Large: Cerbo GX, Cerbo-S GX, Ekrano GX, Venus GX, Octo GX, MultiPlus-II GX o EasySolar-II GX. Color Control GX y CanVU GX no son compatibles con Venus OS Large. Comparación de velocidad: requisitos en la página principal de la sección.
• Conexión a Internet en el GX: para descargar Venus OS Large desde el menú de actualizaciones e instalar nodos adicionales.
• Un ordenador en la misma red: el editor de Node-RED se abre en el navegador.

Preparación: Cerbo GX, MultiPlus-II GX y EasySolar-II GX no necesitan ninguna. En Venus GX debes instalar y ejecutar primero la versión v2.73 o posterior, y después Venus OS Large. Esto se debe al particionado de la memoria flash que requiere Venus OS Large.

Instalación de Venus OS Large

1. Actualización. Actualiza el GX a la última versión: Settings → General → Firmware → Online updates (en versiones anteriores, Settings → Firmware → Online updates).
2. Tipo de imagen «Large». En el mismo menú, configura Image type como «Large», vuelve al nivel anterior, comprueba si hay una nueva versión e instálala. El tiempo de descarga depende de la conexión; después, el GX se reinicia y la instalación suele tardar unos 2 minutos.
3. Comprobación. Tras el reinicio, los ajustes de Venus OS Large deberían aparecer en las integraciones del menú Settings. Esto indica que la imagen se ha instalado correctamente.
4. Activación de Node-RED. Activa Node-RED en los ajustes de integraciones. Para activar y desactivar Node-RED y Signal K necesitas el nivel de acceso de instalador.

Las actualizaciones siguen funcionando igual, con o sin conexión a Internet. El ajuste Image type determina qué imagen se actualiza.

Primera apertura del editor

• Dirección: https://venus.local:1881. Si no funciona, sustituye venus.local por la dirección IP del dispositivo GX en la red local, por ejemplo, https://192.168.178.224:1881. El capítulo sobre Remote Console en la red LAN del manual del dispositivo GX explica cómo encontrar la dirección IP.
• Advertencia del navegador: Node-RED en el GX utiliza una conexión cifrada con un certificado autofirmado, por lo que el navegador mostrará «La conexión no es privada». Debes pulsar «Avanzado» o «Detalles» y continuar. La ventaja es que el usuario y la contraseña no se transmiten por la red en texto sin cifrar.
• Antigua dirección http y puerto 1880: tras pasar a https, la dirección debe empezar por https y el puerto es 1881. Si intentas conectarte como antes, aparecerá el error ERR_EMPTY_RESPONSE. La escucha adicional en el puerto 1880 (para nodos que solo se conectan por http) se activa en el archivo de ajustes del usuario; consulta dashboard y buenas prácticas.
• A través de VRM: también puedes acceder al editor de forma remota desde el menú Venus OS Large del portal VRM. Según la calidad de la conexión, puede funcionar lentamente.

Contraseña del editor

Modo seguro y reinicio

En el menú del GX puedes activar Node-RED en modo seguro (safe mode): Node-RED arranca, pero no ejecuta los flujos. Así puedes abrir el editor y corregir los flujos antes de que empiece a funcionar nada; los flujos solo se ejecutarán tras desplegar los cambios (Deploy). Es una salida de emergencia cuando algún flujo provoca una carga elevada en el procesador del GX u otros problemas.

Para reiniciar Node-RED, desactívalo y vuelve a activarlo en el menú Venus OS Large Features → Node-RED.

Copias de seguridad de los flujos

• Exportación: menú del editor → Export → «all flows» guarda un archivo flows.json en el ordenador. El manual recomienda hacerlo periódicamente y guardar siempre una copia adicional antes de actualizar el software del GX.
• Restauración: en una instalación nueva, utiliza Import para importar el mismo archivo. Si el flujo utiliza nodos que no están en la paleta, el editor lo indicará; primero tendrás que instalarlos.
• Qué no incluye la exportación: la configuración del propio Node-RED, que se guarda en los archivos .config.*.json del directorio /data/home/nodered/.node-red/.
• Copia de toda la partición de datos y restablecimiento: el archivo venus-data-00-backup-data-partition.tgz en una memoria USB copia toda la partición /data a la memoria USB, mientras que venus-data-20-node-red-reset.tgz elimina los archivos de /data/home/nodered/ y permite empezar con Node-RED desde cero. Inserta la memoria USB en el GX y reinicia el dispositivo; tres pitidos indican que el proceso ha terminado (en el MultiPlus-II GX aparece un mensaje en la pantalla).

Espacio en la partición de datos

Los nodos adicionales se instalan en la partición de datos del GX, por lo que se conservan tras actualizar Venus OS. En esta partición siempre deben quedar al menos 30 MB de espacio libre. Cuando el espacio libre baja del 5%, el GX muestra la advertencia #46 Data partition full; el valor exacto aparece en el menú Settings → General → Modifications. Si la partición está llena, es posible que Node-RED no llegue a arrancar y Venus OS deje de funcionar correctamente.

La paleta de nodos Victron forma parte de Venus OS Large y solo se actualiza junto con él. Si ya hay una versión más reciente de la paleta en internet, pero aún no está incluida en Venus OS Large, el manual recomienda esperar: la nueva versión de Venus OS Large suele publicarse poco después de la actualización de la paleta. Contenido de la paleta: nodos Victron. Primer flujo funcional: relé según el estado de la batería.

Equipos afectados

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

Fuentes

• Venus OS Large image: Signal K and Node-RED — cap. 2–5, FAQ Q3–Q5 y Q8, cap. 7 y 8victronenergy.com · EN
• Manual del Cerbo GX — Remote Console en la red LAN, actualizaciones de softwarevictronenergy.com · EN