Omni IoT-Integration

Omni IoT-Geraete bieten Fahrzeugkonnektivitaet ueber das SCOR TCP-Protokoll. Diese Anleitung behandelt die Geraeteeinrichtung, verfuegbare Befehle, Fehlercode-Interpretation und Konfigurationsoptionen.

Ueberblick

Omni IoT-Geraete kommunizieren ueber das SCOR-Protokoll und ermoeglichen:

• Sperren/Entsperren - Fernsteuerung des Fahrzeugs
• Standortverfolgung - GPS-Positionsaktualisierungen
• Statusueberwachung - Batterie-, Geschwindigkeits-, Kilometerstand-Daten
• Fehlerberichterstattung - Controller-Fehlfunktionswarnungen
• Fahrzeugeinstellungen - Scheinwerfer, Gasgriff, Geschwindigkeitsmodus

Protokollarchitektur

Levy Fleets Dashboard
         ↓
    SCOR TCP-Protokoll
         ↓
    Omni IoT-Geraet
         ↓
    UART-Schnittstelle
         ↓
  Fahrzeug-Controller

Das IoT-Geraet uebersetzt zwischen SCOR (TCP) und UART (Controller) und handhabt das Kommunikationsprotokoll fuer beide Richtungen.

Geraeteeinrichtung

Omni-Geraet hinzufuegen

Geraeteinformationen

SCOR-Protokollbefehle

Sperren und Entsperren

Die primaeren Befehle zur Fahrzeugsteuerung:

Fahrzeug entsperren

*SCOS,OM,<IMEI>,S25,1,1,0#

Initiiert den R0 → L0 Handshake zum Entsperren des Scooters.

Fahrzeug sperren

*SCOS,OM,<IMEI>,S25,1,1,1#

Initiiert den R0 → L1 Handshake zum Sperren des Scooters.

Operationsschluessel-Handshake

Fuer manuelle Sperr-/Entsperrvorgaenge verwendet das SCOR-Protokoll einen Schluesselaustausch:

R0-Befehlsformat:

*SCOS,OM,<IMEI>,R0,<VORGANG>,<SCHLUESSEL_GUELTIGKEIT>,<BENUTZER_ID>,<ZEITSTEMPEL>#

Status und Standort

Fahrzeugstatus anfordern (S6)

*SCOS,OM,<IMEI>,S6#

Gibt Batteriestand, Sperrzustand, Zuendungsstatus, Geschwindigkeit und Kilometerstand zurueck.

Standort anfordern (D0)

*SCOS,OM,<IMEI>,D0#

Gibt GPS-Koordinaten mit dem letzten Fix zurueck.

Heartbeat-Konfiguration

Heartbeat-Einstellungen setzen (S5)

*SCOS,OM,<IMEI>,S5,0,<S6_ENTSPERRT>,<HEARTBEAT_SEKUNDEN>,<S6_INTERVALL>#

Fahrzeugeinstellungen

Fahrzeugeinstellungen konfigurieren (S7)

*SCOS,OM,<IMEI>,S7,<SCHEINWERFER>,<GESCHWINDIGKEITSMODUS>,<GASGRIFF_MODUS>,<RUECKLICHT>#

Warntöne

Warnung ausloesen (V0)

*SCOS,OM,<IMEI>,V0,<TON_CODE>#

Firmware und Diagnose

Firmware-Version abrufen (G0)

*SCOS,OM,<IMEI>,G0#

Gibt Controller-Firmware-Versionsdetails zurueck.

Fehlercodes anfordern (E0)

*SCOS,OM,<IMEI>,E0#

Gibt aktuelle Controller-Fehlercodes zurueck.

Fehlercodes

Fehler-Schweregrade

Haeufige Fehlercodes

Fehlercode-Antwort

Bei Anforderung von Fehlercodes ueber E0 enthaelt die Antwort:

{
  "code": "4",
  "hex": "0x04",
  "description": "Motor hall issue",
  "severity": "critical",
  "userFriendlyMessage": "Motor-Sensor-Fehlfunktion - nicht fahren",
  "technicalDetails": "Motor-Hall-Effekt-Sensorfehler erkannt"
}

Kritische Fehler-Aktionen

Wenn ein kritischer Fehler erkannt wird:

1. Sofort auf Wartung setzen - Aus Kundenansicht entfernen
2. Fehler protokollieren - Fuer Wartungsverfolgung aufzeichnen
3. Betrieb alarmieren - Feldpersonal benachrichtigen
4. Inspektion planen - Physische Pruefung veranlassen

Telemetriedaten

S6-Status-Frame

Der S6-Frame bietet umfassenden Fahrzeugstatus:

D0-Standort-Frame

Der D0-Frame liefert GPS-Daten:

Datenaktualisierungs-Frequenz

Dashboard-Vorgaenge

Befehle senden

Von der Fahrzeugdetailseite:

Telemetrie anzeigen

Das Dashboard zeigt Echtzeit-Telemetrie:

• Batteriestand - Aktueller Ladeprozentsatz
• Sperrstatus - Gesperrt/Entsperrt-Anzeige
• Letzter Standort - GPS-Koordinaten und Zeitstempel
• Geschwindigkeit - Aktuelle oder zuletzt gemeldete Geschwindigkeit
• Kilometerstand - Gesamtstrecken-Anzeige
• Fehlerstatus - Alle aktiven Fehlercodes

Befehlsverlauf

Kuerzlich an das Geraet gesendete Befehle anzeigen:

1. Gehen Sie zu Fahrzeugdetails → IoT
2. Klicken Sie auf Befehlsverlauf
3. Gesendete Befehle und Antworten ueberpruefen
4. Auf fehlgeschlagene Befehle pruefen

Fehlerbehebung

Geraet antwortet nicht

Verbindungsprobleme

1. SIM-Aktivierung verifizieren - Sicherstellen, dass Mobilfunktarif aktiv ist
2. Signal pruefen - Geraet benoetigt ausreichende Abdeckung
3. Aus-/Einschalten - Kann voruebergehende Probleme beheben
4. Firmware-Update - Veraltete Firmware kann Fehler haben

Befehlsfehler

Fehlercode-Warnungen

Wenn Fehlercodes gemeldet werden:

1. Schweregrad pruefen - Kritische Fehler benoetigen sofortige Aufmerksamkeit
2. Verlauf ueberpruefen - Ist dies ein wiederkehrendes Problem?
3. Querverweisen - Auf verwandte Telemetrie-Anomalien pruefen
4. Service planen - Techniker entsenden, falls erforderlich

Best Practices

Geraetekonfiguration

1. S6 waehrend Fahrten aktivieren - S6_ENTSPERRT=2 fuer Kilometerstands-Tracking setzen
2. Angemessenen Heartbeat setzen - Balance zwischen Batterie und Datenaktualitaet
3. Fehlercodes ueberwachen - Warnungen fuer kritische Fehler einrichten
4. Firmware-Versionen verfolgen - Geraete aktuell halten

Betriebsrichtlinien

1. Nach Installation testen - Ueberpruefen, ob Sperren/Entsperren funktioniert
2. Neue Geraete ueberwachen - Auf fruehe Probleme achten
3. Regelmaessige Zustandspruefungen - Geraetekonnektivitaet ueberpruefen
4. Probleme dokumentieren - Wiederkehrende Probleme verfolgen

Sicherheitsueberlegungen

1. IMEI-Handling sichern - Geraetkennungen nicht offenlegen
2. Ungewoehnliche Befehle ueberwachen - Auf unautorisierten Zugriff achten
3. Befehlsprotokolle auditieren - Ueberpruefen, wer welche Befehle sendet
4. Anmeldedaten aktualisieren - Geteilte Geheimnisse rotieren

API-Referenz

Befehl senden

POST /api/iot/scor
{
  "imei": "123456789012345",
  "command": "*SCOS,OM,123456789012345,S6#"
}

Befehlsantwort

{
  "success": true,
  "command_id": "cmd_abc123",
  "sent_at": "2025-01-15T10:30:00Z",
  "response": {
    "received": true,
    "data": { /* Telemetrie */ }
  }
}

Telemetrie-Webhook

Telemetrie-Updates koennen Webhooks ausloesen:

{
  "event": "vehicle.location_updated",
  "data": {
    "vehicle_id": "uuid",
    "latitude": 40.7128,
    "longitude": -74.0060,
    "battery_percent": 85,
    "lock_status": 1
  }
}