Dashboard, accès via VRM et bonnes pratiques

Comment se connecter à Node-RED sur le GX

Node-RED fonctionne sur l’appareil GX lui-même. Sur le réseau local, le navigateur s’y connecte directement ; hors de chez vous, la connexion passe par le portail VRM. Les flows peuvent également récupérer eux-mêmes des données depuis VRM et enregistrer des fichiers sur la partition de données de l’appareil.

Dashboard : FlowFuse Dashboard 2.0

Le dashboard est une page affichée dans le navigateur avec des graphiques, des indicateurs et des commandes, par exemple des interrupteurs et des curseurs. Victron recommande le paquet FlowFuse Dashboard 2.0 — à jour et activement développé.

1. Installation. Dans l’éditeur : menu à droite → Manage palette → onglet Install, recherchez et installez @flowfuse/node-red-dashboard. L’appareil GX doit disposer d’une connexion Internet fonctionnelle. La palette s’installe sur la partition de données et reste donc en place après une mise à jour de Venus OS.
2. Structure. Les nouveaux nœuds apparaissent dans la palette à gauche. Le dashboard comporte quatre niveaux : ui-base (adresse de base, /dashboard par défaut), ui-page (pages), ui-group (groupes sur une page) et les widgets — graphique, indicateur, bouton, interrupteur.
3. Données de l’installation. Reliez un nœud d’entrée Victron (par exemple l’état de charge de la batterie) à un widget, et un interrupteur du dashboard à un nœud de sortie, par exemple un relais. Contenu de la palette Victron : nœuds Victron.
4. Deploy et visualisation. Après le déploiement (Deploy), vous pouvez ouvrir le dashboard depuis le panneau « Dashboard 2.0 » à droite de l’éditeur. Dans le portail VRM, le menu Venus OS Large affiche alors une tuile supplémentaire pour l’accès à distance.

• Relais depuis le dashboard. Réglez d’abord le relais en mode manuel (Manual) dans le menu GX ou dans VictronConnect. Pour que l’interrupteur affiche également les changements effectués ailleurs, par exemple dans le menu GX, reliez aussi l’état du relais à l’entrée de l’interrupteur — comme dans l’exemple « Relay switching » du wiki Victron.
• Fréquence des données. Les nœuds d’entrée Victron envoient un message à chaque changement de valeur. Si l’option « only changes » n’est pas cochée, ils envoient également la valeur actuelle toutes les 5 secondes — le graphique reçoit alors un point même lorsque rien ne change.
• Ancien dashboard. Le paquet node-red-dashboard est obsolète et, selon le manuel, ne doit plus être utilisé.
• Alternative : uibuilder. node-red-contrib-uibuilder permet de contrôler entièrement l’apparence, mais ne propose pas de widgets prêts à l’emploi — vous devez écrire vous-même l’interface en HTML, CSS et JavaScript. Plus souple, mais nettement plus difficile que Dashboard 2.0.

Accès à distance via VRM

Les trois interfaces — éditeur de flux, tableau de bord Node-RED et panneau d’administration Signal K — sont également accessibles à distance via le portail VRM.

1. Installation dans VRM. L’appareil GX doit envoyer des données au portail VRM — pour le connecter : supervision dans VRM.
2. Menu Venus OS Large. Connectez-vous à VRM, sélectionnez l’installation et cliquez sur le menu Venus OS Large. Les vignettes de l’éditeur et de Signal K y apparaissent après l’activation de ces fonctions sur le GX, et celle du tableau de bord après son déploiement.
3. Connexion. Node-RED demande le même mot de passe qu’en local — depuis Venus OS 3.50, il s’agit du mot de passe du profil de sécurité associé à l’utilisateur admin (détails).

• Le fonctionnement peut être lent. Le manuel précise que la vitesse dépend de la qualité de la connexion.
• Uniquement via VRM. Le manuel Victron décrit l’accès à distance à Node-RED uniquement via VRM ; il ne décrit pas la redirection de ports sur le routeur.

Données VRM dans les flux

Certains flux nécessitent des données absentes de l’appareil GX lui-même, par exemple des prévisions de production photovoltaïque ou d’irradiation solaire. Elles sont récupérées dans la base de données du portail VRM via l’API VRM.

1. Jeton d’accès. Dans le portail VRM, ajoutez un nouveau jeton dans la section Access tokens. Une fois généré, il ne peut plus être consulté — enregistrez-le immédiatement dans votre gestionnaire de mots de passe.
2. Nœud VRM API. Victron VRM API node facilite l’utilisation de l’API dans les flux. Description complète de l’API : documentation de l’API VRM.
3. Prévisions. Utilisez l’appel stats avec l’un des attributs du tableau ; le manuel précise que d’autres attributs peuvent également être utiles.

Solution prête à l’emploi : Dynamic ESS — récupère dans VRM la consigne optimale pour l’ESS, calculée à partir des tarifs dynamiques de l’électricité et des prévisions de production photovoltaïque. Son flux constitue aussi un bon exemple d’utilisation de l’API VRM.

Le jeton est la clé du compte. Traitez-le comme un mot de passe : avant de partager un flux, par exemple sur le forum Victron Community, vérifiez que le jeton n’est pas saisi directement dans un nœud function, change ou inject.

Stockage : partition de données /data

Les palettes, les flux, les identifiants et le contexte enregistré sont stockés sur la partition de données de l’appareil GX. Ils sont ainsi conservés lors d’une mise à jour de Venus OS, mais l’espace est limité et Node-RED comme Signal K peuvent remplir entièrement cette partition.

• Au moins 30 MB libres — en permanence, selon le manuel Venus OS Large.
• Avertissement #46. Lorsque l’espace libre descend sous 5%, le GX signale #46 Data partition full. La valeur exacte est affichée dans le menu Settings → General → Modifications.
• Conséquences d’une partition pleine. Venus OS ne fonctionne plus correctement, Node-RED ou Signal K ne démarre plus — le système n’est pas conçu pour fonctionner sans espace libre.
• Pas de gros fichiers sur /data. N’y enregistrez pas de photos, de vidéos ou de journaux volumineux. Stockez ces données hors du GX — dans une base de données, dans le cloud, via MQTT ou FTP — et accédez-y par leur URL.
• Uniquement les palettes nécessaires. Chaque palette installée occupe de l’espace. Supprimez celles qui ne servent pas avec le bouton remove dans Manage palette.

Si la partition est déjà pleine — procédez dans cet ordre, en commençant par la méthode la moins radicale :

1. Journaux Signal K. Si vous utilisez Signal K, le manuel recommande de commencer par supprimer ses journaux, puis de vérifier que l’option « Keep only most recent data log files » est activée dans Signal K → Server → Settings (activée par défaut).
2. Flux et palettes. Supprimez les flux et les palettes ajoutées. Si l’éditeur ne démarre pas, le fichier venus-data-20-node-red-reset.tgz sur une clé USB supprime tout le contenu de /data/home/nodered/ — tous les flux et toutes les palettes — et permet de repartir de zéro. Faites d’abord une sauvegarde : venus-data-00-backup-data-partition.tgz copie toute la partition /data sur la clé USB (fonctionnement).
3. Réinitialisation du GX aux paramètres d’usine — selon le manuel de l’appareil GX. L’inconvénient est de devoir reconfigurer entièrement l’appareil.

Vous pouvez aussi surveiller l’occupation de la partition dans un flux — le wiki Victron propose deux exemples : « Monitor disk usage » (graphique sur l’ancien tableau de bord, voir l’incohérence ci-dessus) et « Using MQTT to monitor disk space », qui nécessite d’activer le service MQTT on LAN (Plaintext) dans le menu du GX et affiche l’espace libre uniquement dans la fenêtre debug.

Variables de contexte et mémoire flash

Les variables de contexte (context, flow, global) permettent aux flux de mémoriser des valeurs, par exemple un compteur ou le dernier état. Par défaut, elles sont conservées uniquement dans la mémoire RAM de l’appareil GX — elles disparaissent après un redémarrage ou une coupure d’alimentation.

Pour les conserver après un redémarrage, vous devez activer leur enregistrement sur disque dans le fichier settings-user.js (voir fichiers de configuration) :

module.exports = {
  contextStorage: {
    default: {
      module: "localfilesystem",
      config: {
        // enregistrement toutes les 5 minutes
        flushInterval: 300
      }
    }
  }
}

• N’enregistrez pas trop souvent. Le manuel avertit que les écritures fréquentes usent la mémoire flash — cet exemple enregistre le contexte toutes les 300 s, soit toutes les 5 minutes.
• Uniquement de petites données. Ne stockez pas de données volumineuses ou binaires dans le contexte — il est enregistré sur la même petite partition /data.
• Après la modification, redémarrez Node-RED (redémarrage).

Fichiers de configuration — quand les modifier

La grande majorité des installations utilisant Node-RED n’ont pas besoin de modifier ces fichiers — et ne devraient pas le faire. Venus OS Large est conçu pour éviter le recours à la ligne de commande. Leur modification nécessite un accès root via SSH (manuel Victron).

• Un seul bloc. Les paramètres de ces fichiers doivent se trouver dans le bloc module.exports = {}. Plusieurs paramètres — par exemple le port 1880 et contextStorage — se placent dans ce même bloc, séparés par des virgules.
• settings.js est ignoré. Le fichier /data/home/nodered/settings.js n’est pas lu, même si vous le créez — seul settings-user.js dans le répertoire .node-red est pris en compte.
• Images dans le tableau de bord. Pour que Node-RED serve, par exemple, l’arrière-plan du tableau de bord, ajoutez httpStatic: "/data/home/nodered/www" dans settings-user.js, créez ce répertoire, attribuez-le à l’utilisateur nodered (chown -R nodered:nodered) et placez-y un fichier, par exemple image.png. Dans le tableau de bord, utilisez un chemin relatif : background-image: url(/image.png);. Cela occupe aussi de l’espace sur /data — limitez-vous à de petits fichiers.

Redémarrage après modification des paramètres. Le plus simple, dans le menu GX : Venus OS Large Features → Node-RED — désactivez puis réactivez. En ligne de commande :

# arrêter
svc -d /service/node-red-venus
# démarrer
svc -u /service/node-red-venus
# redémarrer
svc -t /service/node-red-venus

Si quelque chose ne fonctionne plus après une modification, lancez Node-RED en mode sans échec — il démarre sans exécuter les flux (mode sans échec).

Sécurité et permissions

• Mot de passe. Depuis Venus OS 3.50, l’accès à Node-RED est protégé par le mot de passe du profil de sécurité (Settings → General → Security Profile), avec l’utilisateur admin ; dans les versions antérieures, par le mot de passe de la console à distance. Détails : mot de passe de l’éditeur.
• Connexion chiffrée. L’éditeur utilise https sur le port 1881. Le certificat est autosigné — d’où l’avertissement du navigateur — mais l’identifiant et le mot de passe ne transitent pas en clair sur le réseau.
• Port 1880 uniquement si nécessaire. Certains nœuds se connectent uniquement en http. Pour eux, vous pouvez activer en plus le port 1880 sur toutes les interfaces dans settings-user.js, puis redémarrer Node-RED :

  module.exports = {
    // également http sur le port 1880
    uiHost: "::"
  }

  Il s’agit de http sans chiffrement, contrairement au port 1881 — activez-le uniquement si un nœud l’exige.
• Erreur EACCES lors de l’enregistrement d’un fichier. Depuis Venus OS 2.90, Node-RED s’exécute sous l’utilisateur nodered, et non root. Les flux ne peuvent donc lire et écrire que les fichiers de cet utilisateur — généralement sous /data/home/nodered/. Au lieu d’un autre chemin, utilisez par exemple /data/home/nodered/storage.txt.
• Jeton VRM et mots de passe dans les flux. Les identifiants enregistrés par les nœuds comme données d’authentification sont stockés dans le fichier chiffré flows_cred.json. Ne saisissez pas directement de jeton ou de mot de passe dans les nœuds function, change ou inject — ils se retrouveraient dans le fichier non chiffré flows.json et dans chaque export.

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 — tableau de bord, fichiers de configuration, API VRM, FAQ, accès via VRM, partition de données pleinevictronenergy.com · EN
• node-red-contrib-victron — Example Flows (relais depuis le tableau de bord, occupation du disque, commande par seuil)github.com · EN
• API VRM — documentationvictronenergy.com · EN
• FlowFuse Dashboard 2.0 — Getting started (installation, chemin /dashboard, création)dashboard.flowfuse.com · EN