Victron Battery-Inverter
Die Victron Battery-Inverter Modbus-Vorlage richtet sich an Victron-Energy-ESS-Anlagen, die über ein GX-Gerät (Cerbo GX oder Venus GX) per Modbus TCP erreichbar sind. Die Vorlage liest die vollständigen Systemdaten aus dem com.victronenergy.system-Dienst: phasenweiser AC-Verbrauch, Netzleistung, AC- und DC-seitige PV-Erzeugung, Batteriespannung, Ladestrom, Ladezustand und geschätzte Restlaufzeit. Zusätzlich werden die ESS-Mode-2-Register für Netz-Sollwert, Lade- und Entladestromlimits, maximale Einspeisung und den PV-Leistungsbegrenzer erfasst. Damit steht Ihnen als Installateur eine einheitliche Datenquelle für die gesamte Energiebilanz Ihrer Victron-Anlage zur Verfügung.
- Protokoll
- Modbus TCP
- Anschluss
- Ethernet, Modbus TCP
- Register
- 43, nur lesen
- Marke
- Victron
- Zuletzt aktualisiert
Register (43)
43 lesen, 0 schreiben
| Name | Einheit | Zugriff | Adresse (Verborgen bis zur Eingabe Ihrer E-Mail-Adresse) | Funktion (verborgen) | Typ (verborgen) |
|---|---|---|---|---|---|
| serial_number | Lesen | ||||
| ccgx_relay1_state | Lesen | ||||
| ccgx_relay2_state | Lesen | ||||
| ac_pv_on_output_power_l1 | W | Lesen | |||
| ac_pv_on_output_power_l2 | W | Lesen | |||
| ac_pv_on_output_power_l3 | W | Lesen | |||
| ac_pv_on_input_power_l1 | W | Lesen | |||
| ac_pv_on_input_power_l2 | W | Lesen | |||
| ac_pv_on_input_power_l3 | W | Lesen | |||
| ac_consumption_power_l1 | W | Lesen | |||
| ac_consumption_power_l2 | W | Lesen | |||
| ac_consumption_power_l3 | W | Lesen | |||
| grid_power_l1 | W | Lesen | |||
| grid_power_l2 | W | Lesen | |||
| grid_power_l3 | W | Lesen | |||
| ac_genset_power_l1 | W | Lesen | |||
| ac_genset_power_l2 | W | Lesen | |||
| ac_genset_power_l3 | W | Lesen | |||
| active_input_source | Lesen | ||||
| dc_battery_voltage | V | Lesen | |||
| dc_battery_current | A | Lesen | |||
| active_power | W | Lesen | |||
| battery_soc | % | Lesen | |||
| battery_state | Lesen | ||||
| battery_consumed_amphours | Lesen | ||||
| battery_time_to_go | s | Lesen | |||
| dc_pv_power | W | Lesen | |||
| dc_pv_current | A | Lesen | |||
| charger_power | W | Lesen | |||
| dc_system_power | W | Lesen | |||
| ve_bus_charge_current | A | Lesen | |||
| ve_bus_charge_power | W | Lesen | |||
| ess_control_loop_setpoint | W | Lesen | |||
| ess_max_charge_current_percentage | % | Lesen | |||
| ess_max_discharge_current_percentage | % | Lesen | |||
| ess_control_loop_setpoint_scale_factor_2 | W | Lesen | |||
| ess_max_discharge_power | W | Lesen | |||
| system_max_charge_current | A | Lesen | |||
| max_feed_in_power | W | Lesen | |||
| feed_excess_dc | Lesen | ||||
| dont_feed_excess_ac | Lesen | ||||
| pv_power_limiter_active | Lesen | ||||
| max_charge_voltage | V | Lesen |
Register werden geladen…
Senden Sie Ihre Geräteliste
Steht ein Gerät noch nicht in der Bibliothek, erstellen wir die Vorlage kostenlos, sobald wir die Register haben.
Anwendungsfälle
- Überwachen Sie Ladezustand und Restlaufzeit der Batterie, um unerwartete nächtliche Entladezyklen frühzeitig zu erkennen.
- Prüfen Sie die Netzleistung auf L1, L2 und L3, um die Einhaltung der Einspeisegrenzen Ihres Netzbetreibers zu verifizieren.
- Vergleichen Sie DC-seitige PV-Leistung mit AC-gekoppelter Erzeugung, um die Leistung von MPPT-Regler und Wechselrichter saisonübergreifend zu bewerten.
- Richten Sie Alarme auf Änderungen von active_input_source ein, um ungeplante Umschaltungen auf Generator oder Netz sofort zu erkennen.
- Dokumentieren Sie die Werte von ess_max_discharge_power und max_feed_in_power, um zu bestätigen, dass die ESS-Konfiguration mit den Netzanschlussvereinbarungen übereinstimmt.
Installation
Aktivieren Sie Modbus TCP auf Ihrem GX-Gerät unter Einstellungen, dann Dienste, und schalten Sie den Modbus-TCP-Schalter ein.
Verbinden Sie den ModbusCloud Gateway mit demselben Netzwerk wie das GX-Gerät und stellen Sie sicher, dass TCP-Port 502 erreichbar ist.
Fügen Sie im ModbusCloud-Portal den Gateway hinzu, importieren Sie die Victron Battery-Inverter Modbus-Vorlage und setzen Sie die Unit-ID auf 100, die dem com.victronenergy.system-Dienst entspricht.
Verifizieren Sie die Verbindung, indem Sie Register 843 (battery_soc) auslesen: Ein Wert zwischen 0 und 100 bestätigt, dass der Gateway den richtigen Dienst und die richtige Unit-ID abfragt.
Zu beachten
Die Batteriespannung wird zehnfach zu hoch angezeigt. Was ist falsch?
Register 840 (dc_battery_voltage) verwendet laut der offiziellen Victron-Registerliste einen Skalierungsfaktor von 10. Wenn Ihre Integration den rohen uint16-Wert ohne Division durch 10 weiterverarbeitet, erscheint die Spannung zehnmal so hoch wie die tatsächliche DC-Busspannung. Dividieren Sie den Rohwert durch 10, um den Wert in Volt zu erhalten.
Netzleistungsregister liefern große positive Werte statt negativer Einspeisung. Warum?
Die Register 820 bis 822 sind vom Typ int16 (vorzeichenbehaftet). Viele Modbus-Clients lesen Register standardmäßig als vorzeichenlose 16-Bit-Ganzzahlen. Ein negativer Wert wie -500 W erscheint dann als 65036. Konfigurieren Sie Ihren Client so, dass diese Register als vorzeichenbehaftete 16-Bit-Ganzzahlen interpretiert werden, damit Einspeiseleistung korrekt als negativer Wert angezeigt wird.
Der Gateway verbindet sich, aber alle Register liefern null oder sind nicht verfügbar.
Modbus TCP ist auf Victron-GX-Geräten standardmäßig deaktiviert. Prüfen Sie, ob es unter Einstellungen, dann Dienste, dann Modbus TCP aktiviert ist. Stellen Sie außerdem sicher, dass Sie Unit-ID 100 verwenden. Unit-ID 0 zeigt zwar auf denselben Dienst, wird aber von vielen Clients abgelehnt. Victron empfiehlt ausdrücklich die Verwendung von ID 100.
Ist es sicher, ESS-Sollwertregister von außen zu beschreiben?
Die ESS-Register (Adressen 2700 bis 2710) sind in dieser Vorlage schreibgeschützt. Sollten Sie extern ESS-Sollwerte schreiben, beachten Sie: ESS Mode 2 verfügt über keinen automatischen Passthrough-Rückfall, wenn ein steuerndes Skript keine neuen Werte sendet. Der Wechselrichter arbeitet in diesem Fall mit dem zuletzt geschriebenen Sollwert weiter, bis manuell eingegriffen wird. Testen Sie Sollwertänderungen stets in einer kontrollierten Umgebung.
Selbst sehen, wie es funktioniert?
