Victron Victron Energy (battery) Modbus TCP template

Victron Energy (battery)

Victron Energy maakt batterijopslagsystemen en energiemanagementsystemen die draaien op een GX-apparaat zoals de Cerbo GX of de Color Control GX. Deze template koppelt via Modbus TCP aan de Victron Energy (battery) integratie en leest het systeemvermogen van de accu en de laadtoestand uit via registers 842 en 843, beschikbaar via de com.victronenergy.system service op Unit ID 100. Daarnaast stel je via register 2901 het ESS-minimum laadniveau in als schrijfbaar setpoint. Met de ModbusCloud Gateway houd je de accu in realtime in de gaten en pas je de ontlaadinstellingen op afstand aan.

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

Registers (3)

2 lezen, 1 schrijven

NaamEenheidToegangAdres (Verborgen tot je je e-mailadres invult)Functie (verborgen)Type (verborgen)
powerWLezen
soc%Lezen
limitsoc%Schrijven

Registers laden…

Stuur jouw apparatenlijst

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

Gebruikstoepassingen

  • Bekijk het actuele batterijvermogen om onverwachte ontlading tijdens stroomuitval direct te detecteren.
  • Volg de laadtoestand over meerdere weken om geleidelijke capaciteitsafname van de accu te signaleren.
  • Stel een alert in wanneer de laadtoestand onder een drempelwaarde zakt om diepe ontlading te voorkomen.
  • Controleer of het ESS-minimum laadniveau in register 2901 overeenkomt met het energiebeheersbeleid van de installatie.
  • Vergelijk het batterijvermogen met de PV-productie om de ESS-laadplanning te valideren.

Installatie

  1. Activeer Modbus TCP op het Victron GX-apparaat via Instellingen, dan Services, en schakel de Modbus-TCP service in. Noteer het IP-adres van het GX-apparaat.

  2. Verbind de ModbusCloud Gateway met hetzelfde lokale netwerk als het Victron GX-apparaat en zorg dat TCP-poort 502 bereikbaar is tussen beide apparaten.

  3. Voeg in het ModbusCloud-portal de Gateway toe, importeer de Victron Energy (battery) template en stel Unit ID 100 in voor de com.victronenergy.system service.

  4. Controleer de verbinding door de livewaarden van register 842 (batterijvermogen) en register 843 (laadtoestand) in het portaldashboard te bekijken.

Veelvoorkomende aandachtspunten

Registers 842 en 843 geven nul of geen respons terug. Hoe kan dat?

Modbus TCP staat standaard uitgeschakeld op alle Victron GX-apparaten. Ga naar Instellingen, dan Services op het GX-apparaat en schakel de Modbus-TCP service in. Controleer ook of het IP-adres van het GX-apparaat correct is ingevoerd en of poort 502 niet geblokkeerd wordt door een firewall of VLAN-instelling in je netwerk.

De laadtoestand klopt, maar het batterijvermogen lijkt omgekeerd van teken. Wat is er mis?

Register 842 is een signed int16: positieve waarden betekenen dat de accu geladen wordt, negatieve waarden dat de accu ontladen wordt. Dit is het gedocumenteerde gedrag van de com.victronenergy.system service. Controleer of je Modbus-client de waarde interpreteert als een signed 16-bits integer en niet als unsigned.

Schrijven naar register 2901 heeft geen effect op het ESS-gedrag. Wat gaat er fout?

Register 2901 moet worden geschreven naar Unit ID 100 en de waarde wordt vermenigvuldigd met een factor 10: een minimum laadniveau van 20% vereist de waarde 200. Controleer ook of de ESS-assistent actief is op het GX-apparaat, want het register heeft alleen effect wanneer ESS is ingesteld via VEConfigure.

Is het veilig om willekeurige waarden naar het ESS minimum SoC register te schrijven?

Wees voorzichtig bij het schrijven naar register 2901. Een te laag ingesteld minimum laadniveau kan leiden tot herhaaldelijke diepe ontlading, wat de accu versneld aantast en de garantie van bepaalde accusystemen kan laten vervallen. Houd je aan het bereik dat de accufabrikant adviseert en test wijzigingen altijd onder toezicht bij de inbedrijfstelling.

Elektricien aan het werk in een open verdeelkast