Teltonika

Introducción

Los routers Teltonika IoT sirven como columna vertebral de conectividad para el Monitoreo de Torre GCXONE, proporcionando estado celular en tiempo real, seguimiento GPS, cambios de estado de entrada/salida y datos de calidad de señal desde sitios de torre remotos. Esta guía recorre el proceso completo de incorporación de un router Teltonika IoT — desde añadir el Dispositivo en GCXONE e ingresar las credenciales requeridas, hasta configurar reglas de Alarma para pérdida de red, geo‑fencing, uso de datos SIM y detección de interferencias.

Qué monitorizan los Dispositivos Teltonika

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

• Estado de conectividad de red y calidad de señal (RSRQ, RSRP)
• Uso de datos de la tarjeta SIM frente a los límites Mensual configurados
• Cambios de estado de los puertos de entrada/salida (I/O) físicos — digital, analógico, aislado, relé
• Posición GPS relativa al límite del sitio asignado (geo‑fencing)
• Detección de interferencias (jammer) basada en patrones de degradación súbita de la señal

Nota: Teltonika gestiona la comunicación, el seguimiento GPS y el enrutamiento de telemetría de borde para la torre. Esto lo convierte en la columna vertebral del monitoreo de conectividad — sin él, GCXONE no puede detectar cortes de red, interferencias de señal o movimiento no autorizado del dispositivo.

Requisitos previos

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

Importante: Asegúrese de que el router Teltonika esté en línea, sea accesible desde el servidor GCXONE (IP directa o vía VPN), y de que las credenciales administrativas proporcionadas tengan acceso completo a la API.

Guía de configuración Teltonika con GCXONE

Siga estos pasos para añadir un router Teltonika IoT 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: Navegar a la Instalación

En GCXONE, navegue al Sitio donde el Dispositivo Teltonika está instalado físicamente. Esta es la entidad padre bajo la cual se registrará el Dispositivo.

• Ir a Configuración → Instalaciones
• Localizar y abrir la instalación objetivo
• Hacer clic en Editar para abrir el panel de Configuración de la instalación

Paso 2: Abrir el cuadro de diálogo del Dispositivo

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

Paso 3: Seleccionar tipo de Dispositivo

En el cuadro de diálogo del dispositivo, abra el desplegable Tipo de Dispositivo y seleccione Teltonika-IOT para cargar los campos de configuración correspondientes.

Paso 4: Introducir detalles del Dispositivo

Complete todos los campos obligatorios para establecer una conexión segura entre GCXONE y el router Teltonika. 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 desplegable, un Habilitar audio interruptor (activado por defecto), un Zona horaria, un Dispositivo Configuración 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 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 establecer una conexión con el router Teltonika usando las credenciales proporcionadas.

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 (intensidad de señal, estado de red, estados de E/S)
• El dispositivo queda disponible para la configuración de reglas de alarma

Importante: Si la conexión falla, verifique que la dirección IP sea accesible, que el puerto esté abierto y que las credenciales sean correctas. Compruebe que no haya reglas de firewall que bloqueen el acceso de GCXONE al dispositivo.

Configuración de Reglas de Alarma

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

Las reglas de alarma pueden configurarse a nivel de Sitio o a nivel de Dispositivo. Las reglas de conectividad Teltonika 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 sección Propiedades adicionales.
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 preconfiguradas. 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.

Consejo: Por defecto, todas las reglas de alarma están inactivas. Debe establecer explícitamente "active": true para cada regla que desea que GCXONE monitorice. 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:

Nota:Los códigos de Evento se utilizan para notificaciones CMS entre sistemas (p. ej., IMMIX, Evalink). Los códigos de Grupo son identificadores internos de GCXONE para flujos de trabajo de Alarma de torre. Ambos deben estar presentes para una integración completa.

Reglas de Alarma de Conectividad Teltonika

Las siguientes reglas de Alarma están disponibles para dispositivos IoT Teltonika en la sección de Monitoreo de Conectividad del JSON de Reglas de Alarma Personalizadas. Cada regla supervisa un aspecto específico de la salud de la red, I/O físico o seguridad.

Regla 1: Cambio de Estado de Entrada/Salida

Supervisa cambios de estado físico en los puertos I/O de Teltonika. Esta regla cubre entradas y salidas digitales, analógicas, aisladas y de relé — esencial para detectar aperturas de puertas, eventos de energía, disparos de sensores externos y cambios de estado de equipos.

Configuración JSON Predeterminada

"IOStatusChange": {
  "input": {
    "AnalogCurrentLoop": {"active": false, "low": 4, "high": 20},
    "AnalogInput": {"active": false, "low": 11, "high": 14},
    "DigitalInput": {"active": false, "ranges": ["Low level", "High level"], "alertOn": "High Level"},
    "IsolatedInput": {"active": false, "ranges": ["Low level", "High level"], "alertOn": "High Level"},
    "PowerSocketInput": {"active": false, "ranges": ["Low level", "High level"], "alertOn": "High Level"},
    "eventCode": "input.statechange",
    "groupCode": "tower.input.statechange"
  },
  "output": {
    "IsolatedOutput": {"active": false, "ranges": ["Low level", "High level"], "alertOn": "High Level"},
    "Relay": {"active": false, "ranges": ["open", "closed"], "alertOn": "open"},
    "PowerSocketOutput": {"active": false, "ranges": ["Low level", "High level"], "alertOn": "High Level"},
    "eventCode": "output.statechange",
    "groupCode": "tower.output.statechange"
  }
}

Tipos de Entrada

Tipos de Salida

Regla 2: Uso del Paquete de Datos de la Tarjeta SIM

Rastrea el consumo mensual de datos móviles de la tarjeta SIM del router Teltonika. Genera una advertencia cuando el uso de datos alcanza el porcentaje configurado del total mensual permitido — evitando cargos inesperados por exceso o interrupciones del servicio.

Configuración JSON predeterminada

"simCardDataPackage": {
  "active": false,
  "simBillingStartDate": 1,
  "simDataPackageGB": 10,
  "usageWarningPercent": 80,
  "eventCode": "sim.data.usage.warning",
  "groupCode": "tower.connectivity.simdata.alert"
}

Parámetros de Configuración

Comportamiento de Ejemplo

• Con simDataPackageGB configurado en 10 y usageWarningPercent en 80, GCXONE genera una Alarma cuando el uso acumulado de datos SIM supera los 8 GB en el período de facturación.
• La Alarma se borra automáticamente cuando el uso de datos se restablece al inicio del nuevo ciclo de facturación.
• Reduzca el umbral (p. ej., 70 %) para una advertencia temprana en sitios con alternativas de conectividad limitadas.

Regla 3: Pérdida de Red Celular

Detecta cuando el router Teltonika pierde la conectividad de red móvil o la señal cae a un nivel inaceptable. Inmediatamente genera una Alarma a los operadores sobre posibles fallas de comunicación del sitio.

Configuración JSON predeterminada

"cellNetworkLoss": {
  "active": false,
  "eventCode": "modem.signal.warning",
  "groupCode": "tower.connectivity.signal.alert"
}

Comportamiento de Ejemplo

• GCXONE genera una Alarma cuando la señal celular cae por debajo del umbral aceptable o se pierde la conectividad por completo.
• La Alarma se borra automáticamente una vez que la señal vuelve a un nivel aceptable.
• Esta regla no tiene parámetros de umbral — depende de la evaluación de calidad de señal incorporada en GCXONE para el estado del módem reportado por el router.

Regla 4: Geocercado

Monitorea la posición GPS del router Teltonika respecto a la Ubicación asignada del sitio. Genera una Alarma si el Dispositivo se desplaza fuera del radio configurado — detectando posible desplazamiento de la Torre, robo o movimiento no autorizado.

Configuración JSON predeterminada

"geoFencing": {
  "active": false,
  "radiusMetersWarning": 500,
  "eventCode": "geo.fence.breach",
  "groupCode": "tower.connectivity.geofence.alert"
}

Comportamiento de ejemplo

• El límite de la geo-cerca está centrado en las coordenadas definidas en la configuración del Site Pariente en GCXONE.
• Si la posición GPS informada por el router Teltonika supera los 500 metros del centro del sitio, se genera una Alarma de violación.
• La Alarma se elimina automáticamente cuando el Dispositivo vuelve dentro del límite definido.
• Reduzca el radio para instalaciones fijas permanentes; utilice un radio mayor para despliegues de Torre móviles o semimóviles.

Panel de Teltonika

Cada dispositivo Teltonika tiene su propia pestaña Panel (Configuration → el sitio del dispositivo → Dispositivos → el dispositivo Teltonika → Panel) que muestra el estado de la Conexión VPN y celular (LTE) en tiempo real, el uso de datos, la temperatura del módem, los detalles de la SIM y del tiempo de actividad, y la posición GPS más reciente del Dispositivo en un mapa. Un campo Site Radius Meters en esta pantalla permite ver y actualizar el radio de la geo-cerca directamente — ingrese un valor en metros y haga clic en Submit, en lugar de editar la configuración JSON manualmente. Si la última posición informada del Dispositivo está fuera del radio configurado, el panel muestra una barra de advertencia con la distancia actual al sitio. Un botón Capture Now solicita una nueva lectura GPS bajo demanda, y Set Site to Current GPS actualiza las coordenadas del sitio para que coincidan con la última posición conocida del Dispositivo.

Regla 5: Detección de interferencias

Detecta posibles intentos de interferencia de radiofrecuencia basados en una degradación repentina de la señal y una baja calidad de señal recibida (RSRQ). La detección de interferencias es crítica para despliegues de Torre sensibles a la Seguridad donde la interferencia de señal puede indicar intentos deliberados de interrupción.

Configuración JSON predeterminada

"jammerDetection": {
  "active": false,
  "criteria": {
    "signalDropThreshold": 25,
    "minSignalLevel": -113,
    "rsrqThreshold": -20
  },
  "eventCode": "modem.jammer.detected",
  "groupCode": "tower.connectivity.jamming.alert"
}

Comportamiento de ejemplo

• GCXONE evalúa tanto el nivel absoluto de señal (RSRQ) como la tasa de cambio de la señal (porcentaje de caída) para distinguir interferencias reales de la variación normal de la señal.
• Se genera una Alarma cuando la caída de señal supera el 25 % O el RSRQ cae por debajo de -20 y el nivel de señal está bajo -113 dBm simultáneamente.
• La Alarma se elimina automáticamente una vez que se restablece la estabilidad normal de la señal.

Nota:Los umbrales de detección de interferencias pueden necesitar ajuste según las condiciones locales del entorno RF. Los sitios en áreas urbanas con variación natural de señal pueden requerir un signalDropThreshold más alto para reducir falsos positivos.

Referencia de Configuración

JSON Completo de Reglas de Alarma de Conectividad Teltonika

A continuación se muestra la configuración JSON predeterminada completa para todas las reglas de alarma de conectividad Teltonika. Copie esto en la propiedad Reglas de Alarma Personalizado y modifíquelo según sea necesario para su despliegue.

"connectivityMonitoring": {
  "IOStatusChange": {
    "input": {
      "AnalogCurrentLoop": {"active": false, "low": 4, "high": 20},
      "AnalogInput": {"active": false, "low": 11, "high": 14},
      "DigitalInput": {"active": false, "ranges": ["Low level", "High level"], "alertOn": "High Level"},
      "IsolatedInput": {"active": false, "ranges": ["Low level", "High level"], "alertOn": "High Level"},
      "PowerSocketInput": {"active": false, "ranges": ["Low level", "High level"], "alertOn": "High Level"},
      "eventCode": "input.statechange",
      "groupCode": "tower.input.statechange"
    },
    "output": {
      "IsolatedOutput": {"active": false, "ranges": ["Low level", "High level"], "alertOn": "High Level"},
      "Relay": {"active": false, "ranges": ["open", "closed"], "alertOn": "open"},
      "PowerSocketOutput": {"active": false, "ranges": ["Low level", "High level"], "alertOn": "High Level"},
      "eventCode": "output.statechange",
      "groupCode": "tower.output.statechange"
    }
  },
  "simCardDataPackage": {
    "active": false,
    "simBillingStartDate": 1,
    "simDataPackageGB": 10,
    "usageWarningPercent": 80,
    "eventCode": "sim.data.usage.warning",
    "groupCode": "tower.connectivity.simdata.alert"
  },
  "cellNetworkLoss": {
    "active": false,
    "eventCode": "modem.signal.warning",
    "groupCode": "tower.connectivity.signal.alert"
  },
  "geoFencing": {
    "active": false,
    "radiusMetersWarning": 500,
    "eventCode": "geo.fence.breach",
    "groupCode": "tower.connectivity.geofence.alert"
  },
  "jammerDetection": {
    "active": false,
    "criteria": {
      "signalDropThreshold": 25,
      "minSignalLevel": -113,
      "rsrqThreshold": -20
    },
    "eventCode": "modem.jammer.detected",
    "groupCode": "tower.connectivity.jamming.alert"
  }
}

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 conectividad Teltonika:

Mejores Prácticas de Configuración

• Siempre comience con Aplicar Predeterminado para cargar el conjunto completo de reglas preconfiguradas antes de realizar cambios.
• Permita reglas de forma incremental: comience con reglas críticas (pérdida de red, detección de interferencias) antes de habilitar reglas sensibles a umbrales como cambios de estado I/O.
• Pruebe las reglas de alarma en un entorno de pruebas o en un solo dispositivo antes de desplegarlas en todos los sitios.
• Establezca usageWarningPercent para datos SIM en 70–80 % para dar a los operadores tiempo suficiente para actuar antes de que se agote el plan.
• Para geocercas en sitios permanentes, use un radio pequeño (100–200 m). Para despliegues temporales, use 500 m o más.
• 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.

Configuración de OpenVPN en el Router Teltonika

Desde el lado de NXGEN, le proporcionaremos un archivo de configuración OpenVPN (ovpn) y un segmento de IP LAN que debe asignarse a la red del cliente.

Configuración Paso a Paso

Paso 1: Cambie la IP LAN predeterminada del Router Teltonika a la IP proporcionada por el equipo de NXGEN

• Abra la consola web del router.
• Navegue a Red → Interfaces → General → Editar LAN.
• Introduzca la IP LAN y la subred → Guardar.

Paso 2: Importar el archivo de configuración OpenVPN proporcionado por el equipo NXGEN

• En la consola web, navegue a Servicios → VPN → OPENVPN.
• En la opción Añadir nueva interfaz, indique el "VPN Name" y establezca el Rol a "Client" → Añadir.

• Seleccione "Enable OpenVPN configuration file" → Explore y adjunte el archivo ovpn.
• Seleccione Permitir y Guarde.

• Después de unos minutos, el estado cambiará a "Connected".

Paso 3: Probar la conectividad

• Navegue a Sistema → Administración → Solucionar problemas.
• En Diagnósticos, seleccione el método "Ping" → Introduzca la IP "10.10.22.42" → Ejecutar.

• La conexión VPN está configurada correctamente si recibe una respuesta de ping exitosa.

Solución de problemas

El Dispositivo no se conecta

Reglas de Alarma no se activan

Regla de datos SIM no se activa

• Asegúrese de que el router Teltonika informe métricas de uso de datos SIM a GCXONE.
• Verifique que simDataPackageGB coincida con el tamaño real de su plan SIM.
• El campo simBillingStartDate está actualmente Inactivo — el seguimiento del uso de datos utiliza el mes calendario por ahora.

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