Queclink IoT-Integration

Levy Fleets bietet umfassende Unterstuetzung fuer Queclink GL530-Serie IoT-Geraete und implementiert 100% des @Track Air Interface Protocol v80.56. Mit 85+ unterstuetzten Befehlen ist dies eine der funktionsreichsten IoT-Integrationen.

Ueberblick

Queclink IoT-Geraete kommunizieren mit Levy Fleets ueber einen sicheren API-Endpunkt, der umfangreiche Telemetriedaten verarbeitet. Die Integration unterstuetzt:

• Hochpraezises GPS-Tracking mit Multi-GNSS-Unterstuetzung
• Umfassende Batterieueberwachung einschliesslich BMS-Integration
• ECU-Steuerung fuer Sperren/Entsperren und Geschwindigkeitsbegrenzung
• Multi-Zonen-Geofencing mit Eintritts-/Austritts-Erkennung
• Umfangreiches Alarmsystem mit anpassbaren Ausloesern
• CAN-Bus-Integration fuer Fahrzeugdiagnose
• OTA-Konfiguration fuer Remote-Geraeteverwaltung
• NFC-Unterstuetzung fuer kartenbasierte Vorgaenge

Geraetekonfiguration

Servereinstellungen

Konfigurieren Sie Ihr Queclink-Geraet fuer die Kommunikation mit Levy Fleets:

Authentifizierung

Queclink-Geraete authentifizieren sich mit dem IoT-API-Schluessel. Konfigurieren Sie den x-api-key-Header in Ihren Geraeteeinstellungen.

Geraeteidentifikation

Geraete werden durch IMEI im Nachrichten-Payload identifiziert. Das System verwendet intelligentes Caching fuer Fahrzeugabfragen zur Leistungsoptimierung.

Unterstuetzte Befehle (85+)

Standortberichte

Status & Informationen

Batterie & Strom

ECU (Elektronische Steuereinheit)

Sperrvorgaenge

Geschwindigkeit & Gasgriff

Geofencing

Alarme & Warnungen

Bewegungserkennung

Umkippen & Wiederherstellung

Systemereignisse

Konfiguration & GPS

NFC & Extern

Erweiterte Sicherheitserkennung

Queclink-Geraete unterstuetzen erweiterte Sicherheitsfunktionen, die fuer diese Integration einzigartig sind:

KI-Erkennung & Zusatz

Geraete mit KI-Box-Integration unterstuetzen intelligente Erkennung:

Das KI-Erkennungssystem kann identifizieren:

• Helmnutzungs-Compliance
• Fahrerverhaltensmuster
• Hinderniserkennung
• Spurabweichungswarnungen

Bestaetigung & Gepuffert

Nachrichtenformat

Nachrichtenstruktur

Queclink-Nachrichten folgen diesem Format:

+RESP:GTXXX,PROTOCOL,IMEI,...,CHECKSUM$

Komponenten:

• +RESP / +ACK / +BUFF - Nachrichtentyp
• GTXXX - Befehlscode
• PROTOCOL - Protokollversionskennung
• IMEI - 15-stellige Geraetekennung
• ... - Befehlsspezifische Datenfelder
• CHECKSUM$ - Nachrichtenpruefssumme

Beispielnachrichten

Standortbericht (GTFRI):

+RESP:GTFRI,380701,867648045123456,,0,0,1,1,0.0,0,35.6,-73.9876,40.7580,20251225120000,0310,0260,00F7,36A3,00,0.0,,,99,20251225120001,0065$

Batteriestatus (GTBAT):

+RESP:GTBAT,380701,867648045123456,,0,85,4200,0,20251225120000,0065$

Sperre erfolgreich (GTLOC):

+RESP:GTLOC,380701,867648045123456,,0,1,20251225120000,0065$

Telemetrieverarbeitung

Standortbericht-Verarbeitung

Beim Empfang von GTFRI- oder GTERI-Nachrichten:

1. Koordinaten parsen - Breitengrad, Laengengrad, Geschwindigkeit, Richtung extrahieren
2. GPS-Fix validieren - Fix-Qualitaetsindikator pruefen
3. Fahrzeug aktualisieren - Aktuelle Position und last_location_update setzen
4. In Fahrtverlauf speichern - Falls aktive Fahrt, zu ride_locations hinzufuegen
5. Geschwindigkeit berechnen - Geschwindigkeitswert umrechnen und validieren
6. Kilometerstand anwenden - Kumulierte Strecke aktualisieren
7. Zonenpruefung ausloesen - Geofence-Grenzen auswerten

Batterie-Datenfelder

Batterienachrichten enthalten umfassende BMS-Daten:

ECU-Berichtsverarbeitung

ECU-Nachrichten (GTECU, GTECS) liefern Fahrzeugcontroller-Daten:

Fahrzeugidentitaetsaufloesung

Caching-Strategie

Die Integration verwendet effizientes Caching fuer Fahrzeugabfragen:

1. Speicher-Cache pruefen - Nach IMEI im 1-Stunden-Cache suchen
2. Cache-Treffer - Gecachte Fahrzeugidentitaet sofort zurueckgeben
3. Cache-Fehler - Datenbank nach Fahrzeug per iot_imei abfragen
4. Cache befuellen - Ergebnis fuer 1 Stunde speichern
5. Identitaet zurueckgeben - Fahrzeug-UUID und -Nummer bereitstellen

Vorteile

• Reduzierte Datenbanklast - Einzelne Abfrage pro Stunde pro Geraet
• Schnellere Verarbeitung - Sub-Millisekunden-Cache-Abfragen
• Konsistente Identitaet - Gleiche Fahrzeug-ID ueber alle Nachrichten

Cache-Invalidierung

Cache wird automatisch geleert bei:

• IoT-Geraete-Massenimport
• Aenderung der Fahrzeug-IMEI
• Manueller Cache-Loeschung

Aktive Fahrt-Integration

Fahrterkennung

Fuer jede eingehende Nachricht:

1. Abfrage aktiver/pausierter Fahrten nach vehicle_uuid
2. Falls nicht gefunden, nach vehicle_number suchen (Legacy-Unterstuetzung)
3. Legacy-Fahrten mit korrekten UUIDs nachfuellen
4. Telemetrie mit Fahrt verknuepfen

Standortverlauf

Waehrend aktiver Fahrten fuehren Standortberichte zu:

1. Einfuegen in die Tabelle ride_locations
2. Enthalten: Koordinaten, Geschwindigkeit, Hoehe, Richtung
3. Berechnen, ob Fahrzeug sich bewegt
4. Rohdaten fuer Debugging speichern
5. Fahrtstrecke/-dauer aktualisieren

Zonendurchsetzung

Nach der Standortverarbeitung:

await enforceZoneActions(admin, {
  vehicleId: vehicleUuid,
  rideId: rideId,
  latitude: location.latitude,
  longitude: location.longitude,
  context: 'iot_queclink'
})

Zonenaktionen umfassen:

• Geschwindigkeitslimit-Anwendung in Langsamzonen
• Gasgriff-Deaktivierung in Verbotszonen
• Warnungsgenerierung bei Grenzverletzungen

Befehle senden

IoT-Passwort

Konfigurieren Sie das Queclink-Passwort:

Einstellungen > Fahrzeuge > IoT-Passwoerter > Queclink

Standard-Passwort: ks600

Dashboard-Befehle

Befehlsantwort-Behandlung

Sperr-/Entsperrbefehle beinhalten Ergebnisverarbeitung:

Alarmbehandlung

Alarmtypen

Das System verarbeitet mehrere Alarmkategorien:

Alarmverarbeitung

1. Alarmnachricht parsen und Typ extrahieren
2. Zugehoerigen Kunden nachschlagen (falls Fahrt aktiv)
3. Alarmdatensatz in Datenbank erstellen
4. Benachrichtigung generieren, falls erforderlich
5. Fahrzeugstatus bei Bedarf aktualisieren

Kundenbenachrichtigungen

Fuer bestimmte Alarme waehrend aktiver Fahrten:

• SOS-Warnungen benachrichtigen Flottenbetreiber sofort
• Aufprallerkennung kann Notfallprotokolle ausloesen
• Manipulationswarnungen werden zur Untersuchung markiert

Datenspeicherung

Telemetrietabelle

Alle Nachrichten werden gespeichert mit:

Fahrt-Standorte

Fuer aktive Fahrten werden GPS-Daten in ride_locations gespeichert:

Nicht zugeordnete Geraete

Nicht zugeordnete erfassen

Wenn eine Nachricht von einer unbekannten IMEI eintrifft:

1. Nachricht fuer Protokollierungszwecke verarbeiten
2. In Tabelle iot_unmatched_devices erfassen
3. Speichern: IMEI, Protokoll, Quelle, Payload, Zeitstempel
4. Im Dashboard "Nicht zugeordnete Geraete" sichtbar machen

Nicht zugeordnete aufloesen

Um ein nicht zugeordnetes Geraet zu registrieren:

1. Navigieren Sie zu IoT-Geraete > Nicht zugeordnete Geraete
2. Klicken Sie auf den nicht zugeordneten Eintrag
3. Klicken Sie auf "Geraet registrieren"
4. Erforderliche Felder ausfuellen (Unterkonto, IoT-Typ)
5. Speichern - Geraet wird nun normal verfolgt

Konfigurationsoptionen

Berichtsintervalle

Konfigurieren Sie, wie oft das Geraet berichtet:

Strommodi

Geofence-Konfiguration

Konfigurieren Sie bis zu 100 Geofence-Zonen pro Geraet:

Fehlerbehebung

Keine Standort-Updates

Symptome: Fahrzeugposition aktualisiert nicht

Loesungen:

1. Geraetestrom und Batteriestand pruefen
2. Ueberpruefen, ob GPS-Antenne Sicht zum Himmel hat
3. FRI-Intervallkonfiguration ueberpruefen
4. Mobilfunkkonnektivitaet pruefen
5. GTGPS-Nachrichten auf Fix-Status untersuchen

Befehle funktionieren nicht

Symptome: Sperr-/Entsperrbefehle werden nicht ausgefuehrt

Loesungen:

1. IoT-Passwort in Einstellungen ueberpruefen
2. Pruefen, ob Geraet online ist (zuletzt gesehen < 5 min)
3. Befehlsantwort ueberpruefen (GTLOF/GTULF = Fehlschlag)
4. ECU-Status auf Fehler pruefen
5. Fahrzeug bei Bedarf aus-/einschalten

Heartbeat fehlt

Symptome: Geraet zeigt offline an, kein GTHBD

Loesungen:

1. Serverkonfiguration auf Geraet verifizieren
2. Mobilfunk-Signalstaerke pruefen
3. Sicherstellen, dass SIM-Karte aktiv ist
4. Auf Watchdog-Neustarts pruefen (GTDOG)
5. Pruefen, ob Geraet im Tiefschlaf ist

Zonendurchsetzung funktioniert nicht

Symptome: Geschwindigkeit in Langsamzonen nicht begrenzt

Loesungen:

1. Ueberpruefen, ob Zone korrekt konfiguriert ist
2. Pruefen, ob Zonentyp Durchsetzung unterstuetzt
3. Bestaetigen, dass Fahrt aktiv ist
4. Standortgenauigkeit ueberpruefen
5. Pruefen, ob ECU Geschwindigkeitsbefehle empfangen kann

Gepufferte Nachrichten

Symptome: Verzoegerte Telemetrie-Ankunft

Erklaerung: Bei Offline-Status puffert das Geraet Nachrichten und sendet sie bei Wiederverbindung. Diese kommen mit +BUFF-Praefix an.

Behandlung:

• Nachrichten werden mit Original-Zeitstempeln verarbeitet
• Fahrtstatistiken werden rueckwirkend aktualisiert
• Zonendurchsetzung wird nicht auf historische Daten angewandt

API-Referenz

Endpunkt

POST /api/iot/queclink

Header

x-api-key: your-iot-api-key
Content-Type: application/json

Anfragebody

{
  "imei": "867648045123456",
  "message": "+RESP:GTFRI,380701,867648045123456,...",
  "timestamp": "2025-12-25T12:00:00Z"
}

Antwort

{
  "success": true,
  "imei": "867648045123456",
  "messageType": "+RESP",
  "command": "GTFRI",
  "processed": true
}

Health Check

GET /api/iot/queclink

Gibt Servicestatus zurueck einschliesslich:

• Servicename und -version
• Protokollversion
• Abdeckungsstatistiken (85 Befehle, 100%)
• Liste aller unterstuetzten Befehle

---