Mesajes
Este capítulo describe los formatos de todos los tipos de mensajes. Puede solicitar mensajes de un tipo específico utilizando marcas.
Todas las marcas se utilizan solo en formato DEC.
Tipos de mensajes
Los siguientes tipos de mensajes están disponibles:
| Marca en HEX | Marca en DEC | Descripción |
|---|---|---|
| 0x0000 | 0 | Mensaje de datos |
| 0x0100 | 256 | SMS |
| 0x0200 | 512 | Comando |
| 0x0400 | 1024 | Historial de usuario |
| 0x0300 | 768 | Notificación de usuario |
| 0x0500 | 1280 | Mensaje de facturación |
| 0x0600 | 1536 | Evento |
| 0x0700 | 1792 | Cultivo de parcela |
| 0x0800 | 2048 | Registro de servicio WDC |
| 0x0900 | 2304 | SMS del conductor |
| 0x1000 | 4096 | Registro de historial |
| 0x2000 | 8192 | Uso de vídeo |
| 0x4000 | 16384 | Mensaje de activación de notificación |
| 0x5000 | 20480 | Asunto |
Para eliminar mensajes específicos, debe tener las siguientes marcas ACL:
| Tipo de mensaje | Marca de mensaje HEX(DEC) | Marca ACL HEX(DEC) |
|---|---|---|
| Mensaje de datos | 0x0000(0) | 0x800000(8388608) |
| SMS | 0x0100(256) | 0x800000(8388608) |
| Comando | 0x0200(512) | 0x800000(8388608) |
| Evento | 0x0600(1536) | 0x2000000(33554432) |
| Historial | 0x1000(4096) | 0x800(2048) |
Para obtener más información sobre las marcas ACL, consulte la sección Marcas de acceso.
Mensaje de datos
La marca de los mensajes de datos es 0x0000.
{
"t": <uint>, /* Hora del mensaje (UTC) */
"f": <uint>, /* Marcas (ver abajo) */
"tp": "ud", /* Tipo de mensaje ('ud' denota un mensaje de datos) */
"pos": { /* Ubicación */
"y": <double>, /* Latitud */
"x": <double>, /* Longitud */
"z": <int>, /* Altitud */
"s": <uint>, /* Velocidad */
"c": <uint>, /* Rumbo */
"sc": <ubyte> /* Cantidad de satélites */
},
"i": <uint>, /* Datos de entrada */
"o": <uint>, /* Datos de salida */
"p": { /* Parámetros */
<text>: <double>
...
},
"lc": <int>, /* Suma de verificación del mensaje LBS */
"rt": <uint> /* Hora de registro del mensaje (UTC) */
}
Marcas de mensaje de datos:
| Valor HEX | Valor DEC | Descripción |
|---|---|---|
| 0x01 | 1 | Los datos de ubicación están disponibles. |
| 0x02 | 2 | La información sobre datos de entrada está disponible. |
| 0x04 | 4 | La información sobre datos de salida está disponible. |
| 0x10 | 16 | El mensaje contiene un bit de alarma. |
| 0x20 | 32 | El mensaje contiene información sobre el código del conductor en el parámetro avl_driver. |
| 0x20000 | 131072 | El mensaje fue corregido por LBS. |
SMS
La marca de los mensajes SMS es 0x0100(256).
{
"t": <uint>, /* Hora del mensaje (UTC) */
"f": <uint>, /* Marcas: los mensajes SMS no tienen marcas, por lo que se colocará 0 */
"tp": "us", /* Tipo de mensaje ('us' denota un mensaje SMS) */
"st": <text>, /* Texto del mensaje */
"mp": <text>, /* Número de teléfono del módem */
"p": {} /* Parámetros */
}
Comando
La marca de los comandos es 0x0200(512).
{
"t": <uint>, /* Hora del mensaje (UTC) */
"f": <uint>, /* Marcas: los comandos no tienen marcas, por lo que se colocará 0 */
"tp": "ucr", /* Tipo de mensaje ('ucr' denota un comando) */
"ca": <text>, /* Nombre del comando */
"cn": <text>, /* Tipo de comando */
"cp": <text>, /* Parámetros del comando */
"ui": <uint>, /* ID de usuario */
"ln": <text>, /* Nombre del enlace */
"lt": <text>, /* Tipo de enlace */
"et": <uint>, /* Hora de ejecución */
"p": {} /* Parámetros */
}
Los tipos de enlace se describen en la página update_command_definition.
Evento
La marca de los eventos es 0x0600(1536).
{
"t": <uint>, /* Hora del mensaje (UTC) */
"f": <uint>, /* Marcas (ver abajo) */
"tp": "evt", /* Tipo de mensaje ('evt' denota un evento) */
"et": <text>, /* Texto del evento */
"x": <double>, /* Longitud */
"y": <double>, /* Latitud */
"p": {} /* Parámetros */
}
Marcas de eventos:
| Valor HEX | Valor DEC | Descripción |
|---|---|---|
| 0x0 | 0 | Evento simple. |
| 0x1 | 1 | Infracción. |
| 0x2 | 2 | Servicio de mantenimiento o llenado de combustible. |
| 0x4 | 4 | Progreso de ruta. |
| 0x10 | 16 | Servicio de mantenimiento. Esta marca se establece además de 0x2. |
| 0x20 | 32 | Llenado de combustible. Esta marca se establece además de 0x2. |
Notificación
La marca de las notificaciones es 0x0300(768).
{
"t": <uint>, /* Hora del mensaje (UTC) */
"f": <uint>, /* Marcas: las notificaciones no tienen marcas, por lo que se colocará 0 */
"tp": "xx", /* Tipo de mensaje */
"p": {} /* Parámetros */
}
Mensaje de facturación
La marca de los mensajes de facturación es 0x0500(1280).
{
"t": <uint>, /* Hora del mensaje (UTC) */
"f": <uint>, /* Marcas: 0x1 se establece cuando el mensaje contiene información de pago */
"tp": "xx", /* Tipo de mensaje */
"p": {} /* Parámetros */
}
SMS al conductor
La marca de los mensajes SMS es 0x0900(2304).
{
"t": <uint>, /* Hora del mensaje (UTC) */
"f": <uint>, /* Marcas: 0x1 se establece cuando el mensaje es enviado */
"tp": "xx", /* Tipo de mensaje */
"p": { /* Parámetros */
"phone": <text>, /* Número de teléfono */
"sms_text": <text>, /* Texto del SMS */
"driver_name": <text>, /* Nombre del conductor */
"driver_id": <uint> /* ID del conductor */
}
}
Historial
La marca de los registros de historial es 0x1000(4096).
{
"t": <uint>, /* Hora del mensaje (UTC) */
"f": 4096, /* Marcas: 4096 denota un registro de historial */
"tp": "xx", /* Tipo de mensaje */
"p": { /* Parámetros */
"user": <text>, /* Nombre de usuario */
"action": <text>, /* Acción */
"host": <text>, /* Host */
"p1": <text>, /* Parámetros */
...
}
}
Mensajes WLN
Los mensajes WLN tienen el siguiente formato:
REG;time;lon;lat;speed;course;double params;int params;text params;long params;boolean params;
Dentro de la sección, los parámetros están separados por comas. Ejemplo:
REG;1466585078;30.4367027283;59.7207145691;1;273;ALT:24.0,adc1:0.0,adc2:25.57,adc3:0.0,adc4:0.0,adc5:0.0,adc6:0.0,fuel1:0.0,fuel2:170.0,fuel3:0.0,odometer:7293607.0,acc:0.0,pwr_int:0.731,pwr_ext:25.751,hdop:1.7;in13:1,,SATS:5,count1:1,count2:0,temp1:0,temp2:23,temp3:0,sats_glonass:0,sats_gps:5;soft_version:"44";;;