Victron Victron Ess Modbus TCP template

Victron Ess

Victron Ess is het VE.Bus-gebaseerde energieopslagsysteem dat een Victron MultiPlus of Quattro omvormer/acculader combineert met een GX-apparaat en accubank voor net-parallelle en off-grid werking. Deze Modbus TCP-template leest het volledige VE.Bus-registerblok: per-fase AC-ingangsspanning, stroom, frequentie en vermogen; DC-accuspanning, -stroom, laadtoestand, temperatuur en laadstatus; plus een uitgebreide alarmset voor overbelasting, lage accustand, ripple, netverlies en BMS-status. ESS-vermogensinstellingen en energietellers over alle AC-paden zijn ook direct beschikbaar. Importeer de template in je ModbusCloud-portal en heb direct inzicht in je Victron Ess-installatie.

Protocol
Modbus TCP
Aansluiting
Ethernet, Modbus TCP
Registers
94, lezen en schrijven
Laatst bijgewerkt

Registers (94)

89 lezen, 5 schrijven

NaamEenheidToegangAdres (Verborgen tot je je e-mailadres invult)Functie (verborgen)Type (verborgen)
voltage_input_l1VLezen
voltage_input_l2VLezen
voltage_input_l3VLezen
current_input_l1ALezen
current_input_l2ALezen
current_input_l3ALezen
frequency_input_l1HzLezen
frequency_input_l2HzLezen
frequency_input_l3HzLezen
active_power_input_l1WLezen
active_power_input_l2WLezen
active_power_input_l3WLezen
voltage_output_l1VLezen
voltage_output_l2VLezen
voltage_output_l3VLezen
current_output_l1ALezen
current_output_l2ALezen
current_output_l3ALezen
frequency_outputHzLezen
current_input_limitALezen
active_power_output_l1WLezen
active_power_output_l2WLezen
active_power_output_l3WLezen
battery_voltageVLezen
battery_currentALezen
phase_countLezen
active_inputLezen
soc%Lezen
ve_bus_stateLezen
ve_bus_errorLezen
switch_positionLezen
temperature_alarmLezen
low_battery_alarmLezen
overload_alarmLezen
ess_power_setpoint_phase_1WLezen
ess_disable_charge_flag_aLezen
ess_disable_feedback_flag_aLezen
ess_power_setpoint_phase_2WLezen
ess_power_setpoint_phase_3WLezen
temperature_sensor_alarmLezen
voltage_sensor_alarmLezen
temperature_alarm_l1Lezen
low_battery_alarm_l1Lezen
overload_alarm_l1Lezen
ripple_alarm_l1Lezen
temperature_alarm_l2Lezen
low_battery_alarm_l2Lezen
overload_alarm_l2Lezen
ripple_alarm_l2Lezen
temperature_alarm_l3Lezen
low_battery_alarm_l3Lezen
overload_alarm_l3Lezen
ripple_alarm_l3Lezen
disable_pv_inverterLezen
ve_bus_bms_allow_battery_chargeLezen
ve_bus_bms_allow_battery_dischargeLezen
ve_bus_bms_expectedLezen
ve_bus_bms_errorLezen
battery_temperature°CLezen
ve_bus_resetLezen
phase_rotation_warningLezen
grid_lost_alarmLezen
feed_dc_overvoltage_to_gridLezen
max_dc_overvoltage_power_to_grid_l1WLezen
max_dc_overvoltage_power_to_grid_l2WLezen
max_dc_overvoltage_power_to_grid_l3WLezen
ac_input1_ignoredLezen
ac_input2_ignoredLezen
ac_power_setpoint_as_feed_in_limitLezen
solar_offset_voltageVLezen
sustain_activeLezen
energy_from_ac_in_1_to_ac_outWhLezen
energy_from_ac_in_1_to_batteryWhLezen
energy_from_ac_in_2_to_ac_outWhLezen
energy_from_ac_in_2_to_batteryWhLezen
energy_from_ac_out_to_ac_in_1WhLezen
energy_from_ac_out_to_ac_in_2WhLezen
energy_from_battery_to_ac_in_1WhLezen
energy_from_battery_to_ac_in_2WhLezen
energy_from_battery_to_ac_outWhLezen
energy_from_ac_out_to_batteryWhLezen
low_cell_voltage_imminentLezen
charge_stateLezen
int32_ess_power_setpoint_phase_1WLezen
int32_ess_power_setpoint_phase_2WLezen
int32_ess_power_setpoint_phase_3WLezen
prefer_renewable_energyWhLezen
select_remote_generatorLezen
remote_generator_selectedLezen
set_active_power_l1WSchrijven
ess_disable_charge_flag_bSchrijven
ess_disable_feedback_flag_bSchrijven
set_active_power_l2WSchrijven
set_active_power_l3WSchrijven

Registers laden…

Stuur jouw apparatenlijst

Staat een apparaat niet in de bibliotheek, dan maken we de template gratis zodra we de registers hebben.

Gebruikstoepassingen

  • Bewaak de laadtoestand en temperatuur van de accu om de BatteryLife-werking door het jaar heen te controleren.
  • Volg het AC-ingangs- en uitgangsvermogen per fase om onbalans in drievoudige installaties tijdig te signaleren.
  • Stel een melding in bij het activeren van het grid_lost_alarm of overload_alarm zodat monteurs direct worden gewaarschuwd.
  • Vergelijk energy_from_battery_to_ac_out met energy_from_ac_in_1_to_battery om de rendementsontwikkeling over tijd bij te houden.
  • Verifieer of de ESS-vermogensinstellingen geschreven naar set_active_power_l1 tot en met L3 correct worden teruggerapporteerd in de uitleesregisters.

Installatie

  1. Activeer Modbus TCP op het GX-apparaat (Cerbo GX, Venus GX of vergelijkbaar) via Instellingen, vervolgens Services, en zet de Modbus TCP-service aan.

  2. Verbind de ModbusCloud Gateway met hetzelfde netwerk als het GX-apparaat. Het GX-apparaat biedt Modbus TCP aan op poort 502; er is geen extra bedrading nodig.

  3. Voeg de Gateway toe in het ModbusCloud-portal, importeer de Victron Ess-template en stel het unit-ID in op 246 voor het VE.Bus-apparaat op de VE.Bus-poort van het GX-apparaat.

  4. Controleer de verbinding door te verifiëren dat register 30 (soc) een waarde tussen 0 en 100 toont en register 26 (battery_voltage) een realistische DC-spanning teruggeeft.

Veelvoorkomende aandachtspunten

Spanning- en stroomregisters lijken een factor tien te hoog. Hoe kan dat?

Victron VE.Bus Modbus-registers voor AC-spanning en DC-accuspanning gebruiken een schaalfactor van 10: deel de ruwe registerwaarde door 10 om de werkelijke spanning in volt te krijgen. Hetzelfde geldt voor de accustroom. Controleer altijd de schaalfactor in de Victron Modbus TCP-registerlijst voordat je een waarde interpreteert.

De Gateway verbindt maar alle VE.Bus-registers geven een fout terug. Wat nu?

De meest voorkomende oorzaak is een verkeerd unit-ID. Het VE.Bus-systeem op de VE.Bus-poort van het GX-apparaat gebruikt standaard unit-ID 246. Controleer het werkelijke unit-ID in het GX-apparaat via Instellingen en pas het unit-ID in het ModbusCloud-portal hierop aan.

De energietellers springen onverwacht terug naar nul. Is dit een storing?

Dit is normaal gedrag van VE.Bus. De energietellers zoals energy_from_ac_in_1_to_ac_out zijn vluchtig: ze worden gereset bij het uitschakelen van de Multi of Quattro en ook bij het opnieuw opstarten van het GX-apparaat. Gebruik de historische logging in het ModbusCloud-portal om cumulatieve gegevens te bewaren.

Ik heb een waarde naar set_active_power_l1 geschreven maar de omvormer reageerde onverwacht. Wat moet ik controleren?

De schrijfregisters set_active_power_l1 tot en met L3 sturen de ESS-regelkring rechtstreeks aan. Onjuiste instellingen kunnen de omvormer over zijn nominale capaciteit duwen, beveiligingen activeren of onbedoelde teruglevering aan het net veroorzaken. Test schrijfacties altijd stapsgewijs, controleer of de ESS-assistent actief is, en gebruik ess_disable_charge_flag_b en ess_disable_feedback_flag_b alleen bewust.

Elektricien aan het werk in een open verdeelkast