GS - SLIMTrack

GS - SLIMTrack
Protocolo de comunicación GPRS
Características generales
SlimTrack es un dispositivo de posicionamiento que reporta a un servidor por
GPRS a través del protocolo TCP
El mecanismo de comunicación puede resumirse de la siguiente manera:
1. Protocolo Dispositivo/Servidor
1.1
Formato del mensaje:
(id_dispositivoCMNDmensaje_variable)
(
Id__dispositivo
CMND
Mensaje_variable
)
inicio de mensaje
ID del dispositivo
comando
dato correspondiente a CMND
fin de mensaje
1.2
Tipos de comandos: CMND
1.2.1
Los comandos CMND tienen 4 caracteres
1.2.2
Los comandos que van desde el servidor al dispositivo empiezan con
la letra A
1.2.3
Los comandos que van desde el dispositivo al servidor empiezan con
la letra B
2. Conexión
2.1
2.2
2.3
2.4
El dispositivo hace una petición de conexión al servidor (Login, BP05)
El servidor acepta la petición (respuesta al pedido de Login, AP05)
El dispositivo intenta mantener la conexión abierta enviando una señal
periódica (Handshake, BP00)
El servidor le responde a esa señal (respuesta al Handshake, AP01)
Página 1 de 12
Versión Mayo 2013
3. Reportes de posición
3.1
3.2
El dispositivo reportará su posición periódicamente al servidor (reporte
periódico)
El dispositivo intentará reenviar posiciones anteriores cuyos reportes no
lograron una conexión efectiva en su momento (descarga de log /
memoria).
4. Comandos enviados desde el servidor y respuestas del dispositivo
El dispositivo reportara las respuestas a comandos enviados desde el
servidor.
Página 2 de 12
Versión Mayo 2013
1- Formato General de los mensajes
(ID_DispositivoCMNDmensaje_variable)
donde:
(
ID_Dispos
itivo
inicio de mensaje (0x28) (40)
ID del dispositivo
12 caracteres, tipo string
CMND
Comando
4 caracteres, tipo string
Axxx: Los comandos enviados desde el servidor
comienzan con la letra A
Bxxx: Los reportes enviados desde el dispositivo
comienzan con la letra B
Mensaje_
variable
Cuerpo del mensaje, depende del comando CMND
Longitud variable
)
fin de mensaje (0x29) (41)
Página 3 de 12
Versión Mayo 2013
2- Conexión TCP entre Dispositivo y Servidor
BP05 Login: petición de conexión
Petición de conexión del dispositivo hacia el servidor
1. El dispositivo envía:
(012345678901BP05000012345678901130520A3439.9629S058
26.3504W000.1175622323.8700000000L000450AC)
(
012345678901
BP05
000
012345678901
130520
A
3439.9629
S
05826.3504
W
000.1
175622
323.87
00000000
L
000450AC
)
inicio de mensaje
ID dispositivo
Comando Login
(reservado)
ID Dispositivo
Fecha: AAMMDD (20 de mayo de 2013)
Validez GPS: ‘A’=válido, ‘V’=inválido
Latitud: ggmm.dddd
(grados minutos décimas de minuto)
Hemisferio: ‘S’=sur, ‘N’=norte
Longitud
(grados minutos décimas de minuto)
‘W’ = oeste, ‘E’ = este
Velocidad en Km/h
Hora: 17:56:22
Rumbo: 000.00 a 359.59
Estados de entradas y salidas: ‘0’ y ‘1’
Byte 1: Alimentación externa: ‘0’ = SI, ‘1’ = NO
Otros bytes: (reservado)
(reservado)
(reservado)
Fin de mensaje
Respuesta del servidor
(012345678901AP05)
AP05
El servidor acepta la conexión (Login)
Página 4 de 12
Versión Mayo 2013
AP05 Respuesta del Servidor a una petición de
conexión (Login)
Respuesta del Servidor a una Petición de conexión del dispositivo
1. El Servidor envía:
(012345678901AP05)
(
012345678901
AP05
)
inicio de mensaje
ID dispositivo
Comando Login
Fin de mensaje
Nota: Origina esta respuesta un pedido de conexión (Login) por
parte del equipo mediante comando BP05
Página 5 de 12
Versión Mayo 2013
BP00 Mantener conexión abierta
Envío de mensaje desde el dispositivo hacia el servidor para mantener
la conexión abierta
1. El Dispositivo envía:
(012345678901BP00000012345678901HSO)
(
012345678901
BP00
000
012345678901
HSO
)
inicio de mensaje
ID dispositivo
Comando: Mantener conexión abierta
(reservado)
ID Dispositivo
dato del mensaje
Fin de mensaje
Respuesta del servidor
(012345678901AP01HSO)
Página 6 de 12
Versión Mayo 2013
AP05 Respuesta del Servidor a petición de mantener
la conexión abierta
Respuesta del Servidor a una Petición del Dispositivo de mantener la
conexión abierta
1. El Servidor envía:
(012345678901AP01HSO)
(
012345678901
AP01
HSO
)
inicio de mensaje
ID dispositivo
Comando repuesta a conexión abierta
confirmación del dato recibido
Fin de mensaje
Nota: Origina esta respuesta un pedido de mantenimiento de
conexión abierta por parte del equipo mediante comando BP00
Página 7 de 12
Versión Mayo 2013
3- Reportes periódicos de posición del dispositivo
BR00 Reporte periódico de posición en línea
Reporte periódico de posición del dispositivo
1. El dispositivo envía:
(012345678901BR00130520A3439.9629S05826.3504W000.11756
22323.8700000000L000450AC)
(
012345678901
BR00
130520
A
3439.9629
S
05826.3504
W
000.1
175622
323.87
00000000
L
000450AC
)
inicio de mensaje
ID dispositivo
Comando de Reporte Periódico en línea
Fecha: AAMMDD (20 de mayo de 2013)
Validez GPS: ‘A’=válido, ‘V’=inválido
Latitud: ggmm.dddd
(grados minutos décimas de minuto)
Hemisferio: ‘S’=sur, ‘N’=norte
Longitud
(grados minutos décimas de minuto)
‘W’ = oeste, ‘E’ = este
Velocidad en Km/h
Hora: 17:56:22
Rumbo: 000.00 a 359.59
Estados de entradas y salidas: ‘0’ y ‘1’
Byte 1: Alimentación externa: ‘0’ = SI, ‘1’ = NO
Otros bytes: (reservado)
(reservado)
(reservado)
Fin de mensaje
Respuesta del servidor
No hay respuesta del servidor
Página 8 de 12
Versión Mayo 2013
BR01 Reporte de posición descargado de log/memoria
Reporte de posición descargado desde log/memoria, debido a que no
pudo ser enviado en el momento en que se generó el reporte
1. El dispositivo envía:
(012345678901BR01130520A3439.9629S05826.3504W000.11756
22323.8700000000L000450AC)
(
012345678901
BR01
130520
A
3439.9629
S
05826.3504
W
000.1
175622
323.87
00000000
L
000450AC
)
inicio de mensaje
ID dispositivo
Comando de Reporte de descarga de posición
Fecha: AAMMDD (20 de mayo de 2013)
Validez GPS: ‘A’=válido, ‘V’=inválido
Latitud: ggmm.dddd
(grados minutos décimas de minuto)
Hemisferio: ‘S’=sur, ‘N’=norte
Longitud
(grados minutos décimas de minuto)
‘W’ = oeste, ‘E’ = este
Velocidad en Km/h
Hora: 17:56:22
Rumbo: 000.00 a 359.59
Estados de entradas y salidas: ‘0’ y ‘1’
Byte 1: Alimentación externa: ‘0’ = SI, ‘1’ = NO
Otros bytes: (reservado)
(reservado)
(reservado)
Fin de mensaje
Respuesta del servidor
No hay respuesta del servidor
Página 9 de 12
Versión Mayo 2013
4- Comandos enviados desde el servidor y respuestas
del dispositivo
AV01 Corte de Combustible
Envío de mensaje desde el Servidor hacia el dispositivo para accionar o
liberar el Corte de Combustible
1. El Servidor envía:
(012345678901AV01b)
(
012345678901
AV01
b
)
inicio de mensaje
ID dispositivo
Comando: Activar/Liberar Corte de Combustible
0 = Activar Corte Combustible
1 = Liberar Combustible
Fin de mensaje
Respuesta del dispositivo
(012345678901BV01)
Página 10 de 12
Versión Mayo 2013
BV01 Respuesta del Dispositivio a Activar/Liberar
Corte de Combustible
Respuesta del Dispositivo a una Petición del Servidor para
Activar/Liberar Corte de Combustible
1. El Dispositivo envía:
(012345678901BV01b)
(
012345678901
BV01
b
)
inicio de mensaje
ID dispositivo
Comando de repuesta a Activación/Liberación
de Corte de Combustible
0 = Corte Combustible Activado
1 = Combustible Liberado
Fin de mensaje
Nota: Origina esta respuesta un pedido de Activación/Liberación del
Corte de Combustible por parte del Servidor mediante comando
AV01
Página 11 de 12
Versión Mayo 2013
© Global Solution S.A. 2013
www.globalsolution.com.ar
CIT- Centro Industrial Tecnológico
Av. Int. Fco. Rabanal 3220 | (C1437FQS) Buenos Aires – Argentina
Telfax: +54 11 4918-4138/ 4130 / 4136
[email protected]
[email protected]
[email protected]
Página 12 de 12
Versión Mayo 2013