Victron-Knoten in Node-RED

Victron-Palette

Node-RED bringt einen eigenen Basissatz an Nodes mit. Venus OS Large ergänzt ihn um Victron-Nodes — die Palette node-red-contrib-victron. Sie ist ab Werk installiert. Die Nodes arbeiten über D-Bus, also mit den Werten, die Venus OS von den am GX angeschlossenen Geräten bereitstellt. Im Node wählen Sie Gerät und Parameter aus; Pfade mit Platzhaltern, z. B. {tracker}, löst der Editor automatisch in die verfügbaren Optionen der angeschlossenen Geräte auf.

• Palette aktualisieren — nur zusammen mit einer neuen Version von Venus OS Large. Die Palette lässt sich weder über den Editor noch über die Befehlszeile aktualisieren. Ist online bereits eine neuere Palette verfügbar, müssen Sie auf die nächste Version von Venus OS Large warten — sie erscheint meist kurz nach dem Paletten-Update.
• Beschreibung der Nodes — das Projekt-Wiki auf GitHub beschreibt jeden Node und seine Pfade (Seiten Input nodes, Output nodes und Virtual devices). Die Pfade und Werte auf dieser Seite stammen daraus.
• Andere Paletten — zusätzliche Nodes, z. B. für ein Dashboard, werden aus dem Internet auf der GX-Datenpartition installiert und bleiben daher nach einem Venus-OS-Update erhalten. Erforderlicher freier Speicherplatz: erste Inbetriebnahme.

Node-Typen

Das Wiki unterteilt die Victron-Nodes in Eingangs-Nodes, Steuerungs-Nodes und virtuelle Geräte und führt zusätzlich zwei benutzerdefinierte Nodes (custom) auf.

Vollständige Liste der Geräte-Nodes

Alle 33 Eingangs-Nodes; 18 davon haben auch eine Steuerungsvariante (im Wiki mit dem Zusatz „Control“). Beschreibungen gemäß Wiki.

Wann der Node eine Nachricht sendet

• Bei jeder Wertänderung — dies ist das grundlegende Verhalten eines Eingangs-Nodes.
• Mit aktiviertem „only changes“ — nur dann, wenn sich der Wert ändert.
• Ohne „only changes“ — zusätzlich sendet der Node alle 5 s den aktuellen Wert, auch wenn er sich nicht geändert hat.
• Wert in festen Zeitabständen — speichern Sie msg.payload mit einem change-Node im Kontext (flow. oder global.) und lesen Sie ihn mit einem inject-Node im gewünschten Zeitabstand aus. So funktioniert das integrierte Beispiel „Only Messages at Regular Intervals“.
• Kontext nach einem Neustart — standardmäßig liegt der Kontext nur im RAM und geht beim Neustart des GX-Geräts oder bei einem Stromausfall verloren. Die Speicherung auf einem Datenträger wird in der Datei /data/home/nodered/.node-red/settings-user.js aktiviert (Speicher localfilesystem; im Beispiel aus dem Handbuch wird alle 300 s gespeichert). Speichern Sie nicht zu häufig, um den Flash-Speicher nicht zu verschleißen.

So funktioniert der Steuerungs-Node

Der Control-Node schreibt den Wert aus msg.payload in das Gerät. Parameter mit einer Werteliste (Enum) werden über eine Zahl eingestellt — in den Victron-Beispielen sendet der inject-Node z. B. die Zahl 3 an den Vebus-Control-Node, um den Wechselrichter/das Ladegerät einzuschalten. Die Werte für jeden Pfad finden Sie in der Tabelle unten und im Wiki.

• Zeitplan — der inject-Node kann einen Wert zu einer festen Uhrzeit, an ausgewählten Tagen oder alle paar Minuten innerhalb eines festgelegten Zeitfensters senden. Node-RED verwendet die in der Remote Console eingestellte Zeitzone; nach einer Änderung muss Node-RED neu gestartet werden.
• Zustand beibehalten — das Beispiel „Event Based Scheduling“ verbindet den Vebus-Eingangs-Node (/Mode) mit dem Steuerungs-Node, um zu den geplanten Zeiten den gewählten Modus beizubehalten, auch wenn ihn jemand versehentlich ändert.
• Besondere Zeitpläne — für Feiertage, zufällige Zeitverschiebungen oder Sonnenuntergang und Sonnenaufgang verweist Victron auf den zusätzlichen Node node-red-big-timer (Menü Manage palette → Install).

Nützliche Pfade

Jeder Parameter hat einen eigenen D-Bus-Pfad. Der Editor ersetzt die Platzhalter in den Pfaden durch die auf den angeschlossenen Geräten verfügbaren Werte:

Ausgewählte Pfade aus dem Wiki — für die Automatisierung nach Batteriezustand, PV-Erzeugung und Wechselrichtermodus:

Relais — was zuerst eingestellt werden muss

Damit Node-RED das Relais schalten kann, muss es zunächst auf manuelle Steuerung eingestellt werden — meist in VictronConnect. Anschließend steuert der Knoten Relay Control das Relais: 1 schließt den Kontakt (Closed), 0 öffnet ihn (Open).

• Generatorrelais — in der GX-Konsole wird die Funktion „Generator“ eingestellt; Start und Stopp werden über den Knoten Generator Control gesendet (/Start: 1 Start, 0 Stop). Fischer-Panda-Generatoren startet der Knoten Generator direkt über D-Bus.
• Schalter im Dashboard — das Beispiel „Relay Switching“ steuert das Relais über das Dashboard. Damit der Schalter auch Änderungen anzeigt, die an anderer Stelle vorgenommen wurden, etwa im GX-Menü, wird der Eingangsknoten Relay zusätzlich mit dem Eingang des Schalters verbunden. Dafür wird die Palette node-red-dashboard benötigt — siehe Dashboard und Fernzugriff.
• Fertiger Flow — Relais je nach Batteriezustand ein- und ausschalten: Schritt-für-Schritt-Beispiel.

Virtuelle Geräte

Mit einem virtuellen Gerät lassen sich Hardware oder Datenquellen an GX anbinden, die Victron nicht unterstützt. Nach dem Anlegen in Node-RED erscheint es im GX und verhält sich wie ein echtes Victron-Gerät — auch im VRM-Portal. Beispiele aus dem Handbuch: Wetterdaten einer API als virtuelle Wetterstation, berechneter Netzbezug und Netzeinspeisung als virtueller Netzzähler, Position von GPSd als virtuelles GPS, LoRa- oder MQTT-Sensoren als virtueller Tank oder Temperatursensor.

1. Aktuelles Venus OS. Aktualisieren Sie GX auf die neueste Version.
2. Knoten Virtual Device. Fügen Sie ihn zum Flow hinzu und wählen Sie den Gerätetyp.
3. Daten. Verbinden Sie die Datenquelle oder Steuerungslogik. An den Knoten wird msg.payload als Objekt gesendet: Die Schlüssel sind D-Bus-Pfade ohne führenden Schrägstrich, die Werte sind Messwerte, z. B. {"Dc/0/Voltage": 48.2, "Dc/0/Current": 12.5, "Soc": 85}.

• Name auf D-Bus: com.victronenergy.<Typ>.virtual_<Knoten-ID>.
• Trennen und Wiederverbinden: msg.connected = false trennt das Gerät und gibt den Dienstnamen auf D-Bus frei, msg.connected = true verbindet es erneut.
• Ausgang: ein Port — leitet die ursprüngliche Nachricht weiter, wobei msg.connected auf den aktuellen Verbindungsstatus mit D-Bus gesetzt ist.

Virtueller Schalter (Virtual Switch)

Erstellt einen Schalter ohne physisches Relais — beispielsweise für einen IoT-Schalter mit Tasmota-Firmware, den der Flow je nach Batteriezustand steuert. Laut Handbuch erscheint er im Schalterpanel (Switch) der neuen Venus-OS-Oberfläche und lässt sich wie ein echter Schalter ein- und ausschalten. Sein Zustand wird im GX gespeichert und kann einen Neustart überdauern.

• Steuerung: {"SwitchableOutput/output_1/State": 1} schaltet ein, {"SwitchableOutput/output_1/Dimming": 75} setzt den Dimmwert auf 75%. msg.connected = false trennt den Schalter.
• 11 Typen: On/Off (0 aus, 1 ein), Dimmable (ein/aus und Dimmen 0–100%), Temperature setpoint (Thermostat-Schieberegler in °C), Stepped, Basic slider, Dropdown, Numeric input, Three state (0 Off, 1 On, 2 Auto), RGB color wheel, CCT wheel und RGB+White dimmer.
• Ausgänge: Port 1 gibt die Nachricht mit msg.connected weiter; Port 2 sendet den neuen Zustand bei einer Änderung; Port 3 den neuen Dimm- oder Sollwert (Typen mit Dimmen, Stufen, Zahlenwert und RGB).

Benachrichtigungen und Ereignisse

Integrierte Beispiele

Im Editor: Menü oben rechts → Import (oder Ctrl+I) → Examples → node-red-contrib-victron. Dieselben Beispiele stehen im Wiki auf der Seite Example Flows. Einige benötigen zusätzliche Paletten — meist node-red-dashboard.

Wo sich die Quellen unterscheiden

• Typen virtueller Geräte. Das Handbuch zu Venus OS Large (Kap. 5.8) nennt 9: Battery, Generator, GPS, Grid meter, Meteo, Motor drive, PV inverter, Tank sensor und Temperature sensor. Das Wiki (Virtual devices) nennt 14: Hinzu kommen AC Load, DC Load, Electric Vehicle, Energy meter und Pulse meter; „Motor drive“ heißt dort E-drive (Dienst com.victronenergy.motordrive). Welche Typen bei Ihnen verfügbar sind, zeigt die Typenliste im Virtual Device-Knoten.
• Wo der virtuelle Schalter sichtbar ist. Handbuch: im Schalterpanel der neuen Venus-OS-Oberfläche. Wiki: Venus OS erkennt ihn als angeschlossenen I/O-Extender des Cerbo GX, und er lässt sich über die GX-Oberfläche bedienen.
• Wie oft Nachrichten eintreffen. FAQ Q9 und Beispiel „Only Messages at Regular Intervals“: bei jeder Änderung, ohne „only changes“ zusätzlich alle 5 s. Beispiel „Event Based Scheduling“: standardmäßig alle 5 s, Änderungen werden sofort gesendet — „etwa einmal pro Sekunde“.
• Uhrzeiten in „Trigger Based Scheduling“. Beschreibung: Einschalten um 6:00, Ausschalten um 22:00. Im Flow selbst sendet der Knoten „Trigger 'ON' at 22:00“ um 22:00 den Wert 3 (On), und „Trigger 'OFF' at 6:00“ sendet um 6:00 den Wert 4 (Off). Prüfen Sie nach dem Import die Uhrzeiten und Werte in den inject-Knoten.
• Paletten-Update. Kap. 5.3 und FAQ Q2: Die Victron-Palette lässt sich weder im Editor noch über die Kommandozeile aktualisieren — nur mit einer neuen Version von Venus OS Large. Kap. 5.6 sagt allgemein, dass Node-RED eine neuere Palette verwendet, wenn eine neuere Version als die werkseitige installiert wurde. Zur Victron-Palette sagt das Handbuch in Q2 ausdrücklich: nur mit einer neuen Version von Venus OS Large.
• Platzhalter. Die Legende im Wiki nennt {type}, {tracker}, {phase}, {day}, {input}, {channel} und {index}. In den Pfadbeschreibungen stehen jedoch auch {relay} (/Relay/{relay}/State), {line} (/Ac/Consumption/{line}/Power im System-Knoten) und {historyDay} (/History/Daily/{historyDay}/Yield im Solarcharger-Knoten).

Betroffene Geräte

Cerbo GXSystemsteuerzentrale und Gateway zum VRM-Portal.Ekrano GXGX-Zentrale mit integriertem 7″-Touchscreen.

Quellen

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