PROTOCOLO DE COMUNICAÇÃO RASTREADOR EASY TRACKER MODELO 328908 Versão: 2.01 Data Versão: 19/06/2013 Número de páginas: 8 Nome do arquivo: Protocolo de Comunicação 328908
CONTROLE DE VERSÃO Versão Data Autor Descrição 2.01 19/06/2013 Francisco de Paula Lima Filho Criação 2.02 20/08/2013 Francisco de Paula Lima Filho Melhorias: inclusão de outros periféricos
STRING DE RASTREAMENTO FORMATO ASCII - UDP N TIPO DESCRIÇÃO 0 Início de Mensagem Sempre igual a 02 hexadecimal 1 Status de posição 2=Normal; 3=Da memória; 4=modem satelital; 5=outros periféricos; Quando o status da posição for iguala 5 utilizar a tabela Outros Periféricos que se encontra na página 8 2 Status do GPS A = Posição Atualizada; M = Memória; I = Inválido; 3 Versão Versão do Firmware 4 D Dezena do dia 5 D Unidade do dia 6 M Dezena do mês 7 M Unidade do mês 8 Y Dezena do ano 9 Y Unidade do ano 10 H Dezena da hora 11 H Unidade da hora 12 M Dezena do minuto 13 M Unidade do minuto 14 S Dezena do segundo 15 S Unidade do segundo 16 Sinal da longitude W = Oeste; L = Leste; 17 Long Longitude 18 Long Longitude 19 Long Longitude 20 Long Longitude 21 Long Longitude 22 Long Longitude 23 Long Longitude 24 Long Longitude 25 Sinal da latitude S = Sul; N = Norte; 26 Lat Latitude
27 Lat Latitude 28 Lat Latitude 29 Lat Latitude 30 Lat Latitude 31 Lat Latitude 32 Lat Latitude 33 Lat Latitude 34 Velocidade Centena da velocidade em km/h 35 Velocidade Dezena da velocidade em km/h 36 Velocidade Unidade da velocidade em km/h 37 Direção Centena do Ângulo GPS 38 Direção Dezena do Ângulo GPS 39 Direção Unidade do Ângulo GPS 40 ID Série do equipamento 41 ID Série do equipamento 42 ID Série do equipamento 43 ID Série do equipamento 44 ID Série do equipamento 45 ID Série do equipamento 46 Ignição 1 = Pós-chave ligado; 0 = Desligado; 47 Antifurto 1 = Disparado; 0 = Normal; 48 Saídas 1 4 Uma saída por bit; 0 = Desligado; 1 = Ligado (saídas de 3 a 4 disponível no modelo 328908 Plus) 49 Entradas 2 8 Uma saída por bit; 0 = Desligado; 1 = Ligado (entradas de 4 a 8 disponível no modelo 328908 Plus) 50 Acelerômetro P = Parado; M = Movimento; 51 Acelerômetro X Valor Hexadecimal 52 Acelerômetro Y Valor Hexadecimal 53 Acelerômetro Z Valor Hexadecimal 54 Tensão da Bateria Valor Hexadecimal 55 Terminador Sempre igual a 03 Hexadecimal
Resposta de confirmação ao equipamento Toda mensagem enviada pelo rastreador deverá ser retornada com um byte de ACK 06 hexadecimal. É obrigatório gerar uma resposta ao equipamento quando chegar uma string, pois se não houver essa resposta o equipamento considerará que a mensagem não foi enviada e armazenará na sua memória interna para ser enviada posteriormente. Cálculo da latitude/longitude: São 9 caracteres ao todo que chegam do equipamento por coordenada. Vou mencionar eles pela posição. Por exemplo: Latitude: S23330020 Longitude: W46323510 Nesse caso o S e o W seriam o primeiro caractere. Cálculo da Latitude: Exemplo da Latitude: S23330020 No sinal da Latitude podem vir 2 caracteres. S ou N. S = Sinal Negativo; N = Sinal Positivo; Depois disso, separa-se os dois primeiros caracteres. No caso 23, o segundo e terceiro caractere. O restante 330020, precisa ser dividido por 0,6. Resultado: 550033,333333333
Disso, se separa o número antes da vírgula. 550033 Nesse caso, a resposta teve 6 caracteres, se tivesse 4 ou 5, seria necessário adicionar um 0 a frente do resultado, por exemplo, se a resposta fosse 50033, teria que adicionar um zero a frente para ficar 050033. Se a resposta fosse 0033, adicionaria dois zeros a frente, a resposta ficara 000033. Se a resposta tiver mais de 6 caracteres, por exemplo 7550033, remover o primeiro caractere. Nesse caso ficaria 550033. Com essa resposta, adiciona os outros caracteres de volta, sendo que para separar o caractere 2 e 3 dos outros números, adiciona-se um ponto.. No final fica: -23.550033 Cálculo da Longitude Exemplo de longitude: W 46323510 A longitude no Brasil sempre é negativa. Então sempre chegará um W na longitude. Então o sinal sempre é negativo. Depois separa os segundo e terceiro caractere, no caso o 46. Divide o restante por 0,6, no caso o 323510. Resultado: 539183,333333333 Separa o número anterior a vírgula, 539183. Verifica a quantidade de caracteres e adiciona os zeros se necessário ou remove os caracteres necessários. Adiciona o sinal e o ponto. No final fica: -46.539183 Verificando as coordenadas obtidas no Google Maps. HTTP://maps.google.com/maps?f=q&source=s q&hl=pt-br&geocode=&q=-23.550033,%20-46.539183
Acelerômetro O acelerômetro varia de 0x00 a 0x64 respectivamente -90º a 90 º onde 0x32 = 0º. Comandos para o Equipamento Os comandos abaixo devem ser enviados no mesmo IP e porta da ultima conexão recebida e pelo mesmo IP e porta que está configurado no equipamento. Ao receber um comando o equipamento enviará uma resposta de confirmação com o código hexadecimal 06. -Configurações: CMD + ID + apn1 (APN) (usuário) (senha) CMD + ID + apn2 (APN) (usuário) (senha) CMD + ID + porta1 (porta) CMD + ID + porta2 (porta) CMD + ID + num1 (número1 de envio SMS) CMD + ID + num2 (número2 de envio SMS) CMD + ID + num3 (número3 de envio SMS) CMD + ID + num4 (número4 de envio SMS) CMD + ID + trackingon (rota detalhada ativada) CMD + ID + trackingoff (rota detalhada desativada) CMD + ID +angle (ângulo da rota detalhada em graus) -Troca de tempo de transmissão: CMD + ID + Timeon (tempo em segundos) CMD + ID + Timeoff (tempo em segundos) CMD + ID + Timestartsleep (tempo em segundos) CMD + ID + Timesleep (tempo em segundos) CMD + ID + Timegpsinvalid (tempo em segundos) -Saídas: CMD + ID + outputon + n CMD+ ID + outputoff + n
STRING DE RASTREAMENTO FORMATO ASCII UDP OUTROS PERIFÉRICOS Quando há o uso de outros periféricos junto com o rastreador uma nova tabela de dados é enviada com os dados específicos do periférico em questão. Abaixo segue o formato de envio destes dados: N TIPO DESCRIÇÃO 0 Início de Mensagem Sempre igual a 02 hexadecimal 1 Status de posição 5 = outros periféricos; 2 Código do periférico 3 Outros periféricos Byte 0 4 Outros periféricos Byte 1 5 Outros periféricos Byte 2 6 Outros periféricos Byte 3 7 Outros periféricos Byte 4 8 Outros periféricos Byte 5 9 Outros periféricos Byte 6 10 Outros periféricos Byte 7 11 Outros periféricos Byte 8 12 Outros periféricos Byte 9 13 Outros periféricos Byte 10 14 Outros periféricos Byte n*... 1= Ibutton; 2= teclado;3=alarme; 4 9 = outros ID s de periféricos que podem ser definidos no software de programação. 15 Terminador Sempre igual a 03 Hexadecimal *= número de bytes varia conforme o tipo de periférico.