Victron

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:

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 dasGerä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.

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

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

"voltage": {
  "active": false,
  "low": 12,
  "high": 14,
  "eventCode": "battery.voltage.warning",
  "groupCode": "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

"stateOfCharge": {
  "active": false,
  "low": 15,
  "eventCode": "battery.soc.warning",
  "groupCode": "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.
• Festlegenniedrig 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:

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.

"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

Alarmregeln werden nicht ausgelöst

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.