---
title: "Teltonika"
source: /de/gcxone/devices/teltonika
locale: de
updated: 2026-09-14
---
## **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:

| Anforderung | Details |
| --- | --- |
| GCXONE‑Zugriff | Administrator‑ oder Operator‑Rolle mit Zugriff auf das Konfiguration‑Modul |
| Geräte‑Anmeldedaten | Administrativer Benutzername und Passwort für den Teltonika‑Router |
| IP Adresse | Öffentliche oder VPN‑erreichbare IP Adresse des Teltonika‑Geräts |
| Seriennummer | Die eindeutige Hardware‑Seriennummer des Routers |
| Kontrol Port | HTTP‑Port, der für die Gerätekommunikation verwendet wird (Standard‑Port 80) |
| Objekt erstellt | Das Objekt, dem dieses Gerät zugewiesen wird, muss bereits in GCXONE existieren |

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

![Teltonika device type selection](/api/media/file/241db0f73ec2102c7e00c8575ff0f9bedb48e1a6-1920x1140.png)

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

![Teltonika device details form](/api/media/file/c143498beac1fd7b64b1c655bb983af40be71a15-1920x1140.png)

| Feld | Beschreibung | Hinweise |
| --- | --- | --- |
| Gerätetyp | Wählen Sie 'Teltonika-IOT' aus dem Dropdown | Muss exakt übereinstimmen — bestimmt, welches Telemetriemodell verwendet wird |
| Gerätename | Ein eindeutiger und beschreibender Name für dieses Gerät in GCXONE | Verwenden Sie eine Namenskonvention, die Standort und Gerät identifiziert – z. B. 'Tower-North-Router-01' |
| IP Adresse | Öffentliche oder VPN‑erreichbare IP Adresse des Teltonika‑Routers | Muss vom GCXONE‑Server erreichbar sein; verwenden Sie VPN, wenn das Gerät hinter NAT liegt |
| Seriennummer | Die auf dem Router aufgedruckte Hardware‑Seriennummer | Auf dem Geräteetikett oder im Teltonika‑Geräteverwaltungsportal zu finden |
| Kontrol Port | HTTP‑Port für die Gerätekommunikation | Standard ist in der Regel Port 80; prüfen Sie Ihre Netzwerkkonfiguration |
| RTSP-Port | RTSP‑Port für Videostreaming vom Gerät | Pflichtfeld |
| Server Port | Server‑Kommunikationsport für das Gerät | Pflichtfeld |
| HTTPS Port | HTTPS‑Port für die sichere Kommunikation mit dem Gerät | Pflichtfeld |
| Benutzername | Administrativer Anmelde‑Benutzername für den Router | Muss vollen Zugriff auf alle Geräteparameter und APIs haben |
| Passwort | Administratives Anmeldekennwort für den Router | Sicher in GCXONE gespeichert; verwenden Sie ein starkes und eindeutiges Kennwort |

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

![Custom Alarm Rules property](/api/media/file/173a7af67907b6ab0344527435e0ef87159acb45-975x492.png)

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

| Feld | Beschreibung |
| --- | --- |
| active | Boolean (true/false). Auf true setzen, um die Überwachung für diese Regel zu aktivieren. Bei false wird die Regel ignoriert. |
| eventCode | Eindeutiger Zeichenketten‑Identifier, der von GCXONE verwendet wird, um diesen Alarmtyp an CMS‑Integrationen (IMMIX / Evalink / AmWin / LISA) zu übermitteln. Dieser Code erscheint in ausgehenden Alarmbenachrichtigungen. |
| groupCode | Logischer Gruppierungs‑Identifier für Tower‑Überwachungs‑Workflows – wird verwendet, um verwandte Alarme im Tower‑Alarm‑Manager von GCXONE zu filtern und zu organisieren. |

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

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

| Eingabetyp | Beschreibung und Parameter |
| --- | --- |
| AnalogCurrentLoop | Überwacht 4–20 mA Stromschleifensensoren. Low/High auf den zulässigen Strombereich einstellen. Alarmiert, wenn der Strom außerhalb dieses Bereichs liegt. |
| AnalogInput | Überwacht analoge Spannungseingänge (z. B. 11–14 V). Low/High‑Schwellenwerte festlegen. Der Alarm wird ausgelöst, wenn die Spannung außerhalb des Bereichs liegt. |
| DigitalInput | Überwachung binärer Zustände. alertOn auf den Zustand setzen, der einen Alarm auslösen soll (z. B. 'High Level' zur Türöffnungs‑Erkennung). |
| IsolatedInput | Elektrisch isolierter digitaler Eingang. Gleiche Konfiguration wie DigitalInput. Wird verwendet, wenn eine Isolation vom Hauptkreis erforderlich ist. |
| PowerSocketInput | Überwacht den Zustand der Steckdose (Low/High‑Level). alertOn auf den auslösenden Zustand setzen. Geeignet zur Erkennung von Netzstrom. |

**Ausgabetypen**

| Ausgabetyp | Beschreibung und Parameter |
| --- | --- |
| IsolatedOutput | Überwacht den Zustand eines isolierten Ausgangskanals. alertOn auf 'High Level' setzen, um zu alarmieren, wenn der Ausgang aktiv ist. |
| Relay | Verfolgt den Relais‑Zustand (offen/geschlossen). alertOn auf 'open' setzen, um zu alarmieren, wenn das Relais nicht erregt ist. Nützlich für Schütze‑ oder Schloss‑Überwachung. |
| PowerSocketOutput | Überwacht den Ausgangszustand der Steckdose. Alarmiert, wenn der Ausgang den konfigurierten alertOn‑Zustand erreicht. |

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

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

**Konfigurationsparameter**

| Parametername | Beschreibung | Beispielwert |
| --- | --- | --- |
| simBillingStartDate | Startdatum des Abrechnungszyklus des SIM‑Tarifs (derzeit Inaktiv) | 1 |
| simDataPackageGB | Gesamte mobile Datenmenge pro Monat (in GB) | 10 |
| usageWarningPercent | Warnschwelle als Prozentsatz der Gesamtdatenutzung | 80 |
| eventCode | CMS‑Alarmkennzeichen für diesen ERREIGNISTYP | sim.data.usage.warning |
| groupCode | Interne Turm‑Alarmgruppe für Filterung und Weiterleitung | tower.connectivity.simdata.alert |

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

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

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

| Parametername | Beschreibung | Beispielwert |
| --- | --- | --- |
| radiusMetersWarning | Radius (in Metern) vom definierten Geo‑Fence‑Mittelpunkt – typischerweise dem Standort‑Geo‑Ort – innerhalb dessen der Turm verbleiben muss. | 500 |
| eventCode | CMS Alarm‑Kennung für Geo‑Fence‑Verstoß‑Ereignisse | geo.fence.breach |
| groupCode | Interner Turm‑Alarm‑Gruppen‑Kennzeichner | 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**

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

| Parametername | Beschreibung | Beispielwert |
| --- | --- | --- |
| signalDropThreshold | Prozentualer Signalabfall, der als potenzielles Jamming‑Ereignis gilt | 25 |
| minSignalLevel | Minimal akzeptabler Signalpegel (in dBm), unterhalb dessen Jamming vermutet wird | -113 |
| rsrqThreshold | Minimal akzeptabler RSRQ (Reference Signal Received Quality); schlechter RSRQ kann auf Störungen hinweisen | -20 |
| eventCode | CMS‑Kennung für Jammer‑Erkennungs‑Ereignisse | modem.jammer.detected |
| groupCode | Turm‑Alarm‑Gruppen‑Kennzeichner | tower.connectivity.jamming.warnen |

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

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

| Regel | Ereigniscode | Gruppencode |
| --- | --- | --- |
| I/O Eingang Zustandsänderung | input.statechange | tower.input.statechange |
| I/O Ausgang Zustandsänderung | output.statechange | tower.output.statechange |
| SIM‑Datenverbrauchs‑Warnung | sim.data.usage.warning | tower.connectivity.simdata.alert |
| Mobilfunknetzverlust | modem.signal.warning | tower.connectivity.signal.alert |
| Geo‑Fence‑Verstoß | geo.fence.breach | tower.connectivity.geofence.alert |
| Jammer‑Erkennung | modem.jammer.detected | tower.connectivity.jamming.alert |

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

![Teltonika LAN IP Konfiguration](/api/media/file/7194714fd2d59953cdf3d359f5e3cd2d7718e155-1544x648.png)

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

![Teltonika OpenVPN Schnittstellen‑Einrichtung](/api/media/file/b8ef5e12a6ce0ebe2d8bac1162b30e4e708b5403-1540x632.png)

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

![Teltonika OpenVPN Datei‑Upload](/api/media/file/eeb8a411acb3e99f8dc1483d4b5711e833c61c4b-1520x632.png)

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

![Teltonika OpenVPN verbundener Status](/api/media/file/51aefbb4ee40b7283dd6e24b05bd22796b3a35ce-1342x307.png)

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

![Teltonika VPN Ping‑Test](/api/media/file/deae69404db9e13fb4cc85f5921e6525a1ea8e91-1545x695.png)

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

## **Fehlerbehebung**

### Gerät verbindet sich nicht

| Symptom / Prüfung | Lösung |
| --- | --- |
| Verbindung schlägt sofort nach dem Speichern fehl | Prüfen, ob die IP Adresse vom GCXONE‑Server erreichbar ist. Versuchen Sie, die IP vom Server zu pingen oder die VPN‑Konnektivität zu prüfen. |
| Authentifizierungsfehler | Bestätigen Sie, dass Benutzername und Passwort korrekt sind und administrative Rechte besitzen. Melden Sie sich direkt an der Teltonika‑Admin‑Oberfläche an, um die Anmeldedaten zu überprüfen. |
| Portbezogener Verbindungsfehler | Prüfen Sie, ob der konfigurierte Kontrol Port korrekt ist und nicht durch eine Firewall blockiert wird. Standard ist Port 80. |
| Gerät zeigt nach der ersten Verbindung offline | Prüfen Sie, ob sich die IP Adresse des Teltonika‑Routers geändert hat (DHCP). Erwägen Sie die Verwendung einer statischen IP oder einer DHCP‑Reservierung. |

### Alarm Regeln lösen nicht aus

| Symptom / Prüfung | Lösung |
| --- | --- |
| Keine Warnen erhalten bei überschrittenem Schwellenwert | Prüfen Sie, ob die Regel "active": true im JSON enthält. Überprüfen Sie, dass das Benutzerdefiniert Alarm Regeln JSON gültig ist (keine Syntaxfehler). |
| eventCode erscheint nicht im CMS | Bestätigen Sie, dass der Ereigniscode in Ihrer CMS‑Integration konfiguriert ist. Prüfen Sie das CMS‑Kanal‑Mapping in GCXONE unter den Integrationseinstellungen der Site. |
| Falschpositive Warnen (zu viele Warnen) | Erweitern Sie den niedrigen/hohen Bereich für analoge Eingänge; erhöhen Sie signalDropThreshold für Jammer‑Erkennung. |
| Geo‑Fence Warnen für einen festen Standort | Prüfen Sie, ob die GPS‑Koordinaten der Site in GCXONE korrekt auf den tatsächlichen Turmstandort gesetzt sind. Erhöhen Sie radiusMetersWarning, wenn die GPS‑Meldung Schwankungen aufweist. |

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