Teltonika

Einleitung

Teltonika IoT-Router dienen als Konnektivitäts‑Rückgrat für GCXONE Tower Monitoring und liefern Echtzeit‑Mobilfunkstatus, GPS‑Tracking, I/O‑Zustandsänderungen und Signalqualitätsdaten von entfernten Turmstandorten. Dieses Handbuch führt durch den kompletten Onboarding‑Prozess für einen Teltonika IoT‑Router – vom Hinzufügen des Geräts in GCXONE und Eingeben der erforderlichen Anmeldedaten bis zur Konfiguration von Alarmregeln für Netzausfall, Geofencing, SIM‑Datennutzung und Jammer‑Erkennung.

Was Teltonika Geräte überwachen

Nach der Anbindung an GCXONE melden Teltonika‑Router kontinuierlich die folgenden Telemetrie‑Kategorien:

• Netzwerkverbindungsstatus und Signalqualität (RSRQ, RSRP)
• SIM‑Kartendatenverbrauch im Vergleich zu konfigurierten monatlichen Limits
• Physische Eingangs‑/Ausgangsport‑Zustandsänderungen – digital, analog, isoliert, Relais
• GPS‑Position relativ zur zugewiesenen Objektgrenze (Geofencing)
• Jammer‑Erkennung basierend auf plötzlichen Signalverschlechterungs‑Mustern

Hinweis:Teltonika übernimmt Kommunikation, GPS‑Tracking und Edge‑Telemetrie‑Routing für den Turm. Damit ist es das Rückgrat der Konnektivitäts‑Überwachung – ohne es kann GCXONE Netzwerkausfälle, Signalinterferenzen oder nicht autorisierte Gerätebewegungen nicht erkennen.

Voraussetzungen

Stellen Sie vor Beginn des Geräte‑Onboardings sicher, dass die folgenden Informationen und Zugriffe verfügbar sind:

Wichtig:Stellen Sie sicher, dass der Teltonika‑Router online ist, vom GCXONE‑Server aus erreichbar ist (direkte IP oder via VPN), und dass die bereitgestellten administrativen Anmeldedaten vollen API‑Zugriff besitzen.

Teltonika‑Konfigurations‑Leitfaden mit GCXONE

Befolgen Sie diese Schritte, um einen Teltonika IoT‑Router zu GCXONE hinzuzufügen. Das Gerät wird unter einem bestehenden Objekt registriert und beginnt nach der Konfiguration sofort mit der Telemetrie‑Übermittlung.

Schritt 1:Zum Objekt navigieren

Navigieren Sie in GCXONE zu dem Objekt, in dem das Teltonika‑Gerät physisch installiert ist. Dies ist das übergeordnete Element, unter dem das Gerät registriert wird.

• Gehen Sie zu Konfiguration → Sites
• Suchen und öffnen Sie das Ziel‑Objekt
• Klicken Sie auf Bearbeiten, um das Konfigurations‑Panel des Objekts zu öffnen

Schritt 2:Dialogfeld Gerät öffnen

Navigieren Sie in der Standortkonfiguration zum Abschnitt Geräte und klicken Sie auf Neu hinzufügen, um den Dialog zur Geräteerstellung zu öffnen.

Schritt 3:Gerätetyp auswählen

Öffnen Sie im Gerätedialog das Dropdown Gerätetyp und wählen Sie Teltonika-IOT, um die entsprechenden Konfigurationsfelder zu laden.

Schritt 4:Gerätedetails eingeben

Füllen Sie alle erforderlichen Felder aus, um eine sichere Verbindung zwischen GCXONE und dem Teltonika‑Router herzustellen. Jedes Feld wird nachfolgend detailliert beschrieben.

Schritt 5: Unter den Verbindungsfeldern enthält der Dialog außerdem ein Entitätsgruppe auswählen Dropdown, ein Enable Audio Schalter (standardmäßig aktiviert), ein erforderliches Zeitzone, ein Gerätekonfiguration Abschnitt (Site Pulse Konfiguration), ein Erweiterte Einstellungen Abschnitt (Ereignisabfrage, Heatmap-Maske konfigurieren, Periodische Statusabfrage, Ereignis Haltezeit — standardmäßig 30 Tage), und ein optionaler Standort Abschnitt (Breitengrad, Längengrad, Plus Code, What3Words).

Schritt 6:Speichern und Verbindung prüfen

Nachdem alle Felder ausgefüllt wurden, klicken Sie auf Speichern. GCXONE versucht sofort, eine Verbindung zum Teltonika‑Router mit den angegebenen Anmeldedaten herzustellen.

Eine erfolgreiche Verbindung führt zu:

• Das Gerät erscheint in der Geräte‑Liste der Site mit einem aktiven Statusanzeiger
• Live‑Telemetriedaten beginnen in GCXONE zu fließen (Signalstärke, Netzwerkstatus, I/O‑Zustände)
• Das Gerät wird für die Konfiguration von Alarmregeln verfügbar

Wichtig: Wenn die Verbindung fehlschlägt, prüfen Sie, ob die IP Adresse erreichbar ist, der Port offen ist und die Anmeldedaten korrekt sind. Stellen Sie sicher, dass keine Firewall‑Regeln den Zugriff von GCXONE auf das Gerät blockieren.

Alarmregeln-Konfiguration

GCXONE verwendet eine JSON‑basierte Alarmregel‑Konfiguration, um festzulegen, welche Telemetrieparameter überwacht werden, welche Schwellenwerte Warnungen auslösen und wie diese Warnungen in CMS‑Integrationen identifiziert werden.

Alarmregeln können auf Site‑Ebene oder Geräte‑Ebene konfiguriert werden. Teltonika‑Konnektivitätsregeln werden typischerweise auf Geräte‑Ebene für präzise Steuerung angewendet.

So wenden Sie Alarmregeln an

1. Navigieren Sie zur Ziel‑Site oder zum Ziel‑Gerät in GCXONE.
2. Klicken Sie auf Bearbeiten und gehen Sie zum Abschnitt Zusätzliche Eigenschaften.
3. Suchen Sie die Eigenschaft mit dem Namen Custom Alarm Rules.
4. Öffnen Sie die drei Punkte (⋮) der Eigenschaft und wählen Sie Apply Default, um das vorkonfigurierte Regelset zu laden. Alle Regeln sind standardmäßig inaktiv.
5. Ändern Sie das JSON, um bestimmte Regeln zu aktivieren, indem Sie für die relevanten Parameter "active": true setzen.
6. Legen Sie Ihre Schwellenwerte, Ereigniscodes und Gruppencodes nach Bedarf fest.
7. Klicken Sie auf Speichern. GCXONE beginnt sofort, eingehende Telemetrie anhand der konfigurierten Regeln zu bewerten.

Tipp: Standardmäßig sind alle Alarmregeln inaktiv. Sie müssen explizit "active": true für jede Regel setzen, die GCXONE überwachen soll. Dies verhindert versehentliche Warnungen während der Ersteinrichtung.

Regelstruktur

Jede Alarmregel folgt einer einheitlichen JSON-Struktur. Das Verständnis der gemeinsamen Felder hilft beim Anpassen von Regeln:

Hinweis:Event‑Codes werden für CMS‑übergreifende Benachrichtigungen verwendet (z. B. IMMIX, Evalink). Group‑Codes sind GCXONE‑interne Identifier für Tower‑Alarm‑Workflows. Beide müssen für eine vollständige Integration vorhanden sein.

Teltonika‑Konnektivitäts‑Alarmregeln

Die folgenden Alarmregeln stehen für Teltonika‑IoT‑Geräte im Abschnitt Connectivity Monitoring des Custom Alarm Rules JSON zur Verfügung. Jede Regel überwacht einen bestimmten Aspekt der Netzwerk‑Gesundheit, physischen I/O oder Sicherheit.

Regel 1: Eingangs‑/Ausgangs‑Statusänderung

Überwacht physische Zustandsänderungen an Teltonika‑I/O‑Ports. Diese Regel deckt digitale, analoge, isolierte und Relais‑Eingänge sowie -Ausgänge ab – unverzichtbar zum Erkennen von Türöffnungen, Stromereignissen, externen Sensorsignalen und Geräte‑Zustandsänderungen.

Standard‑JSON‑Konfiguration

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

Eingabetypen

Ausgabetypen

Regel 2: SIM‑Karten‑Datentarif‑Nutzung

Verfolgt den monatlichen Mobil‑Datenverbrauch der SIM‑Karte des Teltonika‑Routers. Löst eine Warnung aus, wenn die Datennutzung den konfigurierten Prozentsatz des gesamten monatlichen Kontingents erreicht – verhindert unerwartete Überziehungsgebühren oder Serviceunterbrechungen.

Standard JSON Konfiguration

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

Konfigurationsparameter

Beispielverhalten

• Wenn simDataPackageGB auf 10 und usageWarningPercent auf 80 gesetzt ist, löst GCXONE eine Warnen aus, wenn die kumulative SIM‑Datenutzung im Abrechnungszeitraum 8 GB überschreitet.
• Die Warnen wird automatisch gelöscht, wenn die Datenutzung zu Beginn des neuen Abrechnungszyklus zurückgesetzt wird.
• Setzen Sie die Schwelle niedriger (z. B. 70 %), um bei Standorten mit begrenzten Kommunikationsalternativen frühzeitig zu warnen.

Regel 3: Verlust des Mobilfunknetzes

Erkennt, wenn der Teltonika‑Router die Mobilfunkverbindung verliert oder das Signal auf ein inakzeptables Niveau sinkt. Warnt Betreiber sofort vor möglichen Kommunikationsausfällen am Standort.

Standard JSON Konfiguration

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

Beispielverhalten

• GCXONE löst eine Warnen aus, wenn das Mobilfunksignal unter die akzeptable Schwelle fällt oder die Verbindung vollständig verloren geht.
• Die Warnen wird automatisch gelöscht, sobald das Signal wieder ein akzeptables Niveau erreicht.
• Diese Regel hat keine Schwellenparameter – sie nutzt die integrierte Signalqualitätsbewertung von GCXONE für den vom Router gemeldeten Modemstatus.

Regel 4: Geo‑Fencing

Überwacht die GPS‑Position des Teltonika‑Routers im Verhältnis zum zugewiesenen Standort. Löst eine Warnen aus, wenn das Gerät den konfigurierten Radius überschreitet – erkennt mögliche Turmverschiebungen, Diebstahl oder nicht autorisierte Bewegungen.

Standard JSON Konfiguration

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

Beispielverhalten

• Die Geo‑Fence‑Grenze ist zentriert auf den Koordinaten, die in der Konfiguration des übergeordneten Standorts in GCXONE definiert sind.
• Wenn die vom Teltonika-Router gemeldete GPS-Position mehr als 500 Meter vom Standortzentrum entfernt ist, wird eine Verstoß-Warnung ausgelöst.
• Die Warnung wird automatisch gelöscht, sobald das Gerät wieder innerhalb der definierten Grenze ist.
• Reduzieren Sie den Radius für permanente feste Installationen; verwenden Sie einen größeren Radius für mobile oder halbmobile Turm‑Einsätze.

Teltonika‑Dashboard

Jedes Teltonika‑Gerät hat einen eigenen Dashboard‑Tab (Konfiguration → Standort des Geräts → Geräte → das Teltonika‑Gerät → Dashboard), der den Live‑Status von VPN‑ und Mobilfunk‑(LTE‑)Verbindungen, Datenverbrauch, Modem‑Temperatur, SIM‑ und Laufzeitdetails sowie die zuletzt gemeldete GPS‑Position des Geräts auf einer Karte anzeigt. Ein Feld „Site Radius Meters“ auf diesem Bildschirm ermöglicht das direkte Anzeigen und Aktualisieren des Geo‑Fence‑Radius – geben Sie einen Wert in Metern ein und klicken Sie auf „Submit“, anstatt die JSON‑Konfiguration manuell zu bearbeiten. Wenn die zuletzt gemeldete Position des Geräts außerhalb des konfigurierten Radius liegt, zeigt das Dashboard ein Warnbanner mit dem aktuellen Abstand zum Standort an. Ein „Capture Now“-Button fordert bei Bedarf eine frische GPS‑Messung an, und „Set Site to Current GPS“ aktualisiert die Koordinaten des Standorts auf die zuletzt bekannte Position des Geräts.

Regel 5: Jammer‑Erkennung

Erkennt potenzielle Funkfrequenz‑Jamming‑Versuche anhand plötzlicher Signalverschlechterung und schlechter Reference Signal Received Quality (RSRQ). Die Jammer‑Erkennung ist für sicherheitskritische Turm‑Einsätze entscheidend, bei denen Signalstörungen auf gezielte Störungsversuche hinweisen können.

Standard‑JSON‑Konfiguration

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

Beispielverhalten

• GCXONE bewertet sowohl den absoluten Signalpegel (RSRQ) als auch die Änderungsrate des Signals (Abfall‑Prozentsatz), um echtes Jamming von normalen Signal­schwankungen zu unterscheiden.
• Eine Warnung wird ausgelöst, wenn der Signalabfall 25 % überschreitet ODER der RSRQ unter -20 fällt und gleichzeitig der Signalpegel unter -113 dBm liegt.
• Die Warnung wird automatisch gelöscht, sobald die normale Signalstabilität wiederhergestellt ist.

Hinweis:Jammer‑Erkennungs‑Schwellenwerte können je nach lokalen RF‑Umgebungsbedingungen angepasst werden. Standorte in städtischen Gebieten mit natürlicher Signalvariation können einen höheren signalDropThreshold benötigen, um Fehlalarme zu reduzieren.

Konfigurationsreferenz

Vollständige Teltonika Connectivity Alarm Regeln JSON

Das folgende ist die vollständige Standard‑JSON‑Konfiguration für alle Teltonika‑Konnektivitäts‑Alarm‑Regeln. Kopieren Sie diese in die Benutzerdefiniert Alarm Regeln‑Eigenschaft und passen Sie sie nach Bedarf für Ihre Bereitstellung an.

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

Zusammenfassung der Ereigniscodes und Gruppencodes

Kurzreferenz für alle Teltonika‑Konnektivitäts‑Ereigniscodes und Gruppencodes:

Konfigurations‑Bewährte Verfahren

• Beginnen Sie immer mit Apply Default, um das vollständige vorkonfigurierte Regelset zu laden, bevor Sie Änderungen vornehmen.
• Aktivieren Sie Regeln schrittweise — beginnen Sie mit kritischen Regeln (Netzwerkverlust, Jammer‑Erkennung), bevor Sie schwellenwertempfindliche Regeln wie I/O‑Zustandsänderungen aktivieren.
• Testen Sie Alarm‑Regeln in einer Staging‑Umgebung oder an einem einzelnen Gerät, bevor Sie sie an allen Standorten ausrollen.
• Setzen Sie usageWarningPercent für SIM‑Daten auf 70–80 %, um den Bedienern ausreichend Zeit zu geben, Maßnahmen zu ergreifen, bevor das Kontingent erschöpft ist.
• Verwenden Sie für Geo‑Fencing an permanenten Standorten einen kleinen Radius (100–200 m). Für temporäre Einsätze nutzen Sie 500 m oder mehr.
• Dokumentieren Sie Ihre Ereigniscodes und Gruppencodes in Ihrer CMS‑Konfiguration, um eine korrekte Alarm‑Weiterleitung sicherzustellen.

OpenVPN‑Konfiguration auf Teltonika‑Router

Von der NXGEN‑Seite stellen wir Ihnen eine OpenVPN‑(ovpn)‑Konfigurationsdatei und ein LAN‑IP‑Segment zur Verfügung, das dem Kundennetz zugewiesen werden muss.

Schritt‑für‑Schritt‑Konfiguration

Schritt 1: Ändern Sie die Standard‑LAN‑IP des Teltonika‑Routers auf die von dem NXGEN‑Team bereitgestellte IP.

• Öffnen Sie die Router‑Webkonsole.
• Navigieren Sie zu Netzwerk → Schnittstellen → Allgemein → LAN bearbeiten.
• Geben Sie die LAN‑IP und das Subnetz ein → Speichern.

Schritt 2: OpenVPN-Konfigurationsdatei importieren, bereitgestellt vom NXGEN-Team

• Im Web‑Console zu Services → VPN → OPENVPN navigieren.
• Unter der Option Add New Interface den "VPN Name" angeben und die Rolle auf "Client" setzen → Add.

• „Enable OpenVPN configuration file“ auswählen → Durchsuchen und die ovpn‑Datei anhängen.
• Aktivieren auswählen und speichern.

• Nach einigen Minuten ändert sich der Status zu "Connected".

Schritt 3: Konnektivität testen

• Zu System → Administration → Troubleshoot navigieren.
• Unter Diagnostics die Methode "Ping" auswählen → IP "10.10.22.42" eingeben → Ausführen.

• Die VPN‑Verbindung ist erfolgreich konfiguriert, wenn Sie eine erfolgreiche Ping‑Antwort erhalten.

Fehlerbehebung

Gerät verbindet sich nicht

Alarm Regeln lösen nicht aus

SIM‑Daten Regel aktiviert sich nicht

• Stellen Sie sicher, dass der Teltonika‑Router SIM‑Datenverbrauchsmetriken an GCXONE meldet.
• Verifizieren Sie, dass simDataPackageGB Ihrer tatsächlichen SIM‑Tarifgröße entspricht.
• Das Feld simBillingStartDate ist derzeit Inaktiv — die Datennutzungsverfolgung verwendet vorerst den Kalendermonat.

Für zusätzlichen Support kontaktieren Sie Ihren NXGEN‑Vertreter oder lesen Sie den vollständigen GCXONE Turm Überwachung Konfiguration Guide, der die Überwachung von Victron Energy und EFOY Fuel Cell sowie die Teltonika IoT‑Konnektivität abdeckt.