Victron

Introducción

Los dispositivos Victron Energy son un componente esencial del ecosistema de Monitoreo de Torre GCXONE, proporcionando monitoreo en tiempo real de potencia y energía para sitios de torres remotos. Registran el rendimiento de carga solar, la salud de la batería y el voltaje general del sistema de CC, garantizando que el sistema energético opere dentro de umbrales seguros y proporcionando advertencias tempranas de irregularidades en la batería o en la energía solar.

Esta guía describe los pasos necesarios para incorporar un dispositivo Victron Energy en GCXONE, cubriendo la configuración de credenciales y la activación de reglas de alarma. Una vez completado, su dispositivo transmitirá telemetría en vivo y activará Alarmas automáticas cuando se superen los umbrales de voltaje o de estado de carga.

Qué monitorizan los dispositivos Victron

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

• Niveles de voltaje de la batería en todo el sistema de CC
• Corriente de carga solar y potencia de aporte de los controladores PV
• Estado de carga (SOC) de la batería como porcentaje
• Estado operativo del cargador y del inversor
• Salud general del sistema y Estados de alarma

Nota:Victron es el sistema principal de monitoreo de energía de la torre. Sin él, GCXONE no puede detectar el agotamiento de la batería, bajo rendimiento solar o anomalías de voltaje de CC que podrían causar que una instalación pierda energía.

Requisitos previos

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

Advertencia:Las credenciales del portal VRM proporcionadas deben tener privilegios administrativos. Las cuentas de solo lectura no permitirán que GCXONE recupere el conjunto completo de datos de telemetría necesario para el monitoreo.

Guía de configuración de Victron con GCXONE

Siga estos pasos para agregar un dispositivo Victron a GCXONE. El dispositivo se registrará bajo una instalación existente y comenzará a informar telemetría inmediatamente después de la configuración.

Paso 1: Navegue a la Instalación

En GCXONE, navegue a la Instalación donde el dispositivo Victron está instalado físicamente. Esta es la entidad padre bajo la cual se registrará el dispositivo.

• Ir a Configuration → Sites
• Localice y abra la instalación objetivo
• Haga clic Editar para abrir el panel de Configuración de la instalación

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 el tipo de Dispositivo

En el diálogo de Dispositivo, abra el Tipo de Dispositivo desplegable y seleccione Victron para cargar los campos de configuración correspondientes.

Paso 4: Ingresar detalles del Dispositivo

Complete todos los campos obligatorios para establecer una conexión segura entre GCXONE y el portal Victron VRM. Cada campo se describe en detalle a continuación.

Paso 5: Debajo de los campos de conexión, el diálogo también tiene un Seleccionar grupo de entidad desplegable, un requerido Zona horaria, una Configuración de Dispositivo sección (Configuración de Site Pulse), una 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 introducir todos los campos, haga clic en Guardar. GCXONE intentará inmediatamente conectar con la API de Victron VRM usando las credenciales proporcionadas 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
• GCXONE detectando automáticamente el PV Controller y Battery Manager
• Datos de telemetría en tiempo real comenzando a fluir a GCXONE (voltaje de batería, corriente de carga, aporte solar, SOC)
• El dispositivo queda disponible para la configuración de reglas de alarma

Advertencia: Si la conexión falla, verifique que el número de serie coincida con el dispositivo en el Portal VRM, que las credenciales tengan privilegios administrativos y que la API de Victron VRM sea accesible desde el servidor GCXONE.

Configuración de Reglas de Alarma

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

Las reglas de alarma pueden configurarse a nivel de sitio o de dispositivo. Las reglas de Victron Energy se aplican normalmente 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 los tres puntos (⋮) 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 permitir 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 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 desee que GCXONE supervise. Esto evita alarmas accidentales durante la configuración inicial.

Estructura de la regla

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

Reglas de alarma Victron Energy

Las siguientes reglas de alarma están disponibles para dispositivos Victron en la sección Energy Monitoring sección del JSON de Reglas de Alarma Personalizadas. Cada regla supervisa un aspecto específico de la salud y el rendimiento del sistema eléctrico.

Regla de voltaje de batería

Supervisa el voltaje del sistema DC del banco de baterías. Un voltaje fuera del rango aceptable puede indicar una falla de carga, carga excesiva o degradación de la batería.

Configuración JSON predeterminada

"voltage": {
  "active": false,
  "low": 12,
  "high": 14,
  "eventCode": "battery.voltage.warning",
  "groupCode": "tower.solar.voltage.alert"
}

Comportamiento de ejemplo

• Cuando el voltaje cae por debajo de 12 V, se activa una alarma que indica que la batería se está descargando por debajo de niveles seguros.
• Cuando el voltaje supera los 14 V, se activa una alarma que indica una posible condición de sobrecarga.
• La alarma se borra automáticamente cuando el voltaje vuelve al rango de 12 V–14 V.
• Ajuste los umbrales según la química específica de su batería: los sistemas de litio normalmente operan dentro de un rango de voltaje diferente al de los de plomo‑ácido.

Regla de Estado de Carga (SOC) de la batería

Supervisa el porcentaje de carga restante en el banco de baterías. El SOC es un indicador más fiable de la energía utilizable que el voltaje solo, especialmente bajo carga.

Configuración JSON predeterminada

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

Comportamiento de ejemplo

• GCXONE activa una alarma cuando el SOC de la batería cae por debajo del 15 %.
• La alarma se borra automáticamente cuando el SOC supera el umbral configurado.
• Establezca bajo más alto (p.ej., 25–30 %) en sitios con entrada solar limitada o alto consumo de energía para dar a los operadores más tiempo de anticipación antes de una posible interrupción.

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 Victron Energy:

Referencia de Configuración

JSON completo de Reglas de Alarmas Victron Energy

Copie esto en la propiedad Reglas de Alarmas Personalizado y modifíquelo según sea necesario para su despliegue.

"energyMonitoring": {
  "voltage": {
    "active": false,
    "low": 12,
    "high": 14,
    "eventCode": "battery.voltage.warning",
    "groupCode": "tower.solar.voltage.alert"
  },
  "stateOfCharge": {
    "active": false,
    "low": 15,
    "eventCode": "battery.soc.warning",
    "groupCode": "tower.battery.soc.alert"
  }
}

Mejores prácticas de Configuración

• Siempre comience con Apply Default para cargar el conjunto completo de reglas preconfiguradas antes de realizar cambios.
• Permita ambas reglas juntas — Voltage y SOC se complementan y, juntas, proporcionan una visión completa de la salud de la batería.
• Establezca low para SOC en 25–30 % en sitios con exposición solar limitada o durante los meses de invierno cuando la aportación solar se reduce.
• Ajuste los umbrales de voltaje según la química de su batería: los sistemas de litio tienen rangos de operación seguros diferentes a los de baterías de plomo‑ácido.
• 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

Reglas de Alarmas no se activan

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