EFOY Fuel Cell

Introduction

Les appareils EFOY Fuel Cell sont un composant essentiel de l’écosystème de surveillance des tours GCXONE, fournissant une alimentation de secours autonome pour les sites de tours distants où l’alimentation réseau est indisponible ou peu fiable.

Ce guide décrit les étapes nécessaires pour intégrer une EFOY Fuel Cell dans GCXONE — configuration de l’appareil, paramétrage de la clé API et activation de la règle d’Alarme. Une fois terminé, votre appareil diffusera des télémesures en direct et déclenchera des alertes automatisées lorsque les seuils de carburant, de tension ou de température seront dépassés.

Ce que les appareils EFOY surveillent

Une fois connectés à GCXONE, les appareils EFOY Fuel Cell rapportent en continu les catégories de télémesure suivantes :

• Niveau de cartouche de carburant en pourcentage de capacité restante
• Tension de sortie de la pile à combustible
• État de charge (SOC) de la batterie interne
• Température de fonctionnement du Système
• État de santé global de la pile à combustible et statut de temps de fonctionnement

Note : EFOY assure la génération d’alimentation de secours pour les sites qui ne peuvent pas compter uniquement sur l’énergie solaire ou le réseau. Sans la surveillance EFOY, GCXONE ne peut pas détecter l’épuisement du carburant, les baisses de tension ou les conditions thermiques pouvant entraîner la mise hors connexion d’un site.

Prérequis

Avant de commencer l’intégration de l’appareil, assurez‑vous que les informations et accès suivants sont disponibles :

Avertissement : La clé API EFOY doit être configurée au niveau du Tenant avant d’ajouter l’appareil. Si la clé est manquante ou incorrecte, GCXONE ne pourra pas récupérer les télémesures depuis le Cloud EFOY.

Configuration de la clé API EFOY

Avant d’ajouter un appareil EFOY, vous devez configurer la clé API au niveau du Tenant dans GCXONE. Cette clé est partagée entre tous les appareils EFOY du tenant.

Étape 1 : Naviguer vers Paramètres du Tenant dans GCXONE.

Étape 2 : Sélectionner le tenant cible et cliquer sur Modifier.

Étape 3 : Aller à la Propriétés Personnalisées section.

Étape 4 : Cliquer sur Ajouter et créer une nouvelle propriété avec les valeurs suivantes :

• Nom : EFOYAPIKey
• Valeur : Votre clé API EFOY Cloud

Étape 5 : Cliquer sur Enregistrer.

Remarque : La clé API ne doit être configurée qu’une fois par locataire. Tous les appareils EFOY ajoutés sous ce locataire utiliseront automatiquement la même clé.

Guide de configuration de la pile à combustible EFOY avec GCXONE

Suivez ces étapes pour ajouter une pile à combustible EFOY à GCXONE. L’appareil sera enregistré sous un site existant et commencera à transmettre la télémétrie immédiatement après la configuration.

Étape 1 :Naviguer vers le Site

Dans GCXONE, naviguer vers le Site où la pile à combustible EFOY est physiquement installée. Il s’agit de l’entité parent sous laquelle le dispositif sera enregistré.

• Aller à Configuration → Sites
• Localiser et ouvrir le site cible
• Cliquer sur Modifier pour ouvrir le panneau de configuration du site

Étape 2 : Ouvrir la boîte de dialogue Appareil

Dans la configuration du site, accédez à la section Appareils et cliquer sur Ajouter Nouveau pour ouvrir la boîte de dialogue de création d’appareil.

Étape 3 : Sélectionner le Type d'appareil

Dans la boîte de dialogue appareil, ouvrir le menu déroulant Type d'appareil et sélectionner EFOY Cloud pour charger les champs de configuration appropriés.

Étape 4 : Saisir les détails de l'appareil

Remplir tous les champs obligatoires pour établir une connexion sécurisée entre GCXONE et l'API EFOY Cloud. Chaque champ est décrit en détail ci‑dessous.

Étape 5 : Sous les champs de connexion, la boîte de dialogue comporte également un Sélectionner le groupe d'entités menu déroulant, un Activer l'audio bascule (activée par défaut), un champ obligatoire Fuseau horaire, un Configuration de l'appareil section (Configuration Site Pulse), un Paramètres avancés section (Event Polling, Configurer Masque Heatmap, Vérification périodique de santé, Temps rétention de l’événement — 30 jours par défaut), et une option Emplacement section (Latitude, Longitude, Plus Code, What3Words).

Étape 6 : Enregistrer et vérifier la Connexion

Après avoir saisi tous les champs, cliquer sur Enregistrer. GCXONE tentera immédiatement de se connecter à l’API EFOY Cloud en utilisant la clé API et le numéro de série configurés.

Une connexion réussie entraîne :

• L’appareil apparaît dans la liste des appareils du site avec un indicateur d’état actif
• Les données de télémétrie En direct commencent à être transmises à GCXONE (niveau de carburant, tension, température, SOC)
• L’appareil devient disponible pour la configuration des règles d’Alarme

Avertissement : Si la connexion échoue, vérifier que la propriété de locataire EFOYAPIKey est correctement configurée, que le numéro de série correspond à l’appareil dans le portail EFOY Cloud, et que l’API EFOY Cloud est accessible depuis le serveur GCXONE.

Configuration des Règles d’Alarme

GCXONE utilise une configuration de règle d’Alarme basée sur JSON pour définir quels paramètres de télémétrie sont surveillés, quels seuils déclenchent des alertes, et comment ces alertes sont identifiées dans les intégrations CMS.

Les règles d’Alarme peuvent être configurées au niveau du Niveau du Site ou niveau de l’Appareil. Les règles de pile à combustible EFOY sont généralement appliquées au niveau de l’Appareil pour un contrôle précis.

Comment appliquer les règles d’Alarme

1. Naviguer vers le Site ou l’Appareil cible dans GCXONE.
2. Cliquer sur Modifier et accéder à la Propriétés supplémentaires section.
3. Localiser la propriété nommée Règles d’Alarme Personnalisées.
4. Ouvrir le menu de la propriété (⋮) et sélectionner Appliquer par défautpour charger l’ensemble de règles préconfigurées. Toutes les règles sont inactives par défaut.
5. Modifier le JSON pour activer des règles spécifiques en définissant "active": true pour les paramètres concernés.
6. Définir vos seuils, codes d’événement et codes de groupe selon les besoins.
7. Cliquer sur Enregistrer. GCXONE commencera immédiatement à évaluer la télémétrie entrante par rapport aux règles configurées.

Note :Par défaut, toutes les règles d’alarme sont inactives. Vous devez définir explicitement"active": true pour chaque règle que vous souhaitez que GCXONE surveille. Cela évite les alertes accidentelles lors de la configuration initiale.

Structure de la règle

Chaque règle d'alarme suit une structure JSON cohérente. Comprendre les champs communs aide lors de la personnalisation des règles :

Règles d'Alarme de la Pile à Combustible EFOY

Les règles d'alarme suivantes sont disponibles pour les appareils EFOY dans la section Surveillance de la Pile à Combustible du JSON des Règles d'Alarme Personnalisées. Chaque règle surveille un aspect spécifique de la santé et des performances de la pile à combustible.

Règle de Niveau de carburant

Surveille le pourcentage de carburant restant dans la cartouche de carburant EFOY. C’est la règle la plus critique pour la surveillance EFOY — une cartouche épuisée entraînera l’arrêt de la pile à combustible, supprimant l’alimentation de secours du Site.

Configuration JSON par défaut

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

Comportement d'exemple

• Avec bas réglé à 15, GCXONE déclenche une Alerte lorsque le niveau de la cartouche de carburant descend en dessous de 15 %.
• L'Alerte se désactive automatiquement lorsque la cartouche est remplacée ou rechargée et que le niveau remonte au‑delà du seuil.
• Régler bas plus élevé (par ex., 25 %) sur les sites distants où la logistique de ravitaillement prend plus de temps, afin de donner aux opérateurs davantage de marge.

Règle de tension

Surveille la tension de sortie de la pile à combustible EFOY. Une tension hors de la plage acceptable peut indiquer un défaut de la puissance de sortie de la pile ou un problème du système DC connecté.

Configuration JSON par défaut

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

Comportement d'exemple

• Lorsque la tension descend en dessous de 12 V, une Alerte est déclenchée indiquant une puissance de sortie insuffisante.
• Lorsque la tension dépasse 15 V, une Alerte est déclenchée indiquant une possible condition de surtension.
• L'Alerte se désactive automatiquement lorsque la tension revient dans la plage 12 V–15 V.

Règle d'état de charge (SOC)

Suit l'état de charge de la batterie interne du système EFOY. Le SOC reflète la capacité de la pile à combustible à maintenir la sortie lors du démarrage et des transitions à faible carburant.

Configuration JSON par défaut

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

Exemple de comportement

• GCXONE déclenche une alerte lorsque le SOC de la batterie interne descend en dessous de 15 %.
• L'alerte se désactive automatiquement lorsque le SOC dépasse le seuil configuré.

Règle de température

Surveille la température de fonctionnement de la pile à combustible EFOY. Des températures en dehors de la plage de fonctionnement sûre peuvent réduire l'efficacité, déclencher des arrêts de sécurité ou causer des dommages permanents à l'Unité.

Configuration JSON par défaut

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

Exemple de comportement

• Une alerte thermique est déclenchée lorsque la température descend en dessous de 10 °C ou dépasse 35 °C.
• L'alerte se désactive automatiquement lorsque la température revient dans la plage de fonctionnement sûre.
• Ajuster les seuils en fonction des conditions environnementales du site de la tour — les installations extérieures dans des climats extrêmes peuvent nécessiter des plages plus larges ou plus étroites.

Résumé des codes d'événement et des codes de groupe

Référence rapide pour tous les codes d'événement et de groupe de la pile à combustible EFOY :

Référence de configuration

JSON complet des Règles d’Alarme de la pile à combustible EFOY

Copier ceci dans la propriété Règles d’Alarme Personnalisées et modifier selon les besoins de votre déploiement.

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

Bonnes pratiques de configuration

• Commencer toujours par Appliquer par défaut pour charger l’ensemble complet de règles préconfigurées avant d’apporter des modifications.
• Activer le niveau de carburant règle en premier — c’est la plus critique opérationnellement pour les sites dépendant de l’alimentation de secours EFOY.
• Définir bas pour le niveau de carburant à 20–25 % sur les sites distants où le ravitaillement nécessite une planification logistique préalable.
• Activer Température la surveillance sur les sites exposés à des températures extrêmes afin de détecter les conditions thermiques avant qu’elles n’entraînent une interruption.
• Tester les Règles d’Alarme sur un seul appareil avant de les déployer sur tous les sites.
• Documenter vos codes d’événement et codes de groupe dans la configuration de votre CMS afin d’assurer un routage correct des alarmes.

Dépannage

L’Appareil ne se connecte pas

Règles d’Alarme ne se déclenchent pas

Pour un support supplémentaire, contacter votre représentant NXGEN ou consulter le Guide complet de configuration de la surveillance de la tour GCXONE, qui couvre la surveillance Victron Energy et Teltonika IoT en plus de la pile à combustible EFOY.