Victron Battery-Inverter
De Victron Battery-Inverter template is bedoeld voor Victron Energy ESS-installaties die via een GX-apparaat (Cerbo GX of Venus GX) beschikbaar zijn over Modbus TCP. De template leest de volledige systeemdata uit de com.victronenergy.system-service: AC-verbruik per fase, netvoeding, AC- en DC-gekoppeld PV-vermogen, accuspanning, laadstroom, laadtoestand en verwachte resterende looptijd. Ook de ESS Mode 2-registers voor netsetpoint, laad- en ontlaadlimieten, maximale teruglevering en de PV-limiteervlag worden uitgelezen. Zo heb je als installateur één overzichtelijke databron voor de gehele energiehuishouding van de Victron-installatie.
- Protocol
- Modbus TCP
- Aansluiting
- Ethernet, Modbus TCP
- Registers
- 43, alleen lezen
- Merk
- Victron
- Laatst bijgewerkt
Registers (43)
43 lezen, 0 schrijven
| Naam | Eenheid | Toegang | Adres (Verborgen tot je je e-mailadres invult) | Functie (verborgen) | Type (verborgen) |
|---|---|---|---|---|---|
| serial_number | Lezen | ||||
| ccgx_relay1_state | Lezen | ||||
| ccgx_relay2_state | Lezen | ||||
| ac_pv_on_output_power_l1 | W | Lezen | |||
| ac_pv_on_output_power_l2 | W | Lezen | |||
| ac_pv_on_output_power_l3 | W | Lezen | |||
| ac_pv_on_input_power_l1 | W | Lezen | |||
| ac_pv_on_input_power_l2 | W | Lezen | |||
| ac_pv_on_input_power_l3 | W | Lezen | |||
| ac_consumption_power_l1 | W | Lezen | |||
| ac_consumption_power_l2 | W | Lezen | |||
| ac_consumption_power_l3 | W | Lezen | |||
| grid_power_l1 | W | Lezen | |||
| grid_power_l2 | W | Lezen | |||
| grid_power_l3 | W | Lezen | |||
| ac_genset_power_l1 | W | Lezen | |||
| ac_genset_power_l2 | W | Lezen | |||
| ac_genset_power_l3 | W | Lezen | |||
| active_input_source | Lezen | ||||
| dc_battery_voltage | V | Lezen | |||
| dc_battery_current | A | Lezen | |||
| active_power | W | Lezen | |||
| battery_soc | % | Lezen | |||
| battery_state | Lezen | ||||
| battery_consumed_amphours | Lezen | ||||
| battery_time_to_go | s | Lezen | |||
| dc_pv_power | W | Lezen | |||
| dc_pv_current | A | Lezen | |||
| charger_power | W | Lezen | |||
| dc_system_power | W | Lezen | |||
| ve_bus_charge_current | A | Lezen | |||
| ve_bus_charge_power | W | Lezen | |||
| ess_control_loop_setpoint | W | Lezen | |||
| ess_max_charge_current_percentage | % | Lezen | |||
| ess_max_discharge_current_percentage | % | Lezen | |||
| ess_control_loop_setpoint_scale_factor_2 | W | Lezen | |||
| ess_max_discharge_power | W | Lezen | |||
| system_max_charge_current | A | Lezen | |||
| max_feed_in_power | W | Lezen | |||
| feed_excess_dc | Lezen | ||||
| dont_feed_excess_ac | Lezen | ||||
| pv_power_limiter_active | Lezen | ||||
| max_charge_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 de laadtoestand en resterende looptijd van de accu om onverwacht nachtelijk ontladen vroegtijdig te signaleren.
- Controleer het netvermogen op L1, L2 en L3 om te verifiëren dat de teruglevering binnen de limieten van de netbeheerder blijft.
- Vergelijk het DC-gekoppeld PV-vermogen met de AC-gekoppelde opbrengst om de prestaties van MPPT en omvormer seizoensgericht te beoordelen.
- Stel een alert in op wijzigingen van active_input_source om ongeplande schakelingen naar generator of net direct te detecteren.
- Rapporteer de waarden van ess_max_discharge_power en max_feed_in_power om te bevestigen dat de ESS-configuratie aansluit op de netcontractafspraken.
Installatie
Activeer Modbus TCP op je GX-apparaat via Instellingen, dan Services, en zet de Modbus TCP-schakelaar aan.
Sluit de ModbusCloud Gateway aan op hetzelfde netwerk als het GX-apparaat en zorg dat TCP-poort 502 bereikbaar is.
Voeg in het ModbusCloud-portaal de Gateway toe, importeer de Victron Battery-Inverter template en stel Unit ID 100 in, het adres dat overeenkomt met de com.victronenergy.system-service.
Controleer de verbinding door register 843 (battery_soc) te lezen: een waarde tussen 0 en 100 bevestigt dat de Gateway het juiste service en Unit ID aanspreekt.
Veelvoorkomende aandachtspunten
De accuspanning is tien keer te hoog. Wat gaat er mis?
Register 840 (dc_battery_voltage) heeft een schaalfactor van 10 volgens de officiële Victron-registerlijst. Als je integratie de ruwe uint16-waarde doorgeeft zonder die door 10 te delen, lijkt de spanning tien keer hoger dan de werkelijke DC-busspanning. Deel de ruwe registerwaarde door 10 om volt te krijgen.
Netvermogenregisters geven grote positieve getallen in plaats van negatieve teruglevering. Waarom?
De registers 820 tot en met 822 zijn van het type int16 (signed). Veel Modbus-clients lezen registers standaard als unsigned 16-bit integers. Een negatieve waarde zoals -500 W verschijnt dan als 65036. Configureer je client om deze registers als signed 16-bit integers te interpreteren zodat teruglevering correct als negatieve waarde verschijnt.
De Gateway verbindt maar alle registers geven nul of zijn niet beschikbaar. Wat nu?
Modbus TCP staat standaard uitgeschakeld op Victron GX-apparaten. Controleer of het is ingeschakeld via Instellingen, dan Services, dan Modbus TCP. Controleer ook of je Unit ID 100 gebruikt. Unit ID 0 verwijst naar dezelfde service, maar veel clients weigeren dat adres. Victron adviseert zelf om 100 te gebruiken.
Is het veilig om ESS-setpointregisters van buitenaf te beschrijven?
De ESS-registers (adressen 2700 tot en met 2710) zijn in deze template alleen-lezen. Schrijf je toch extern naar ESS-setpoints, houd er dan rekening mee dat ESS Mode 2 geen automatische terugval naar passthrough heeft als een sturend script stopt met updates. De omvormer blijft dan op het laatst geschreven setpoint werken totdat je handmatig ingrijpt. Test setpointwijzigingen altijd eerst in een gecontroleerde omgeving.
Zelf zien hoe het werkt?
