Node-RED auf dem Cerbo GX aktivieren

Voraussetzungen

• GX-Gerät mit Venus OS Large — Cerbo GX, Cerbo-S GX, Ekrano GX, Venus GX, Octo GX, MultiPlus-II GX oder EasySolar-II GX. Color Control GX und CanVU GX unterstützen Venus OS Large nicht. Geschwindigkeitsvergleich: Voraussetzungen auf der Übersichtsseite des Bereichs.
• Internetzugang am GX-Gerät — zum Herunterladen von Venus OS Large über das Aktualisierungsmenü und zum Installieren zusätzlicher Nodes.
• Computer im selben Netzwerk — der Node-RED-Editor wird im Browser geöffnet.

Vorbereitung: Bei Cerbo GX, MultiPlus-II GX und EasySolar-II GX ist keine Vorbereitung erforderlich. Auf dem Venus GX müssen Sie zuerst Version v2.73 oder neuer installieren und starten, erst danach Venus OS Large — wegen der für Venus OS Large erforderlichen Partitionierung des Flash-Speichers.

Venus OS Large installieren

1. Aktualisierung. Aktualisieren Sie das GX-Gerät auf die neueste Version: Settings → General → Firmware → Online updates (in früheren Versionen Settings → Firmware → Online updates).
2. Image-Typ „Large“. Stellen Sie im selben Menü Image type auf „Large“, gehen Sie eine Ebene zurück, prüfen Sie auf eine neue Version und installieren Sie diese. Die Download-Dauer hängt von der Internetverbindung ab. Danach startet das GX-Gerät neu; die eigentliche Installation dauert normalerweise etwa 2 Minuten.
3. Prüfung. Nach dem Neustart sollten im Menü Settings unter den Integrationen die Einstellungen für Venus OS Large sichtbar sein — daran erkennen Sie, dass das Image korrekt installiert wurde.
4. Node-RED aktivieren. Aktivieren Sie Node-RED in den Integrationseinstellungen. Zum Ein- und Ausschalten von Node-RED und Signal K ist die Zugriffsebene „Installateur“ erforderlich.

Updates funktionieren weiterhin wie bisher — online oder offline. Die Einstellung Image type bestimmt, welches Image aktualisiert wird.

Editor zum ersten Mal öffnen

• Adresse: https://venus.local:1881. Falls sie nicht funktioniert, ersetzen Sie venus.local durch die IP-Adresse des GX-Geräts im lokalen Netzwerk, z. B. https://192.168.178.224:1881. Wie Sie die IP-Adresse finden, beschreibt das Kapitel zur Remote Console im LAN im Handbuch des GX-Geräts.
• Browserwarnung — Node-RED auf dem GX nutzt eine verschlüsselte Verbindung mit einem selbstsignierten Zertifikat. Deshalb meldet der Browser „Diese Verbindung ist nicht privat“. Klicken Sie auf „Erweitert“ oder „Details“ und fahren Sie fort. Der Vorteil: Benutzername und Passwort werden nicht im Klartext über das Netzwerk übertragen.
• Alte http-Adresse und Port 1880 — nach der Umstellung auf https muss die Adresse mit https beginnen; der Port ist 1881. Ein Verbindungsversuch mit den alten Angaben führt zum Fehler ERR_EMPTY_RESPONSE. Ein zusätzlicher Listener auf Port 1880 (für Nodes, die nur http unterstützen) lässt sich in der Benutzereinstellungsdatei aktivieren — siehe Dashboard und bewährte Vorgehensweisen.
• Über VRM — der Editor ist auch aus der Ferne über das Menü Venus OS Large im VRM-Portal erreichbar. Je nach Verbindungsqualität kann er langsam reagieren.

Passwort für den Editor

Abgesicherter Modus und Neustart

Im GX-Menü können Sie Node-RED im abgesicherten Modus (safe mode) aktivieren: Node-RED startet, führt aber keine Flows aus. Sie können dann den Editor öffnen und die Flows korrigieren, bevor etwas ausgeführt wird — die Flows starten erst nach dem Bereitstellen der Änderungen (Deploy). Das ist ein Notbehelf, wenn ein Flow die GX-CPU stark belastet oder andere Probleme verursacht.

Node-RED neu starten können Sie, indem Sie es im Menü Venus OS Large Features → Node-RED aus- und wieder einschalten.

Flow-Backups

• Export: Editormenü → Export → „all flows“ speichert die Datei flows.json auf dem Computer. Das Handbuch empfiehlt regelmäßige Backups sowie eine zusätzliche Sicherung vor jedem Update der GX-Software.
• Wiederherstellen: Importieren Sie dieselbe Datei auf der neuen Installation mit Import. Verwendet ein Flow Nodes, die in der Palette fehlen, meldet der Editor dies; diese müssen Sie zunächst nachinstallieren.
• Was der Export nicht umfasst: die Konfiguration von Node-RED selbst — sie liegt in den Dateien .config.*.json im Verzeichnis /data/home/nodered/.node-red/.
• Gesamte Datenpartition sichern und zurücksetzen: Die Datei venus-data-00-backup-data-partition.tgz auf einem USB-Stick kopiert die gesamte Partition /data auf den USB-Stick. Die Datei venus-data-20-node-red-reset.tgz löscht die Dateien in /data/home/nodered/ und ermöglicht einen Neuanfang mit Node-RED. Stecken Sie den USB-Stick in das GX-Gerät und starten Sie es neu; drei Signaltöne zeigen den Abschluss an (beim MultiPlus-II GX eine Meldung auf dem Display).

Speicherplatz auf der Datenpartition

Zusätzliche Nodes werden auf der Datenpartition des GX installiert und bleiben daher nach einem Venus-OS-Update erhalten. Auf dieser Partition müssen immer mindestens 30 MB frei bleiben. Sinkt der freie Speicherplatz unter 5%, meldet das GX die Warnung #46 Data partition full; den genauen Wert zeigt das Menü Settings → General → Modifications. Bei voller Partition startet Node-RED möglicherweise gar nicht mehr, und Venus OS funktioniert nicht mehr korrekt.

Die Victron-Node-Palette ist Bestandteil von Venus OS Large und wird nur zusammen damit aktualisiert. Ist online bereits eine neuere Palette verfügbar, die noch nicht in Venus OS Large enthalten ist, empfiehlt das Handbuch abzuwarten — eine neue Version von Venus OS Large erscheint meist kurz nach dem Paletten-Update. Inhalt der Palette: Victron-Nodes. Erster funktionsfähiger Flow: Relais nach Batteriezustand steuern.

Betroffene Geräte

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

Quellen

• Venus OS Large image: Signal K and Node-RED — Kap. 2–5, FAQ Q3–Q5 und Q8, Kap. 7 und 8victronenergy.com · EN
• Cerbo-GX-Handbuch — Remote Console im LAN, Software-Updatesvictronenergy.com · EN