EFOY Fuel Cell

Inleiding

EFOY Fuel Cell apparaten zijn een kerncomponent van het GCXONE Toren Monitoren-ecosysteem, die autonome back‑up stroom leveren voor afgelegen torenlocaties waar netstroom niet beschikbaar of onbetrouwbaar is.

Deze gids beschrijft de stappen die nodig zijn om een EFOY Fuel Cell toe te voegen aan GCXONE — inclusief Apparaat Configuratie, API‑sleutelinstelling en Alarm‑regelactivatie. Na voltooiing zal uw Apparaat live telemetrie streamen en geautomatiseerde Alarmen activeren wanneer brandstof-, spannings‑ of temperatuurdrempels worden overschreden.

Wat EFOY Apparaten Monitoren

Zodra ze zijn verbonden met GCXONE, rapporteren EFOY Fuel Cell apparaten continu de volgende categorieën telemetrie:

• Brandstofcartridge‑niveau als percentage van de resterende capaciteit
• Uitgangsspanning van de brandstofcel
• Interne batterij‑state of charge (SOC)
• Systeem operationele temperatuur
• Algemene brandstofcel Status en runtime status

Opmerking:EFOY verzorgt back‑up stroomgeneratie voor locaties die niet alleen op zonne‑ of netstroom kunnen vertrouwen. Zonder EFOY monitoring kan GCXONE geen brandstofuitputting, spanningsdalingen of thermische omstandigheden detecteren die een locatie offline kunnen laten gaan.

Voorvereisten

Zorg ervoor dat de volgende informatie en toegang beschikbaar zijn voordat u begint met het onboarden van het Apparaat:

Waarschuwing: De EFOY API‑sleutel moet op Tenant‑niveau worden geconfigureerd voordat het Apparaat wordt toegevoegd. Als de sleutel ontbreekt of onjuist is, kan GCXONE geen telemetrie van het EFOY Cloud ophalen.

Configureren van de EFOY API‑sleutel

Voordat u een EFOY Apparaat toevoegt, moet u de API‑sleutel configureren op Tenant‑niveau in GCXONE. Deze sleutel wordt gedeeld door alle EFOY Apparaten onder de tenant.

Stap 1: Navigeer naar Tenant‑instellingen in GCXONE.

Stap 2: Selecteer de doel‑tenant en klik op Bewerken.

Stap 3: Ga naar de Aangepaste Eigenschappen sectie.

Stap 4: Klik Toevoegen en maak een nieuwe eigenschap aan met de volgende waarden:

• Naam: EFOYAPIKey
• Waarde: Uw EFOY Cloud API-sleutel

Stap 5: Klik Opslaan.

Opmerking: De API-sleutel hoeft slechts één keer per tenant te worden geconfigureerd. Alle EFOY‑apparaten die onder die tenant worden toegevoegd, gebruiken automatisch dezelfde sleutel.

EFOY Brandstofcel Configuratiehandleiding met GCXONE

Volg deze stappen om een EFOY Brandstofcel toe te voegen aan GCXONE. Het apparaat wordt geregistreerd onder een bestaande site en begint onmiddellijk na configuratie telemetrie te rapporteren.

Stap 1: Navigeer naar de Site

Navigeer in GCXONE naar de Site waar de EFOY Brandstofcel fysiek is geïnstalleerd. Dit is de bovenliggende entiteit waaronder het apparaat wordt geregistreerd.

• Ga naar Configuratie → Sites
• Zoek en open de doel‑site
• Klik Bewerken om het configuratiepaneel van de site te openen

Stap 2: Open het Apparaat‑dialoogvenster

Binnen de site‑configuratie navigeert u naar de Apparaten sectie en klik Nieuw toevoegen om het dialoogvenster voor apparaatcreatie te openen.

Stap 3: Selecteer Apparaattype

Open in het apparaat‑dialoogvenster de Apparaattype vervolgkeuzelijst en selecteer EFOY Cloud om de juiste configuratievelden te laden.

Stap 4: Apparaatdetails invoeren

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

Stap 5: Onder de verbindingsvelden bevat het dialoogvenster ook een Selecteer entiteitsgroep vervolgkeuzelijst, een Audio inschakelen schakelaar (standaard ingeschakeld), een vereiste Tijdzone, een Apparaatconfiguratie sectie (Site puls configuratie), een Geavanceerde instellingen sectie (Event Polling, Configure Heatmap Mask, Periodic Health Check, Event Retention Time — 30 dagen standaard), en een optionele Locatie sectie (Latitude, Longitude, Plus Code, What3Words).

Stap 6: Opslaan en Verifiëren Verbinding

Na het invullen van alle velden, klik op Opslaan. GCXONE zal onmiddellijk proberen verbinding te maken met de EFOY Cloud API met de geconfigureerde API‑sleutel en serienummer.

Een succesvolle verbinding resulteert in:

• Het apparaat verschijnt in de lijst met apparaten van de site met een actieve statusindicator
• Live telemetriegegevens beginnen te stromen naar GCXONE (brandstofniveau, spanning, temperatuur, SOC)
• Het apparaat wordt beschikbaar voor alarmregelsconfiguratie

Waarschuwing: Als de verbinding mislukt, controleer dan of de EFOYAPIKey‑tenant‑eigenschap correct is geconfigureerd, het serienummer overeenkomt met het apparaat in het EFOY Cloud‑portaal, en de EFOY Cloud API bereikbaar is vanaf de GCXONE‑server.

Alarmregelsconfiguratie

GCXONE gebruikt een JSON‑gebaseerde alarmregelsconfiguratie om te definiëren welke telemetrie‑parameters worden gemonitord, welke drempels alarmen activeren, en hoe die alarmen worden geïdentificeerd in CMS‑integraties.

Alarmregels kunnen worden geconfigureerd op het Site‑niveau of Apparaat‑niveau. EFOY‑brandstofcelregels worden doorgaans toegepast op Apparaat‑niveau voor precieze controle.

Hoe alarmregels toe te passen

1. Navigeer naar de doel‑Site of Apparaat in GCXONE.
2. Klik op Bewerken en ga naar de Aanvullende eigenschappen sectie.
3. Zoek de eigenschap met de naam Aangepaste Alarmregels.
4. Open het menu van de eigenschap (⋮) en selecteer Standaard toepassen om de vooraf geconfigureerde regelset te laden. Alle regels zijn standaard inactief.
5. Pas de JSON aan om specifieke regels in te schakelen door "active": true voor de relevante parameters.
6. Stel uw drempels, event‑codes en groepscodes in naar behoefte.
7. Klik op Opslaan. GCXONE begint onmiddellijk met het evalueren van binnenkomende telemetrie tegen de geconfigureerde regels.

Opmerking: Standaard zijn alle alarmregels inactief. U moet expliciet instellen "active": true voor elke regel die u wilt dat GCXONE bewaakt. Dit voorkomt onbedoelde alarmen tijdens de initiële configuratie.

Regelstructuur

Elke alarmregel volgt een consistente JSON-structuur. Het begrijpen van de gemeenschappelijke velden helpt bij het aanpassen van regels:

EFOY Brandstofcel Alarmregels

De volgende alarmregels zijn beschikbaar voor EFOY‑apparaten onder de Brandstofcelmonitoring sectie van de Aangepaste Alarmregels JSON. Elke regel bewaakt een specifiek aspect van de gezondheid en prestaties van de brandstofcel.

Brandstofniveau Regel

Bewaakt het resterende brandstofpercentage in de EFOY‑brandstofcartridge. Dit is de meest kritieke regel voor EFOY‑monitoring — een lege cartridge zorgt ervoor dat de brandstofcel uitschakelt, waardoor de back‑upstroom van de locatie verdwijnt.

Standaard JSON‑configuratie

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

Voorbeeldgedrag

• Met laag ingesteld op 15, GCXONE geeft een alarm wanneer het brandstofcartridgetniveau onder 15% daalt.
• Het alarm wordt automatisch gewist wanneer het cartridge wordt vervangen of bijgevuld en het niveau boven de drempel stijgt.
• Stel laag hoger (bijv. 25%) in afgelegen locaties waar de logistiek voor bijtanken langer duurt, om operators meer speling te geven.

Spanningsregel

Monitort de uitgangsspanning van de EFOY brandstofcel. Een spanning buiten het acceptabele bereik kan wijzen op een storing in de vermogensoutput van de brandstofcel of een probleem met het aangesloten DC‑systeem.

Standaard JSON‑configuratie

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

Voorbeeldgedrag

• Wanneer de spanning onder 12 V daalt, wordt een alarm geactiveerd dat onvoldoende vermogensoutput aangeeft.
• Wanneer de spanning boven 15 V stijgt, wordt een alarm geactiveerd dat een mogelijke overspanningssituatie aangeeft.
• Het alarm wordt automatisch gewist wanneer de spanning terugkeert binnen het bereik van 12 V–15 V.

Ladingstoestand‑regel (SOC)

Volgt de laadstatus van de interne batterij binnen het EFOY‑systeem. De SOC geeft de capaciteit van de brandstofcel weer om output te handhaven tijdens opstarten en bij lage brandstofovergangen.

Standaard JSON‑configuratie

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

Voorbeeldgedrag

• GCXONE activeert een alarm wanneer de interne batterij‑SOC onder 15 % daalt.
• Het alarm wordt automatisch gewist wanneer de SOC boven de geconfigureerde drempel stijgt.

Temperatuurregel

Monitort de bedrijfstemperatuur van de EFOY brandstofcel. Temperaturen buiten het veilige bedrijfsbereik kunnen de efficiëntie verminderen, veiligheidsuitschakelingen activeren of permanente schade aan de Eenheid veroorzaken.

Standaard JSON Configuratie

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

Voorbeeldgedrag

• Een thermisch alarm wordt geactiveerd wanneer de temperatuur onder 10 °C daalt of boven 35 °C stijgt.
• Het alarm wordt automatisch gewist wanneer de temperatuur terugkeert binnen het veilige bedrijfsbereik.
• Pas de drempels aan op basis van de omgevingscondities van de torenlocatie — buiteninstallaties in extreme klimaten kunnen bredere of smallere bereiken vereisen.

Samenvatting van gebeurteniscodes en groepscodes

Snelle referentie voor alle EFOY brandstofcel gebeurteniscodes en groepscodes:

Configuratie Referentie

Complete EFOY Brandstofcel Alarm Regels JSON

Kopieer dit naar de eigenschap Aangepaste Alarm Regels en pas het aan indien nodig voor uw implementatie.

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

Configuratie Best Practices

• Begin altijd met Standaard toepassen om de volledige vooraf geconfigureerde regelset te laden voordat u wijzigingen aanbrengt.
• Inschakelen de Brandstofniveau regel eerst — dit is operationeel het meest kritisch voor locaties die afhankelijk zijn van EFOY back-up stroom.
• Instellen laag voor brandstofniveau op 20–25% op afgelegen locaties waar bijtanken geavanceerde logistieke planning vereist.
• Inschakelen Temperatuur monitoring op locaties die worden blootgesteld aan extreme hitte of kou om thermische omstandigheden te detecteren voordat ze een uitschakeling veroorzaken.
• Test alarmregels op één apparaat voordat u ze naar alle locaties uitrolt.
• Documenteer uw gebeurteniscodes en groepscodes in uw CMS configuratie om correcte alarmroutering te waarborgen.

Probleemoplossing

Apparaat maakt geen verbinding

Alarmregels activeren niet

Voor extra ondersteuning kunt u contact opnemen met uw NXGEN‑vertegenwoordiger of de volledige GCXONE Toren Monitoren Configuratiehandleiding raadplegen, die Victron Energy‑ en Teltonika‑IoT‑monitoring naast de EFOY Brandstofcel behandelt.