GCXONEDocumentatie

Victron

Bijgewerkt op 11 augustus 2026Apparaten en integratiesPDF downloadenWijziging voorstellenHulp krijgen
Op deze pagina
  1. Inleiding
  2. Vereisten
  3. Victron-configuratiehandleiding voor de GCX-ONE
  4. Problemen oplossen

Inleiding

De apparaten van Victron Energy vormen een essentieel onderdeel van het GCXONE Tower Monitoring-ecosysteem en zorgen voor realtime stroom- en energiemonitoring van afgelegen torenlocaties. Ze houden de laadprestaties van de zonnepanelen, de toestand van de accu’s en de totale gelijkspanning van het systeem bij. Zo wordt gewaarborgd dat het energiesysteem binnen veilige grenzen blijft functioneren en wordt er vroegtijdig gewaarschuwd bij afwijkingen in de accu’s of de zonnepanelen.

In deze handleiding worden de stappen beschreven die nodig zijn om een Victron Energy-apparaat in GCXONE te integreren, waaronder het instellen van inloggegevens en het activeren van alarmregels. Zodra dit is voltooid, zal uw apparaat live telemetriegegevens doorsturen en automatische waarschuwingen activeren wanneer drempelwaarden voor spanning of laadstatus worden overschreden.

Welke Victron-apparaten houden toezicht op

Zodra ze zijn aangesloten op GCXONE, sturen Victron-apparaten continu de volgende categorieën telemetriegegevens door:

  • Accuspanningsniveaus in het gelijkstroomsysteem
  • Laadstroom van zonne-energie en ingangsvermogen van PV-regelaars
  • Laadstatus (SOC) van de accu in procenten
  • Werkingsstatus van de lader en de omvormer
  • Algemene systeemstatus en alarmtoestanden

Victron is het belangrijkste systeem voor stroommonitoring van de toren. Zonder dit systeem kan GCXONE geen batterijleegloop, verminderde prestaties van de zonnepanelen of afwijkingen in de gelijkspanning detecteren die ertoe zouden kunnen leiden dat een locatie zonder stroom komt te zitten.

Vereisten

Zorg ervoor dat de volgende informatie en toegangsrechten beschikbaar zijn voordat u begint met het aanmelden van het apparaat:

RequirementDetails
GCXONE AccessAdmin or Operator role with Configuration module access
VRM Portal AccountAn active Victron VRM Portal account with administrative access to the target device
Username & PasswordAdministrative credentials for the Victron VRM Portal
Serial NumberThe unique serial number of the Victron device as listed in the VRM Portal
Site CreatedThe site this device will be assigned to must already exist in GCXONE

Victron-configuratiehandleiding voor de GCX-ONE

Volg deze stappen om een Victron-apparaat aan GCXONE toe te voegen. Het apparaat wordt onder een bestaande locatie geregistreerd en begint direct na de configuratie met het doorsturen van telemetriegegevens.

Stap 1 — Ga naar de website

Ga in GCXONE naar de locatie waar het Victron-apparaat fysiek is geïnstalleerd. Dit is de bovenliggende entiteit waaronder het apparaat wordt geregistreerd.

  • Ga naar Configuratie → Sites
  • Zoek de doelsite en open deze
  • Klik Bewerken om het configuratiescherm van de site te openen

Stap 2 — Open het dialoogvenster ‘Apparaat’

Ga binnen de siteconfiguratie naar de Apparaten rubriek en klik op Apparaat toevoegen om het dialoogvenster voor het aanmaken van een apparaat te openen.

Stap 3 — Selecteer het type apparaat

Open in het apparaatvenster het Type apparaat het dropdown-menu openen en selecteren Victron om de juiste configuratievelden te laden.

Stap 4 — Voer de apparaatgegevens in

Vul alle verplichte velden in om een beveiligde verbinding tot stand te brengen tussen GCXONE en het Victron VRM-portaal. Elk veld wordt hieronder uitgebreid beschreven.

FieldDescriptionNotes
Device TypeSelect 'Victron' from the dropdownMust match exactly — determines which telemetry model is used
Device NameA uniquedescriptive name for this device in GCXONE
Serial NumberThe hardware serial number of the Victron deviceFound on the device label or in the Victron VRM Portal
UsernameAdministrative login username for the VRM PortalMust have full administrative access to the configured device
PasswordAdministrative login password for the VRM PortalStored securely within GCXONE; use a strong

Stap 5 — Opslaan en verbinding controleren

Nadat u alle velden hebt ingevuld, klikt u op Opslaan. GCXONE zal onmiddellijk proberen verbinding te maken met de Victron VRM API met behulp van de opgegeven inloggegevens en het serienummer.

Een succesvolle verbinding leidt tot:

  • Het apparaat dat in de apparatenlijst van de site wordt weergegeven met een actieve statusindicator
  • GCXONE detecteert automatisch de beschikbare PV-regelaar en Batterijbeheer
  • Er beginnen live telemetriegegevens binnen te komen bij GCXONE (accuspanning, laadstroom, zonne-energie-input, SOC)
  • Het apparaat is nu beschikbaar voor het instellen van alarmregels

Configuratie van alarmregels

GCXONE maakt gebruik van een op JSON gebaseerde configuratie van alarmregels om te bepalen welke telemetrieparameters worden gemonitord, welke drempelwaarden waarschuwingen activeren en hoe die waarschuwingen worden weergegeven in CMS-integraties.

Alarmregels kunnen worden geconfigureerd op de Locatieniveau of Apparaatniveau. De Victron Energy-regels worden doorgaans op apparaatniveau toegepast voor een nauwkeurige regeling.

Hoe alarmregels toepassen

  1. Ga in GCXONE naar de betreffende site of het betreffende apparaat.
  2. Klik Bewerken en ga naar de Overige kenmerken paragraaf.
  3. Zoek het object met de naam Aangepaste alarmregels.
  4. Open het hamburgermenu (⋮) van het object en selecteer Standaard instellen om de vooraf geconfigureerde regelset te laden. Alle regels zijn standaard uitgeschakeld.
  5. Pas de JSON aan om bepaalde regels in te schakelen door het volgende in te stellen: "active": true voor de betreffende parameters.
  6. Stel uw drempelwaarden, gebeurteniscodes en groepscodes naar behoefte in.
  7. Klik Opslaan. GCXONE zal onmiddellijk beginnen met het toetsen van binnenkomende telemetriegegevens aan de hand van de geconfigureerde regels.

Regelstructuur

Elke alarmregel volgt een consistente JSON-structuur. Inzicht in de veelvoorkomende velden is handig bij het aanpassen van regels:

FieldDescription
activeBoolean (true/false). Set to true to enable monitoring for this rule. When false
lowLower threshold value. An alert triggers when the monitored value falls below this level.
highUpper threshold value. An alert triggers when the monitored value exceeds this level.
eventCodeUnique string identifier used by GCXONE to communicate this alarm type to CMS integrations (IMMIX
groupCodeLogical grouping identifier for Tower Monitoring workflows. Used for filtering

Alarmregels van Victron Energy

De volgende alarmregels zijn beschikbaar voor Victron-apparaten onder de Energiemonitoring gedeelte van het JSON-bestand met aangepaste alarmregels. Elke regel houdt toezicht op een specifiek aspect van de status en prestaties van het voedingssysteem.

1. Regel voor de accuspanning

Houdt de gelijkspanning van het systeem over de accubank in de gaten. Een spanning buiten het toegestane bereik kan wijzen op een laadfout, een te hoge belasting of verslechtering van de accu’s.

Standaard JSON-configuratie

json

"spanning": { "actief": false, "laag": 12, "high": 14, "eventCode": "battery.voltage.warning", "groupCode": "tower.solar.voltage.alert" }

ParameterDescriptionExample Value
lowMinimum acceptable battery voltage (V). Alert triggers when voltage falls below this value.12
highMaximum acceptable battery voltage (V). Alert triggers when voltage exceeds this value.14
eventCodeCMS alarm identifier for voltage eventsbattery.voltage.warning
groupCodeInternal tower alarm group for filtering and routingtower.solar.voltage.alert

Voorbeeld van gedrag

  • Wanneer de spanning onder de 12 V daalt, wordt er een waarschuwing geactiveerd die aangeeft dat de accu verder ontlaadt dan veilig is.
  • Wanneer de spanning hoger wordt dan 14 V, wordt er een waarschuwing geactiveerd die wijst op een mogelijke overlaadtoestand.
  • De waarschuwing verdwijnt automatisch zodra de spanning weer binnen het bereik van 12 V tot 14 V ligt.
  • Pas de drempelwaarden aan op basis van de specifieke chemische samenstelling van uw accu — lithiumsystemen werken doorgaans binnen een ander spanningsbereik dan loodzuuraccu’s.

2. Regel inzake de laadstatus (SOC) van de accu

Houdt het resterende laadpercentage in de accubank bij. De SOC is een betrouwbaardere indicator voor de resterende bruikbare energie dan alleen de spanning, vooral onder belasting.

Standaard JSON-configuratie

json

"stateOfCharge": { "active": false, "low": 15, "eventCode": "battery.soc.warning", "groupCode": "tower.battery.soc.alert" }

ParameterDescriptionExample Value
lowMinimum acceptable SOC percentage. Alert triggers when SOC falls below this value.15
eventCodeCMS alarm identifier for low SOC eventsbattery.soc.warning
groupCodeInternal tower alarm group identifiertower.battery.soc.alert

Voorbeeld van gedrag

  • GCXONE geeft een waarschuwing af wanneer het laadniveau (SOC) van de accu onder de 15% daalt.
  • De waarschuwing verdwijnt automatisch zodra de SOC boven de ingestelde drempelwaarde komt.
  • Set laag hoger (bijvoorbeeld 25–30%) op locaties met beperkte zonne-energieopbrengst of een hoog stroomverbruik, zodat exploitanten meer tijd hebben voordat een mogelijke stroomstoring optreedt.

Overzicht van evenementcodes en groepscodes

Overzicht van alle gebeurteniscodes en groepscodes van Victron Energy:

RuleEvent CodeGroup Code
Battery Voltage Warningbattery.voltage.warningtower.solar.voltage.alert
Battery State of Charge Warningbattery.soc.warningtower.battery.soc.alert

Configuratiehandleiding

Volledige JSON-code voor de alarmregels van Victron Energy. Kopieer deze code naar de eigenschap ‘Aangepaste alarmregels’ en pas deze naar behoefte aan voor uw installatie.

json

"energyMonitoring": { "voltage": { "active": false, "low": 12, "high": 14, "eventCode": "battery.voltage.warning", "groupCode": "tower.solar.voltage.alert" }, "stateOfCharge": { "active": false, "low": 15, "eventCode": "battery.soc.warning", "groupCode": "tower.battery.soc.alert" } }

Aanbevolen werkwijzen voor configuratie

  • Begin altijd met Standaard instellen om de volledige, vooraf geconfigureerde regelset te laden voordat u wijzigingen aanbrengt.
  • Schakel beide regels tegelijk in — Spanning en SOC vullen elkaar aan en geven samen een volledig beeld van de toestand van de accu.
  • Set laag voor SOC van 25–30% op locaties met beperkte blootstelling aan zonlicht of tijdens de wintermaanden, wanneer de zoninstraling afneemt.
  • Pas de spanningsdrempels aan op basis van de chemische samenstelling van uw accu — lithiumsystemen hebben andere veilige werkingsbereiken dan loodzuuraccu’s.
  • Test de alarmregels eerst op één apparaat voordat u ze op alle locaties implementeert.
  • Leg uw evenementcodes en groepscodes vast in uw CMS-configuratie om een correcte alarmdoorgave te garanderen.

Problemen oplossen

Het apparaat maakt geen verbinding

Symptom / CheckResolution
Connection fails immediately after SaveVerify that the VRM Portal credentials are correct and have administrative access. Log in directly to the Victron VRM Portal to confirm.
Serial number not recognizedConfirm the serial number matches exactly what is listed in the Victron VRM Portal. Check for leading/trailing spaces or incorrect characters.
Authentication errorEnsure the account used has administrative privileges — read-only accounts are not supported.
No telemetry data after successful connectionVerify the Victron device is online and actively reporting to the VRM Portal. Check device status in the VRM Portal directly.

Alarmregels worden niet geactiveerd

Symptom / CheckResolution
No alerts received for a breached thresholdVerify the rule has "active": true in the JSON. Check that the Custom Alarm Rules JSON is valid (no syntax errors).
eventCode not appearing in CMSConfirm the event code is configured in your CMS integration. Check the CMS channel mapping in GCXONE under the site's integration settings.
Voltage alerts firing unexpectedlyAdjust the low and high thresholds to better match your battery system's normal operating voltage range.
SOC alert not clearing after chargingAllow a few polling cycles for GCXONE to retrieve the updated SOC value from the VRM API. If the alert persists

Neem voor meer ondersteuning contact op met uw NXGEN-vertegenwoordiger of raadpleeg de volledige configuratiehandleiding voor GCXONE Tower Monitoring, waarin naast Victron Energy ook de monitoring van EFOY-brandstofcellen en Teltonika IoT wordt behandeld.

Was deze pagina nuttig?

Bedankt — uw feedback gaat naar het team dat deze pagina beheert.