wichtiges UPDATE für controller 7.2.2 im stable

[FreeProgrammer1]

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.yaml

Es gibt eine normale Energiefluss-Karte und eine kreisförmige Ansicht mit Energiefluss-Darstellung.

Beispiel für die normale Karte:

type: custom:victronadapter-flow

Beispiel für die Kreis-Ansicht:

type: custom:victronadapter-flow-circle

Die 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.victronadapter

Der technische Adaptername in ioBroker lautet:

victronadapter

Das npm-Paket lautet:

iobroker.victronadapter

Feedback 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.

[MyzerAT]

Ich verwende schon sehr sehr lange den modbus adapter für meine Victron Inselanlage mit 5x MPPT, 2x Multiplus WR , Wallbox usw , habe damals auch hier eine Anleitung geschrieben, falls man Victron Geräte im iobroker haben will! Auf jeden Fall, Danke für deine Mühe, werde mir deinen Adapter mal näher anschauen, wenn ich etwas Zeit habe!!!!

ps: oben schreibst du Victron GX / Cerbo GX : du meinst aber Venus GX / Cerbo GX

[MyzerAT]

@FreeProgrammer1

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 installed

Der Adapter ist jedoch bereits installiert und wird auch mit

iobroker list adapters | grep victron

korrekt angezeigt:

system.adapter.victronadapter
0.6.5

Trotzdem schlägt

iobroker add victronadapter

mit 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 victronadapter eine 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!

[FreeProgrammer1]

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

[MyzerAT]

@FreeProgrammer1

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

[MyzerAT]

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: 100

Der 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.

[FreeProgrammer1]

Hallo MyzerAT

Ich habe eine neue Version auf Github gelegt.

lg!

[MyzerAT]

es tut sich was

[MyzerAT]

@FreeProgrammer1

irgendwie stoppt es nach dem 4. device

[MyzerAT]

hier die devices im modbus

[MyzerAT]

@FreeProgrammer1

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.

[FreeProgrammer1]

Hallo
Unter Objekte victronadapter 0 devices wurden keine angelegt ?
Lg

[MyzerAT]

Doch!

Hilfreich wären aus meiner Sicht:

• Debug-Log pro geprüfter Unit-ID
• Timeout/Fehler pro Unit-ID sauber abfangen und weiterscannen
• Scan nicht abbrechen, wenn eine Unit-ID nicht antwortet
• Beim unload/terminate laufende Scans/Polls sauber abbrechen

[FreeProgrammer1]

Hallo
Es gibt eine neue Version als tgz
Lg