Comment activer Node-RED sur le Cerbo GX

Prérequis

• Un appareil GX avec Venus OS Large — Cerbo GX, Cerbo-S GX, Ekrano GX, Venus GX, Octo GX, MultiPlus-II GX ou EasySolar-II GX. Color Control GX et CanVU GX ne prennent pas en charge Venus OS Large. Comparaison des performances : prérequis sur la page principale de la rubrique.
• Une connexion Internet sur le GX — pour télécharger Venus OS Large depuis le menu des mises à jour et installer des nœuds supplémentaires.
• Un ordinateur sur le même réseau — l’éditeur Node-RED s’ouvre dans un navigateur.

Préparation : aucune n’est nécessaire sur Cerbo GX, MultiPlus-II GX et EasySolar-II GX. Sur Venus GX, vous devez d’abord installer et démarrer la version v2.73 ou ultérieure, puis installer Venus OS Large : cette étape assure le partitionnement de la mémoire flash requis par Venus OS Large.

Installation de Venus OS Large

1. Mise à jour. Mettez le GX à jour vers la dernière version : Settings → General → Firmware → Online updates (dans les versions antérieures, Settings → Firmware → Online updates).
2. Type d’image « Large ». Dans le même menu, réglez Image type sur « Large », revenez au niveau précédent, recherchez une nouvelle version et installez-la. La durée du téléchargement dépend de la connexion, puis le GX redémarre ; l’installation elle-même prend généralement environ 2 minutes.
3. Vérification. Après le redémarrage, les paramètres Venus OS Large doivent apparaître dans les intégrations du menu Settings : cela indique que l’image a été installée correctement.
4. Activation de Node-RED. Activez Node-RED dans les paramètres des intégrations. Le niveau d’accès installateur est nécessaire pour activer et désactiver Node-RED et Signal K.

Les mises à jour continuent de fonctionner de la même manière, en ligne ou hors ligne. Le paramètre Image type détermine l’image mise à jour.

Première ouverture de l’éditeur

• Adresse : https://venus.local:1881. Si elle ne fonctionne pas, remplacez venus.local par l’adresse IP de l’appareil GX sur le réseau local, par exemple https://192.168.178.224:1881. Le chapitre du manuel de l’appareil GX consacré à Remote Console sur le réseau LAN explique comment trouver l’adresse IP.
• Avertissement du navigateur — Node-RED sur GX utilise une connexion chiffrée avec un certificat autosigné : le navigateur indique donc « Votre connexion n’est pas privée ». Cliquez sur « Avancé » ou « Détails », puis poursuivez. L’avantage : l’identifiant et le mot de passe ne circulent pas en clair sur le réseau.
• Ancienne adresse http et port 1880 — après le passage à https, l’adresse doit commencer par https et utiliser le port 1881. Une tentative de connexion avec l’ancienne adresse provoque l’erreur ERR_EMPTY_RESPONSE. L’écoute supplémentaire sur le port 1880, pour les nœuds qui se connectent uniquement en http, s’active dans le fichier de paramètres utilisateur — voir tableau de bord et bonnes pratiques.
• Via VRM — l’éditeur est également accessible à distance depuis le menu Venus OS Large du portail VRM. Il peut être lent selon la qualité de la connexion.

Mot de passe de l’éditeur

Mode sans échec et redémarrage

Dans le menu GX, vous pouvez activer Node-RED en mode sans échec (safe mode) : Node-RED démarre, mais n’exécute aucun flux. Vous pouvez alors ouvrir l’éditeur et corriger les flux avant toute exécution — ils ne démarrent qu’après le déploiement des modifications (Deploy). C’est une solution de secours lorsqu’un flux surcharge le processeur du GX ou provoque d’autres problèmes.

Pour redémarrer Node-RED, désactivez-le puis réactivez-le dans le menu Venus OS Large Features → Node-RED.

Sauvegardes des flux

• Exportation : dans le menu de l’éditeur, Export → « all flows » enregistre un fichier flows.json sur votre ordinateur. Le manuel recommande de le faire régulièrement, et de réaliser une sauvegarde supplémentaire avant chaque mise à jour du logiciel GX.
• Restauration : sur une nouvelle installation, utilisez Import pour importer ce même fichier. Si un flux utilise des nœuds absents de la palette, l’éditeur le signale ; vous devez d’abord les installer.
• Ce que l’exportation n’inclut pas : la configuration de Node-RED lui-même, stockée dans les fichiers .config.*.json du répertoire /data/home/nodered/.node-red/.
• Sauvegarde de toute la partition de données et réinitialisation : le fichier venus-data-00-backup-data-partition.tgz placé sur une clé USB copie toute la partition /data sur cette clé, tandis que venus-data-20-node-red-reset.tgz supprime les fichiers de /data/home/nodered/ et permet de repartir de zéro avec Node-RED. Insérez la clé USB dans le GX et redémarrez l’appareil ; trois signaux sonores indiquent la fin de l’opération (un message à l’écran sur le MultiPlus-II GX).

Espace sur la partition de données

Les nœuds supplémentaires s’installent sur la partition de données du GX et restent donc disponibles après une mise à jour de Venus OS. Cette partition doit toujours conserver au moins 30 MB d’espace libre. Lorsque l’espace libre passe sous 5%, le GX affiche l’avertissement #46 Data partition full ; la valeur exacte figure dans le menu Settings → General → Modifications. Si la partition est pleine, Node-RED peut ne pas démarrer du tout et Venus OS ne fonctionne plus correctement.

La palette de nœuds Victron fait partie de Venus OS Large et ne se met à jour qu’avec celui-ci. Lorsqu’une version plus récente de la palette est disponible en ligne mais pas encore dans Venus OS Large, le manuel recommande d’attendre — une nouvelle version de Venus OS Large paraît généralement peu après la mise à jour de la palette. Contenu de la palette : nœuds Victron. Premier flux fonctionnel : relais selon l’état de la batterie.

Appareils concernés

Cerbo GXCentre de commande du système et passerelle vers le portail VRM.Ekrano GXCentre GX avec écran tactile 7″ intégré.

Sources

• Venus OS Large image: Signal K and Node-RED — chap. 2–5, FAQ Q3–Q5 et Q8, chap. 7 et 8victronenergy.com · EN
• Manuel du Cerbo GX — Remote Console sur le réseau LAN, mises à jour du logicielvictronenergy.com · EN