Teltonika

Introduction

Les routeurs IoT Teltonika constituent l'épine dorsale de la connectivité pour la surveillance des tours GCXONE, fournissant en temps réel l'état cellulaire, le suivi GPS, les changements d'état des entrées/sorties et les données de qualité du signal depuis les sites de tours distants. Ce guide décrit le processus complet d'intégration d'un routeur IoT Teltonika — de l'ajout de l'appareil dans GCXONE et la saisie des informations d'identification requises, à la configuration des règles d'alarme pour perte de réseau, géorepérage, utilisation des données SIM et détection de brouilleur.

Ce que les appareils Teltonika surveillent

Une fois connecté à GCXONE, les routeurs Teltonika transmettent en continu les catégories de télémétrie suivantes :

• État de connectivité réseau et qualité du signal (RSRQ, RSRP)
• Utilisation des données de la carte SIM par rapport aux limites mensuelles configurées
• Changements d'état des ports d'entrée/sortie (I/O) physiques — numérique, analogique, isolé, relais
• Position GPS par rapport à la limite du site assigné (géorepérage)
• Détection de brouilleur basée sur des schémas soudains de dégradation du signal

Remarque : Teltonika gère la communication, le suivi GPS et le routage de la télémétrie en périphérie pour la tour. Cela en fait l'épine dorsale de la surveillance de la connectivité — sans lui, GCXONE ne peut pas détecter les pannes réseau, les interférences de signal ou les déplacements non autorisés d'appareils.

Prérequis

Avant de commencer l'intégration de l'appareil, assurez‑vous que les informations et accès suivants sont disponibles :

Important : Assurez‑vous que le routeur Teltonika est en ligne, accessible depuis le serveur GCXONE (IP directe ou via VPN), et que les informations d'identification administratives fournies disposent d'un accès complet à l'API.

Guide de configuration Teltonika avec GCXONE

Suivez ces étapes pour ajouter un routeur IoT Teltonika à 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ù l’appareil Teltonika est physiquement installé. Il s’agit de l’entité parent sous laquelle l’appareil 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éder à la section Appareils et cliquer sur Ajouter pour ouvrir la boîte de dialogue de création d’appareil.

Étape 3 : Sélectionner Type d'appareil

Dans la boîte de dialogue de l'Appareil, ouvrez le menu déroulant Type d'appareil et sélectionnez Teltonika-IOT 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 le routeur Teltonika. Chaque champ est décrit en détail ci‑dessous.

Étape 5 : En dessous des 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 commutateur (activé par défaut), un champ obligatoire Fuseau horaire, un Configuration de l’appareil section (Configuration Site Pulse), un Paramètres avancés section (Interrogation des événements, Configurer le Masque Heatmap, Bilan de santé périodique, Temps rétention de l’événement — 30 jours par défaut), et un Emplacement section (Latitude, Longitude, Plus Code, What3Words).

Étape 6 : Enregistrer et vérifier la connexion

Après avoir rempli tous les champs, cliquez sur Enregistrer. GCXONE tentera immédiatement d’établir une connexion avec le routeur Teltonika en utilisant les informations d’identification fournies.

Une connexion réussie entraîne :

• L’appareil apparaît dans la liste des appareils du site avec un indicateur d’état actif
• Des données de télémétrie en direct commencent à être transmises à GCXONE (force du signal, état du réseau, états I/O)
• L’appareil devient disponible pour la configuration des règles d’Alarme

Important : Si la connexion échoue, vérifiez que l’adresse IP est accessible, que le port est ouvert et que les informations d’identification sont correctes. Assurez‑vous qu’aucune règle de pare‑feu ne bloque l’accès de GCXONE à l’appareil.

Configuration des règles d’Alarme

GCXONE utilise une configuration de règles 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 SITE ou de l’Appareil. Les règles de connectivité Teltonika 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. Naviguez vers le SITE ou l’Appareil cible dans GCXONE.
2. Cliquez sur Modifier et accédez à la section Propriétés supplémentaires.
3. Repérez la propriété nommée Règles d’Alarme personnalisées.
4. Ouvrez le menu à trois points (⋮) de la propriété et sélectionnez Appliquer par défaut pour charger l’ensemble de règles préconfigurées. Toutes les règles sont inactives par défaut.
5. Modifiez le JSON pour activer des règles spécifiques en définissant "active": true pour les paramètres concernés.
6. Définissez vos seuils, codes d’événement et codes de groupe selon les besoins.
7. Cliquez sur Enregistrer. GCXONE commencera immédiatement à évaluer la télémétrie entrante selon les règles configurées.

Astuce : Par défaut, toutes les règles d’Alarme sont inactives. Vous devez explicitement définir "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 :

Note :Les Event Codes sont utilisés pour les notifications CMS inter‑systèmes (p. ex. IMMIX, Evalink). Les Group Codes sont des identifiants internes à GCXONE pour les flux de travail d'alarme de la tour. Les deux doivent être présents pour une intégration complète.

Règles d'Alarme de Connectivité Teltonika

Les règles d'alarme suivantes sont disponibles pour les appareils IoT Teltonika dans la section Surveillance de la Connectivité du JSON des Règles d'Alarme Personnalisées. Chaque règle surveille un aspect spécifique de la santé du réseau, des E/S physiques ou de la Sécurité.

Règle 1 : Changement d'État d'Entrée/Sortie

Surveille les changements d'état physiques sur les ports E/S de Teltonika. Cette règle couvre les entrées et sorties numériques, analogiques, isolées et à relais — indispensable pour détecter les ouvertures de porte, les événements d'alimentation, les déclenchements de capteurs externes et les changements d'état des équipements.

Configuration JSON Par Défaut

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

Types d'Entrée

Types de Sortie

Règle 2 : Utilisation du forfait de données de la carte SIM

Suit la consommation mensuelle de données mobiles de la carte SIM du routeur Teltonika. Déclenche un avertissement lorsque l'utilisation des données atteint le pourcentage configuré de l'allocation mensuelle totale — évitant les frais de dépassement inattendus ou les interruptions de service.

Configuration JSON par défaut

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

Paramètres de configuration

Comportement d’exemple

• Avec simDataPackageGB réglé à 10 et usageWarningPercent réglé à 80, GCXONE déclenche une alerte lorsque l’utilisation cumulative des données SIM dépasse 8 Go pendant la période de facturation.
• L’alerte se désactive automatiquement lorsque l’utilisation des données est réinitialisée au début du nouveau cycle de facturation.
• Réduire le seuil (par ex., 70 %) pour obtenir un avertissement précoce sur les sites disposant de peu d’alternatives de connectivité.

Règle 3 : Perte du réseau cellulaire

Détecte lorsque le routeur Teltonika perd la connectivité du réseau mobile ou que le signal chute à un niveau inacceptable. Alerte immédiatement les opérateurs d’éventuelles pannes de communication du site.

Configuration JSON par défaut

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

Comportement d’exemple

• GCXONE déclenche une alerte lorsque le signal cellulaire descend en dessous du seuil acceptable ou que la connectivité est totalement perdue.
• L’alerte se désactive automatiquement dès que le signal revient à un niveau acceptable.
• Cette règle ne possède aucun paramètre de seuil — elle s’appuie sur l’évaluation intégrée de la qualité du signal de GCXONE pour l’état du modem signalé par le routeur.

Règle 4 : Géorepérage

Surveille la position GPS du routeur Teltonika par rapport à l’emplacement du site assigné. Déclenche une alerte si l’appareil se déplace au‑delà du rayon configuré — détectant un éventuel déplacement de la tour, un vol ou un mouvement non autorisé.

Configuration JSON par défaut

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

Exemple de comportement

• La limite de géofence est centrée sur les coordonnées définies dans la configuration du Site parent dans GCXONE.
• Si la position GPS signalée par le routeur Teltonika dépasse 500 m du centre du Site, une alerte de violation est générée.
• L'alerte se dissipe automatiquement lorsque l'Appareil revient à l'intérieur de la limite définie.
• Réduire le rayon pour les installations fixes permanentes ; utiliser un rayon plus grand pour les déploiements de tours mobiles ou semi‑mobiles.

Tableau de bord Teltonika

Chaque appareil Teltonika possède son propre onglet Tableau de bord (Configuration → le site de l'appareil → Appareils → l'appareil Teltonika → Tableau de bord) affichant l'état en direct de la connexion VPN et cellulaire (LTE), la consommation de données, la température du modem, les détails de la carte SIM et du temps de fonctionnement, ainsi que la position GPS la plus récente de l'appareil sur une carte. Un champ Site Radius Meters sur cet écran permet de visualiser et de mettre à jour le rayon du géofence directement — saisissez une valeur en mètres et cliquez sur Soumettre, au lieu de modifier la configuration JSON manuellement. Si la dernière position signalée par l'appareil se trouve en dehors du rayon configuré, le tableau de bord affiche une bannière d'avertissement indiquant la distance actuelle par rapport au site. Un bouton Capturer maintenant demande une nouvelle lecture GPS à la demande, et Définir le site sur le GPS actuel met à jour les coordonnées du site pour correspondre à la dernière position connue de l'appareil.

Règle 5 : Détection de brouilleur

Détecte les tentatives potentielles de brouillage des fréquences radio basées sur une dégradation soudaine du signal et une mauvaise Qualité du Signal Référencé Reçu (RSRQ). La détection de brouilleur est cruciale pour les déploiements de tours sensibles à la Sécurité où les interférences du signal peuvent indiquer des tentatives de perturbation délibérées.

Configuration JSON par défaut

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

Exemple de comportement

• GCXONE évalue à la fois le niveau absolu du signal (RSRQ) et le taux de variation du signal (pourcentage de chute) pour distinguer un vrai brouillage d'une variation normale du signal.
• Une alerte est déclenchée lorsque la chute du signal dépasse 25 % OU que le RSRQ tombe en dessous de -20 et que le niveau du signal est simultanément inférieur à -113 dBm.
• L'alerte se dissipe automatiquement une fois la stabilité normale du signal rétablie.

Note :Les seuils de détection de brouilleur peuvent nécessiter un ajustement en fonction des conditions locales de l'environnement RF. Les sites en zones urbaines avec une variation naturelle du signal peuvent nécessiter un signalDropThreshold plus élevé pour réduire les faux positifs.

Référence de configuration

JSON complet des Règles d'Alarme de connectivité Teltonika

Voici la configuration JSON par défaut complète pour toutes les Règles d'Alarme de connectivité Teltonika. Copiez‑la dans la propriété Règles d'Alarme Personnalisées et modifiez‑la selon les besoins de votre déploiement.

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

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 connectivité Teltonika :

Bonnes pratiques de configuration

• Commencer toujours par Appliquer le défaut pour charger l’ensemble complet de règles préconfigurées avant d’apporter des modifications.
• Activer les règles progressivement — commencer par les règles critiques (perte de réseau, détection de brouilleur) avant d’activer les règles sensibles aux seuils comme les changements d’état I/O.
• Tester les règles d’Alarme dans un environnement de préproduction ou sur un seul appareil avant de les déployer sur toutes les locations.
• Définir usageWarningPercent pour les données SIM à 70–80 % afin de laisser aux opérateurs suffisamment de temps pour agir avant l’épuisement du forfait.
• Pour le géorepérage sur les sites permanents, utiliser un petit rayon (100–200 m). Pour les déploiements temporaires, utiliser 500 m ou plus.
• Documenter vos codes d’événement et de groupe dans la configuration de votre CMS afin d’assurer le bon acheminement des Alarmes.

Configuration OpenVPN sur le routeur Teltonika

Du côté NXGEN, nous vous fournirons un fichier de configuration OpenVPN (ovpn) et un segment d’IP LAN à attribuer au réseau du Client.

Configuration étape par étape

Étape 1 : Modifier l’IP LAN par défaut du routeur Teltonika avec l’IP fournie par l’équipe NXGEN

• Ouvrir la console web du routeur.
• Naviguer vers Réseau → Interfaces → Général → Modifier LAN.
• Saisir l’IP LAN et le masque de sous‑réseau → Enregistrer.

Étape 2 : Importer le fichier de configuration OpenVPN fourni par l'équipe NXGEN

• Dans la console web, accéder à Services → VPN → OPENVPN.
• Sous l'option Ajouter une nouvelle interface, saisir le "VPN Name" et définir le Rôle sur "Client" → Ajouter.

• Sélectionner "Activer le fichier de configuration OpenVPN" → Parcourir et attacher le fichier ovpn.
• Sélectionner Activer et Enregistrer.

• Après quelques minutes, le statut passe à "Connected".

Étape 3 : Tester la connectivité

• Accéder à Système → Administration → Dépannage.
• Dans Diagnostics, choisir la méthode "Ping" → Saisir l'IP "10.10.22.42" → Exécuter.

• La connexion VPN est correctement configurée si vous obtenez une réponse ping réussie.

Dépannage

L'Appareil ne se connecte pas

Les Règles d'Alarme ne se déclenchent pas

Règle de données SIM non activée

• S'assurer que le routeur Teltonika transmet les métriques d'utilisation des données SIM à GCXONE.
• Vérifier que simDataPackageGB correspond à la taille réelle de votre forfait SIM.
• Le champ simBillingStartDate est actuellement Inactif — le suivi de la consommation de données utilise le mois calendaire pour le moment.

Pour obtenir une assistance supplémentaire, contacter votre représentant NXGEN ou consulter le Guide complet de configuration du suivi de la tour GCXONE qui couvre la surveillance des systèmes Victron Energy et EFOY Fuel Cell ainsi que la connectivité IoT Teltonika.