Victron Battery
Victron Battery is een Modbus TCP-template voor accu-monitors en via CAN-bus aangesloten BMS-systemen die via een Victron GX-apparaat worden uitgelezen. De template beslaat de volledige com.victronenergy.battery-registerruimte: live metingen voor spanning, stroom, temperatuur, laadtoestand en gezondheid van de accu; een uitgebreide alarmset voor onder- en overspanning, temperatuur, celongelijkheid, zekering en laadstroom; historische data inclusief laadcycli, diepste ontlading en lifetime energiedoorvoer; en door het BMS gerapporteerde laad- en ontlaadlimieten. Gebruik deze template in ModbusCloud om accubewaking centraal te beheren in elke Victron-installatie, zonder maatwerk scripting.
- Protocol
- Modbus TCP
- Aansluiting
- Ethernet, Modbus TCP
- Registers
- 84, alleen lezen
- Merk
- Victron
- Laatst bijgewerkt
Registers (84)
84 lezen, 0 schrijven
| Naam | Eenheid | Toegang | Adres (Verborgen tot je je e-mailadres invult) | Functie (verborgen) | Type (verborgen) |
|---|---|---|---|---|---|
| voltage | V | Lezen | |||
| starter_battery_voltage | V | Lezen | |||
| current | A | Lezen | |||
| temperature | °C | Lezen | |||
| mid_voltage | V | Lezen | |||
| mid_voltage_deviation | Lezen | ||||
| consumed_amphours | Lezen | ||||
| soc | % | Lezen | |||
| alarm | Lezen | ||||
| low_voltage_alarm | Lezen | ||||
| high_voltage_alarm | Lezen | ||||
| low_starter_voltage_alarm | Lezen | ||||
| high_starter_voltage_alarm | Lezen | ||||
| low_state_of_charge_alarm | Lezen | ||||
| low_temperature_alarm | Lezen | ||||
| high_temperature_alarm | Lezen | ||||
| mid_voltage_alarm | Lezen | ||||
| low_fused_voltage_alarm | Lezen | ||||
| high_fused_voltage_alarm | Lezen | ||||
| fuse_blown_alarm | Lezen | ||||
| high_internal_temperature_alarm | Lezen | ||||
| relay_status | Lezen | ||||
| deepest_discharge | Lezen | ||||
| last_discharge | Lezen | ||||
| average_discharge | Lezen | ||||
| charge_cycles | count | Lezen | |||
| full_discharges | count | Lezen | |||
| total_amphours_drawn | Lezen | ||||
| history_min_voltage | V | Lezen | |||
| history_max_voltage | V | Lezen | |||
| time_since_last_full_charge | h | Lezen | |||
| automatic_syncs | count | Lezen | |||
| low_voltage_alarms | count | Lezen | |||
| high_voltage_alarms | count | Lezen | |||
| low_starter_voltage_alarms | count | Lezen | |||
| high_starter_voltage_alarms | count | Lezen | |||
| min_starter_voltage | V | Lezen | |||
| max_starter_voltage | V | Lezen | |||
| low_fused_voltage_alarms | count | Lezen | |||
| high_fused_voltage_alarms | count | Lezen | |||
| min_fused_voltage | V | Lezen | |||
| max_fused_voltage | V | Lezen | |||
| dc_discharged_energy | Wh | Lezen | |||
| dc_charged_energy | Wh | Lezen | |||
| time_to_go | h | Lezen | |||
| soh | % | Lezen | |||
| charge_max_voltage | V | Lezen | |||
| discharge_min_voltage | V | Lezen | |||
| charge_max_current | A | Lezen | |||
| discharge_max_current | A | Lezen | |||
| capacity_in_amphours | Lezen | ||||
| timestamp_1st_last_error | Lezen | ||||
| timestamp_2nd_last_error | Lezen | ||||
| timestamp_3rd_last_error | Lezen | ||||
| timestamp_4th_last_error | Lezen | ||||
| min_cell_temperature | °C | Lezen | |||
| max_cell_temperature | °C | Lezen | |||
| high_charge_current_alarm | Lezen | ||||
| high_discharge_current_alarm | Lezen | ||||
| cell_imbalance_alarm | Lezen | ||||
| internal_failure_alarm | Lezen | ||||
| high_charge_temperature_alarm | Lezen | ||||
| low_charge_temperature_alarm | Lezen | ||||
| low_cell_voltage_alarm | Lezen | ||||
| victron_state | Lezen | ||||
| error | Lezen | ||||
| system_switch | Lezen | ||||
| balancing | Lezen | ||||
| number_of_batteries | count | Lezen | |||
| batteries_parallel | count | Lezen | |||
| batteries_series | count | Lezen | |||
| number_of_cells_per_battery | count | Lezen | |||
| min_cell_voltage | mV | Lezen | |||
| max_cell_voltage | mV | Lezen | |||
| shutdowns_due_error | count | Lezen | |||
| diagnostics_1st_last_error | Lezen | ||||
| diagnostics_2nd_last_error | Lezen | ||||
| diagnostics_3rd_last_error | Lezen | ||||
| diagnostics_4th_last_error | Lezen | ||||
| allow_to_charge | Lezen | ||||
| allow_to_discharge | Lezen | ||||
| external_relay | Lezen | ||||
| history_min_cell_voltage | V | Lezen | |||
| history_max_cell_voltage | V | Lezen |
Registers laden…
Stuur jouw apparatenlijst
Staat een apparaat niet in de bibliotheek, dan maken we de template gratis zodra we de registers hebben.
Gebruikstoepassingen
- Volg laadtoestand en accugezondheid over meerdere maanden om capaciteitsverlies in oudere accu's te detecteren.
- Ontvang een melding bij een lage-laadtoestand- of celongelijkheids-alarm voordat er een beveiligingsafsluiting plaatsvindt.
- Vergelijk dc_charged_energy en dc_discharged_energy over seizoenen heen om de round-trip efficiëntie te controleren.
- Analyseer min_cell_voltage en max_cell_voltage in de tijd om cellen te identificeren die afwijken van het pakketgemiddelde.
- Rapporteer het aantal laadcycli en volledige ontladingen aan onderhoudsteams voor garantie- en levensduurplanning.
Installatie
Schakel Modbus TCP in op het Victron GX-apparaat via Instellingen, dan Services, en zet Modbus TCP aan; de service luistert standaard op TCP-poort 502.
Verbind de ModbusCloud Gateway met hetzelfde netwerk als het GX-apparaat en zorg dat de gateway het IP-adres van het GX-apparaat kan bereiken op poort 502.
Voeg in het ModbusCloud-portaal de Gateway toe, importeer de Victron Battery-template en stel het unit ID in op het device instance-nummer dat zichtbaar is in het GX-apparaat onder Instellingen, Services, Modbus TCP, Beschikbare services.
Controleer de verbinding door de registers soc (adres 266) en voltage (adres 259) in de live weergave van het portaal te vergelijken met de waarden op het scherm van het GX-apparaat.
Veelvoorkomende aandachtspunten
Spanning en stroom zijn een factor tien of honderd te hoog. Hoe komt dat?
Victron Modbus TCP-registers gebruiken schalingsfactoren: spanningswaarden worden vermenigvuldigd met 100 verzonden, stroomwaarden met 10. Als je client die schalingsfactoren niet automatisch toepast, deel je de ruwe registerwaarde zelf door de bijbehorende factor. De ModbusCloud-template verwerkt dit intern; onverwacht hoge waarden duiden op het ontbreken van de template of een verkeerd unit ID.
De gateway verbindt, maar alle registers geven nul of zijn leeg. Wat nu?
De meest voorkomende oorzaak is een verkeerd unit ID. Het GX-apparaat kent per aangesloten accu een unit ID toe op basis van het device instance, niet een vaste waarde. Open het GX-apparaat, ga naar Instellingen, Services, Modbus TCP, Beschikbare services en zoek de com.victronenergy.battery-vermelding om het juiste unit ID te vinden.
Historische registers zoals deepest_discharge zijn leeg op een CAN-bus accu. Klopt de template?
Ja, de template klopt. Historische registers zoals diepste ontlading, laadcycli en mid-spanning zijn alleen beschikbaar via een BMV-accu-monitor. CAN-bus BMS-accu's leveren die velden niet via de com.victronenergy.battery-service. Lege waarden op die adressen zijn het verwachte gedrag zoals gedocumenteerd door Victron.
Het register time_to_go staat op nul. Is de accu leeg?
Nee. Een waarde van nul in time_to_go is een speciale code die aangeeft dat de accu op dat moment aan het laden is, niet dat de resterende tijd nul is. Een daadwerkelijk lage resterende tijd geeft een kleine positieve waarde. Controleer altijd ook het soc-register om de werkelijke laadtoestand te bevestigen voordat je een melding aanmaakt.
Zelf zien hoe het werkt?
