Trama Binaria Patrol Scan v6

Manual de trama binaria
Válido solo para las versiones
Patrol Scan v6.0 o superior
Guzmán Barrón 255 – Vista Alegre – Dist. Victor Larco – Trujillo
http://www.telcomip.com [email protected]
+51(44)423040 Nextel( 51*)406*2839
RPC : 940236796 RPM: #977282060
Revisiones del Manual
Rev.
Fecha
Cambios
Autor
1.0
1.1
1.2
1.3
1.4
1.4
1.5
1.5
21/11/2014
07/01/2015
21/01/2015
02/02/2015
10/06/2015
22/07/2015
04/08/2015
16/08/2015
Primera edición
Calculo de consumo
Banderas
Corrección Lat y Long
Ejemplos
Reestructuración de Ejemplos por colores
Combustible y corrección de Estructura de Bandera
Revisión general de textos
HJM
HJM
HJM
LEGS
HJM
EJM
HJM
EJM
Guzmán Barrón 255 – Vista Alegre – Dist. Victor Larco – Trujillo
http://www.telcomip.com [email protected]
+51(44)423040 Nextel( 51*)406*2839
RPC : 940236796 RPM: #977282060
Consideraciones
Este manual indica cómo interpretar el contenido de la trama binaria enviada desde Patrol
Scan hacia el servidor de rastreo en protocolo TCP/UDP. El servidor que recibirá la trama
binaria deberá acondicionar sus tiempo de conexión tanto en tamaño de trama, reposo y
Timeout para evitar la desconexión y conexión recurrente de Patrol Scan porqué esto
genera mayor consumo de tráfico que a su vez se refleja en un mayor costo por mes en la
factura de transmisión de datos.
En este manual se describe la trama básica de Patrol Scan la cual consta de hasta 21 bytes
como máximo pudiendo esta variar según el tipo de información enviada desde Patrol
Scan hacia el servidor.
El consumo de Megabytes por mes dependerá de cómo este configurado Patrol Scan, el
servidor al que se encuentra direccionado y la operadora en la cual se encuentra
funcionando el rastreador. En Condiciones ideales el equipo Patrol Scan consume 0.8Mb
mes bajo condiciones ideales.
Para describir las condiciones ideales se describen a continuación los siguientes términos.
Protocolos:
TCP: Al conectarse al servidor se produce un inicio de sesión que consume 240Bytes
y luego por cada trama enviada tiene una cabecera adicional de 44Bytes, este tipo de
conexión es la más segura y permite evitar pérdidas de datos en la red puesto que el
rastreador al detectar que el servidor no está operativo (gracias al inicio de sesión)
empieza a almacenar datos para cuando se vuelva a reconectar descargar la información
guardada.
UDP: No requiere de inicio de sesión y la cabecera de cada trama es de 28Bytes, este
tipo de conexión es la más económica pero NO es la más segura puesto que si el servidor
no está operativo el rastreador no se enterará de esta desconexión y enviara los datos a la
red y se perderán. Solo se pondrá a grabar cuando por alguna condición de red se pueda
enterar que el servidor no está presente y todo ese tiempo serán puntos perdidos.
Guzmán Barrón 255 – Vista Alegre – Dist. Victor Larco – Trujillo
http://www.telcomip.com [email protected]
+51(44)423040 Nextel( 51*)406*2839
RPC : 940236796 RPM: #977282060
Para el siguiente ejemplo asumiremos un vehículo con intervalo de transmisión de 1
minuto sobre protocolo UDP, trabaja 8 horas diarias de Lunes a Domingo
Cabecera de Transmisión
Tamaño de la trama
Intervalo de transmisión en movimiento
Intervalo de transmisión detenido
Minutos en movimiento por mes
Minutos detenido por mes
Tamaño de la transmisión
Bytes en movimiento
Bytes detenido
Bytes por mes
Consumo factura por mes
28 Bytes para UDP
21 Bytes
1 Minuto
10 Minutos
13440 [480 minutos por Día x 7 días
por semana x 4 semanas por mes]
29760 [43200 minutos por
30 días – 13440 minutos
en movimiento]
49 [ 28bytes cabecera + 21bytes cadena]
13440 [13440 mes /1 min.
Intervalo de movimiento]
2976 [ 29760 / 10 min
Intervalo detenido]
16416 [13440 mov. + 2976 detenido]
804384 bytes (0.8Mb) [ 49 x 16416]
Esta información es solo referencial, en la práctica las tramas enviadas cuando
está detenido podrían reducirse si es que se encuentran en algún lugar sin cobertura
GPS o podría aumentar si es que el servidor no tiene correctamente configurado sus
tiempo de transmisión y timeout haciendo que el dispositivo Patrol Scan haciendo que
tenga muchos intentos de conexión según el protocolo elegido, tampoco se contempla
las veces que se envían comandos desde el servidor.
Guzmán Barrón 255 – Vista Alegre – Dist. Victor Larco – Trujillo
http://www.telcomip.com [email protected]
+51(44)423040 Nextel( 51*)406*2839
RPC : 940236796 RPM: #977282060
TRAMA BÁSICA:
Estructuras F0 – F1 – F2
La estructura para las cadenas de Tipo F0 – F1 – F2 son las mismas en todos los
casos, solo la cabecera inicial identifica que tipo de dato es el enviado, estas 3 tramas
suman un total de 21 Bytes cada una. Este tipo de cadenas son las que se usan para reportar
una ubicación.
<Tipo><Lon><Serie><Vel><Ori><Sat><Fech><Lat><Long><Band>
Donde:
<Tipo> Indica que tipo de información contiene la cadena y esta tiene los siguientes
valores:
F0 = Es la primera cadena que envía el equipo cuando se conecta por primera vez
al servidor o cuando se vuelve a reconectar después de haber estado conectado
con al servidor.
F1 = Es la cadena básica que se enviara después de haber hecho comunicación
con el servidor, es a lo que llamamos Cadena On-Line.
F2 = Es la cadena básica que contiene información almacenada porque no se pudo
enviar al servidor por diferentes motivos, es a lo que llamamos Cadena Off-Line
(Datos Grabados)
F3 = Es la cadena básica que indica cuando el equipo está reportando pero no
puede captar posición por falta de satélites o intensidad de satélites insuficientes
para triangular su posición, por ejemplo sótanos, edificios altos o corte de antena.
F4 = Es la cadena básica que informa que la comunicación con el modulo GPS
tiene problemas y podría necesitar inspección en la fábrica.
FF = Es la cadena de confirmación que genera Patrol Scan después de haber
recibido la petición de ejecutar un comando, (abre, limpia, apaga, etc.)
Estructura : Big-Endian
Signo : Sin Signo
Tamaño : 1 Byte
<Lon> Indica el tamaño que tendrá la cadena luego de este valor.
Estructura : Big-Endian
Signo : Sin Signo
Tamaño : 1 Byte
Guzmán Barrón 255 – Vista Alegre – Dist. Victor Larco – Trujillo
http://www.telcomip.com [email protected]
+51(44)423040 Nextel( 51*)406*2839
RPC : 940236796 RPM: #977282060
<Serie> Indica el número de SERIE del equipo, a diferencia de versiones anteriores
ahora la cadena enviara el número del equipo el cual es irrepetible en nuestros diferentes
productos lo cual permite una identificación sin confusiones.
Estructura : Big-Endian
Signo : Sin Signo
Tamaño : 3 Bytes
<Vel> Indica la velocidad del equipo, expresado en Km/h este valor puede variar de 0 a
255 convertido a decimal, los valores son solo enteros.
Estructura : Big-Endian
Signo : Sin Signo
Tamaño : 1 Byte
<Ori> Indica la orientación del rumbo, este valor son solo enteros y puede variar entre
0 a 180 convertido a decimal, a este valor hay que multiplicarlo por 2 y se obtiene la
orientación final en esta cadena, la precisión de la orientación es +/- 1 Grado
Estructura : Big-Endian
Signo : Sin Signo
Tamaño : 1 Byte
<Sat> Indica la cantidad de satélites con los cuales está trabajando en ese instante Patrol
Scan, los valores pueden variar de 3 a 15 convertido a decimal.
Estructura : Big-Endian
Signo : Sin Signo
Tamaño : 1 Byte
<Fech> Indica la Fecha y la Hora en formato EPOCH TIME (puede conseguir mayor
información en http://www.epochconverter.com)
Estructura : Little-Endian
Signo : Sin Signo
Tamaño : 4 Bytes
<Lat> Indica la Latitud y está en formato entero con signo se debe dividir entre 10000
para obtener el valor final.
Estructura : Little-Endian
Signo : Con Signo
Tamaño : 4 Bytes
Guzmán Barrón 255 – Vista Alegre – Dist. Victor Larco – Trujillo
http://www.telcomip.com [email protected]
+51(44)423040 Nextel( 51*)406*2839
RPC : 940236796 RPM: #977282060
<Long> Indica la Longitud y está en formato entero con signo se debe dividir entre
10000 para obtener el valor final.
Estructura : Little-Endian
Signo : Con Signo
Tamaño : 4 Bytes
<Band> Indica el estado y es expresado en Hexadecimal.
Estructura : Big-Endian
Signo : Sin Signo
Tamaño : 1 Byte
A CONTINUACION SOLO SE DESCRIBEN LOS CAMPOS ANTES NO
MENCIONADOS
Estructura F3
Es la cadena básica que indica cuando el equipo está reportando pero no puede
captar posición por falta de satélites o intensidad de satélites insuficientes para triangular
su posición, por ejemplo sótanos, edificios altos o corte de antena. El total de consumido
es de 12 Bytes.
<Tipo><Lon><Serie><Band><Libre><Fech>
<Libre> Son Caracteres sin uso por el momento.
Tamaño : 2 Bytes
Estructura F4
Es la cadena básica que informa que la comunicación con el modulo GPS tiene
problemas y podría necesitar inspección en la fábrica. El total consumido es de 8 Bytes.
<Tipo><Lon><Serie><Band><Libre>
<Libre> Son Caracteres sin uso por el momento.
Tamaño : 2 Bytes
Guzmán Barrón 255 – Vista Alegre – Dist. Victor Larco – Trujillo
http://www.telcomip.com [email protected]
+51(44)423040 Nextel( 51*)406*2839
RPC : 940236796 RPM: #977282060
Estructura FF
Es la cadena de confirmación que genera Patrol Scan después de haber recibido la
petición de ejecutar un comando, (abre, limpia, apaga, etc.). El total consumido es 6
Bytes.
<Tipo><Lon><Serie><Rpta>
<Rpta> Indica el resultado de la petición de ejecución de un comando.
0 = ERROR cuando el comando no existe o no pudo ser ejecutado.
1 = OK cuando la petición a sido aceptada y será ejecutada.
Estructura : Big-Endian
Signo : Sin Signo
Tamaño : 1 Byte
Guzmán Barrón 255 – Vista Alegre – Dist. Victor Larco – Trujillo
http://www.telcomip.com [email protected]
+51(44)423040 Nextel( 51*)406*2839
RPC : 940236796 RPM: #977282060
Banderas
La Bandera es un dato formado de 2 dígitos que esta expresado en Hexadecimal, según
sean lo valores de activado = 1 o desactivado = 0 esto formara una palabra binaria a
continuación se detalla la bandera:
Relé de
apagado
Vehicula
r ha sido
activado
Alarma
del
Vehícul
o
Activad
o
Censado
de
Encendid
o
Alarm
a de
Corte
de
Baterí
a
Alarm
a
Botón
de
Pánico
Alarm
a
Corte
Anten
a GPS
Ejemplos:
Si se activara el botón de pánico la palabra seria la siguiente:
0
0
0
0
1
0
Al convertir este número binario a Hexadecimal se tiene: 08
Si se activara Corte de Batería
0
0
0
1
0
0
Al convertir este número binario a Hexadecimal se tiene: 10
Si se activara Relé de apagado y Botón de Pánico
1
0
0
0
1
0
Al convertir este número binario a Hexadecimal se tiene: 88
Guzmán Barrón 255 – Vista Alegre – Dist. Victor Larco – Trujillo
http://www.telcomip.com [email protected]
Alarma
Alarma
Vehículo Exceso de
a salido Velocidad
de la
Detectad
Geocerc
o
a
0
0
0
0
0
0
+51(44)423040 Nextel( 51*)406*2839
RPC : 940236796 RPM: #977282060
Ejemplos
A Continuación ejemplos de las tramas básicas y su significado.
Long[Bytes]:21 Recv[HEX]: F013143393325D06B86C9555FA894FFFEA5B68FB20
Fíjese que solo en la primera trama hemos divido por colores la ubicación de
cada uno de los campos y la conversión también esta descrita por los mismos colores
pero los valores están convertidos según las instrucciones del significado de cada byte.
Long[Bytes]:21 Recv[HEX]: F013143393325D06B86C9555FA894FFFEA5B68FB20
Código: F0
Longitud de cadena: 13Hex [19 Bytes]
Serie del equipo: 143393
Velocidad: 50.0 kph
Orientación: 186.0
Cantidad de Satélites: 6 Sat
Fecha Epoch Time: 1435856056 [Thu Jul 02 11:54:16 PET 2015]
Lat/Long: -11.9409167 , -77.0780100
Bandera: 20Hex Binario : 100000 [6 Bits]
Long[Bytes]: 21 Recv[HEX]: F1131433F500A20AB9549455182E47FF40AD6FFB00
Código: F1
Longitud de cadena: 13Hex [19 Bytes]
Serie del equipo: 1433F5
Velocidad: 0.0 kph
Orientación: 324.0
Cantidad de Satélites: 10 Sat
Fecha Epoch Time: 1435784377 [Wed Jul 01 15:59:37 PET 2015]
Lat/Long : -12.1872667 , -76.9453867
Bandera: 00Hex Binario : 0 [1 Bits]
Long[Bytes]: 21 Recv[HEX]: F2132833AA1262052B50945551564FFF109268FB24
Código : F2
Longitud de cadena: 13Hex [19 Bytes]
Serie del equipo: 2833AA
Velocidad: 18.0 kph
Orientación: 196.0
Cantidad de Satélites: 5 Sat
Fecha Epoch Time: 1435783211 [Wed Jul 01 15:40:11 PET 2015]
Lat/Long : -11.9629583 , -77.0549067
Bandera: 24Hex Binario : 100100 [6 Bits]
Long[Bytes]: 12 Recv[HEX]: F30A1533920000204C529455
Código : F3
Longitud de cadena: 0AHex [10 Bytes]
Serie del equipo : 153392
Bandera: 00Hex Binario 0 [1 Bits]
Bytes Libres: 00HEX
Fecha Epoch Time: 1435783756 [Wed Jul 01 15:49:16 PET 2015]
Guzmán Barrón 255 – Vista Alegre – Dist. Victor Larco – Trujillo
http://www.telcomip.com [email protected]
+51(44)423040 Nextel( 51*)406*2839
RPC : 940236796 RPM: #977282060
Long[Bytes]: 6 Recv[HEX]: FF041433C501
Código: FF
Longitud de cadena: 04Hex [4 Bytes]
Serie del equipo: 1433C5
Respuesta: 01Hex (OK)
Guzmán Barrón 255 – Vista Alegre – Dist. Victor Larco – Trujillo
http://www.telcomip.com [email protected]
+51(44)423040 Nextel( 51*)406*2839
RPC : 940236796 RPM: #977282060
Extensión
TramaBásica+Combustible
Estructuras E0 – E1 – E2
Las estructuras del Tipo E son similares que las F, solamente adiciona las banderas
del sensor presente y el valor de los sensores la trama para 1 solo sensor de combustible
consta de 24 bytes y tiene el siguiente formato.
<Tipo><Lon><Serie><Vel><Ori><Sat><Fech><Lat><Long><Band><Band2><Val01>
Donde :
Los campos previos a Band2 están explicados en el capítulo anterior.
<Band2> Indica el tipo de Lectura y la cantidad de sensores presentes.
Estructura : Big-Endian
Signo : Sin Signo
Tamaño : 1 Byte
Reservado
Reservado
Reservado
Reservado
Reservado
Sensor #2
presente
Sensor #1
presente
ADC
Modo
ADC modo
= 0 si el dato enviado es un valor ADC
Para esta condición el dato <Val01> se leerá directamente.
Ejemplo:
<Val01> += 0F03 = 3843 en decimal
= 1 si el dato enviado es un valor en Galones
Para esta condición el dato <Val01> se deberá hacer la conversión a
galones como se indica a continuación.
Ejemplo:
<Val01> += 04D2 = 1234 en decimal /100 = 12.34 Galones
El Valor Máximo en ADC es 0xFFFF (65535) y en Galones es 0xFFFF/100
(655.35)
Sensor #1 presente
= 0 no hay lectura presente y no existe sensor 1
= 1 si hay lectura desde el sensor
Sensor #2 presente
= 0 no hay lectura presente y no existe sensor 2
= 1 si hay lectura desde el sensor
Guzmán Barrón 255 – Vista Alegre – Dist. Victor Larco – Trujillo
http://www.telcomip.com [email protected]
+51(44)423040 Nextel( 51*)406*2839
RPC : 940236796 RPM: #977282060
<Val01> Indica el Valor leído del sensor en ADC o en Galones
Estructura : Little-Endian
Signo : Sin Signo
Tamaño : 2 Bytes
Ejemplo de una cadena de combustible:
Long[Bytes]:24 Recv[HEX]: E1162833FC000009871DCE55CBAB84FF0E214AFB000304D2
E1 16 2833FC 00 00 09 871DCE55 CBAB84FF 0E214AFB 00 03 04D2
Band2 : 03 = Sensor 1 presente y con lectura , con ADC modo en Galones
Val01 : 04D2 = 1234 en decimal /100 = 12.34 Galones
Comandos Especiales solo para funciones de GPS para tractor
Para asegurar la recepción de cada una de las tramas enviadas, el servidor
deberá responderá al equipo de rastreo el siguiente comando:
.posOK.
Para poder leer las posiciones almacenadas en la memoria micro SD el servidor
deberá enviar el siguiente comando:
.sdleer.HHddMMyy*
Donde:
HH = Es la hora en formato 24hr : 00 – 23
dd = Es el día del mes en 2 dígitos: 01 – 31
MM = Es el mes del año en 2 dígitos: 01 – 12
yy = Es el año en 2 dígitos: 15, 16, 17 ….
El equipo de rastreo grabara todas las posiciones en archivos agrupados por
horas, el intervalo de grabación está definido por el usuario y se encuentra en el
manual de uso del equipo.
Para eliminar un registro en particular en la memoria micro SD se envía el
siguiente comando:
.sdborrar.HHddMMyy*
Para eliminar los datos en la micro SD.
.sdlimpiar.
Para detener el envió de los datos de la memoria micro SD después de haber
solicitado la descarga.
.sdstop.
Guzmán Barrón 255 – Vista Alegre – Dist. Victor Larco – Trujillo
http://www.telcomip.com [email protected]
+51(44)423040 Nextel( 51*)406*2839
RPC : 940236796 RPM: #977282060