---
title: "Victron"
source: /es/gcxone/devices/victron
locale: es
updated: 2026-09-14
---
## **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:

| Requisito | Detalles |
| --- | --- |
| Acceso a GCXONE | Rol de Administrador o Operador con acceso al módulo Configuración |
| Cuenta del portal VRM | Una cuenta activa del portal Victron VRM con acceso administrativo al dispositivo objetivo |
| Nombre de usuario y contraseña | Credenciales administrativas para el portal Victron VRM |
| Número de serie | El número de serie único del dispositivo Victron tal como aparece en el portal VRM |
| Instalación Creada | La instalación a la que se asignará este dispositivo debe existir previamente en GCXONE |

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

| Campo | Descripción | Notas |
| --- | --- | --- |
| Tipo de Dispositivo | Seleccione 'Victron' del desplegable | Debe coincidir exactamente — determina qué modelo de telemetría se utiliza |
| Nombre del Dispositivo | Un nombre único y descriptivo para este dispositivo en GCXONE | Utilice una convención de nombres que identifique el sitio y el dispositivo (p. ej., 'Torre-Norte-Victron-01') |
| Número de serie | El número de serie del hardware del dispositivo Victron | Se encuentra en la etiqueta del dispositivo o en el portal Victron VRM |
| Nombre de usuario | Nombre de usuario de inicio de sesión administrativo para el portal VRM | Debe tener acceso administrativo completo al dispositivo configurado |
| Contraseña | Contraseña de inicio de sesión administrativo para el portal VRM | Almacenada de forma segura dentro de GCXONE; utilice una contraseña fuerte y única |

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

| Campo | Descripción |
| --- | --- |
| active | Booleano (true/false). Establézcalo en true para permitir la monitorización de esta regla. Cuando es false, la regla se ignora. |
| low | Valor de umbral inferior. Se genera una alarma cuando el valor monitorizado cae por debajo de este nivel. |
| high | Valor de umbral superior. Se genera una alarma cuando el valor monitorizado supera este nivel. |
| eventCode | Identificador de cadena único utilizado por GCXONE para comunicar este tipo de alarma a integraciones CMS (IMMIX / Evalink / AmWin / LISA). Este código aparece en las notificaciones de alarma salientes. |
| groupCode | Identificador de agrupación lógica para flujos de trabajo de Monitoreo de Torre — usado para filtrar y organizar alarmas relacionadas dentro del Gestor de Alarmas de Torre de GCXONE. |

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

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

| Parámetro | Descripción | Valor de ejemplo |
| --- | --- | --- |
| low | Voltaje mínimo aceptable de la batería (V). Se genera una alarma cuando el voltaje cae por debajo de este valor. | 12 |
| high | Voltaje máximo aceptable de la batería (V). La alarma se activa cuando el voltaje supera este valor. | 14 |
| eventCode | Identificador de alarma CMS para eventos de voltaje | battery.voltage.warning |
| groupCode | Grupo interno de alarma de Torre para filtrado y enrutamiento | 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**

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

| Parámetro | Descripción | Valor de ejemplo |
| --- | --- | --- |
| bajo | Porcentaje mínimo aceptable de SOC. La alarma se activa cuando el SOC cae por debajo de este valor. | 15 |
| eventCode | Identificador de alarma CMS para eventos de SOC bajo | battery.soc.warning |
| groupCode | Identificador interno del grupo de alarma de Torre | 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:

| Regla | Código de evento | Código de grupo |
| --- | --- | --- |
| Advertencia de voltaje de la batería | battery.voltage.warning | tower.solar.voltage.alert |
| Advertencia de estado de carga de la batería | battery.soc.warning | tower.battery.soc.alert |

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

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

| Síntoma / Verificación | Resolución |
| --- | --- |
| La Conexión falla inmediatamente después de Guardar | Verifique que las credenciales del portal VRM sean correctas y tengan acceso administrativo. Inicie sesión directamente en el portal Victron VRM para confirmarlo. |
| Número de serie no reconocido | Confirme que el número de serie coincida exactamente con lo que figura en el portal Victron VRM. Verifique espacios iniciales o finales o caracteres incorrectos. |
| Error de autenticación | Asegúrese de que la cuenta utilizada tenga privilegios administrativos — las cuentas de solo lectura no son compatibles. |
| No hay datos de telemetría después de una conexión exitosa | Verifique que el dispositivo Victron esté en línea y reportando activamente al portal VRM. Consulte el Estado del dispositivo en el portal VRM directamente. |

### Reglas de Alarmas no se activan

| Síntoma / Verificación | Resolución |
| --- | --- |
| No se reciben alarmas para un umbral superado | Verifique que la regla tenga "active": true en el JSON. Compruebe que el JSON de Reglas de Alarma Personalizadas sea válido (sin errores de sintaxis). |
| eventCode no aparece en el CMS | Confirme que el código de evento esté configurado en su integración CMS. Verifique la asignación de canales CMS en GCXONE bajo la configuración de Integración del sitio. |
| Alertas de voltaje se disparan inesperadamente | Ajuste los umbrales bajo y alto para que coincidan mejor con el rango de voltaje de operación normal de su sistema de baterías. |
| Alarma SOC no se despeja después de la carga | Permita algunos ciclos de sondeo para que GCXONE recupere el valor SOC actualizado de la API VRM. Si la alarma persiste, actualice manualmente el Estado del dispositivo en GCXONE. |

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.