---
title: "Victron"
source: /nl/gcxone/devices/victron
locale: nl
updated: 2026-09-14
---
## **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:

| Vereiste | Details |
| --- | --- |
| GCXONE‑toegang | Admin‑ of Operator‑rol met toegang tot de Configuratie‑module |
| VRM‑Portalaccount | Een actief Victron VRM‑Portalaccount met administratieve toegang tot het doelapparaat |
| Gebruikersnaam & wachtwoord | Administratieve inloggegevens voor de Victron VRM‑Portal |
| Serienummer | Het unieke serienummer van het Victron‑apparaat zoals vermeld in de VRM‑Portal |
| Site gemaakt | De site waaraan dit apparaat wordt toegewezen moet reeds bestaan in GCXONE |

**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.

| Veld | Beschrijving | Notities |
| --- | --- | --- |
| Apparaattype | Selecteer 'Victron' in de keuzelijst | Moet exact overeenkomen — bepaalt welk telemetriemodel wordt gebruikt |
| Apparaatnaam | Een unieke; beschrijvende naam voor dit apparaat in GCXONE | Gebruik een naamgevingsconventie die de site en het apparaat identificeert (bijv. 'Toren-Noord-Victron-01') |
| Serienummer | Het hardware‑serienummer van het Victron‑apparaat | Gevonden op het apparaatlabel of in de Victron VRM‑portal |
| Gebruikersnaam | Administratieve inlog‑gebruikersnaam voor de VRM‑portal | Moet volledige administratieve toegang hebben tot het geconfigureerde apparaat |
| Wachtwoord | Administratief inlog‑wachtwoord voor de VRM‑portal | Veilig opgeslagen in GCXONE; gebruik een sterk en uniek wachtwoord |

**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:

| Veld | Beschrijving |
| --- | --- |
| active | Boolean (true/false). Stel in op true om bewaking voor deze regel in te schakelen. Bij false wordt de regel genegeerd. |
| low | Onderste drempelwaarde. Een alarm wordt geactiveerd wanneer de gemeten waarde onder dit niveau daalt. |
| high | Bovenste drempelwaarde. Een alarm wordt geactiveerd wanneer de gemeten waarde dit niveau overschrijdt. |
| eventCode | Unieke tekenreeksidentificatie die GCXONE gebruikt om dit alarmtype te communiceren naar CMS-integraties (IMMIX / Evalink / AmWin / LISA). Deze code verschijnt in uitgaande alarmmeldingen. |
| groupCode | Logische groeperingsidentificatie voor Tower Monitoring-workflows — gebruikt om gerelateerde alarmen te filteren en te organiseren binnen GCXONE's Toren Alarm Manager. |

### 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**

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

| Parameter | Beschrijving | Voorbeeldwaarde |
| --- | --- | --- |
| low | Minimale aanvaardbare batterijspanning (V). Alarm wordt geactiveerd wanneer de spanning onder deze waarde daalt. | 12 |
| hoog | Maximum acceptabele batterij voltage (V). Alarm wordt geactiveerd wanneer de voltage deze waarde overschrijdt. | 14 |
| eventCode | CMS alarm‑identificatie voor voltage‑gebeurtenissen | battery.voltage.warning |
| groupCode | Interne toren alarmgroep voor filteren en routeren | 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**

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

| Parameter | Beschrijving | Voorbeeldwaarde |
| --- | --- | --- |
| laag | Minimum acceptabel SOC‑percentage. Alarm wordt geactiveerd wanneer SOC onder deze waarde daalt. | 15 |
| eventCode | CMS alarm‑identificatie voor lage SOC‑gebeurtenissen | battery.soc.warning |
| groupCode | Interne toren alarmgroep‑identificatie | 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:

| Regel | Event Code | Group Code |
| --- | --- | --- |
| Batterij voltage Waarschuwing | battery.voltage.warning | tower.solar.voltage.alert |
| Batterij State of Charge Waarschuwing | battery.soc.warning | tower.battery.soc.alert |

### Configuratie Referentie

#### Volledig Victron Energy Alarm Rules JSON

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

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

#### 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

| Symptoom / Controle | Oplossing |
| --- | --- |
| Verbinding mislukt onmiddellijk na Opslaan | Controleer of de VRM‑Portal‑referenties correct zijn en administratieve toegang hebben. Log direct in op de Victron VRM Portal om te bevestigen. |
| Serienummer niet herkend | Bevestig dat het serienummer exact overeenkomt met wat in de Victron VRM Portal staat. Controleer op voor‑ of achtervoegsels of onjuiste tekens. |
| Authenticatiefout | Zorg ervoor dat het gebruikte account administratieve permissies heeft — alleen‑lezen accounts worden niet ondersteund. |
| Geen telemetriegegevens na succesvolle verbinding | Controleer of het Victron‑apparaat online is en actief rapporteert aan de VRM Portal. Controleer de Apparaat status direct in de VRM Portal. |

### Alarm Rules worden niet geactiveerd

| Symptoom / Controle | Oplossing |
| --- | --- |
| Geen alarmen ontvangen voor een overschreden drempel | Controleer of de regel "active": true bevat in de JSON. Controleer of de Aangepast Alarm Regels JSON geldig is (geen syntaxisfouten). |
| eventCode verschijnt niet in CMS | Bevestig dat de eventcode is geconfigureerd in uw CMS‑integratie. Controleer de CMS‑kanaalmapping in GCXONE onder de integratie‑instellingen van de site. |
| Spanningsalarmen activeren onverwacht | Pas de lage en hoge drempels aan om beter overeen te komen met het normale bedrijfs‑spanningsbereik van uw batterijsysteem. |
| SOC‑alarm wordt niet gewist na het opladen | Geef GCXONE enkele poll‑cycli om de bijgewerkte SOC‑waarde van de VRM‑API op te halen. Als het alarm blijft bestaan, ververs dan handmatig de Apparaat status in GCXONE. |

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.