---
title: "EFOY Fuel Cell"
source: /fr/gcxone/devices/efoy-fuel-cell
locale: fr
updated: 2026-09-14
---
## **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 :

| Exigence | Détails |
| --- | --- |
| Accès GCXONE | Rôle Administrateur ou Opérateur avec accès au module Configuration |
| Clé API EFOY | Une clé API valide configurée au niveau du Tenant dans les Propriétés personnalisées de GCXONE |
| Numéro de série | Le numéro de série unique de la pile à combustible tel qu’indiqué dans le Portail Cloud EFOY |
| Compte Cloud EFOY | Un compte actif sur le Portail Cloud EFOY avec accès à l’appareil cible |
| Site créé | Le site auquel cet appareil sera affecté doit déjà exister dans GCXONE |

**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.

| Champ | Description | Remarques |
| --- | --- | --- |
| Type d'appareil | Sélectionner « EFOY Cloud » dans la liste déroulante | Doit correspondre exactement — détermine le modèle de télémétrie utilisé |
| Nom de l'appareil | Un nom unique et descriptif pour cet appareil dans GCXONE | Utiliser une convention de nommage qui identifie le site et l'appareil (par ex. « Tower-North-EFOY-01 ») |
| Numéro de série | Le numéro de série unique de la pile à combustible | Trouvé sur l'étiquette de l'appareil ou dans le portail EFOY Cloud |
| Adresse IP | Facultatif : point de terminaison API EFOY Cloud | Laisser vide pour utiliser le point de terminaison EFOY Cloud par défaut |
| Nom d'utilisateur | Facultatif : nom d'utilisateur du compte EFOY Cloud | Fournit une solution de secours basée sur des identifiants si la clé API n'est pas disponible |
| Mot de passe | Facultatif : mot de passe du compte EFOY Cloud | Stocké de façon sécurisée dans GCXONE |
| Port de contrôle / Port RTSP / Port serveur / Port HTTPS | Ports de connexion facultatifs | Non requis — la télémétrie EFOY est récupérée via la clé API au niveau du locataire, pas via une connexion directe à l'appareil |

**É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éfaut**pour 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 :

| Champ | Description |
| --- | --- |
| active | Booléen (true/false). Définir sur true pour Activer la surveillance de cette règle. Lorsque false, la règle est ignorée. |
| low | Valeur seuil basse. Une alerte se déclenche lorsque la valeur surveillée descend en dessous de ce niveau. |
| high | Valeur seuil haute. Une alerte se déclenche lorsque la valeur surveillée dépasse ce niveau. |
| eventCode | Identifiant chaîne unique utilisé par GCXONE pour communiquer ce type d'alarme aux intégrations CMS (IMMIX / Evalink / AmWin / LISA). Ce code apparaît dans les notifications d'alarme sortantes. |
| groupCode | Identifiant de regroupement logique pour les flux de travail de surveillance de la tour — utilisé pour filtrer et organiser les alarmes liées dans le Gestionnaire d'Alarme de la tour de GCXONE. |

### 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**

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

| Paramètre | Description | Valeur d'exemple |
| --- | --- | --- |
| low | Pourcentage de carburant minimum acceptable. L'Alerte se déclenche lorsque le carburant descend en dessous de cette valeur. | 15 |
| eventCode | Identifiant d'alarme CMS pour les événements de carburant bas | fuel.low.warning |
| groupCode | Groupe d'alarme interne de la tour pour le filtrage et le routage | 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**

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

| Paramètre | Description | Valeur d'exemple |
| --- | --- | --- |
| bas | Tension de sortie minimale acceptable (V) | 12 |
| haut | Tension de sortie maximale acceptable (V) | 15 |
| eventCode | Identifiant d'alarme CMS pour les événements de tension | fuel.voltage.critical |
| groupCode | Identifiant de groupe d'alarme interne de la tour | 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**

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

| Nom du paramètre | Description | Valeur d'exemple |
| --- | --- | --- |
| bas | Pourcentage SOC minimal acceptable | 15 |
| eventCode | Identifiant d'alarme CMS pour les événements SOC bas | fuel.soc.warning |
| groupCode | Identifiant de groupe d'alarme interne de la tour | 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**

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

| Paramètre | Description | Valeur d'exemple |
| --- | --- | --- |
| bas | Température de fonctionnement minimale acceptable (°C) | 10 |
| haut | Température de fonctionnement maximale acceptable (°C) | 35 |
| eventCode | Identifiant d'alarme CMS pour les événements de température | fuel.temperature.warning |
| groupCode | Identifiant de groupe d'alarme interne de la tour | 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ègle | Code d'événement | Code de groupe |
| --- | --- | --- |
| Avertissement de niveau de carburant | fuel.low.warning | tower.fuel.level.alert |
| Avertissement de tension | fuel.voltage.critical | tower.fuel.voltage.alert |
| Avertissement d'état de charge | fuel.soc.warning | tower.fuel.soc.alert |
| Avertissement de température | fuel.temperature.warning | tower.fuel.temperature.alert |

### 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.

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

#### 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

| Symptôme / Vérification | Résolution |
| --- | --- |
| La connexion échoue immédiatement après l’enregistrement | Vérifier que la propriété locataire EFOYAPIKey est correctement configurée avec une clé API valide. |
| Numéro de série non reconnu | Confirmer que le numéro de série correspond exactement à celui indiqué dans le portail EFOY Cloud. Vérifier les espaces en début ou fin. |
| Aucune donnée de télémétrie après une connexion réussie | S’assurer que l’appareil EFOY est alimenté et rapporte activement à EFOY Cloud. Vérifier le Statut du périphérique dans le portail EFOY Cloud directement. |
| Clé API acceptée mais aucun appareil visible | Vérifier que la clé API possède les autorisations suffisantes pour accéder à l’appareil de pile à combustible spécifique dans EFOY Cloud. |

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

| Symptôme / Vérification | Résolution |
| --- | --- |
| Aucune alerte reçue pour un seuil franchi | Vérifier que la règle possède "active": true dans le JSON. Vérifier que le JSON des Règles d’Alarme Personnalisées est valide (pas d’erreurs de syntaxe). |
| eventCode n’apparaît pas dans le CMS | Confirmer que le code d’événement est configuré dans votre intégration CMS. Vérifier le mappage des canaux CMS dans GCXONE sous les paramètres d’intégration du Site. |
| Alertes de température déclenchées de façon inattendue | Ajuster les seuils bas et haut pour mieux correspondre à la plage de température environnementale normale du Site. |
| Alerte de niveau de carburant ne se désactive pas après le ravitaillement | Attendre quelques cycles d’interrogation pour que GCXONE récupère le niveau de carburant mis à jour depuis l’API EFOY Cloud. Si l’alerte persiste, actualiser manuellement le statut du périphérique dans GCXONE. |

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.