Victron
Einleitung
Geräte von Victron Energy sind ein zentraler Bestandteil des GCXONE Tower Monitoring-Ökosystems und ermöglichen die Echtzeitüberwachung von Leistung und Energie an abgelegenen Turmstandorten. Sie erfassen die Ladeeffizienz der Solaranlage, den Zustand der Batterien und die Gesamtspannung des Gleichstromsystems – so wird sichergestellt, dass das Energiesystem innerhalb sicherer Grenzwerte arbeitet, und es werden frühzeitig Warnungen bei Unregelmäßigkeiten bei Batterien oder der Solaranlage ausgegeben.
In dieser Anleitung werden die erforderlichen Schritte zur Integration eines Victron Energy-Geräts in GCXONE beschrieben – von der Einrichtung der Anmeldedaten bis zur Aktivierung der Alarmregeln. Nach Abschluss des Vorgangs überträgt Ihr Gerät Live-Telemetriedaten und löst automatische Warnmeldungen aus, sobald Schwellenwerte für Spannung oder Ladezustand überschritten werden.
Welche Victron-Geräte werden überwacht?
Sobald sie mit GCXONE verbunden sind, melden Victron-Geräte kontinuierlich die folgenden Telemetriedaten:
- Batteriespannungswerte im Gleichstromsystem
- Solarladestrom und Eingangsleistung von PV-Reglern
- Ladezustand (SOC) der Batterie in Prozent
- Betriebsstatus von Ladegerät und Wechselrichter
- Allgemeiner Systemzustand und Alarmzustände
Victron ist das zentrale Stromüberwachungssystem des Turms. Ohne dieses System kann GCXONE weder eine Entladung der Batterien noch eine Leistungsminderung der Solaranlage oder Anomalien bei der Gleichspannung erkennen, die zu einem Stromausfall an der Anlage führen könnten.
Victron ist das zentrale Stromüberwachungssystem des Turms. Ohne dieses System kann GCXONE weder eine Entladung der Batterien noch eine Leistungsminderung der Solaranlage oder Anomalien bei der Gleichspannung erkennen, die zu einem Stromausfall an der Anlage führen könnten.
Voraussetzungen
Bevor Sie mit der Geräteeinbindung beginnen, stellen Sie sicher, dass die folgenden Informationen und Zugriffsrechte vorhanden sind:
| Requirement | Details |
|---|---|
| GCXONE Access | Admin or Operator role with Configuration module access |
| VRM Portal Account | An active Victron VRM Portal account with administrative access to the target device |
| Username & Password | Administrative credentials for the Victron VRM Portal |
| Serial Number | The unique serial number of the Victron device as listed in the VRM Portal |
| Site Created | The site this device will be assigned to must already exist in GCXONE |
Die angegebenen Anmeldedaten für das VRM-Portal müssen über Administratorrechte verfügen. Bei schreibgeschützten Konten kann GCXONE nicht den vollständigen Telemetriedatensatz abrufen, der für die Überwachung erforderlich ist.
Victron-Konfigurationsanleitung für GCX-ONE
Befolgen Sie diese Schritte, um ein Victron-Gerät zu GCXONE hinzuzufügen. Das Gerät wird unter einem bestehenden Standort registriert und beginnt unmittelbar nach der Konfiguration mit der Übermittlung von Telemetriedaten.
Schritt 1 – Rufen Sie die Website auf
Navigieren Sie in GCXONE zu dem Standort, an dem das Victron-Gerät physisch installiert ist. Dies ist die übergeordnete Einheit, unter der das Gerät registriert wird.
- Weiter zu Einstellungen → Websites
- Suchen und öffnen Sie die Zielseite
- Klicken Bearbeiten um das Konfigurationsfenster der Website zu öffnen
Schritt 2 – Öffnen Sie das Gerätedialogfeld
Navigieren Sie in der Website-Konfiguration zu dem Geräte Abschnitt und klicken Sie auf Gerät hinzufügen um das Dialogfeld zur Geräteerstellung zu öffnen.
Schritt 3 – Gerätetyp auswählen
Öffnen Sie im Gerätedialog das Gerätetyp Dropdown-Menü und wählen Victron um die entsprechenden Konfigurationsfelder zu laden.
Schritt 4 – Gerätedaten eingeben
Füllen Sie alle Pflichtfelder aus, um eine sichere Verbindung zwischen GCXONE und dem Victron VRM-Portal herzustellen. Die einzelnen Felder werden im Folgenden ausführlich beschrieben.
| Field | Description | Notes |
|---|---|---|
| Device Type | Select 'Victron' from the dropdown | Must match exactly — determines which telemetry model is used |
| Device Name | A unique, descriptive name for this device in GCXONE | Use a naming convention that identifies the site and device, e.g., 'Tower-North-Victron-01' |
| Serial Number | The hardware serial number of the Victron device | Found on the device label or in the Victron VRM Portal |
| Username | Administrative login username for the VRM Portal | Must have full administrative access to the configured device |
| Password | Administrative login password for the VRM Portal | Stored securely within GCXONE; use a strong, unique password |
Schritt 5 – Speichern und Verbindung überprüfen
Nachdem Sie alle Felder ausgefüllt haben, klicken Sie auf Speichern. GCXONE versucht sofort, sich mit den angegebenen Zugangsdaten und der Seriennummer bei der Victron VRM-API anzumelden.
Eine erfolgreiche Verbindung führt zu:
- Das Gerät, das in der Geräteliste der Website mit einer aktiven Statusanzeige erscheint
- GCXONE erkennt automatisch die verfügbaren PV-Regler und Batteriemanager
- Es werden nun Live-Telemetriedaten in GCXONE übertragen (Batteriespannung, Ladestrom, Solarstrom, Ladezustand)
- Das Gerät steht nun für die Konfiguration von Alarmregeln zur Verfügung
Sollte die Verbindung fehlschlagen, überprüfen Sie bitte, ob die Seriennummer mit dem Gerät im VRM-Portal übereinstimmt, ob die Anmeldedaten über Administratorrechte verfügen und ob die Victron VRM-API vom GCXONE-Server aus erreichbar ist.
Konfiguration der Alarmregeln
GCXONE nutzt eine JSON-basierte Konfiguration von Alarmregeln, um festzulegen, welche Telemetrieparameter überwacht werden, welche Schwellenwerte Warnmeldungen auslösen und wie diese Warnmeldungen in CMS-Integrationen gekennzeichnet werden.
Alarmregeln können unter Standortebene oder Geräteebene. Die Victron-Energievorschriften werden in der Regel auf Geräteebene angewendet, um eine präzise Steuerung zu gewährleisten.
So wenden Sie Alarmregeln an
- Navigieren Sie in GCXONE zur gewünschten Website oder zum gewünschten Gerät.
- Klicken Bearbeiten und gehen Sie zu der Weitere Eigenschaften Abschnitt.
- Suchen Sie die Immobilie mit dem Namen Benutzerdefinierte Alarmregeln.
- Öffne das Hamburger-Menü (⋮) der Eigenschaft und wähle Standard anwenden um den vorkonfigurierten Regelsatz zu laden. Standardmäßig sind alle Regeln deaktiviert.
- Ändern Sie die JSON-Datei, um bestimmte Regeln zu aktivieren, indem Sie
"active": truefür die entsprechenden Parameter. - Legen Sie Ihre Schwellenwerte, Ereigniscodes und Gruppencodes nach Bedarf fest.
- Klicken Speichern. GCXONE beginnt sofort damit, die eingehenden Telemetriedaten anhand der konfigurierten Regeln zu überprüfen.
Standardmäßig sind alle Alarmregeln deaktiviert. Sie müssen sie ausdrücklich aktivieren. "active": true für jede Regel, die GCXONE überwachen soll. Dadurch werden versehentliche Warnmeldungen während der Ersteinrichtung vermieden.
Regelstruktur
Jede Alarmregel folgt einer einheitlichen JSON-Struktur. Das Verständnis der gängigen Felder ist hilfreich, wenn Sie Regeln anpassen möchten:
| Field | Description |
|---|---|
| active | Boolean (true/false). Set to true to enable monitoring for this rule. When false, the rule is ignored. |
| low | Lower threshold value. An alert triggers when the monitored value falls below this level. |
| high | Upper threshold value. An alert triggers when the monitored value exceeds this level. |
| eventCode | Unique string identifier used by GCXONE to communicate this alarm type to CMS integrations (IMMIX, Evalink, AmWin, LISA). This code appears in outbound alarm notifications. |
| groupCode | Logical grouping identifier for Tower Monitoring workflows. Used for filtering, organizing, and managing related alarms within GCXONE's Tower Alarm Manager. |
Alarmregeln von Victron Energy
Für Victron-Geräte stehen unter der Energieüberwachung Abschnitt der JSON-Datei „Custom Alarm Rules“. Jede Regel überwacht einen bestimmten Aspekt des Zustands und der Leistung des Stromversorgungssystems.
- Regel zur Batteriespannung
Überwacht die Gleichsystemspannung an der Batteriebank. Eine Spannung außerhalb des zulässigen Bereichs kann auf einen Ladefehler, eine übermäßige Belastung oder eine Verschlechterung des Batteriezustands hinweisen.
Standard-JSON-Konfiguration
json
"Spannung": { "aktiv": false, "unterer Grenzwert": 12, "oberer Grenzwert": 14, "Ereignis-Code": "battery.voltage.warning", "Gruppen-Code": "tower.solar.voltage.alert" }
| Parameter | Description | Example Value |
|---|---|---|
| low | Minimum acceptable battery voltage (V). Alert triggers when voltage falls below this value. | 12 |
| high | Maximum acceptable battery voltage (V). Alert triggers when voltage exceeds this value. | 14 |
| eventCode | CMS alarm identifier for voltage events | battery.voltage.warning |
| groupCode | Internal tower alarm group for filtering and routing | tower.solar.voltage.alert |
Beispiel für das Verhalten
- Wenn die Spannung unter 12 V fällt, wird eine Warnmeldung ausgelöst, die darauf hinweist, dass sich die Batterie über das sichere Maß hinaus entlädt.
- Wenn die Spannung 14 V überschreitet, wird eine Warnmeldung ausgelöst, die auf eine mögliche Überladung hinweist.
- Die Warnmeldung wird automatisch zurückgesetzt, sobald die Spannung wieder im Bereich von 12 V bis 14 V liegt.
- Passen Sie die Schwellenwerte an die spezifische Chemie Ihrer Batterie an – Lithium-Systeme arbeiten in der Regel in einem anderen Spannungsbereich als Blei-Säure-Systeme.
- Regel zum Ladezustand (SOC) der Batterie
Überwacht den verbleibenden Ladezustand der Batteriebank in Prozent. Der Ladezustand (SOC) ist ein zuverlässigerer Indikator für die verbleibende 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 | Description | Example Value |
|---|---|---|
| low | Minimum acceptable SOC percentage. Alert triggers when SOC falls below this value. | 15 |
| eventCode | CMS alarm identifier for low SOC events | battery.soc.warning |
| groupCode | Internal tower alarm group identifier | tower.battery.soc.alert |
Beispiel für das Verhalten
- GCXONE löst eine Warnmeldung aus, wenn der Ladezustand des Akkus unter 15 % fällt.
- Die Warnmeldung wird automatisch zurückgesetzt, sobald der SOC-Wert den konfigurierten Schwellenwert überschreitet.
- Satz
niedrighöher (z. B. 25–30 %) an Standorten mit begrenzter Sonneneinstrahlung oder hohem Stromverbrauch, um den Betreibern mehr Vorlaufzeit vor einem möglichen Ausfall zu verschaffen.
Übersicht über Veranstaltungs- und Gruppencodes
Übersicht über alle Ereigniscodes und Gruppencodes von Victron Energy:
| Rule | Event Code | Group Code |
|---|---|---|
| Battery Voltage Warning | battery.voltage.warning | tower.solar.voltage.alert |
| Battery State of Charge Warning | battery.soc.warning | tower.battery.soc.alert |
Konfigurationshandbuch
Vollständige JSON-Datei mit den Victron Energy-Alarmregeln. Kopieren Sie diese in das Feld „Benutzerdefinierte Alarmregeln“ und passen Sie sie nach Bedarf an Ihre Umgebung 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" } }
Bewährte Verfahren für die Konfiguration
- Beginnen Sie immer mit Standard anwenden um den vollständigen vorkonfigurierten Regelsatz zu laden, bevor Änderungen vorgenommen werden.
- Aktivieren Sie beide Regeln gleichzeitig — Spannung und SOC ergänzen sich gegenseitig und vermitteln gemeinsam ein umfassendes Bild vom Zustand der Batterie.
- Satz
niedrigfür SOC bei 25–30 % an Standorten mit begrenzter Sonneneinstrahlung oder in den Wintermonaten, wenn die Sonneneinstrahlung geringer ist. - Passen Sie die Spannungsgrenzwerte an die Chemie Ihrer Batterie an – Lithium-Systeme haben andere sichere Betriebsbereiche als Blei-Säure-Batterien.
- Testen Sie die Alarmregeln zunächst auf einem einzelnen Gerät, bevor Sie sie auf allen Standorten bereitstellen.
- Dokumentieren Sie Ihre Ereigniscodes und Gruppencodes in Ihrer CMS-Konfiguration, um eine korrekte Alarmweiterleitung sicherzustellen.
Fehlerbehebung
Das Gerät lässt sich nicht verbinden
| Symptom / Check | Resolution |
|---|---|
| Connection fails immediately after Save | Verify that the VRM Portal credentials are correct and have administrative access. Log in directly to the Victron VRM Portal to confirm. |
| Serial number not recognized | Confirm the serial number matches exactly what is listed in the Victron VRM Portal. Check for leading/trailing spaces or incorrect characters. |
| Authentication error | Ensure the account used has administrative privileges — read-only accounts are not supported. |
| No telemetry data after successful connection | Verify the Victron device is online and actively reporting to the VRM Portal. Check device status in the VRM Portal directly. |
Alarmregeln werden nicht ausgelöst
| Symptom / Check | Resolution |
|---|---|
| No alerts received for a breached threshold | Verify the rule has "active": true in the JSON. Check that the Custom Alarm Rules JSON is valid (no syntax errors). |
| eventCode not appearing in CMS | Confirm 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 unexpectedly | Adjust the low and high thresholds to better match your battery system's normal operating voltage range. |
| SOC alert not clearing after charging | Allow a few polling cycles for GCXONE to retrieve the updated SOC value from the VRM API. If the alert persists, manually refresh the device status in GCXONE. |
Wenn Sie weitere Unterstützung benötigen, wenden Sie sich bitte an Ihren NXGEN-Ansprechpartner oder lesen Sie das vollständige „GCXONE Tower Monitoring Configuration Guide“, das neben Victron Energy auch die Überwachung von EFOY-Brennstoffzellen und Teltonika-IoT-Geräten behandelt.