NEWS
Victron Adapter für Victron GX / Cerbo GX KI-Generiert
-
Vorstellung: ioBroker.victronadapter für Victron GX / Cerbo GX
Hallo zusammen,
ich möchte euch hier meinen neuen ioBroker-Adapter ioBroker.victronadapter vorstellen.
Der Adapter ist für Victron GX- und Cerbo-GX-Systeme gedacht und liest die wichtigsten Werte über Modbus TCP aus. Das Besondere an dem Adapter ist aus meiner Sicht, dass man sich nicht selbst mit den einzelnen Modbus-Registern beschäftigen muss. Ziel ist, dass man im ioBroker möglichst einfach nur die Verbindung zum Victron GX / Cerbo GX einträgt und der Adapter die relevanten Datenpunkte automatisch bereitstellt.
Warum der Adapter?
Viele Victron-Werte sind zwar über Modbus TCP erreichbar, aber die Einrichtung ist für viele Anwender eher umständlich. Man muss wissen, welche Unit-ID verwendet wird, welche Register relevant sind und wie die Werte interpretiert werden müssen.
Der Adapter soll genau diese Arbeit abnehmen.
Man trägt im Idealfall nur ein:
- IP-Adresse oder Hostname des GX-Geräts
- Modbus-TCP-Port, normalerweise
502 - System-Unit-ID, normalerweise
100 - Abfrageintervall
- optional eine Unit-ID-Liste für die automatische Suche
Danach stellt der Adapter die Werte strukturiert als ioBroker-Datenpunkte bereit.
Wichtige Funktionen
Der Adapter liest unter anderem Werte für folgende Bereiche aus:
- Netzbezug / Netzeinspeisung
- PV-Leistung
- Batterieleistung
- Batterieladestand
- AC-Verbraucher
- essentielle Verbraucher
- System- und Statusinformationen
Zusätzlich gibt es eine automatische Suche über bekannte Victron-Unit-IDs. Dadurch soll der Adapter verschiedene Victron-Dienste besser erkennen können, ohne dass man jeden Modbus-Bereich manuell konfigurieren muss.
Kein manuelles Modbus-Mapping nötig
Das ist für mich der wichtigste Punkt:
Man muss keine Modbus-Register selbst anlegen oder bearbeiten.
Der Adapter bringt die bekannten Register und Zuordnungen bereits mit. Die Werte werden automatisch gelesen und als ioBroker-Datenpunkte angelegt. Dadurch ist der Einstieg deutlich einfacher als bei einer komplett manuellen Modbus-Konfiguration.
Lovelace-Unterstützung
Der Adapter bringt auch Lovelace-Dateien mit. Damit können die Victron-Werte optisch dargestellt werden.
Enthalten sind unter anderem:
victronadapter-card.js victronadapter-flow.yaml victronadapter-flow-circle.yamlEs gibt eine normale Energiefluss-Karte und eine kreisförmige Ansicht mit Energiefluss-Darstellung.
Beispiel für die normale Karte:
type: custom:victronadapter-flowBeispiel für die Kreis-Ansicht:
type: custom:victronadapter-flow-circleDie Lovelace-Karte nutzt die vorhandenen
dashboard.*-Datenpunkte des Adapters.Voraussetzungen
Benötigt wird:
- ioBroker mit aktuellem js-controller
- Node.js 22 oder neuer
- ioBroker Admin 7.6.20 oder neuer
- Victron GX oder Cerbo GX
- aktiviertes Modbus TCP am Victron-Gerät
- Netzwerkverbindung vom ioBroker-System zum GX-Gerät
Hinweis zur Entstehung
Der Adapter wurde mit Unterstützung von KI erstellt.
Rückmeldungen, Tests und Verbesserungsvorschläge sind daher ausdrücklich willkommen.
Repository
Das GitHub-Repository ist vorbereitet unter:
https://github.com/FreeProgrammer1/ioBroker.victronadapterDer technische Adaptername in ioBroker lautet:
victronadapterDas npm-Paket lautet:
iobroker.victronadapterFeedback erwünscht
Ich würde mich freuen, wenn andere Victron-Nutzer den Adapter testen und Rückmeldung geben:
- Werden eure Victron-Werte korrekt erkannt?
- Stimmen die Dashboard-Werte?
- Funktioniert die automatische Unit-ID-Suche?
- Gibt es Geräte oder Konfigurationen, die noch fehlen?
- Ist die Lovelace-Darstellung verständlich?
Vielen Dank vorab fürs Testen und für euer Feedback.
Hallo FreeProgrammer1,
zunächst einmal vielen Dank für deine Arbeit an dem Adapter. Ich wollte ihn heute in einer ioBroker-Multihost-Umgebung testen und bin dabei auf ein Problem gestoßen.
Mein System
-
ioBroker Multihost
-
Master: RDJLHOME
-
Slave: RDJLTULLN
-
Adapter wurde über GitHub erfolgreich installiert und wird unter den Adaptern korrekt angezeigt:
- Version: 0.6.5+96deb73
Problem
Der Adapter lässt sich zwar problemlos installieren, allerdings kann keine Instanz angelegt werden.
Sowohl über die ioBroker-Admin-Oberfläche als auch über die Konsole erscheint folgende Fehlermeldung:

Unknown packet name victronadapter. Please install packages from outside the repository using "iobroker url <url-or-package>" adapter "victronadapter" cannot be installedDer Adapter ist jedoch bereits installiert und wird auch mit
iobroker list adapters | grep victronkorrekt angezeigt:
system.adapter.victronadapter 0.6.5Trotzdem schlägt
iobroker add victronadaptermit der oben genannten Fehlermeldung fehl.
Meine Anmerkung
Ich könnte vermutlich über verschiedene Konsolenbefehle oder Workarounds weiter experimentieren. Allerdings denke ich, dass das nicht Sinn der Sache sein sollte.
Aus Anwendersicht sollte nach der erfolgreichen Installation des Adapters einfach über die Admin-Oberfläche oder per
iobroker add victronadaptereine Instanz angelegt werden können – genau wie bei anderen Adaptern auch.Vielleicht fehlt hier noch etwas in der Paketdefinition bzw. der Registrierung des Adapters.
Falls ich beim Testen helfen kann oder weitere Informationen benötigt werden, stelle ich diese gerne zur Verfügung.
Vielen Dank!
-
Hallo MyzerAT,
so habe ich das auch gesehen:
GX ist der übergeordnete Sammelbegriff von Victron für die gesamte Gerätefamilie der Kommunikations- und Überwachungszentralen (dazu gehören CCGX, Venus GX, Cerbo GX und Ekrano GX).
Der Cerbo GX wird einmal separat erwähnt, da er das aktuelle Modell ist und die meisten ihn kennen.
Er ist das aktuelle Standardmodell (mit einem deutlich schnelleren Dual-Core-Prozessor, Anschlüssen für die GX Touch-Displays sowie integriertem Bluetooth und WLAN).Ich habe eine dreiphasige 15-kW-Victron-Anlage mit einem 15-kWh-Akku im Betrieb.
NIMM MAL DAS iobroker.victronadapter.tgz und Installiere aus Datei.
Der Adapter ist aktuell noch nicht über npm bzw. das offizielle ioBroker-Repository verfügbar. Dadurch kann iobroker add victronadapter den Adapter nicht wie einen offiziellen Repository-Adapter auflösen. Genau darauf weist die Meldung hin:
Unknown packet name victronadapter.
Please install packages from outside the repository using
"iobroker url <url-or-package>"LG
-
Hallo MyzerAT,
so habe ich das auch gesehen:
GX ist der übergeordnete Sammelbegriff von Victron für die gesamte Gerätefamilie der Kommunikations- und Überwachungszentralen (dazu gehören CCGX, Venus GX, Cerbo GX und Ekrano GX).
Der Cerbo GX wird einmal separat erwähnt, da er das aktuelle Modell ist und die meisten ihn kennen.
Er ist das aktuelle Standardmodell (mit einem deutlich schnelleren Dual-Core-Prozessor, Anschlüssen für die GX Touch-Displays sowie integriertem Bluetooth und WLAN).Ich habe eine dreiphasige 15-kW-Victron-Anlage mit einem 15-kWh-Akku im Betrieb.
NIMM MAL DAS iobroker.victronadapter.tgz und Installiere aus Datei.
Der Adapter ist aktuell noch nicht über npm bzw. das offizielle ioBroker-Repository verfügbar. Dadurch kann iobroker add victronadapter den Adapter nicht wie einen offiziellen Repository-Adapter auflösen. Genau darauf weist die Meldung hin:
Unknown packet name victronadapter.
Please install packages from outside the repository using
"iobroker url <url-or-package>"LG
Die Instanz lässt sich nun anlegen und startet. Ich habe IP der Venus GX, Port 502 und Unit-ID eingetragen.
Beim Start stürzt der Adapter aber ab:
TypeError: Cannot read properties of undefined (reading 'timers')
at finish (/opt/iobroker/node_modules/iobroker.victronadapter/lib/modbusClient.js:65:31)
at Socket.onConnect (/opt/iobroker/node_modules/iobroker.victronadapter/lib/modbusClient.js:80:17)Danach:
Terminated (UNCAUGHT_EXCEPTION)System:
Node.js 22.23.0
js-controller 7.2.2
Adapter-Version 0.6.6
Host RDJLTulln
-
Der normale ioBroker Modbus-Adapter modbus.0 läuft bei mir seit Jahren stabil auf dem Host RDJLTULLN und liest die Venus GX mit denselben Verbindungsdaten problemlos aus:
IP: 192.168.1.6
Port: 502
Unit-ID: 100Der neue victronadapter.0 verwendet exakt dieselben Daten. Die Verbindung scheint grundsätzlich zustande zu kommen, danach stürzt der Adapter aber ab mit:
TypeError: Cannot read properties of undefined (reading 'timers')
at finish (/opt/iobroker/node_modules/iobroker.victronadapter/lib/modbusClient.js:65:31)
at Socket.onConnect (/opt/iobroker/node_modules/iobroker.victronadapter/lib/modbusClient.js:80:17)Daher vermute ich keinen Netzwerk- oder Modbus-Konfigurationsfehler, sondern einen Fehler im Adaptercode beim Verbindungs-/Timer-Handling.
-
Hallo MyzerAT
Ich habe eine neue Version auf Github gelegt.
lg!

-
Hallo MyzerAT
Ich habe eine neue Version auf Github gelegt.
lg!

-
Hallo MyzerAT
Ich habe eine neue Version auf Github gelegt.
lg!

ich habe jetzt nur jene ids eingetragen wo auch devices existieren, selbes verhalten, nach dem 4. device tut sich nichts mehr , die instanz ist aber grün und im log kommt auch nichts neues !
Der Adapter erkennt einige Geräte, bricht dann aber ab. Eventuell verursacht eine nicht antwortende oder ungültige Unit-ID einen Abbruch des Scans. Der Adapter sollte bei Timeout/Fehler einer Unit-ID weiterscannen und nicht komplett abbrechen.


-
Hallo
Unter Objekte victronadapter 0 devices wurden keine angelegt ?
Lg -
-
Hallo
Es gibt eine neue Version als tgz
Lg
Hey! Du scheinst an dieser Unterhaltung interessiert zu sein, hast aber noch kein Konto.
Hast du es satt, bei jedem Besuch durch die gleichen Beiträge zu scrollen? Wenn du dich für ein Konto anmeldest, kommst du immer genau dorthin zurück, wo du zuvor warst, und kannst dich über neue Antworten benachrichtigen lassen (entweder per E-Mail oder Push-Benachrichtigung). Du kannst auch Lesezeichen speichern und Beiträge positiv bewerten, um anderen Community-Mitgliedern deine Wertschätzung zu zeigen.
Mit deinem Input könnte dieser Beitrag noch besser werden 💗
Registrieren Anmelden




