Tech docs · Protocollo

Codec 8 · 8 Extended · 16

I dispositivi Teltonika non usano un protocollo proprietario chiuso. Tutta la famiglia FMC/FMM/FMB/TAT/TFT parla Codec 8, Codec 8 Extended o Codec 16: tre protocolli binari documentati che qualsiasi piattaforma di gestione flotte può parsare.

01 · Filosofia

Perché conta che sia aperto

Se domani cambi piattaforma, ti porti i dispositivi. Non sei legato a un software specifico. Cosa diversa è dove li colleghi: parsare il protocollo è una parte; trasformare quei pacchetti in gestione reale della flotta (mappa, geofencing, avvisi, report storici, alta disponibilità) è un progetto a parte.

02 · Varianti

I tre codec

Codec Pensato per I/O elements
Codec 8 Telemetria AVL standard 1 byte per ID (fino a 255)
Codec 8 Extended Bus CAN con molto I/O (FMC150, FMC650) 2 byte per ID (fino a 65535) + payload variabile
Codec 16 Quando il dispositivo deve indicare quale evento ha scatenato l'invio Codec 8 + generation type per record
03 · Wire format

Struttura di un pacchetto AVL

[Preamble:        4 bytes 0x00000000]
[Data length:     4 bytes]
[Codec ID:        1 byte  (0x08, 0x8E o 0x10)]
[Number of data:  1 byte]
[AVL data:        timestamp + priority + GPS + I/O]
[Number of data:  1 byte  (stesso valore)]
[CRC-16/IBM:      4 bytes]
04 · Integrazioni

Piattaforme che lo parlano già

  • TraccarOpen source, supporto completo Codec 8/8E/16. Self-hosted.
  • WialonCommerciale, decoder Teltonika di serie.
  • FlespiBroker MQTT con decoder integrato, utile se il tuo stack è event-driven.
  • Fleet CompleteIMEI Teltonika riconosciuto di default.
  • GPSWOX · Mapon · OneStepGPSConfermati.
05 · DIY

Se vuoi parsarlo da solo

Il dispositivo apre una connessione TCP/UDP verso l'host:porta che gli configuri (via FOTA Web o con il Configurator). Il server riceve pacchetti binari, valida il CRC e li spacchetta. Su GitHub trovi parser di riferimento in Python, Go e Node cercando "Teltonika Codec 8" — utili come punto di partenza.

Passare da un parser di demo a una piattaforma di produzione non è banale: sessioni TCP persistenti con migliaia di dispositivi, keepalive e riconnessione, archiviazione storica (una flotta di 200 veicoli genera nell'ordine di gigabyte al mese di telemetria grezza), tabella di I/O ID diversa per modello con scala e unità, decodifica CAN parametro per parametro, mappa, avvisi, geofencing, report e comandi downlink con la propria validazione CRC. Per questo la maggior parte delle flotte si collega a una piattaforma specializzata invece di mantenerne una propria.

06 · Configurazione

Come cambiare codec

  • Configurator (USB) — software di Teltonika per Windows. Colleghi il dispositivo, cambi il parametro e salvi.
  • FOTA Web — task di configurazione remota, applicabile a un gruppo di IMEI.
07 · Riferimento

Documentazione ufficiale

La specifica Teltonika dei codec mantiene il riferimento binario esatto, esempi di pacchetto e le tabelle di I/O ID per modello.