GCXONEDocumentatie

EFOY-brandstofcel

Bijgewerkt op 11 augustus 2026Apparaten en integratiesPDF downloadenWijziging voorstellenHulp krijgen
Op deze pagina
  1. Inleiding
  2. Vereisten
  3. EFOY-brandstofcel: configuratiehandleiding met GCX-ONE
  4. Problemen oplossen

Inleiding

EFOY-brandstofcelinstallaties vormen een essentieel onderdeel van het GCXONE Tower Monitoring-ecosysteem en zorgen voor autonome noodstroomvoorziening voor afgelegen torenlocaties waar geen of onbetrouwbare netstroom beschikbaar is.

In deze handleiding worden de stappen beschreven die nodig zijn om een EFOY-brandstofcel in GCXONE te integreren — van de configuratie van het apparaat en het instellen van de API-sleutel tot het activeren van alarmregels. Zodra dit is voltooid, zal uw apparaat live telemetriegegevens doorsturen en automatische waarschuwingen activeren wanneer drempelwaarden voor brandstof, spanning of temperatuur worden overschreden.

Wat houden EFOY-apparaten in de gaten??

Zodra ze zijn aangesloten op GCXONE, sturen EFOY-brandstofcelapparaten continu de volgende categorieën telemetriegegevens door:

  • Het niveau van de brandstofpatroon als percentage van de resterende capaciteit
  • Uitgangsspanning van de brandstofcel
  • Laadstatus (SOC) van de interne accu
  • Bedrijfstemperatuur van het systeem
  • Algemene toestand van de brandstofcel en status van de bedrijfstijd

Vereisten

Zorg ervoor dat de volgende informatie en toegangsrechten beschikbaar zijn voordat u begint met het aanmelden van het apparaat:

RequirementDetails
GCXONE AccessAdmin or Operator role with Configuration module access
EFOY API KeyA valid API key configured at the Tenant level in GCXONE Custom Properties
Serial NumberThe unique serial number of the fuel cell as listed in the EFOY Cloud Portal
EFOY Cloud AccountAn active account on the EFOY Cloud Portal with access to the target device
Site CreatedThe site this device will be assigned to must already exist in GCXONE

De EFOY-API-sleutel configureren

Voordat u een EFOY-apparaat toevoegt, moet u de API-sleutel op tenantniveau in GCXONE configureren. Deze sleutel geldt voor alle EFOY-apparaten die onder die tenant vallen.

  1. Ga naar Instellingen voor huurders in GCXONE.
  2. Selecteer de gewenste tenant en klik op Bewerken.
  3. Ga naar de Aangepaste eigenschappen paragraaf.
  4. Klik Toevoegen en maak een nieuw eigenschap aan met de volgende waarden:
  • Naam: EFOYAPIKey
  • Waarde: Uw EFOY Cloud API-sleutel
  1. Klik Opslaan.

EFOY-brandstofcel: configuratiehandleiding met GCX-ONE

Volg deze stappen om een EFOY-brandstofcel aan de GCXONE toe te voegen. Het apparaat wordt onder een bestaande locatie geregistreerd en begint direct na de configuratie met het doorsturen van telemetriegegevens.

Stap 1 — Ga naar de website

Ga in GCXONE naar de locatie waar de EFOY-brandstofcel fysiek is geïnstalleerd. Dit is de bovenliggende entiteit waaronder het apparaat zal worden geregistreerd.

  • Ga naar Configuratie → Sites
  • Zoek de doelsite en open deze
  • Klik Bewerken om het configuratiescherm van de site te openen

Stap 2 — Open het dialoogvenster ‘Apparaat’

Ga binnen de siteconfiguratie naar de Apparaten rubriek en klik op Apparaat toevoegen om het dialoogvenster voor het aanmaken van een apparaat te openen.

Stap 3 — Selecteer het type apparaat

Open in het apparaatvenster het Type apparaat het dropdown-menu openen en selecteren EFOY Cloud om de juiste configuratievelden te laden.

Stap 4 — Voer de apparaatgegevens in

Vul alle verplichte velden in om een beveiligde verbinding tot stand te brengen tussen GCXONE en de EFOY Cloud API. Elk veld wordt hieronder uitgebreid beschreven.

FieldDescriptionNotes
Device TypeSelect 'EFOY Cloud' from the dropdownMust match exactly — determines which telemetry model is used
Device NameA uniquedescriptive name for this device in GCXONE
Serial NumberThe unique serial number of the fuel cellFound on the device label or in the EFOY Cloud Portal
IP AddressOptional: EFOY Cloud API endpointLeave blank to use the default EFOY Cloud endpoint
UsernameOptional: EFOY Cloud account usernameProvides a credential-based fallback if the API key is unavailable
PasswordOptional: EFOY Cloud account passwordStored securely within GCXONE

Stap 5 — Opslaan en verbinding controleren

Nadat u alle velden hebt ingevuld, klikt u op Opslaan. GCXONE zal onmiddellijk proberen verbinding te maken met de EFOY Cloud API met behulp van de geconfigureerde API-sleutel en het serienummer.

Een succesvolle verbinding leidt tot:

  • Het apparaat dat in de apparatenlijst van de website wordt weergegeven met een actieve statusindicator
  • Er beginnen live telemetriegegevens binnen te komen bij GCXONE (brandstofpeil, spanning, temperatuur, SOC)
  • Het apparaat is nu beschikbaar voor het instellen van alarmregels

Configuratie van alarmregels

GCXONE maakt gebruik van een op JSON gebaseerde configuratie van alarmregels om te bepalen welke telemetrieparameters worden gemonitord, welke drempelwaarden waarschuwingen activeren en hoe die waarschuwingen worden weergegeven in CMS-integraties.

Alarmregels kunnen worden geconfigureerd in de Locatieniveau of Apparaatniveau. De instellingen van de EFOY-brandstofcel worden doorgaans op apparaatniveau toegepast om een nauwkeurige regeling te garanderen.

Hoe alarmregels toepassen

  1. Ga in GCXONE naar de betreffende site of het betreffende apparaat.
  2. Klik Bewerken en ga naar de Overige kenmerken paragraaf.
  3. Zoek het object met de naam Aangepaste alarmregels.
  4. Open het hamburgermenu (⋮) van het object en selecteer Standaard instellen om de vooraf geconfigureerde regelset te laden. Alle regels zijn standaard uitgeschakeld.
  5. Pas de JSON aan om bepaalde regels in te schakelen door het volgende in te stellen: "active": true voor de betreffende parameters.
  6. Stel uw drempelwaarden, gebeurteniscodes en groepscodes naar behoefte in.
  7. Klik Opslaan. GCXONE zal onmiddellijk beginnen met het toetsen van binnenkomende telemetrie aan de hand van de geconfigureerde regels.

Regelstructuur

Elke alarmregel volgt een consistente JSON-structuur. Inzicht in de veelvoorkomende velden is handig bij het aanpassen van regels:

FieldDescription
activeBoolean (true/false). Set to true to enable monitoring for this rule. When false
lowLower threshold value. An alert triggers when the monitored value falls below this level.
highUpper threshold value. An alert triggers when the monitored value exceeds this level.
eventCodeUnique string identifier used by GCXONE to communicate this alarm type to CMS integrations (IMMIX
groupCodeLogical grouping identifier for Tower Monitoring workflows. Used for filtering

Regels voor het EFOY-brandstofcelalarm

De volgende alarmregels zijn beschikbaar voor EFOY-apparaten onder de Monitoring van brandstofcellen gedeelte van het JSON-bestand met aangepaste alarmregels. Elke regel houdt een specifiek aspect van de toestand en prestaties van de brandstofcel in de gaten.

1. Regel inzake brandstofpeil

Houdt het resterende brandstofpercentage in de EFOY-brandstofpatroon bij. Dit is de belangrijkste regel bij het monitoren van de EFOY: als een patroon leeg is, wordt de brandstofcel uitgeschakeld, waardoor de noodstroomvoorziening van de locatie wegvalt.

Standaard JSON-configuratie

json

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

ParameterDescriptionExample Value
lowMinimum acceptable fuel percentage. Alert triggers when fuel drops below this value.15
eventCodeCMS alarm identifier for low fuel eventsfuel.low.warning
groupCodeInternal tower alarm group for filtering and routingtower.fuel.level.alert

Voorbeeld van gedrag

  • Met laag Als deze waarde is ingesteld op 15, geeft de GCXONE een waarschuwing af wanneer het niveau van de brandstofpatroon onder de 15% daalt.
  • De waarschuwing verdwijnt automatisch zodra de cartridge is vervangen of bijgevuld en het niveau boven de drempelwaarde komt.
  • Set laag hoger (bijvoorbeeld 25%) op afgelegen locaties waar de logistiek rond het bijtanken meer tijd in beslag neemt, om de exploitanten meer voorbereidingstijd te geven.

2. Spanningsregel

Houdt de uitgangsspanning van de EFOY-brandstofcel in de gaten. Een spanning buiten het toegestane bereik kan wijzen op een storing in de stroomopbrengst van de brandstofcel of op een probleem met het aangesloten gelijkstroomsysteem.

Standaard JSON-configuratie

json

"spanning": { "actief": false, "laag": 12, "hoog": 15, "gebeurteniscode": "fuel.voltage.critical", "groepscode": "tower.fuel.voltage.alert" }

ParameterDescriptionExample Value
lowMinimum acceptable output voltage (V)12
highMaximum acceptable output voltage (V)15
eventCodeCMS alarm identifier for voltage eventsfuel.voltage.critical
groupCodeInternal tower alarm group identifiertower.fuel.voltage.alert

Voorbeeld van gedrag

  • Wanneer de spanning onder de 12 V daalt, wordt er een waarschuwing geactiveerd die aangeeft dat er onvoldoende uitgangsvermogen is.
  • Wanneer de spanning hoger wordt dan 15 V, wordt er een waarschuwing geactiveerd die wijst op een mogelijke overspanningssituatie.
  • De waarschuwing verdwijnt automatisch zodra de spanning weer binnen het bereik van 12 V tot 15 V ligt.

3. Regel inzake de laadstatus (SOC)

Houdt de laadstatus van de interne accu binnen het EFOY-systeem bij. De SOC geeft aan in hoeverre de brandstofcel in staat is om het vermogen op peil te houden tijdens het opstarten en bij een laag brandstofpeil.

Standaard JSON-configuratie

json

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

Parameter NameDescriptionExample Value
lowMinimum acceptable SOC percentage15
eventCodeCMS alarm identifier for low SOC eventsfuel.soc.warning
groupCodeInternal tower alarm group identifiertower.fuel.soc.alert

Voorbeeld van gedrag

  • GCXONE geeft een waarschuwing af wanneer het laadniveau (SOC) van de interne batterij onder de 15% daalt.
  • De waarschuwing verdwijnt automatisch zodra de SOC boven de ingestelde drempelwaarde komt.

4. Temperatuurregel

Houdt de bedrijfstemperatuur van de EFOY-brandstofcel in de gaten. Temperaturen buiten het veilige bedrijfsbereik kunnen het rendement verminderen, veiligheidsuitschakelingen activeren of permanente schade aan het apparaat veroorzaken.

Standaard JSON-configuratie

json

"temperatuur": { "actief": false, "min": 10, "max": 35, "gebeurteniscode": "fuel.temperature.warning", "groepscode": "tower.fuel.temperature.alert" }

ParameterDescriptionExample Value
lowMinimum acceptable operating temperature (°C)10
highMaximum acceptable operating temperature (°C)35
eventCodeCMS alarm identifier for temperature eventsfuel.temperature.warning
groupCodeInternal tower alarm group identifiertower.fuel.temperature.alert

Voorbeeld van gedrag

  • Er wordt een temperatuurwaarschuwing geactiveerd wanneer de temperatuur onder de 10 °C daalt of boven de 35 °C stijgt.
  • De waarschuwing verdwijnt automatisch zodra de temperatuur weer binnen het veilige werkingsbereik ligt.
  • Pas de drempelwaarden aan op basis van de omgevingsomstandigheden op de locatie van de zendmast — bij buiteninstallaties in extreme klimaten kunnen bredere of smallere bereiken nodig zijn.

Overzicht van evenementcodes en groepscodes

Overzicht van alle EFOY-brandstofcel-evenementcodes en groepscodes:

RuleEvent CodeGroup Code
Fuel Level Warningfuel.low.warningtower.fuel.level.alert
Voltage Warningfuel.voltage.criticaltower.fuel.voltage.alert
State of Charge Warningfuel.soc.warningtower.fuel.soc.alert
Temperature Warningfuel.temperature.warningtower.fuel.temperature.alert

Configuratiehandleiding

Volledige JSON-code voor EFOY-brandstofcelalarmen. Kopieer dit naar de eigenschap ‘Aangepaste alarmregels’ en pas het naar behoefte aan voor uw installatie.

json

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

Aanbevolen werkwijzen voor configuratie

  • Begin altijd met Standaard instellen om de volledige, vooraf geconfigureerde regelset te laden voordat u wijzigingen aanbrengt.
  • Schakel de Brandstofpeil Regel nummer één — dit is het meest cruciaal voor de bedrijfsvoering van locaties die afhankelijk zijn van EFOY-noodstroomvoorziening.
  • Set laag voor een brandstofniveau van 20–25% op afgelegen locaties waar het bijtanken een logistieke planning van tevoren vereist.
  • Inschakelen Temperatuur monitoring op locaties die worden blootgesteld aan extreme hitte of kou, om thermische omstandigheden op te sporen voordat deze tot een stillegging leiden.
  • Test de alarmregels eerst op één apparaat voordat u ze op alle locaties implementeert.
  • Leg uw evenementcodes en groepscodes vast in uw CMS-configuratie om een correcte alarmdoorgave te garanderen.

Problemen oplossen

Het apparaat maakt geen verbinding

Symptom / CheckResolution
Connection fails immediately after SaveVerify that the EFOYAPIKey tenant property is correctly configured with a valid API key.
Serial number not recognizedConfirm the serial number matches exactly what is listed in the EFOY Cloud Portal. Check for leading/trailing spaces.
No telemetry data after successful connectionEnsure the EFOY device is powered on and actively reporting to the EFOY Cloud. Check device status in the EFOY Cloud Portal directly.
API key accepted but no devices visibleVerify the API key has sufficient permissions to access the specific fuel cell device in the EFOY Cloud.

Alarmregels worden niet geactiveerd

Symptom / CheckResolution
No alerts received for a breached thresholdVerify the rule has "active": true in the JSON. Check that the Custom Alarm Rules JSON is valid (no syntax errors).
eventCode not appearing in CMSConfirm the event code is configured in your CMS integration. Check the CMS channel mapping in GCXONE under the site's integration settings.
Temperature alerts firing unexpectedlyAdjust the low and high thresholds to better match the site's normal environmental temperature range.
Fuel level alert not clearing after refuelAllow a few polling cycles for GCXONE to retrieve the updated fuel level from the EFOY Cloud API. If the alert persists

Neem voor meer ondersteuning contact op met uw NXGEN-vertegenwoordiger of raadpleeg de volledige configuratiehandleiding voor GCXONE Tower Monitoring, waarin naast de EFOY-brandstofcel ook de IoT-monitoring van Victron Energy en Teltonika wordt behandeld.

Was deze pagina nuttig?

Bedankt — uw feedback gaat naar het team dat deze pagina beheert.