Rastreadores GPS
AVT50
Protocolo
Protocolo AVT50 Tracker
Revisión 2.05 — 7 may 2026 — Mensaje +DFI, límites relé BLE IGN, valla poligonal PEO
El protocolo AVT50 Tracker R2.05 define el formato del flujo de datos, los comandos de configuración y las estructuras de mensajes entre el rastreador GNSS AVT50 y el servidor backend. 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-10 | GNSS Satellites Number en AT@GCS; Charging Mode; limpieza Event Data Mask |
| 1.03 | 2025-05-10 | Escaneo BLE AT@BSS; AT@JAM/TAS; AT@ETS/EHS; eventos temp/humedad externa; +TCF |
| 1.04 | 2025-09-10 | Parámetro GNSS Timeout en AT@GCS |
| 1.05 | 2025-09-24 | Servidor secundario AT@SSI; TLS (TCR/TCL); MQTT (MQT); AT@UPC; AT@BWS; evento upgrade config |
| 2.01 | 2026-01-12 | Filtro GNSS geo-cerca AT@GGF; alarma spoofing GNSS (tipo 39); params señal LTE en AT@JAM |
| 2.02 | 2026-02-03 | Máscara ECL Trigger en +RPT; ECL Trigger Report en AT@ECL |
| 2.03 | 2026-02-25 | Valla poligonal AT@PEO; conexión/relé BLE AT@BCS/BRY/BOS; eventos PEO 40/41 |
| 2.04 | 2026-03-23 | Actualizaciones TOW/MOV/IGN/HBS/CRA; params GSM en AT@JAM; whitelist ABK100 en AT@BSS |
| 2.05 | 2026-05-07 | Mensaje +DFI; límites salida IGN y bits relé BLE; ABR100 en AT@BCS; debounce IGN |
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 |
Todas las tramas terminan con el carácter "#" (0x23). En tramas ASCII imprimibles, "," separa parámetros adyacentes. En tramas hexadecimales no hay separador.
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, 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 (incl. PEO bits 21/24), LED, GNSS/AGPS, odómetro, contador horario, modo carga, timeout GNSS |
| RRS | AT@RRS= | Informe GNSS periódico: modo, intervalos IGN/IGF, ángulo de giro, standby largo |
| RTO | AT@RTO= | Operación en tiempo real: reinicio, apagado, reset, 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 |
| TOW | AT@TOW= | Detección de alarma de remolque (TOW) |
| SPD | AT@SPD= | Umbral y duración de alarma de velocidad |
| GEO | AT@GEO= | Geo-cercas circulares (hasta 32 zonas) |
| PEO | AT@PEO= | Vallas poligonales (hasta 50 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 (umbrales señal LTE y 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 y ADC | IGN | Ignición e ignición virtual; máscara salidas con ignición ON, límite velocidad GNSS, debounce |
| E/S y ADC | DAM | Multiplexado entradas digitales y analógicas (incl. delta AIS) |
| E/S y ADC | OUT | Salidas digitales |
| E/S y ADC | AOS | Asignación de salidas de alarma y máscaras de activación |
| BLE | BSS | Escaneo BLE, filtro UUID iBeacon, verificación whitelist accesorios |
| BLE | BWS | Lista blanca balizas BLE (grupos MAC, hasta 256 entradas) |
| 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 |
Modo de informe (SIS/SSI/BMS): 0 = Stop, 1 = TCP, 2 = UDP, 3 = MQTT. Modo búfer: 0 = desactivado, 1 = baja prioridad, 2 = alta prioridad.
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
- AT@PEO?at,,# — consultar vallas poligonales
Enviados por el servidor, la respuesta va al servidor. Enviados por SMS, la respuesta va por SMS.
Formato de mensajes
Los informes, búfer 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, +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/PEO, contador horario, choque, inclinación, TLS, E/S digital |
| 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 |
| 15 | Alarma de remolque |
| 16 | Alarma de exceso de velocidad |
| 19 | Alarma de conducción brusca |
| 20 | Autocalibración G-sensor |
| 21 | Alarma de geo-cerca |
| 22 | Entrada digital 1 |
| 27 | Alarma de salida |
| 28 | Alarma delta AIS |
| 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 |
| 40 | Alarma valla PEO |
| 41 | Alarma exceso velocidad valla PEO |
| 43 | Alarma ECL trigger |
El PDF completo detalla cada estado de evento, bit de máscara PEO, campo de datos y longitud en bytes con rangos de valores.
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 |
| MQTT | Protocolo de telemetría MQTT |
| PEO | Valla poligonal (zona geo) |
| 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 |
| TOW | Detección de remolque |
| UTC | Tiempo universal coordinado |
| VG | Ignición virtual |
| VGN / VGF | Ignición virtual encendida / apagada |
En este documento, "terminal", "dispositivo" y "equipo" se refieren al rastreador GNSS AVT50 salvo indicación contraria.
AVT50 — Protocolo
v2.05 · 2026-05-07 · Release
Página 1 de 105
Si la vista previa no carga, use Descargar o Abrir en nueva pestaña.