Nœuds Victron dans Node-RED

Palette Victron

Node-RED possède son propre ensemble de nœuds de base. Venus OS Large y ajoute les nœuds Victron — la palette node-red-contrib-victron, préinstallée. Les nœuds fonctionnent sur D-Bus, à partir des valeurs que Venus OS expose pour les appareils connectés au GX. Dans le nœud, vous sélectionnez l’appareil et le paramètre ; l’éditeur transforme automatiquement les chemins contenant des variables, par exemple {tracker}, en options disponibles sur les appareils connectés.

• Mise à jour de la palette — uniquement avec une nouvelle version de Venus OS Large. La palette ne peut être mise à jour ni depuis l’éditeur ni en ligne de commande. Lorsqu’une palette plus récente est disponible en ligne, vous devez attendre la prochaine version de Venus OS Large — elle paraît généralement peu après la mise à jour de la palette.
• Description des nœuds — le wiki du projet sur GitHub décrit chaque nœud et ses chemins (pages Input nodes, Output nodes et Virtual devices). Les chemins et les valeurs présentés sur cette page en sont issus.
• Autres palettes — les nœuds supplémentaires, par exemple dashboard, s’installent depuis Internet sur la partition de données du GX et restent donc disponibles après une mise à jour de Venus OS. Espace libre requis : première mise en service.

Types de nœuds

Le wiki classe les nœuds Victron en nœuds d’entrée, de commande et appareils virtuels, et répertorie séparément deux nœuds personnalisés (custom).

Liste complète des nœuds d’appareils

Les 33 nœuds d’entrée ; 18 possèdent également une version de commande (avec la mention « Control » dans le wiki). Descriptions selon le wiki.

Quand le nœud envoie un message

• À chaque changement de valeur — c’est le comportement de base du nœud d’entrée.
• Avec « only changes » coché — uniquement lorsque la valeur change.
• Sans « only changes » — le nœud envoie aussi la valeur actuelle toutes les 5 s, même si elle n’a pas changé.
• Valeur à intervalle régulier — avec un nœud change, enregistrez msg.payload dans le contexte (flow. ou global.), puis lisez cette valeur à l’intervalle choisi avec un nœud inject. C’est le fonctionnement de l’exemple intégré « Only Messages at Regular Intervals ».
• Contexte après un redémarrage — par défaut, le contexte est conservé uniquement en RAM et disparaît au redémarrage du GX ou en cas de coupure d’alimentation. L’enregistrement sur disque s’active dans le fichier /data/home/nodered/.node-red/settings-user.js (stockage localfilesystem ; dans l’exemple du manuel, enregistrement toutes les 300 s). N’enregistrez pas trop souvent pour éviter d’user la mémoire flash.

Fonctionnement du nœud de commande

Le nœud Control écrit dans l’appareil la valeur de msg.payload. Les paramètres à liste de valeurs (enum) se règlent avec un nombre — dans les exemples Victron, le nœud inject envoie par exemple le nombre 3 au nœud Vebus Control pour allumer le convertisseur/chargeur. Les valeurs de chaque chemin figurent dans le tableau ci-dessous et dans le wiki.

• Programmation horaire — le nœud inject peut envoyer une valeur à une heure fixe, certains jours ou toutes les quelques minutes dans une plage horaire définie. Node-RED utilise le fuseau horaire défini dans Remote Console ; après sa modification, vous devez redémarrer Node-RED.
• Maintien de l’état — l’exemple « Event Based Scheduling » relie le nœud d’entrée Vebus (/Mode) au nœud de commande pour maintenir le mode choisi aux heures programmées, même si quelqu’un le modifie accidentellement.
• Programmations particulières — pour les jours fériés, un décalage aléatoire ou le crépuscule et l’aube, Victron recommande le nœud supplémentaire node-red-big-timer (menu Manage palette → Install).

Chemins utiles

Chaque paramètre possède son propre chemin D-Bus. L’éditeur remplace les variables des chemins par les valeurs disponibles sur les appareils connectés :

Sélection de chemins du wiki — pour l’automatisation selon l’état de la batterie, la production PV et le mode du convertisseur :

Relais — réglages préalables

Pour que Node-RED puisse commuter le relais, vous devez d’abord le configurer en commande manuelle — généralement dans VictronConnect. Le relais est ensuite commandé par le nœud Relay Control : 1 ferme le contact (Closed), 0 l’ouvre (Open).

• Relais du groupe électrogène — configurez sa fonction sur « Generator » dans la console GX, puis envoyez les commandes de démarrage et d’arrêt avec le nœud Generator Control (/Start : 1 Start, 0 Stop). Le nœud Generator démarre les groupes Fischer Panda directement via D-Bus.
• Interrupteur dans le tableau de bord — l’exemple « Relay Switching » commande un relais depuis le tableau de bord. Pour que l’interrupteur affiche aussi les changements effectués ailleurs, par exemple dans le menu GX, raccordez également le nœud d’entrée Relay à l’entrée de l’interrupteur. La palette node-red-dashboard est nécessaire — voir tableau de bord et accès à distance.
• Flow prêt à l’emploi — activation et désactivation d’un relais selon l’état de la batterie : exemple pas à pas.

Appareils virtuels

Un appareil virtuel permet de raccorder au GX un équipement ou une source de données que Victron ne prend pas en charge. Une fois créé dans Node-RED, il apparaît dans le GX et se comporte comme un véritable appareil Victron — y compris dans le portail VRM. Exemples du manuel : données météo d’une API comme station météo virtuelle, soutirage et injection réseau calculés comme compteur réseau virtuel, position GPSd comme GPS virtuel, capteurs LoRa ou MQTT comme capteur de réservoir ou de température virtuel.

1. Venus OS à jour. Mettez le GX à jour vers la dernière version.
2. Nœud Virtual Device. Ajoutez-le au flow et sélectionnez le type d’appareil.
3. Données. Raccordez une source de données ou une logique de commande. Envoyez au nœud msg.payload sous forme d’objet : les clés sont les chemins D-Bus sans barre oblique initiale, les valeurs sont les mesures, par exemple {"Dc/0/Voltage": 48.2, "Dc/0/Current": 12.5, "Soc": 85}.

• Nom sur D-Bus : com.victronenergy.<type>.virtual_<id du nœud>.
• Déconnexion et reconnexion : msg.connected = false déconnecte l’appareil et libère le nom du service sur D-Bus, msg.connected = true le reconnecte.
• Sortie : un port — transmet le message d’origine avec msg.connected défini selon l’état actuel de la connexion à D-Bus.

Interrupteur virtuel (Virtual Switch)

Crée un interrupteur sans relais physique — par exemple pour un interrupteur IoT équipé du logiciel Tasmota, que le flow commande selon l’état de la batterie. D’après le manuel, il apparaît dans le panneau des interrupteurs (Switch) de la nouvelle interface Venus OS. Il peut être activé et désactivé comme un véritable interrupteur ; son état est enregistré dans le GX et peut être conservé après un redémarrage.

• Commande : {"SwitchableOutput/output_1/State": 1} active l’interrupteur, {"SwitchableOutput/output_1/Dimming": 75} règle la variation à 75%. msg.connected = false déconnecte l’interrupteur.
• 11 types : On/Off (0 arrêt, 1 marche), Dimmable (marche/arrêt et variation 0–100%), Temperature setpoint (curseur de thermostat en °C), Stepped, Basic slider, Dropdown, Numeric input, Three state (0 Off, 1 On, 2 Auto), RGB color wheel, CCT wheel et RGB+White dimmer.
• Sorties : le port 1 transmet le message avec msg.connected ; le port 2 envoie le nouvel état lorsqu’il change ; le port 3 envoie la nouvelle valeur de variation ou de consigne (types avec variation, paliers, valeur numérique et RGB).

Notifications et événements

Exemples intégrés

Dans l’éditeur : menu en haut à droite → Import (ou Ctrl+I) → Examples → node-red-contrib-victron. Les mêmes exemples figurent dans le wiki, sur la page Example Flows. Certains nécessitent des palettes supplémentaires — le plus souvent node-red-dashboard.

Points de divergence entre les sources

• Types d’appareils virtuels. Le manuel Venus OS Large (chap. 5.8) en répertorie 9 : Battery, Generator, GPS, Grid meter, Meteo, Motor drive, PV inverter, Tank sensor et Temperature sensor. Le wiki (Virtual devices) en indique 14 : AC Load, DC Load, Electric Vehicle, Energy meter et Pulse meter s’y ajoutent, et « Motor drive » y apparaît sous le nom E-drive (service com.victronenergy.motordrive). La liste des types du nœud Virtual Device indique ceux qui sont disponibles sur votre installation.
• Où apparaît l’interrupteur virtuel. Selon le manuel : dans le panneau des interrupteurs de la nouvelle interface Venus OS. Selon le wiki : Venus OS le reconnaît comme un module d’extension d’E/S connecté au Cerbo GX, et l’interface GX permet de le commander.
• Fréquence des messages. FAQ Q9 et exemple « Only Messages at Regular Intervals » : à chaque changement et, sans « only changes », également toutes les 5 s. Exemple « Event Based Scheduling » : toutes les 5 s par défaut, avec envoi immédiat des changements — « environ une fois par seconde ».
• Horaires dans « Trigger Based Scheduling ». Description : activation à 6:00, désactivation à 22:00. Dans le flow lui-même, le nœud « Trigger 'ON' at 22:00 » envoie 3 (On) à 22:00, et « Trigger 'OFF' at 6:00 » envoie 4 (Off) à 6:00. Après l’importation, vérifiez les horaires et les valeurs dans les nœuds inject.
• Mise à jour de la palette. Chap. 5.3 et FAQ Q2 : la palette Victron ne peut être mise à jour ni depuis l’éditeur ni en ligne de commande — uniquement via une nouvelle version de Venus OS Large. Le chap. 5.6 indique de manière générale que, si une version de la palette plus récente que celle fournie d’origine est installée, Node-RED utilisera la plus récente. Pour la palette Victron, le manuel précise explicitement en Q2 : uniquement via une nouvelle version de Venus OS Large.
• Paramètres de substitution. La légende du wiki répertorie {type}, {tracker}, {phase}, {day}, {input}, {channel} et {index}, mais les descriptions des chemins contiennent aussi {relay} (/Relay/{relay}/State), {line} (/Ac/Consumption/{line}/Power dans le nœud System) et {historyDay} (/History/Daily/{historyDay}/Yield dans le nœud Solarcharger).

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

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