---
title: "Victron"
source: /de/gcxone/devices/victron
locale: de
updated: 2026-09-14
---
## **Einleitung**

Victron Energy‑Geräte sind ein Kernbestandteil des GCXONE Tower‑Monitoring‑Ökosystems und liefern Echtzeit‑Leistungs‑ und Energiemonitoring für entfernte Turmstandorte. Sie überwachen die Solarladeleistung, den Batteriezustand und die gesamte DC‑Systemspannung – sie stellen sicher, dass das Energiesystem innerhalb sicherer Grenzwerte arbeitet und geben frühzeitig Warnungen bei Batterie‑ oder Solarabweichungen.

Dieses Handbuch beschreibt die erforderlichen Schritte, um ein Victron Energy‑Gerät in GCXONE zu integrieren – einschließlich Einrichtung der Zugangsdaten und Aktivierung von Alarmregeln. Nach Abschluss wird Ihr Gerät Live‑Telemetrie streamen und automatisierte Warnungen auslösen, wenn Spannungs‑ oder Ladezustands‑Grenzwerte überschritten werden.

### Was Victron‑Geräte überwachen

Nach der Anbindung an GCXONE melden Victron‑Geräte kontinuierlich die folgenden Telemetrie‑Kategorien:

- Batteriespannungswerte im gesamten DC‑System
- Solar‑Ladestrom und Eingangsleistung von PV‑Controllern
- Batterieladezustand (SOC) in Prozent
- Betriebsstatus von Ladegerät und Wechselrichter
- Gesamtsystem‑Gesundheit und Alarmstatus

**Hinweis:**Victron ist das primäre Energiemonitoringsystem des Turms. Ohne Victron kann GCXONE keine Batterieentladung, Solarunterleistung oder DC‑Spannungsanomalien erkennen, die dazu führen könnten, dass ein Standort die Stromversorgung verliert.

## **Voraussetzungen**

Stellen Sie vor Beginn der Geräte‑Onboarding‑Prozedur sicher, dass die folgenden Informationen und Zugriffe verfügbar sind:

| Anforderung | Details |
| --- | --- |
| GCXONE‑Zugriff | Administrator‑ oder Operator‑Rolle mit Zugriff auf das Konfiguration‑Modul |
| VRM‑Portal‑Konto | Ein aktives Victron‑VRM‑Portal‑Konto mit administrativem Zugriff auf das Zielgerät |
| Benutzername & Passwort | Administrative Anmeldedaten für das Victron‑VRM‑Portal |
| Seriennummer | Die eindeutige Seriennummer des Victron‑Geräts, wie im VRM‑Portal angegeben |
| Standort erstellt | Der Standort, dem dieses Gerät zugewiesen wird, muss bereits in GCXONE existieren |

**Warnung:** Die bereitgestellten VRM‑Portal‑Anmeldedaten müssen administrative Privilegien besitzen. Nur‑Lese‑Konten erlauben GCXONE nicht, den vollständigen Telemetrie‑Datensatz abzurufen, der für die Überwachung erforderlich ist.

## **Victron‑Konfigurations‑Leitfaden mit GCXONE**

Befolgen Sie diese Schritte, um ein Victron‑Gerät zu GCXONE hinzuzufügen. Das Gerät wird unter einem bestehenden Standort registriert und beginnt nach der Konfiguration sofort mit der Telemetrie‑Übermittlung.

**Schritt 1:** Zum Standort navigieren

Navigieren Sie in GCXONE zum Standort, an dem das Victron‑Gerät physisch installiert ist. Dies ist das übergeordnete Element, unter dem das Gerät registriert wird.

- Gehen Sie zu **Configuration → Sites**
- Suchen Sie den Zielstandort und öffnen Sie ihn
- Klicken Sie auf **Bearbeiten** um das Konfigurations‑Panel des Standorts zu öffnen

**Schritt 2:** Öffnen Sie den Geräte‑Dialog

Navigieren Sie innerhalb der Standort‑Konfiguration zu dem **Geräte** Abschnitt und klicken Sie **Neu hinzufügen** um den Dialog zur Geräteanlage zu öffnen.

**Schritt 3:** Gerätetyp auswählen

Im Gerätedialog öffnen Sie das**Gerätetyp** Dropdown und wählen Sie **Victron** um die entsprechenden Konfigurationsfelder zu laden.

**Schritt 4:** Gerätedetails eingeben

Füllen Sie alle erforderlichen Felder aus, um eine sichere Verbindung zwischen GCXONE und dem Victron‑VRM‑Portal herzustellen. Jedes Feld wird nachfolgend ausführlich beschrieben.

| Feld | Beschreibung | Hinweise |
| --- | --- | --- |
| Gerätetyp | Wählen Sie im Dropdown „Victron“ aus | Muss exakt übereinstimmen — bestimmt, welches Telemetriemodell verwendet wird |
| Gerätename | Ein eindeutiger, beschreibender Name für dieses Gerät in GCXONE | Verwenden Sie eine Namenskonvention, die Standort und Gerät identifiziert (z. B. „Tower-North-Victron-01“). |
| Seriennummer | Die Hardware‑Seriennummer des Victron‑Geräts | Auf dem Geräteetikett oder im Victron‑VRM‑Portal zu finden |
| Benutzername | Administrativer Anmeldename für das VRM‑Portal | Muss vollen administrativen Zugriff auf das konfigurierte Gerät besitzen |
| Passwort | Administratives Anmeldepasswort für das VRM‑Portal | Sicher in GCXONE gespeichert; verwenden Sie ein starkes und eindeutiges Passwort |

**Schritt 5:** Unter den Verbindungsfeldern enthält der Dialog außerdem ein **Entitätsgruppe auswählen** Dropdown, ein erforderliches **Zeitzone**, ein **Gerätekonfiguration** Abschnitt (Site Pulse Konfiguration), ein **Erweiterte Einstellungen** Abschnitt (Ereignisabfrage, Heatmap‑Maske konfigurieren, Periodische Systemprüfung, Ereignisaufbewahrungszeit — 30 Tage standardmäßig) und ein optionaler**Standort** Abschnitt (Breitengrad, Längengrad, Plus‑Code, What3Words).

**Schritt 6:**Speichern und Verbindung prüfen

Nach Eingabe aller Felder klicken Sie **Speichern**. GCXONE versucht sofort, eine Verbindung zur Victron VRM API mit den angegebenen Zugangsdaten und der Seriennummer herzustellen.

Eine erfolgreiche Verbindung führt zu:

- Das Gerät erscheint in der Geräteliste der Site mit einem aktiven Statusindikator
- GCXONE erkennt automatisch die verfügbaren **PV Controller** und **Battery Manager**
- Live‑Telemetriedaten beginnen in GCXONE zu fließen (Batteriespannung, Ladestrom, Solareingang, SOC)
- Das Gerät wird für die Konfiguration von Alarmregeln verfügbar

**Warnung:** Wenn die Verbindung fehlschlägt, prüfen Sie, ob die Seriennummer mit dem Gerät im VRM‑Portal übereinstimmt, die Zugangsdaten administrative Privilegien besitzen und die Victron VRM API vom GCXONE‑Server erreichbar ist.

## **Alarmregeln-Konfiguration**

GCXONE verwendet eine JSON‑basierte Alarmregel‑Konfiguration, um festzulegen, welche Telemetrieparameter überwacht werden, welche Schwellenwerte Warnungen auslösen und wie diese Warnungen in CMS‑Integrationen identifiziert werden.

Alarmregeln können auf **Site‑Ebene** oder **Geräte‑Ebene**. Victron‑Energy‑Regeln werden typischerweise auf Geräte‑Ebene für präzise Steuerung angewendet.

### Anwenden von Alarmregeln

1. Navigieren Sie zur Ziel‑Site oder zum Ziel‑Gerät in GCXONE.
2. Klicken Sie **Bearbeiten** und öffnen Sie den **Zusätzliche Einstellungen** Abschnitt.
3. Suchen Sie die Einstellung mit dem Namen **Custom Alarm Rules**.
4. Öffnen Sie das Drei‑Punkte‑Menü (⋮) der Einstellung und wählen Sie **Standard übernehmen** zum Laden des vorkonfigurierten Regelsets. Alle Regeln sind standardmäßig inaktiv.
5. JSON ändern, um bestimmte Regeln zu aktivieren, indem Sie setzen `"active": true` für die entsprechenden Parameter.
6. Legen Sie nach Bedarf Ihre Schwellenwerte, Ereigniscodes und Gruppencodes fest.
7. Klicken Sie auf **Speichern**. GCXONE beginnt sofort damit, eingehende Telemetrie anhand der konfigurierten Regeln zu prüfen.

**Hinweis:** Standardmäßig sind alle Alarmregeln inaktiv. Sie müssen explizit setzen `"active": true` für jede Regel, die GCXONE überwachen soll. Dies verhindert versehentliche Warnungen während der Erstkonfiguration.

### Regelstruktur

Jede Alarmregel folgt einer einheitlichen JSON-Struktur. Das Verständnis der gemeinsamen Felder erleichtert die Anpassung von Regeln:

| Feld | Beschreibung |
| --- | --- |
| active | Boolesch (true/false). Auf true setzen, um die Überwachung für diese Regel zu aktivieren. Bei false wird die Regel ignoriert. |
| low | Unterer Schwellenwert. Eine Warnung wird ausgelöst, wenn der überwachte Wert unter diesen Wert fällt. |
| high | Oberer Schwellenwert. Eine Warnung wird ausgelöst, wenn der überwachte Wert diesen Wert überschreitet. |
| eventCode | Eindeutiger Zeichenketten‑Identifier, den GCXONE verwendet, um diesen Alarmtyp an CMS‑Integrationen (IMMIX / Evalink / AmWin / LISA) zu kommunizieren. Dieser Code erscheint in ausgehenden Alarmbenachrichtigungen. |
| groupCode | Logischer Gruppierungs‑Identifier für Tower‑Monitoring‑Workflows – verwendet, um verwandte Alarme im Tower‑Alarm‑Manager von GCXONE zu filtern und zu organisieren. |

### Victron Energy Alarmregeln

Die folgenden Alarmregeln stehen für Victron‑Geräte im **Energy Monitoring** Abschnitt des Custom Alarm Rules JSON. Jede Regel überwacht einen spezifischen Aspekt der Gesundheit und Leistung des Stromsystems.

#### Batteriespannungsregel

Überwacht die DC‑Systemspannung über den Batteriespeicher. Eine Spannung außerhalb des zulässigen Bereichs kann auf einen Ladefehler, übermäßige Last oder Batteriedegradation hinweisen.

**Standard‑JSON‑Konfiguration**

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

| Parameter | Beschreibung | Beispielwert |
| --- | --- | --- |
| low | Minimal zulässige Batteriespannung (V). Eine Warnung wird ausgelöst, wenn die Spannung unter diesen Wert fällt. | 12 |
| hoch | Maximal zulässige Batteriespannung (V). Warnen wird ausgelöst, wenn die Spannung diesen Wert überschreitet. | 14 |
| eventCode | CMS-Alarmkennzeichen für Spannungsereignisse | battery.voltage.warning |
| groupCode | Interne Turm-Alarmgruppe für Filterung und Weiterleitung | tower.solar.voltage.alert |

**Beispielverhalten**

- Fällt die Spannung unter 12 V, wird ein Warnen ausgelöst, das anzeigt, dass die Batterie unter sichere Werte entlädt.
- Überschreitet die Spannung 14 V, wird ein Warnen ausgelöst, das auf einen möglichen Überladeszustand hinweist.
- Das Warnen wird automatisch gelöscht, wenn die Spannung wieder im Bereich von 12 V–14 V liegt.
- Passen Sie die Schwellenwerte an Ihre spezifische Batterietechnologie an – Lithium‑Systeme arbeiten typischerweise in einem anderen Spannungsbereich als Blei‑Säure.

#### Batterie‑Ladezustands‑Regel (SOC)

Überwacht den verbleibenden Ladeprozentsatz im Batteriebank. SOC ist ein zuverlässigerer Indikator für nutzbare Energie als die Spannung allein, insbesondere unter Last.

**Standard‑JSON‑Konfiguration**

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

| Parameter | Beschreibung | Beispielwert |
| --- | --- | --- |
| niedrig | Minimal zulässiger SOC‑Prozentsatz. Warnen wird ausgelöst, wenn der SOC unter diesen Wert fällt. | 15 |
| eventCode | CMS-Alarmkennzeichen für niedrige SOC‑Ereignisse | battery.soc.warning |
| groupCode | Interner Turm‑Alarmgruppen‑Kennzeichner | tower.battery.soc.alert |

**Beispielverhalten**

- GCXONE löst ein Warnen aus, wenn der Batterieladezustand unter 15 % fällt.
- Das Warnen wird automatisch gelöscht, wenn der SOC über den konfigurierten Schwellenwert steigt.
- Festlegen`niedrig` höher (z. B. 25–30 %) an Standorten mit begrenzter Solarleistung oder hohem Stromverbrauch, um den Bedienern mehr Vorlaufzeit vor einem möglichen Ausfall zu geben.

### Zusammenfassung der Ereignis‑ und Gruppencodes

Kurzreferenz für alle Victron Energy Ereignis‑ und Gruppencodes:

| Regel | Ereigniscode | Gruppencode |
| --- | --- | --- |
| Batteriespannung Warnung | battery.voltage.warning | tower.solar.voltage.alert |
| Batterie Ladezustand Warnung | battery.soc.warning | tower.battery.soc.alert |

### Konfiguration Referenz

#### Vollständiges Victron Energy Alarmregeln‑JSON

Kopieren Sie dies in die Eigenschaft Benutzerdefinierte Alarmregeln und passen Sie sie bei Bedarf für Ihre Installation an.

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

#### Konfiguration Bewährte Verfahren

- Beginnen Sie immer mit **Standard anwenden** um den vollständigen vorkonfigurierten Regelset zu laden, bevor Änderungen vorgenommen werden.
- Aktivieren Sie beide Regeln zusammen — **Spannung** und **SOC** ergänzen einander und geben zusammen ein vollständiges Bild des Batteriezustands.
- Setzen Sie `niedrig` für SOC bei 25–30 % an Standorten mit begrenzter Sonneneinstrahlung oder in Wintermonaten, wenn die Solarenergie reduziert ist.
- Passen Sie die Spannungsgrenzwerte basierend auf Ihrer Batterietechnologie an — Lithiumsysteme haben andere sichere Betriebsbereiche im Vergleich zu Blei‑Säure‑Batterien.
- Testen Sie Alarmregeln an einem einzelnen Gerät, bevor Sie sie an allen Standorten einsetzen.
- Dokumentieren Sie Ihre Ereigniscodes und Gruppencodes in Ihrer CMS‑Konfiguration, um eine korrekte Alarmweiterleitung sicherzustellen.

## **Fehlerbehebung**

### Gerät verbindet sich nicht

| Symptom / Prüfung | Lösung |
| --- | --- |
| Verbindung schlägt sofort nach dem Speichern fehl | Stellen Sie sicher, dass die VRM Portal Anmeldedaten korrekt sind und administrative Zugriffe besitzen. Melden Sie sich direkt beim Victron VRM Portal an, um dies zu bestätigen. |
| Seriennummer nicht erkannt | Bestätigen Sie, dass die Seriennummer exakt mit der im Victron VRM Portal angegebenen übereinstimmt. Prüfen Sie auf führende/trailing Leerzeichen oder falsche Zeichen. |
| Authentifizierungsfehler | Stellen Sie sicher, dass das verwendete Konto administrative Privilegien hat — Nur-Lese-Konten werden nicht unterstützt. |
| Keine Telemetriedaten nach erfolgreicher Verbindung | Vergewissern Sie sich, dass das Victron Gerät online ist und aktiv an das VRM Portal meldet. Prüfen Sie den Gerätestatus direkt im VRM Portal. |

### Alarmregeln werden nicht ausgelöst

| Symptom / Prüfung | Lösung |
| --- | --- |
| Keine Warnungen erhalten für einen überschrittenen Schwellenwert | Stellen Sie sicher, dass die Regel "active": true im JSON enthält. Prüfen Sie, dass das Benutzerdefiniert Alarmregeln JSON gültig ist (keine Syntaxfehler). |
| eventCode wird im CMS nicht angezeigt | Bestätigen Sie, dass der Ereigniscode in Ihrer CMS-Integration konfiguriert ist. Prüfen Sie die CMS-Kanalzuordnung in GCXONE unter den Integrationseinstellungen der Site. |
| Spannungswarnungen werden unerwartet ausgelöst | Passen Sie die unteren und oberen Schwellenwerte an, um besser dem normalen Betriebs‑Spannungsbereich Ihres Batteriesystems zu entsprechen. |
| SOC‑Warnung wird nach dem Laden nicht gelöscht | Lassen Sie einige Abfragezyklen zu, damit GCXONE den aktualisierten SOC‑Wert von der VRM‑API abruft. Wenn die Warnung weiterhin besteht, aktualisieren Sie den Gerätestatus in GCXONE manuell. |

Für zusätzlichen Support kontaktieren Sie Ihren NXGEN‑Vertreter oder lesen Sie den vollständigen GCXONE Turm‑Überwachung‑Konfigurations‑Leitfaden, der neben Victron Energy auch die Überwachung von EFOY‑Brennstoffzelle und Teltonika‑IoT abdeckt.