EFOY Fuel Cell

Introducción

Los dispositivos EFOY Fuel Cell son un componente central del ecosistema GCXONE Tower Monitoring, proporcionando energía de respaldo autónoma para sitios de torres remotas donde la energía de red no está disponible o es poco fiable.

Esta guía describe los pasos necesarios para incorporar una EFOY Fuel Cell en GCXONE, cubriendo la configuración del dispositivo, la configuración de la clave API y la activación de la regla de alarma. Una vez completado, su dispositivo transmitirá telemetría en vivo y generará alertas automáticas cuando se superen los umbrales de combustible, voltaje o temperatura.

Qué monitorizan los Dispositivos EFOY

Una vez conectado a GCXONE, los dispositivos EFOY Fuel Cell informan continuamente las siguientes categorías de telemetría:

• Nivel del cartucho de combustible como porcentaje de la capacidad restante
• Voltaje de salida de la celda de combustible
• Estado de carga (SOC) de la batería interna
• Temperatura de operación del Sistema
• Estado general de salud y tiempo de funcionamiento de la celda de combustible

Nota: EFOY gestiona la generación de energía de respaldo para sitios que no pueden depender únicamente de energía solar o de red. Sin el monitoreo de EFOY, GCXONE no puede detectar el agotamiento de combustible, caídas de voltaje o condiciones térmicas que podrían provocar que un sitio quede Sin conexión.

Requisitos previos

Antes de iniciar la incorporación del Dispositivo, asegúrese de que la siguiente información y acceso estén disponibles:

Advertencia: La Clave de API EFOY debe configurarse a nivel de Inquilino antes de añadir el Dispositivo. Si la clave falta o es incorrecta, GCXONE no podrá recuperar la telemetría del EFOY Cloud.

Configuración de la Clave de API EFOY

Antes de añadir un Dispositivo EFOY, debe configurar la clave de API a nivel de Inquilino en GCXONE. Esta clave se comparte entre todos los Dispositivos EFOY bajo el inquilino.

Paso 1: Navegar a Configuración del Inquilino en GCXONE.

Paso 2: Seleccione el inquilino objetivo y haga clic en Editar.

Paso 3: Ir a la Propiedades Personalizadas sección.

Paso 4: Haga clic en Agregar y cree una nueva propiedad con los siguientes valores:

• Nombre: EFOYAPIKey
• Valor: Su clave de API de EFOY Cloud

Paso 5: Haga clic en Guardar.

Nota: La clave de API solo necesita configurarse una vez por inquilino. Todos los dispositivos EFOY añadidos bajo ese inquilino usarán la misma clave automáticamente.

Guía de Configuración de la Celda de Combustible EFOY con GCXONE

Siga estos pasos para añadir una Celda de Combustible EFOY a GCXONE. El dispositivo se registrará bajo un sitio existente y comenzará a informar telemetría inmediatamente después de la configuración.

Paso 1: Navegue al Sitio

En GCXONE, navegue al Sitio donde la EFOY Fuel Cell está instalada físicamente. Esta es la entidad padre bajo la cual se registrará el dispositivo.

• Ir a Configuración → Sitios
• Localice y abra el sitio objetivo
• Haga clic en Editar para abrir el panel de configuración del sitio

Paso 2: Abra el Diálogo de Dispositivo

Dentro de la configuración del sitio, navegue a la Dispositivos sección y haga clic en Agregar Nuevo para abrir el cuadro de diálogo de creación de dispositivo.

Paso 3: Seleccione Tipo de Dispositivo

En el diálogo de dispositivo, abra el Tipo de Dispositivo desplegable y seleccione EFOY Cloud para cargar los campos de configuración apropiados.

Paso 4: Ingrese los detalles del Dispositivo

Complete todos los campos obligatorios para establecer una conexión segura entre GCXONE y la API de EFOY Cloud. Cada campo se describe en detalle a continuación.

Paso 5: Debajo de los campos de conexión, el cuadro de diálogo también tiene un Seleccionar grupo de entidad menú desplegable, un Habilitar audio interruptor (activado por defecto), un obligatorio Zona horaria, un Configuración del Dispositivo sección (Configuración de Site Pulse), un Configuración avanzada sección (Sondeo de eventos, Configurar Máscara de mapa de calor, Control de salud periódico, Tiempo de retención de eventos — 30 días por defecto), y una opcional Ubicación sección (Latitud, Longitud, Código Plus, What3Words).

Paso 6: Guardar y Verificar Conexión

Después de ingresar todos los campos, haga clic en Guardar. GCXONE intentará inmediatamente conectar con la API de EFOY Cloud usando la clave de API configurada y el número de serie.

Una conexión exitosa produce:

• El dispositivo aparece en la lista de dispositivos del sitio con un indicador de estado activo
• Datos de telemetría En Vivo comienzan a fluir a GCXONE (nivel de combustible, voltaje, temperatura, SOC)
• El dispositivo queda disponible para la configuración de reglas de alarma

Advertencia: Si la conexión falla, verifique que la propiedad de inquilino EFOYAPIKey esté configurada correctamente, que el número de serie coincida con el dispositivo en el portal EFOY Cloud, y que la API de EFOY Cloud sea accesible desde el servidor GCXONE.

Configuración de reglas de alarma

GCXONE utiliza una configuración de reglas de alarma basada en JSON para definir qué parámetros de telemetría se monitorizan, qué umbrales generan alarmas y cómo esas alarmas se identifican en integraciones CMS.

Las reglas de alarma pueden configurarse a nivel de sitio o de dispositivo. Las reglas de celda de combustible EFOY suelen aplicarse a nivel de dispositivo para un control preciso.

Cómo aplicar reglas de alarma

1. Navegue al sitio o dispositivo objetivo en GCXONE.
2. Haga clic en Editar y vaya a la Propiedades Adicionales sección.
3. Localice la propiedad llamada Reglas de alarma personalizadas.
4. Abra el menú de la propiedad (⋮) y seleccione Aplicar predeterminado para cargar el conjunto de reglas preconfigurado. Todas las reglas están inactivas por defecto.
5. Modifique el JSON para habilitar reglas específicas estableciendo "active": true para los parámetros relevantes.
6. Establezca sus umbrales, códigos de evento y códigos de grupo según sea necesario.
7. Haga clic en Guardar. GCXONE comenzará inmediatamente a evaluar la telemetría entrante contra las reglas configuradas.

Nota: Por defecto, todas las reglas de alarma están inactivas. Debe establecer explícitamente "active": true para cada regla que desea que GCXONE supervise. Esto evita alarmas accidentales durante la configuración inicial.

Estructura de la Regla

Cada regla de alarma sigue una estructura JSON consistente. Comprender los campos comunes ayuda al personalizar reglas:

Reglas de Alarma de Celdas de Combustible EFOY

Las siguientes reglas de alarma están disponibles para dispositivos EFOY bajo la Monitoreo de Celdas de Combustible sección del JSON de Reglas de Alarma Personalizadas. Cada regla supervisa un aspecto específico de la salud y el rendimiento de la celda de combustible.

Regla de Nivel de Combustible

Supervisa el porcentaje de combustible restante en el cartucho de combustible EFOY. Esta es la regla más crítica para el monitoreo de EFOY — un cartucho agotado hará que la celda de combustible se apague, eliminando la energía de respaldo del sitio.

Configuración JSON Predeterminada

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

Comportamiento de Ejemplo

• Con bajo establezca a 15, GCXONE genera una Alarma cuando el nivel del cartucho de combustible cae por debajo del 15%.
• La Alarma se borra automáticamente cuando el cartucho se reemplaza o recarga y el nivel supera el umbral.
• Establecer bajo más alto (p.ej., 25%) en sitios remotos donde la logística de reabastecimiento lleva más tiempo, para dar a los operadores mayor antelación.

Regla de Voltaje

Supervisa el voltaje de salida de la celda de combustible EFOY. Un voltaje fuera del rango aceptable puede indicar una falla en la salida de energía de la celda o un problema con el sistema DC conectado.

Configuración JSON Predeterminada

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

Comportamiento de Ejemplo

• Cuando el voltaje cae por debajo de 12 V, se genera una Alarma que indica una salida de energía insuficiente.
• Cuando el voltaje supera los 15 V, se genera una Alarma que indica una posible condición de sobrevoltaje.
• La Alarma se borra automáticamente cuando el voltaje vuelve al rango de 12 V–15 V.

Regla de Estado de Carga (SOC)

Rastrea el estado de carga de la batería interna dentro del sistema EFOY. El SOC refleja la capacidad de la celda de combustible para mantener la salida durante el arranque y transiciones de bajo combustible.

Configuración JSON Predeterminada

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

Comportamiento de ejemplo

• GCXONE genera una Alarma cuando el SOC de la batería interna cae por debajo del 15 %.
• La Alarma se borra automáticamente cuando el SOC supera el umbral configurado.

Regla de temperatura

Supervisa la temperatura de funcionamiento de la celda de combustible EFOY. Las temperaturas fuera del rango seguro pueden reducir la eficiencia, activar apagados de seguridad o causar daños permanentes a la unidad.

Configuración JSON predeterminada

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

Comportamiento de ejemplo

• Se genera una advertencia térmica cuando la temperatura cae por debajo de 10 °C o supera los 35 °C.
• La alerta se borra automáticamente cuando la temperatura vuelve al rango seguro de operación.
• Ajuste los umbrales según las condiciones ambientales del sitio de la torre; las instalaciones exteriores en climas extremos pueden requerir rangos más amplios o más estrechos.

Resumen de códigos de Evento y códigos de Grupo

Referencia rápida de todos los códigos de Evento y códigos de Grupo de la celda de combustible EFOY:

Referencia de Configuración

JSON completo de Reglas de Alarma de Celda de Combustible EFOY

Copie esto en la propiedad Regla de Alarma Personalizada y modifíquelo según sea necesario para su despliegue.

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

Mejores prácticas de Configuración

• Siempre comience con Aplicar predeterminado para cargar el conjunto completo de reglas preconfiguradas antes de realizar cambios.
• Permita la Nivel de combustiblePrimero aplique la regla — es la más crítica operativamente para sitios que dependen de la energía de respaldo EFOY.
• Establezca bajo para el nivel de combustible al 20–25 % en sitios remotos donde el repostaje requiere planificación logística anticipada.
• Permita Temperatura la monitorización en sitios expuestos a calor o frío extremos para detectar condiciones térmicas antes de que provoquen un apagado.
• Pruebe las reglas de alarma en un solo dispositivo antes de implementarlas en todos los sitios.
• Documente sus códigos de evento y códigos de grupo en la configuración de su CMS para garantizar el enrutamiento correcto de las alarmas.

Solución de problemas

El Dispositivo no se conecta

Las reglas de Alarma no se activan

Para soporte adicional, contacte a su representante de NXGEN o consulte la Guía completa de Configuración de Monitoreo de Torre GCXONE, que cubre el monitoreo de Victron Energy y Teltonika IoT además de la Celda de Combustible EFOY.