Tech docs · Protocolo

Codec 8 · 8 Extended · 16

Los dispositivos Teltonika no usan un protocolo propietario cerrado. Toda la familia FMC/FMM/FMB/TAT/TFT habla Codec 8, Codec 8 Extended o Codec 16: tres protocolos binarios documentados que cualquier plataforma de flotas puede parsear.

01 · Filosofía

Por qué importa que sea abierto

Si mañana cambias de plataforma, te llevas los equipos. No estás atado a un software concreto. Cosa distinta es dónde los conectas: parsear el protocolo es una parte; convertir esos paquetes en gestión real de flota (mapa, geofencing, alertas, reportes históricos, alta disponibilidad) es un proyecto aparte.

02 · Variantes

Los tres codecs

Codec Pensado para I/O elements
Codec 8 Telemetría AVL estándar 1 byte por ID (hasta 255)
Codec 8 Extended Buses CAN con mucha I/O (FMC150, FMC650) 2 bytes por ID (hasta 65535) + payload variable
Codec 16 Cuando el equipo necesita marcar qué evento dispara el envío Codec 8 + generation type por record
03 · Wire format

Estructura de un paquete 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  (mismo valor)]
[CRC-16/IBM:      4 bytes]
04 · Integraciones

Plataformas que ya lo hablan

  • TraccarCódigo abierto, soporte completo Codec 8/8E/16. Self-hosted.
  • WialonComercial, decoder Teltonika de serie.
  • FlespiBroker MQTT con decoder integrado, útil si tu stack es event-driven.
  • Fleet CompleteIMEI Teltonika reconocido por defecto.
  • GPSWOX · Mapon · OneStepGPSConfirmados.
05 · DIY

Si quieres parsearlo tú mismo

El equipo abre conexión TCP/UDP contra el host:puerto que le configures (por FOTA Web o vía Configurator). El servidor recibe paquetes binarios, valida CRC y desempaqueta. Hay parsers de referencia en Python, Go y Node en GitHub buscando "Teltonika Codec 8" — útiles como punto de partida.

Pasar de un parser de demo a una plataforma de producción no es trivial: sesiones TCP persistentes con miles de equipos, keepalive y reconexión, almacenamiento histórico (una flota de 200 vehículos genera del orden de gigabytes al mes de telemetría cruda), tabla de I/O IDs distinta por modelo con su escala y unidad, decodificación CAN parámetro a parámetro, mapa, alertas, geofencing, reportes, y comandos downlink con su propia validación CRC. Por eso la mayoría de flotas se conectan a una plataforma especializada en lugar de mantener la suya.

06 · Configuración

Cómo cambiar de codec

  • Configurator (USB) — software de Teltonika para Windows. Conectas el equipo, cambias el parámetro y guardas.
  • FOTA Web — tarea de configuración remota, aplicable a un grupo de IMEIs.
07 · Referencia

Documentación oficial

La spec Teltonika de los codecs mantiene la referencia binaria exacta, ejemplos de paquete y las tablas de I/O IDs por modelo.