Victron

Inleiding

Victron Energy‑apparaten vormen een kernonderdeel van het GCXONE Tower Monitoring‑ecosysteem en leveren realtime stroom‑ en energiemonitoring voor afgelegen torensites. Ze volgen de prestaties van de zonne‑oplading, de batterij‑status en de algehele DC‑systeemspanning — zodat het energiesysteem binnen veilige drempels blijft en vroegtijdige waarschuwingen geeft bij batterij‑ of zonne‑afwijkingen.

Deze gids beschrijft de stappen die nodig zijn om een Victron Energy‑apparaat toe te voegen aan GCXONE — van het instellen van inloggegevens tot het activeren van alarmregels. Na voltooiing zal uw apparaat live telemetrie streamen en geautomatiseerde alarmen activeren wanneer spannings‑ of lading‑drempels worden overschreden.

Wat Victron‑apparaten monitoren

Zodra het apparaat is verbonden met GCXONE, rapporteert Victron continu de volgende telemetriecategorieën:

• Batterij voltage niveaus over het DC‑systeem
• Zonne‑laadstroom en invoer‑vermogen van PV‑controllers
• Batterij ladingstoestand (SOC) als percentage
• Status van lader en omvormer
• Algemene systeem‑Status en alarm statussen

Opmerking: Victron is het primaire stroom‑monitoringsysteem van de toren. Zonder Victron kan GCXONE geen batterij‑ontlading, onder‑prestaties van de zonne‑installatie of DC‑spanningsafwijkingen detecteren die een site van stroom kunnen beroven.

Voorvereisten

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

Waarschuwing: De opgegeven VRM‑Portal‑inloggegevens moeten administratieve permissies hebben. Alleen‑lees‑accounts staan GCXONE niet toe de volledige telemetrie‑dataset op te halen die nodig is voor monitoring.

Victron Config‑gids met GCXONE

Volg deze stappen om een Victron‑apparaat toe te voegen aan GCXONE. Het apparaat wordt geregistreerd onder een bestaande site en begint direct met rapporteren na configuratie.

Stap 1: Navigeer naar de Site

In GCXONE navigeert u naar de Site waar het Victron‑apparaat fysiek is geïnstalleerd. Dit is de bovenliggende entiteit waaronder het apparaat wordt geregistreerd.

• Ga naar Configuratie → Sites
• Zoek en open de doel‑site
• Klik Bewerken om het configuratie‑paneel van de site te openen

Stap 2: Open het Apparaat‑dialoogvenster

Binnen de site‑configuratie, navigeer naar de Apparaten sectie en klik op Nieuw toevoegen om het dialoogvenster voor apparaatcreatie te openen.

Stap 3: Selecteer Apparaattype

In het apparaatdialoog, open de Apparaattype keuzelijst en selecteer Victron om de juiste configuratievelden te laden.

Stap 4: Voer Apparaatgegevens in

Vul alle verplichte velden in om een veilige verbinding tussen GCXONE en de Victron VRM‑portal tot stand te brengen. Elk veld wordt hieronder gedetailleerd beschreven.

Stap 5: Onder de verbindingsvelden bevat het dialoogvenster ook een Selecteer Entiteit‑groep keuzelijst, een verplichte Tijdzone, een Apparaat Configuratie sectie (Site puls configuratie), een Geavanceerde instellingen sectie (Event Polling, Configure Heatmap masker, Periodieke Status controle, Event retentie tijd — standaard 30 dagen), en een optionele Locatie sectie (Latitude, Longitude, Plus Code, What3Words).

Stap 6: Opslaan en Verifiëren Verbinding

Na het invoeren van alle velden, klik op Opslaan. GCXONE zal onmiddellijk proberen verbinding te maken met de Victron VRM API met de opgegeven inloggegevens en serienummer.

Een succesvolle verbinding resulteert in:

• Het apparaat verschijnt in de apparaatlijst van de site met een actieve statusindicator
• GCXONE detecteert automatisch de beschikbare PV Controller en Battery Manager
• Live telemetriegegevens beginnen te stromen naar GCXONE (batterij voltage, laadstroom, zonne‑invoer, SOC)
• Het apparaat wordt beschikbaar voor alarm regel configuratie

Waarschuwing: Als de verbinding mislukt, controleer dan of het serienummer overeenkomt met het apparaat in het VRM‑portaal, de inloggegevens administratieve permissies hebben, en de Victron VRM API bereikbaar is vanaf de GCXONE‑server.

Alarmregels Configuratie

GCXONE gebruikt een JSON‑gebaseerde alarm regel configuratie om te definiëren welke telemetrie‑parameters worden gemonitord, welke drempels alarmen activeren, en hoe die alarmen worden geïdentificeerd in CMS‑integraties.

Alarmregels kunnen worden geconfigureerd op het Site‑niveau of Apparaat‑niveau. Victron‑energy regels worden doorgaans toegepast op Apparaat‑niveau voor precieze controle.

Hoe alarmregels toe te passen

1. Navigeer naar de doel‑Site of Apparaat in GCXONE.
2. Klik op Bewerken en ga naar de Aanvullende Eigenschappen sectie.
3. Zoek de eigenschap met de naam Aangepaste Alarmregels.
4. Open de drie puntjes (⋮) van de eigenschap en selecteer Standaard toepassen om de vooraf geconfigureerde regelset te laden. Alle regels zijn standaard inactief.
5. Wijzig de JSON om specifieke regels in te schakelen door "active": true voor de betreffende parameters.
6. Stel uw drempelwaarden, eventcodes en groupcodes in naar behoefte.
7. Klik op Opslaan. GCXONE begint onmiddellijk met het evalueren van binnenkomende telemetrie tegen de geconfigureerde regels.

Opmerking: Standaard zijn alle alarmregels inactief. U moet expliciet instellen "active": true voor elke regel die u wilt dat GCXONE bewaakt. Dit voorkomt onbedoelde alarmen tijdens de initiële configuratie.

Regelstructuur

Elke alarmregel volgt een consistente JSON-structuur. Het begrijpen van de gemeenschappelijke velden helpt bij het aanpassen van regels:

Victron Energy alarmregels

De volgende alarmregels zijn beschikbaar voor Victron‑apparaten onder de Energy Monitoring sectie van de Aangepaste alarmregels JSON. Elke regel bewaakt een specifiek aspect van de gezondheid en prestaties van het energiesysteem.

Batterij voltage regel

Bewaakt de DC‑systeemspanning over de batterijbank. Spanning buiten het aanvaardbare bereik kan duiden op een laadfout, overbelasting of batterijdegradatie.

Standaard JSON-configuratie

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

Voorbeeldgedrag

• Wanneer de voltage onder 12 V daalt, wordt een alarm geactiveerd dat aangeeft dat de batterij ontlaadt buiten veilige grenzen.
• Wanneer de voltage boven 14 V stijgt, wordt een alarm geactiveerd dat een mogelijke overlading aangeeft.
• Het alarm wordt automatisch gewist wanneer de voltage terugkeert naar het bereik van 12 V–14 V.
• Pas de drempels aan op basis van uw specifieke batterijchemie — lithiumsystemen werken doorgaans binnen een ander voltage‑bereik dan lood‑zuur.

Batterij State of Charge (SOC) regel

Monitort het resterende laadpercentage van de batterijbank. SOC is een betrouwbaarder indicatie van bruikbare energie dan alleen voltage, vooral onder belasting.

Standaard JSON‑configuratie

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

Voorbeeldgedrag

• GCXONE activeert een alarm wanneer de batterij‑SOC onder 15 % daalt.
• Het alarm wordt automatisch gewist wanneer de SOC boven de ingestelde drempel stijgt.
• Stel laag hoger (bijv. 25–30 %) in op locaties met beperkte zonne‑invoer of hoog stroomverbruik om operators meer speling te geven vóór een mogelijke stroomuitval.

Samenvatting van event‑codes en group‑codes

Snelle referentie voor alle Victron Energy event‑codes en group‑codes:

Configuratie Referentie

Volledig Victron Energy Alarm Rules JSON

Kopieer dit in de Aangepast Alarm Rules eigenschap en wijzig indien nodig voor uw implementatie.

"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"
  }
}

Configuratie Best Practices

• Begin altijd met Apply Default om de volledige vooraf geconfigureerde regelset te laden voordat u wijzigingen aanbrengt.
• Schakel beide regels tegelijk in — Voltage en SOC vullen elkaar aan en geven samen een volledig beeld van de batterijgezondheid.
• Stel laag voor SOC op 25–30% op locaties met beperkte zonne‑expositie of tijdens wintermaanden wanneer de zonne‑invoer verminderd is.
• Pas de spanningsdrempels aan op basis van uw batterijchemie — lithiumsystemen hebben andere veilige bedrijfsbereiken dan lood‑zuur batterijen.
• Test alarmregels op één apparaat voordat u ze naar alle locaties uitrolt.
• Documenteer uw gebeurteniscodes en groepscodes in uw CMS‑configuratie om correcte alarmroutering te waarborgen.

Probleemoplossing

Apparaat maakt geen verbinding

Alarm Rules worden niet geactiveerd

Voor extra ondersteuning kunt u contact opnemen met uw NXGEN‑vertegenwoordiger of het volledige GCXONE Toren Monitoren Configuratie‑Handboek raadplegen, dat EFOY‑brandstofcel‑ en Teltonika‑IoT‑monitoring naast Victron Energy behandelt.