EFOY Fuel Cell

Einleitung

EFOY Fuel Cell Geräte sind ein Kernbestandteil des GCXONE Tower Monitoring‑Ökosystems und liefern autonome Notstromversorgung für entfernte Turmstandorte, an denen Netzstrom nicht verfügbar oder unzuverlässig ist.

Dieses Handbuch beschreibt die erforderlichen Schritte, um ein EFOY Fuel Cell in GCXONE zu integrieren – einschließlich Geräte‑Konfiguration, API‑Key‑Einrichtung und Aktivierung von Alarmregeln. Nach Abschluss wird Ihr Gerät Live‑Telemetrie streamen und automatisierte Warnungen auslösen, wenn Schwellenwerte für Kraftstoff, Spannung oder Temperatur überschritten werden.

Was EFOY Geräte überwachen

Sobald sie mit GCXONE verbunden sind, melden EFOY Fuel Cell Geräte kontinuierlich die folgenden Telemetrie‑Kategorien:

• Kraftstoffkartuschen‑Stand als Prozentsatz der verbleibenden Kapazität
• Ausgangsspannung der Brennstoffzelle
• Interner Batterieladezustand (SOC)
• Betriebstemperatur des Systems
• Gesamtzustand der Brennstoffzelle und Laufzeitstatus

Hinweis: EFOY übernimmt die Notstromerzeugung für Standorte, die nicht ausschließlich auf Solar‑ oder Netzstrom setzen können. Ohne EFOY‑Überwachung kann GCXONE keinen Kraftstoffverbrauch, Spannungsabfälle oder thermische Bedingungen erkennen, die einen Standort offline schalten könnten.

Voraussetzungen

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

Warnung: Der EFOY API‑Key muss auf Mandantenebene konfiguriert sein, bevor das Gerät hinzugefügt wird. Fehlt der Schlüssel oder ist er falsch, kann GCXONE keine Telemetrie aus der EFOY Cloud abrufen.

Konfiguration des EFOY API‑Key

Bevor Sie ein EFOY Gerät hinzufügen, müssen Sie den API‑Key auf Mandantenebene in GCXONE konfigurieren. Dieser Schlüssel wird für alle EFOY Geräte des Mandanten gemeinsam verwendet.

Schritt 1: Navigieren Sie zu Mandanteneinstellungen in GCXONE.

Schritt 2: Wählen Sie den Ziel‑Mandanten aus und klicken Sie auf Bearbeiten.

Schritt 3: Gehen Sie zu Benutzerdefinierte Eigenschaften Abschnitt.

Schritt 4: Klicken Sie Hinzufügen und erstellen Sie eine neue Eigenschaft mit den folgenden Werten:

• Name: EFOYAPIKey
• Wert: Ihr EFOY Cloud API-Schlüssel

Schritt 5: Klicken Sie Speichern.

Hinweis: Der API-Schlüssel muss nur einmal pro Mandanten konfiguriert werden. Alle unter diesem Mandanten hinzugefügten EFOY‑Geräte verwenden automatisch denselben Schlüssel.

EFOY Brennstoffzellen-Konfigurationshandbuch mit GCXONE

Führen Sie die folgenden Schritte aus, um eine EFOY Brennstoffzelle zu GCXONE hinzuzufügen. Das Gerät wird unter einer bestehenden Site registriert und beginnt nach der Konfiguration sofort mit der Telemetrie‑Übermittlung.

Schritt 1: Navigieren Sie zur Site

In GCXONE navigieren Sie zur Site, an der die EFOY Brennstoffzelle physisch installiert ist. Dies ist das übergeordnete Element, unter dem das Gerät registriert wird.

• Gehen Sie zu Konfiguration → Sites
• Suchen Sie die Ziel‑Site und öffnen Sie sie
• Klicken Sie Bearbeiten um das Konfigurationspanel der Site zu öffnen

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

Im Rahmen der Site‑Konfiguration navigieren Sie zum Geräte Abschnitt und klicken Sie Neu hinzufügen um den Dialog zur Geräteerstellung zu öffnen.

Schritt 3: Gerätetyp auswählen

Im Geräte‑Dialog öffnen Sie das Gerätetyp Dropdown und wählen Sie EFOY Cloud um die entsprechenden Konfigurationsfelder zu laden.

Schritt 4: Geräteinformationen eingeben

Alle erforderlichen Felder ausfüllen, um eine sichere Verbindung zwischen GCXONE und der EFOY Cloud API herzustellen. Jedes Feld wird nachfolgend detailliert beschrieben.

Schritt 5: Unterhalb der Verbindungsfelder enthält der Dialog außerdem ein Entitätsgruppe auswählen Dropdown, ein Audio Aktivieren Schalter (standardmäßig aktiviert), ein erforderliches Zeitzone, ein Gerätekonfiguration Abschnitt (Site Pulse Konfiguration), ein Erweiterte Einstellungen Abschnitt (Ereignisabfrage, Heatmap-Maske konfigurieren, Periodische Statusabfrage, Ereignis Haltezeit — 30 Tage standardmäßig), und optional 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 EFOY Cloud API mit dem konfigurierten API‑Schlüssel und der Seriennummer herzustellen.

Eine erfolgreiche Verbindung führt zu:

• Das Gerät erscheint in der Geräteliste der Site mit einem aktiven Statusindikator
• Live‑Telemetriedaten beginnen in GCXONE zu fließen (Tankfüllstand, Spannung, Temperatur, SOC)
• Das Gerät wird für die Konfiguration von Alarmregeln verfügbar

Warnung: Wenn die Verbindung fehlschlägt, prüfen Sie, ob die EFOYAPIKey‑Mandanten‑Eigenschaft korrekt konfiguriert ist, die Seriennummer mit dem Gerät im EFOY Cloud Portal übereinstimmt und die EFOY Cloud API vom GCXONE‑Server erreichbar ist.

Alarmregeln Konfiguration

GCXONE verwendet eine JSON‑basierte Alarmregel‑Konfiguration, um zu definieren, 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. EFOY‑Brennstoffzellen‑Regeln werden typischerweise auf Geräte‑Ebene für präzise Steuerung angewendet.

So wenden Sie Alarmregeln an

1. Navigieren Sie zur gewünschten Site oder zum gewünschten Gerät in GCXONE.
2. Klicken Sie Bearbeiten und öffnen Sie den Abschnitt Zusätzliche Einstellungen Abschnitt.
3. Suchen Sie die Eigenschaft mit dem Namen Benutzerdefinierte Alarmregeln.
4. Öffnen Sie das Menü der Eigenschaft (⋮) und wählen Sie Standard anwenden um das vorkonfigurierte Regelset zu laden. Alle Regeln sind standardmäßig inaktiv.
5. Ändern Sie das JSON, um bestimmte Regeln zu aktivieren, indem Sie "active": true für die relevanten Parameter setzen.
6. Legen Sie Ihre Schwellenwerte, Ereigniscodes und Gruppencodes nach Bedarf fest.
7. Klicken Sie 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:

EFOY‑Brennstoffzellen‑Alarmregeln

Die folgenden Alarmregeln stehen für EFOY‑Geräte im Fuel Cell Monitoring Abschnitt des benutzerdefinierten Alarmregeln‑JSON. Jede Regel überwacht einen spezifischen Aspekt der Gesundheit und Leistung der Brennstoffzelle.

Tankfüllstand‑Regel

Überwacht den verbleibenden Kraftstoffanteil im EFOY‑Kraftstoffbehälter. Dies ist die kritischste Regel für die EFOY‑Überwachung – ein leerer Behälter führt zum Abschalten der Brennstoffzelle und entfernt die Notstromversorgung vom Standort.

Standard‑JSON‑Konfiguration

"fuelLevel": {
  "active": false,
  "low": 15,
  "eventCode": "fuel.low.warning",
  "groupCode": "tower.fuel.level.alert"
}

Beispielverhalten

• Mit niedrig auf 15 gesetzt, GCXONE löst eine Warnung aus, wenn der Kraftstoffkartuschenstand unter 15 % fällt.
• Die Warnung wird automatisch gelöscht, wenn die Kartusche ausgetauscht oder nachgefüllt wird und der Stand über den Schwellenwert steigt.
• Setzen niedrig höher (z. B. 25 %) an entfernten Standorten, wo die Betankungslogistik länger dauert, um den Bedienern mehr Vorlaufzeit zu geben.

Spannungsregel

Überwacht die Ausgangsspannung der EFOY-Brennstoffzelle. Eine Spannung außerhalb des zulässigen Bereichs kann auf einen Fehler der Stromabgabe der Brennstoffzelle oder ein Problem im angeschlossenen Gleichstromsystem hinweisen.

Standard‑JSON‑Konfiguration

"voltage": {
  "active": false,
  "low": 12,
  "high": 15,
  "eventCode": "fuel.voltage.critical",
  "groupCode": "tower.fuel.voltage.alert"
}

Beispielverhalten

• Fällt die Spannung unter 12 V, wird eine Warnung ausgelöst, die auf unzureichende Stromabgabe hinweist.
• Überschreitet die Spannung 15 V, wird eine Warnung ausgelöst, die auf eine mögliche Überspannung hinweist.
• Die Warnung wird automatisch gelöscht, wenn die Spannung wieder im Bereich von 12 V–15 V liegt.

Ladezustandsregel (SOC)

Verfolgt den Ladezustand der internen Batterie im EFOY‑System. Der SOC spiegelt die Fähigkeit der Brennstoffzelle wider, die Ausgabe beim Start und bei niedrigen Kraftstoffbedingungen aufrechtzuerhalten.

Standard‑JSON‑Konfiguration

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

Beispielverhalten

• GCXONE löst eine Warnung aus, wenn der interne Batterieladezustand (SOC) unter 15 % fällt.
• Die Warnung wird automatisch gelöscht, wenn der SOC über den konfigurierten Schwellenwert steigt.

Temperaturregel

Überwacht die Betriebstemperatur der EFOY-Brennstoffzelle. Temperaturen außerhalb des sicheren Betriebsbereichs können die Effizienz verringern, Sicherheitsabschaltungen auslösen oder dauerhafte Schäden an der Einheit verursachen.

Standard‑JSON‑Konfiguration

"temperature": {
  "active": false,
  "low": 10,
  "high": 35,
  "eventCode": "fuel.temperature.warning",
  "groupCode": "tower.fuel.temperature.alert"
}

Beispielverhalten

• Eine thermische Warnung wird ausgelöst, wenn die Temperatur unter 10 °C fällt oder über 35 °C steigt.
• Die Warnung wird automatisch gelöscht, wenn die Temperatur wieder im sicheren Betriebsbereich liegt.
• Passen Sie die Schwellenwerte an die Umgebungsbedingungen des Turmstandorts an – Außeninstallationen in extremen Klimazonen können breitere oder engere Bereiche erfordern.

Zusammenfassung der Ereignis‑ und Gruppen‑Codes

Kurzreferenz für alle Ereignis‑ und Gruppen‑Codes der EFOY‑Brennstoffzelle:

Konfigurationsreferenz

Vollständige EFOY Brennstoffzellen‑Alarmregeln JSON

Kopieren Sie dies in die Benutzerdefinierte Alarmregeln‑Eigenschaft und passen Sie es nach Bedarf für Ihre Installation an.

"fuelCellMonitoring": {
  "fuelLevel": {
    "active": false,
    "low": 15,
    "eventCode": "fuel.low.warning",
    "groupCode": "tower.fuel.level.alert"
  },
  "voltage": {
    "active": false,
    "low": 12,
    "high": 15,
    "eventCode": "fuel.voltage.critical",
    "groupCode": "tower.fuel.voltage.alert"
  },
  "stateOfCharge": {
    "active": false,
    "low": 15,
    "eventCode": "fuel.soc.warning",
    "groupCode": "tower.fuel.soc.alert"
  },
  "temperature": {
    "active": false,
    "low": 10,
    "high": 35,
    "eventCode": "fuel.temperature.warning",
    "groupCode": "tower.fuel.temperature.alert"
  }
}

Best Practices für die Konfiguration

• Beginnen Sie immer mit Standard anwenden um das vollständige vorkonfigurierte Regelset zu laden, bevor Sie Änderungen vornehmen.
• Aktivieren Sie die Tankfüllstand Regel zuerst – sie ist für Standorte, die auf EFOY‑Backup‑Strom angewiesen sind, am operativ kritischsten.
• Setzen Sie niedrig für den Tankfüllstand auf 20–25 % an entfernten Standorten, wo das Nachfüllen eine vorausschauende Logistikplanung erfordert.
• Aktivieren Sie Temperatur Überwachung an Standorten, die extremen Hitze‑ oder Kältebedingungen ausgesetzt sind, um thermische Zustände zu erfassen, bevor sie einen Shutdown verursachen.
• Testen Sie Alarmregeln an einem einzelnen Gerät, bevor Sie sie an allen Standorten ausrollen.
• 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 das vollständige GCXONE Tower Monitoring Configuration Guide, das neben der EFOY‑Brennstoffzelle auch die Überwachung von Victron Energy und Teltonika IoT abdeckt.