Victron Battery
Victron Battery ist eine Modbus-TCP-Vorlage für Batteriemonitore und CAN-Bus-BMS-Batteriesysteme, die über ein Victron-GX-Gerät ausgelesen werden. Die Vorlage deckt den gesamten com.victronenergy.battery-Registerbereich ab: Echtzeitmessungen für Spannung, Strom, Temperatur, Ladezustand und Batteriezustand; einen umfassenden Alarmsatz für Unter- und Überspannung, Temperatur, Zellungleichgewicht, Sicherung und Ladestrom; historische Daten inklusive Ladezyklen, Tiefentladungen und Lebensdauer-Energiedurchsatz; sowie vom BMS gemeldete Lade- und Entladegrenzen. Nutzen Sie diese Vorlage in Ihrem ModbusCloud-Portal, um das Batterie-Monitoring zentral für alle Victron-Anlagen zu verwalten.
- Protokoll
- Modbus TCP
- Anschluss
- Ethernet, Modbus TCP
- Register
- 84, nur lesen
- Marke
- Victron
- Zuletzt aktualisiert
Register (84)
84 lesen, 0 schreiben
| Name | Einheit | Zugriff | Adresse (Verborgen bis zur Eingabe Ihrer E-Mail-Adresse) | Funktion (verborgen) | Typ (verborgen) |
|---|---|---|---|---|---|
| voltage | V | Lesen | |||
| starter_battery_voltage | V | Lesen | |||
| current | A | Lesen | |||
| temperature | °C | Lesen | |||
| mid_voltage | V | Lesen | |||
| mid_voltage_deviation | Lesen | ||||
| consumed_amphours | Lesen | ||||
| soc | % | Lesen | |||
| alarm | Lesen | ||||
| low_voltage_alarm | Lesen | ||||
| high_voltage_alarm | Lesen | ||||
| low_starter_voltage_alarm | Lesen | ||||
| high_starter_voltage_alarm | Lesen | ||||
| low_state_of_charge_alarm | Lesen | ||||
| low_temperature_alarm | Lesen | ||||
| high_temperature_alarm | Lesen | ||||
| mid_voltage_alarm | Lesen | ||||
| low_fused_voltage_alarm | Lesen | ||||
| high_fused_voltage_alarm | Lesen | ||||
| fuse_blown_alarm | Lesen | ||||
| high_internal_temperature_alarm | Lesen | ||||
| relay_status | Lesen | ||||
| deepest_discharge | Lesen | ||||
| last_discharge | Lesen | ||||
| average_discharge | Lesen | ||||
| charge_cycles | count | Lesen | |||
| full_discharges | count | Lesen | |||
| total_amphours_drawn | Lesen | ||||
| history_min_voltage | V | Lesen | |||
| history_max_voltage | V | Lesen | |||
| time_since_last_full_charge | h | Lesen | |||
| automatic_syncs | count | Lesen | |||
| low_voltage_alarms | count | Lesen | |||
| high_voltage_alarms | count | Lesen | |||
| low_starter_voltage_alarms | count | Lesen | |||
| high_starter_voltage_alarms | count | Lesen | |||
| min_starter_voltage | V | Lesen | |||
| max_starter_voltage | V | Lesen | |||
| low_fused_voltage_alarms | count | Lesen | |||
| high_fused_voltage_alarms | count | Lesen | |||
| min_fused_voltage | V | Lesen | |||
| max_fused_voltage | V | Lesen | |||
| dc_discharged_energy | Wh | Lesen | |||
| dc_charged_energy | Wh | Lesen | |||
| time_to_go | h | Lesen | |||
| soh | % | Lesen | |||
| charge_max_voltage | V | Lesen | |||
| discharge_min_voltage | V | Lesen | |||
| charge_max_current | A | Lesen | |||
| discharge_max_current | A | Lesen | |||
| capacity_in_amphours | Lesen | ||||
| timestamp_1st_last_error | Lesen | ||||
| timestamp_2nd_last_error | Lesen | ||||
| timestamp_3rd_last_error | Lesen | ||||
| timestamp_4th_last_error | Lesen | ||||
| min_cell_temperature | °C | Lesen | |||
| max_cell_temperature | °C | Lesen | |||
| high_charge_current_alarm | Lesen | ||||
| high_discharge_current_alarm | Lesen | ||||
| cell_imbalance_alarm | Lesen | ||||
| internal_failure_alarm | Lesen | ||||
| high_charge_temperature_alarm | Lesen | ||||
| low_charge_temperature_alarm | Lesen | ||||
| low_cell_voltage_alarm | Lesen | ||||
| victron_state | Lesen | ||||
| error | Lesen | ||||
| system_switch | Lesen | ||||
| balancing | Lesen | ||||
| number_of_batteries | count | Lesen | |||
| batteries_parallel | count | Lesen | |||
| batteries_series | count | Lesen | |||
| number_of_cells_per_battery | count | Lesen | |||
| min_cell_voltage | mV | Lesen | |||
| max_cell_voltage | mV | Lesen | |||
| shutdowns_due_error | count | Lesen | |||
| diagnostics_1st_last_error | Lesen | ||||
| diagnostics_2nd_last_error | Lesen | ||||
| diagnostics_3rd_last_error | Lesen | ||||
| diagnostics_4th_last_error | Lesen | ||||
| allow_to_charge | Lesen | ||||
| allow_to_discharge | Lesen | ||||
| external_relay | Lesen | ||||
| history_min_cell_voltage | V | Lesen | |||
| history_max_cell_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
- Verfolgen Sie Ladezustand und Batteriezustand über Monate, um Kapazitätsverluste in alternden Batteriespeichern zu erkennen.
- Erhalten Sie eine Warnung bei niedrigem Ladezustand oder Zellungleichgewichts-Alarm, bevor eine Schutzabschaltung ausgelöst wird.
- Vergleichen Sie dc_charged_energy und dc_discharged_energy saisonübergreifend, um den Wirkungsgrad Ihrer Anlage zu prüfen.
- Analysieren Sie min_cell_voltage und max_cell_voltage über die Zeit, um von der Packspannung abweichende Zellen zu identifizieren.
- Melden Sie Ladezyklen und Vollentladungen an Wartungsteams für Garantie- und Lebensdauerplanung Ihrer Batteriespeicher.
Installation
Aktivieren Sie Modbus TCP auf dem Victron-GX-Gerät unter Einstellungen, dann Dienste, und schalten Sie Modbus TCP ein; der Dienst lauscht standardmäßig auf TCP-Port 502.
Verbinden Sie das ModbusCloud Gateway mit demselben Netzwerk wie das GX-Gerät und stellen Sie sicher, dass das Gateway die IP-Adresse des GX-Geräts auf Port 502 erreichen kann.
Fügen Sie im ModbusCloud-Portal das Gateway hinzu, importieren Sie die Victron-Battery-Vorlage und tragen Sie die Unit-ID ein, die dem Device-Instance-Wert entspricht, der auf dem GX-Gerät unter Einstellungen, Dienste, Modbus TCP, Verfügbare Dienste angezeigt wird.
Prüfen Sie die Verbindung, indem Sie die Register soc (Adresse 266) und voltage (Adresse 259) in der Live-Ansicht des Portals mit den Werten auf dem GX-Gerätedisplay vergleichen.
Zu beachten
Spannungs- und Stromwerte sind um Faktor zehn oder hundert zu groß. Warum?
Victron-Modbus-TCP-Register verwenden Skalierungsfaktoren: Spannungswerte werden mit 100 multipliziert übertragen, Stromwerte mit 10. Wenn Ihr Client diese Faktoren nicht automatisch anwendet, dividieren Sie den Rohwert entsprechend. Die ModbusCloud-Vorlage verarbeitet dies intern; unerwartet hohe Werte deuten auf eine fehlende Vorlage oder eine falsche Unit-ID hin.
Das Gateway verbindet sich, aber alle Register liefern Null oder sind leer. Was nun?
Die häufigste Ursache ist eine falsche Unit-ID. Das GX-Gerät weist jeder angeschlossenen Batterie eine Unit-ID basierend auf der Device-Instanz zu, kein fester Wert. Öffnen Sie das GX-Gerät, navigieren Sie zu Einstellungen, Dienste, Modbus TCP, Verfügbare Dienste und suchen Sie den com.victronenergy.battery-Eintrag, um die korrekte Unit-ID zu ermitteln.
Historische Register wie deepest_discharge sind bei einer CAN-Bus-Batterie leer. Ist die Vorlage fehlerhaft?
Nein. Historische Register wie Tiefentladung, Ladezyklen und Mittenpunktspannung werden ausschließlich von BMV-Batteriemonitoren befüllt. CAN-Bus-BMS-Batterien stellen diese Felder über den com.victronenergy.battery-Dienst nicht bereit. Leere Werte an diesen Adressen sind das von Victron dokumentierte Standardverhalten.
Das Register time_to_go zeigt Null an. Ist die Batterie leer?
Nein. Der Wert Null in time_to_go ist ein Sonderwert, der anzeigt, dass die Batterie gerade geladen wird, nicht dass die Restlaufzeit abgelaufen ist. Eine tatsächlich geringe Restlaufzeit liefert einen kleinen positiven Wert. Prüfen Sie zusätzlich das soc-Register, bevor Sie auf Basis von time_to_go einen Alarm auslösen.
Selbst sehen, wie es funktioniert?
