Tech docs · Protocole

Codec 8 · 8 Extended · 16

Les dispositifs Teltonika n'utilisent pas un protocole propriétaire fermé. Toute la famille FMC/FMM/FMB/TAT/TFT parle Codec 8, Codec 8 Extended ou Codec 16 : trois protocoles binaires documentés que n'importe quelle plateforme de flottes peut parser.

01 · Philosophie

Pourquoi c'est important que ce soit ouvert

Si demain tu changes de plateforme, tu emportes les équipements. Tu n'es pas attaché à un logiciel précis. Autre chose est l'endroit où tu les connectes : parser le protocole en est une partie ; convertir ces paquets en gestion réelle de flotte (carte, geofencing, alertes, rapports historiques, haute disponibilité) est un projet à part.

02 · Variantes

Les trois codecs

Codec Pensé pour I/O elements
Codec 8 Télémétrie AVL standard 1 octet par ID (jusqu'à 255)
Codec 8 Extended Bus CAN avec beaucoup d'I/O (FMC150, FMC650) 2 octets par ID (jusqu'à 65535) + payload variable
Codec 16 Quand l'équipement doit marquer quel événement déclenche l'envoi Codec 8 + generation type par record
03 · Wire format

Structure d'un paquet 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  (même valeur)]
[CRC-16/IBM:      4 bytes]
04 · Intégrations

Plateformes qui le parlent déjà

  • TraccarOpen source, support complet Codec 8/8E/16. Self-hosted.
  • WialonCommercial, décodeur Teltonika d'usine.
  • FlespiBroker MQTT avec décodeur intégré, utile si ta stack est event-driven.
  • Fleet CompleteIMEI Teltonika reconnu par défaut.
  • GPSWOX · Mapon · OneStepGPSConfirmés.
05 · DIY

Si tu veux le parser toi-même

L'équipement ouvre une connexion TCP/UDP contre l'host:port que tu lui configures (par FOTA Web ou via Configurator). Le serveur reçoit les paquets binaires, valide le CRC et désérialise. Il y a des parseurs de référence en Python, Go et Node sur GitHub en cherchant "Teltonika Codec 8" — utiles comme point de départ.

Passer d'un parseur de démo à une plateforme de production n'est pas trivial : sessions TCP persistantes avec des milliers d'équipements, keepalive et reconnexion, stockage historique (une flotte de 200 véhicules génère de l'ordre de gigaoctets par mois de télémétrie brute), table d'I/O IDs différente par modèle avec son échelle et son unité, décodage CAN paramètre par paramètre, carte, alertes, geofencing, rapports, et commandes downlink avec leur propre validation CRC. C'est pourquoi la plupart des flottes se connectent à une plateforme spécialisée plutôt que de maintenir la leur.

06 · Configuration

Comment changer de codec

  • Configurator (USB) — logiciel de Teltonika pour Windows. Tu connectes l'équipement, tu changes le paramètre et tu sauvegardes.
  • FOTA Web — tâche de configuration à distance, applicable à un groupe d'IMEIs.
07 · Référence

Documentation officielle

La spec Teltonika des codecs maintient la référence binaire exacte, des exemples de paquets et les tables d'I/O IDs par modèle.