Rastreadores GPS
AVT20
Protocolo
Protocolo AVT20 Tracker
Revisión 3.03 — 15 jun 2026 — Límites salida IGN, mensaje +DFI, relé BLE ABR100
El protocolo AVT20 Tracker R3.03 define el formato del flujo de datos, los comandos de configuración y las estructuras de mensajes entre el rastreador GNSS AVT20 y el servidor backend a través de LTE Cat-1 / EGPRS. Use las secciones siguientes como referencia estructurada, o abra el PDF completo para parámetros y definiciones de campos.
Historial de revisiones
| Revisión | Fecha | Descripción |
|---|---|---|
| 1.01 | 2024-11-03 | Versión inicial |
| 1.02 | 2025-03-11 | Bit GNSS Satellites Number en máscara GNSS Info Mask de AT@GCS |
| 1.03 | 2025-03-18 | Escaneo BLE AT@BSS; PDP Enable en AT@SIS; info BLE en +RPT |
| 1.04 | 2025-04-18 | AT@ETS / AT@EHS sensores BLE externos; tipos de evento 12 y 31 en +RPT |
| 2.01 | 2025-05-23 | Detección AT@JAM; alarma AT@TAS; máscaras crash/tilt; mensaje +TCF |
| 2.02 | 2025-06-16 | Filtro iBeacon en AT@BSS; máscara BLE iBeacon Info en +RPT y AT@GCS |
| 2.03 | 2025-08-21 | Servidor secundario AT@SSI; TLS (TCR/TCL); MQTT (MQT); Resend Time No SACK |
| 2.04 | 2025-10-24 | OTA config AT@UPC; conexión/relé BLE AT@BCS/BRY/BOS; evento upgrade config |
| 3.01 | 2025-12-30 | Filtro GNSS geo-cerca AT@GGF; lista blanca AT@BWS; alarma spoofing GNSS (tipo 39) |
| 3.02 | 2026-03-24 | Máscara ECL Trigger en +RPT; Motion Event Report en AT@MOV; params GSM en AT@JAM |
| 3.03 | 2026-06-15 | Límites salida IGN y debounce; mensaje +DFI; relé BLE ABR100 en AT@BCS |
Formato del flujo de datos
La comunicación incluye flujos ascendentes (dispositivo → servidor) y descendentes (servidor → dispositivo) a través de la red celular. El flujo ascendente transporta respuestas a comandos descendentes, latidos e informes no solicitados. El flujo descendente transporta configuración, consultas y respuestas a mensajes ascendentes.
Tipos de trama
| Dirección | Codificación | Trama | Uso |
|---|---|---|---|
| Descendente | ASCII imprimible | Comando de configuración | Configurar parámetros del terminal (AT@…=) |
| Descendente | ASCII imprimible | Comando de consulta | Consultar parámetros actuales (AT@…?) |
| Descendente | ASCII imprimible | +SACK | Acuse del servidor para mensajes +RPT |
| Descendente | ASCII imprimible | +SHBD | Respuesta del servidor a latido +HBD |
| Ascendente | ASCII imprimible | +QRY | Respuesta del terminal a un comando de consulta |
| Ascendente | ASCII imprimible | +HBD | Latido periódico para mantener conectividad TCP/UDP |
| Ascendente | ASCII imprimible | +ACK / +NACK | Confirmación o rechazo de comandos de configuración |
| Ascendente | Hexadecimal | +RPT / -RPT | Informes en tiempo real y en búfer |
Comandos de configuración
Los comandos de configuración usan el formato AT@<CLAVE>=<contraseña>,<parámetros>,…,<serial># . Cada comando está protegido por contraseña (predeterminada at) y termina con un número de serie hexadecimal de 4 dígitos y "#".
Ejemplo — configuración del servidor principal:
AT@SIS=at,0,1,255.255.255.255,12345,,,0,0001#
Comandos de red
| Código | Comando | Descripción |
|---|---|---|
| SIS | AT@SIS= | Servidor principal: IP, puerto, modo (0 Stop / 1 TCP / 2 UDP / 3 MQTT), búfer, SACK, latido, PDP/TLS, Resend Time No SACK |
| SSI | AT@SSI= | Servidor secundario (mismos parámetros que SIS) |
| NIS | AT@NIS= | APN, credenciales, modo de escaneo (0 auto Cat1→GSM, 1 Cat1, 2 GSM), Search No Signal Cover |
| MQT | AT@MQT= | MQTT: client ID, topics, QoS, keep-alive (servidor principal o secundario) |
| TCR | AT@TCR= | Descarga remota de certificados TLS (HTTP) |
| TCL | AT@TCL= | Descarga local de certificados TLS |
Comandos generales
| Código | Comando | Descripción |
|---|---|---|
| GMT | AT@GMT= | Configuración de hora GMT / zona horaria |
| GCS | AT@GCS= | Configuración global: máscaras Data Mask, Event Data Mask, LED, GNSS/AGPS, odómetro, contador horario, timeout GNSS, ahorro de energía |
| RRS | AT@RRS= | Informe GNSS periódico: modo, intervalos IGN/IGF, ángulo de giro, programación standby largo |
| RTO | AT@RTO= | Operación en tiempo real: reinicio, apagado, reset, consulta red/versión, posicionamiento, +DFI, info satélites |
| PCL | AT@PCL= | Lista de comandos predefinidos (hasta 32) |
| ECL | AT@ECL= | Lista de comandos por eventos con ECL Trigger Report |
| GGF | AT@GGF= | Filtro GNSS de geo-cerca y detección de spoofing |
Comandos de alarma
| Código | Comando | Descripción |
|---|---|---|
| MOV | AT@MOV= | Alarma de movimiento con Motion Event Report |
| SPD | AT@SPD= | Umbral y duración de alarma de velocidad |
| GEO | AT@GEO= | Geo-cercas circulares (hasta 32 zonas) |
| HBS | AT@HBS= | Conducción brusca con intervalo de activación |
| CRA | AT@CRA= | Detección de choque con debounce |
| JAM | AT@JAM= | Alarma de interferencia (RSRP, RSRQ, RSSI, MINCH/SINR GSM) |
| TAS | AT@TAS= | Detección de alarma de inclinación |
E/S, BLE, OTA y depuración
| Categoría | Código | Descripción |
|---|---|---|
| E/S | IGN | Ignición e ignición virtual; máscara salidas con ignición ON, límite velocidad GNSS, debounce |
| BLE | BSS | Escaneo BLE, filtro UUID iBeacon, verificación lista blanca accesorios |
| BLE | BWS | Lista blanca de balizas BLE (grupos MAC) |
| BLE | BCS | Conexión BLE (ABK100, relé ABR100 cifrado) |
| BLE | BRY | Control de salida de relé BLE |
| BLE | BOS | Forma de onda de salida de alarma BLE |
| BLE | ETS | Sensores de temperatura externos (BLE) |
| BLE | EHS | Sensores de humedad externos (BLE) |
| OTA | UPF | Actualización firmware OTA (MCU principal, módulo red, boot firmware) |
| OTA | UPC | Actualización de configuración OTA |
| OTA | BMS | Sistema de gestión: servidor BMS, modo (Stop/TCP/UDP/MQTT), máscara BMR Data Mask |
| DEBUG | DBG | Servidor de registro de depuración OTA y máscara de log |
Comandos de consulta
Los comandos de consulta recuperan los parámetros actuales del terminal. Usan ASCII imprimible con campos separados por comas:
AT@<CLAVE>?<contraseña>,,<serial>#
- AT@SIS?at,,# — consultar servidor principal
- AT@SSI?at,,# — consultar servidor secundario
- AT@NIS?at,,# — consultar red (APN)
- AT@GMT?at,,# — consultar hora
- AT@GCS?at,,# — consultar configuración global
- AT@RRS?at,,# — consultar informes periódicos
- AT@GEO?at,,# — consultar geo-cercas
Formato de mensajes
Los informes, búfer, datos grandes y latidos comparten una estructura común con zonas de cabecera, datos y cola:
| Zona | Campos | Codificación |
|---|---|---|
| Cabecera | Head (5 B) + Length (2 B) + IMEI (8 B) + Device ID (1 B) | ASCII / HEX / HEX / HEX |
| Datos | Carga variable + G-time (7 B) | HEX o ASCII |
| Cola | Número de serie (2 B) + cola "#" (1 B) | HEX / ASCII |
- +RPT / -RPT, +LDP / -LDP, +BMR / -BMR, +HBD — zona de datos en hexadecimal (big-endian para valores multibyte)
- +SACK / +SHBD — codificación ASCII completa
- +ACK, +QRY, +ALL, +QNI, +VER, +GSV, +LSV, +BSV, +GAV, +SCF, +TCF, +DFI — zona de datos en ASCII con comas
Mensajes de informe (+RPT / -RPT)
Las tramas +RPT son informes en tiempo real enviados en un plazo de 3 minutos. Las tramas -RPT son informes históricos almacenados en búfer y enviados al restablecer la conectividad.
Todos los mensajes y eventos GNSS comparten el mismo formato +RPT/-RPT en hexadecimal. Las máscaras Data Mask y Event Data Mask en AT@GCS controlan qué zonas se incluyen.
Bits principales de la máscara Data Mask +RPT (AT@GCS)
| Bit | Campo | Contenido |
|---|---|---|
| 0 | Multipaquete | Activado automáticamente si el mensaje supera 256 bytes |
| 1 | Tipo de red | Tipo de red celular |
| 2 | Batería | Voltaje (mV) y nivel (%) |
| 3 | Información GNSS | Tipo de fijación, HDOP, velocidad, rumbo, altitud, lat/lon, hora UTC, satélites |
| 4 | Información celular | MCC, MNC, LAC, Cell ID, CSQ |
| 7 | Información de actualización | Estado de actualización de firmware |
| 8 | Datos de evento | Alimentación, ignición, movimiento, kilometraje, GEO, contador horario, choque, inclinación, TLS |
| 19 | Información BLE | Resultados de escaneo BLE y datos de sensores |
| 20 | BLE iBeacon | Resultados de escaneo iBeacon |
| 22 | Config upgrade | Estado OTA de configuración |
Tipos de evento
| Tipo | Evento |
|---|---|
| 0 | Alimentación del terminal |
| 1 | Informe periódico |
| 2 | Movimiento |
| 3 | Alarma de batería |
| 7 | Alarma de choque |
| 11 | Actualización de firmware |
| 12 | Alarma de temperatura externa |
| 13 | Ignición |
| 14 | Alarma de alimentación principal |
| 16 | Alarma de exceso de velocidad |
| 19 | Alarma de conducción brusca |
| 20 | Autocalibración G-sensor |
| 21 | Alarma de geo-cerca |
| 27 | Alarma de salida |
| 29 | Alarma PDP |
| 30 | Información BLE común |
| 31 | Alarma de humedad externa |
| 32 | Alarma de interferencia (jamming) |
| 33 | Alarma de inclinación |
| 34 | Información BLE iBeacon |
| 35 | Descarga certificado TLS |
| 38 | Actualización de configuración |
| 39 | Alarma de spoofing GNSS |
| 43 | Alarma ECL trigger |
Mensajes de datos grandes (+LDP / -LDP)
Las tramas +LDP transportan informes de paquetes de datos grandes, como datos del sensor de choque. Las tramas -LDP son informes en búfer enviados al restablecer la conectividad.
| Bit | Campo Large Data Mask | Contenido |
|---|---|---|
| 0 | Multipaquete | Recuento total de tramas e ID de trama actual |
| 4 | Datos de choque | Tipo, longitud y carga de datos de choque (p. ej. muestras giroscopio) |
Mensajes en búfer (+BMR / -BMR)
Las tramas +BMR son informes BMS en tiempo real. Las tramas -BMR son informes BMS en búfer enviados al restablecer la conectividad. Configure mediante AT@BMS.
| Parámetro | Descripción |
|---|---|
| Report Mode | 0 = Stop, 1 = TCP, 2 = UDP, 3 = MQTT |
| Buffer Mode | 0 = desactivado, 1 = baja prioridad, 2 = alta prioridad |
| BMS Server IP / Port | Dirección del servidor de gestión |
| Connection Life | 0 o 5–300 segundos keep-alive TCP |
| Report Interval | 1–2880 minutos |
| BMR Data Mask | Nivel batería, versión config, estado IGN, info GNSS, info SIM, versión módulo, boot firmware |
Latido y acuse de recibo
| Trama | Dirección | Descripción |
|---|---|---|
| +HBD | Dispositivo → servidor | Latido periódico en modo TCP o UDP (intervalo en AT@SIS) |
| +SHBD | Servidor → dispositivo | Respuesta del servidor a +HBD |
| +ACK | Dispositivo → servidor | Confirma recepción de comando de configuración válido |
| +NACK | Dispositivo → servidor | Rechaza un comando de configuración ilegal |
| +SACK | Servidor → dispositivo | Acuse del servidor cuando SACK Enable está activado |
Respuestas a consultas
| Trama | Descripción |
|---|---|
| +QRY | Respuesta a un comando de consulta individual |
| +ALL | Respuesta masiva con todos los parámetros configurados |
| +QNI | Información de red (APN, IMSI, ICCID, CSQ, cell ID) |
| +VER | Versiones de firmware y hardware |
| +GSV | Visibilidad de satélites GPS |
| +LSV | Valores de satélites GLONASS |
| +BSV | Valores de satélites BEIDOU |
| +GAV | Valores de satélites GALILEO |
| +SCF | Campos de configuración del servidor |
| +TCF | Campos de configuración del terminal (incl. calibración inclinación) |
| +DFI | Información de archivo del dispositivo (subcomando 16 de AT@RTO) |
Términos y abreviaturas
| Término | Significado |
|---|---|
| ACK | Acuse de recibo (Acknowledgement) |
| AGPS | Sistema de posicionamiento asistido |
| APN | Nombre del punto de acceso |
| BLE | Bluetooth Low Energy |
| GNSS | Sistema global de navegación por satélite |
| IMEI | Identidad internacional de equipo móvil |
| IoT | Internet de las cosas |
| LDP | Mensaje de paquete de datos grande |
| MQTT | Protocolo de telemetría MQTT |
| RPT | Mensaje de informe |
| SACK | Acuse del servidor |
| TCP / UDP | Protocolos de control de transmisión / datagramas de usuario |
| TLS | Seguridad de la capa de transporte |
| UTC | Tiempo universal coordinado |
| VG | Ignición virtual |
| VGN / VGF | Ignición virtual encendida / apagada |
AVT20 — Protocolo
v3.03 · 2026-06-15 · Release
Página 1 de 94
Si la vista previa no carga, use Descargar o Abrir en nueva pestaña.