Sunteți pe pagina 1din 98

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.

doc

IAS - Interface de Acesso Central Saver Turbo


Verso 6.0

OmniLink Tecnologia SA.


Alameda Surubij, 1930 - Centro Industrial e Empresarial - Alphaville
06455-040 - Barueri SP

Tel.: (11) 4196 1100


Fax: (11) 4193-2823
www.omnilink.com.br

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

Sumrio de Revises
Verso
5.0
5.0
5.0
5.0
5.0
5.0
5.0

Rev
1.0
1.1
1.2
1.3
1.4
1.5
1.6

Data
22-out-2004
08-nov-2004
31-jan-2005
07-mar-2005
05-mai-2005
17-mai-2005
20-mai-2005

Autor
Welton Balani
Welton Balani
Welton Balani
Eduardo DIpolitto
Eduardo DIpolitto
Eduardo DIpolitto
Welton Balani

5.0

1.7

15-jun-2005

Welton Balani

5.0

1.8

30-jun-2005

Talita Tanferri

5.0

1.9

10-ago-2005

Alessandro Lucena

5.0

2.0

20-set-2005

Welton Balani

5.0
5.0

2.1
2.2

21-dez-2005
11-dez-2006

Alessandro Lucena
Srgio Yamada

6.0

1.0

26-dez-2006

Fabio Lubacheski

6.0

1.1

05-mar-2006

Srgio Yamda

6.0

1.2

20-abr-2007

Fabio Lubacheski

6.0

1.3

15-jun-2007

Fabio Lubacheski

6.0

1.4

08-ago-2007

Fabio Lubacheski

6.0

1.5

20-ago-2007

Alessandro/Fabio

6.0

1.6

18-out-2007

Fabio Lubacheski

6.0

1.7

29-fev-2008

Fabio Lubacheski

Modificaes
Murilo/Adriano
Murilo/Adriano
Murilo/Eduardo DIpolitto
Formatao do texto
Formatao do texto
Reviso dos TC e TE
Reviso dos TC e TE
Reviso Homologao
Reestruturao do documento
Reviso Homologao
Correo do documento
Correo do documento
Projeto Protege, operaes com
Alvos.
Projeto Rastreador Solar.
Projeto Duplo Chip 1454.
Documentao dos TC e TE
referentes ao conceito de Operao na
Central SAVERTurbo
Documentao dos TC e TE
referentes s Mensagens de Extenso
Logstica e Lacre/Deslacre do Motor
Envio no login do cliente o nmero do
ultimo teleevento processado pelo
Cliente
Solicitao da lista de mensagens pr
definidas. E envio de Mensagens pr
para o Rastreador (RI) modelos DPlus
1460 e 1480
Orientao na implementao do
Cliente IAS.
Modificao no XML para exportao
de Alvo e Cerca
Correo do CodMsg do telecomando
de Obteno de Lista de Rastreadores
no documento (de -2 para -1).
Alterao dos modelos de rastreadores
de 44x0 para 44x4
Incluso da descrio de tokens no
Cabealho padro dos Teleeventos

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

6.0

1.8

14-abr-2008

Fabio Lubacheski

6.0

1.9

05-mai-2008

Fabio Lubacheski

6.0

2.0

27-mai-2008

Srgio Yamada

6.0

2.0

18-jun-2008

Fabio Lubacheski

6.0

2.1

25-ago-2008

Fabio Lubacheski

6.0

2.2

22-out-2008

Alessandro Lucena

6.0

2.3

03-nov-2008

Fabio Lubacheski

6.0

2.4

08-jun-2009

Fabio Lubacheski

6.0

2.5

08-jul-2009

Alessandro Lucena

6.0

2.6

03-12-2009

Fbio Lubacheski

6.0

2.7

22-06-2010

Fbio Lubacheski

6.0

2.8

10-09-2010

Fbio Lubacheski

Lista de Telecomandos permitidos


para RI 0454 MiniMax
Incluso no manual a opo
16=Configurar RI 0454 Mini Max
Incluso do novo terminal TVC e
alteraes nas mensagens
Incluso da descrio do TeleEvento
CodMsg=40
Incluso da documentao do
teleevento personalizado
Incluso de IdTerminal + IdStatus em
CodMsg=40
Documentao da confirmao da
recepco de mensagens copel
Modificao da solicitao da lista de
rastreadores
Inseridos 3 novos campos do cadastro
de veculos, criados para atividades de
jammer:
Bloqueador Inteligente; Deteco de
Jammer; Telemetria; Tipo de
Bloqueio Inteligente; Tipo Deteco
de Jammer, Verso Complemento;
Verso Hardware
Reviso nos tokens dos teleeventos
Exceo 0x94 e reviso para
identificar as novas tokens enviadas
do XML do cabealho padro de
televeevento.
Incluso dos eventos logsticos da
Hyundai
Incluso dos eventos logsticos de
Telemetria do MTO Killer

-- Este documento a propriedade da Omnilink Tecnologia Ltda, e contm informao secreta


confidencial e de comrcio. No pode ser transferido da custdia e do controle da Omnilink, exceto
com autorizao escrita.
Este documento ou parte de suas informaes no podem ser usadas, transferidas, reproduzidas,
publicadas, ou divulgadas, em inteiro ou na parte, diretamente ou indiretamente, a no ser que,
autorizao expressa por parte da Omnilink Tecnologia Ltda seja publicada.
2009 Omnilink Tecnologia S.A. Todos os direitos reservados

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

NDICE
1

OBJETIVO.....................................................................................................................................7

REGIME.........................................................................................................................................7

FORMATO DO TEXTO...............................................................................................................7

COMUNICAO..........................................................................................................................7
4.1
4.2
4.3

CONEXO .................................................................................................................................7
REQUISITOS DA IMPLEMENTAO DO CLIENTE IAS .................................................................8
BUFFER DE MEMRIA ...............................................................................................................8

TELECOMANDOS .....................................................................................................................10
5.1
5.2
5.3
5.4
5.5
5.6
5.7
5.8
5.9
5.10
5.11
5.12
5.13
5.14
5.15
5.16
5.17
5.18
5.19
5.20
5.21
5.22
5.23
5.24
5.25
5.26
5.27
5.28
5.29
5.30
5.31
5.32
5.33
5.34
5.35
5.36

CABEALHO PADRO DOS TELECOMANDOS ...........................................................................11


BLOQUEAR ..............................................................................................................................12
DESBLOQUEAR ........................................................................................................................12
ATIVAR MODO RASTREADO ...................................................................................................12
ATIVAR MODO INTERATIVO....................................................................................................12
DESATIVAR .............................................................................................................................12
DESLACRAR BA ....................................................................................................................13
DESLACRAR CABINE ...............................................................................................................13
ENVIAR UM BIP .......................................................................................................................13
LACRAR BA ..........................................................................................................................13
LACRAR CABINE .....................................................................................................................13
LACRAR CARRETA ..................................................................................................................14
DESLACRAR DE CARRETA .......................................................................................................14
DESLACRAR MOTOR ...............................................................................................................14
LACRAR MOTOR .....................................................................................................................14
POSIO AVULSA ...................................................................................................................14
TEMPERATURA AVULSA .........................................................................................................15
AUTORIZAR .............................................................................................................................15
TROCA OPERADORA CELULAR (APENAS PARA MODELO RI 1454 MAX) ................................15
CONFIGURAO DA MENSAGEM FORMATADA .......................................................................15
MENSAGEM FORMATADA .......................................................................................................18
MENSAGEM LIVRE ..................................................................................................................19
MENSAGEM PR-DEFINIDA .....................................................................................................20
MENSAGEM BINRIA ..............................................................................................................21
SOLICITAO DA LISTA DE RASTREADORES DE CENTRAL ......................................................22
SOLICITAO DE INFORMAES SOBRE AS OPERAO ...........................................................22
ASSOCIAO DE OPERAO ...................................................................................................22
SOLICITAO DE INFORMAES SOBRE OS PERFIL DE CONFIGURAO ..................................23
ASSOCIAO DE PERFIL DE CONFIGURAO ..........................................................................23
SOLICITAO DE INFORMAES SOBRE PERFIL DE DEFINIO ...............................................24
SOLICITAO DE INFORMAO SOBRE ALVOS ........................................................................24
SOLICITAO DE INFORMAO SOBRE CERCAS ......................................................................24
IMPORTAO E ASSOCIAO DE GRUPO DE ALVOS ................................................................24
IMPORTAO E ASSOCIAO DE GRUPOS DE CERCAS ............................................................27
IMPORTAO E ASSOCIAO DE GRUPOS DE ROTAS ..............................................................28
SOLICITAO DE INFORMAES SOBRE MENSAGENS FORMATADAS ......................................31

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

5.37
5.38

SOLICITAO DE INFORMAES SOBRE MENSAGENS DE EXTENSO LOGSTICA DE PARADA .31


SOLICITAO DE INFORMAES SOBRE MENSAGENS DE EXTENSO LOGSTICA DE PARADA
ASSOCIADAS A UM TERMINAL .............................................................................................................31
5.39 IMPORTAO E ASSOCIAO DE MENSAGENS DE EXTENSO LOGSTICA DE PARADA ............31
5.40 SOLICITAO DA LISTA DE MENSAGENS DE PR-DEFINIDAS ..................................................33
5.41 SOLICITAO DA TRANSMISSO DA OPERAO .....................................................................33
5.42 SOLICITAO DA TRANSMISSO DO PERFIL DE CONFIGURAO ............................................33
5.43 SOLICITAO DA TRANSMISSO DO CONJUNTO DE ALVOS.....................................................34
5.44 SOLICITAO DA TRANSMISSO DE UM CONJUNTO DE CERCAS .............................................36
5.45 SOLICITAO DA TRANSMISSO DO CONJUNTO DE ROTAS .....................................................36
5.46 SOLICITAO DO STATUS DA TRANSMISSO DA OPERAO ..................................................36
5.47 LOGIN NO IAS.........................................................................................................................37
5.48 SOLICITAO DA TRANSMISSO DAS CONFIGURAES DE EXTENSO LOGSTICA DE PARADA
37
5.49 SOLICITAO DOS TELEEVENTOS PERSONALIZADOS DE USURIO ..........................................38
6

TELEEVENTOS..........................................................................................................................39
6.1
CABEALHO PADRO DOS TELEEVENTOS ...............................................................................39
6.2
CONFIRMAO DE OPERAO REMOTA .................................................................................46
6.3
STATUS DE ENVIO DE TELECOMANDO.....................................................................................47
6.4
MENSAGEM FORMATADA .......................................................................................................48
6.5
SOLICITAO DE AUTORIZAO .............................................................................................48
6.6
SINAL DE VIDA .......................................................................................................................49
6.7
POSIO AVULSA ...................................................................................................................49
6.8
POSIO AUTOMTICA ...........................................................................................................49
6.9
TELEVENTO DE EXCEO .......................................................................................................49
6.10 CONFIRMAO DE LEITURA DE MENSAGEM LIVRE ................................................................50
6.11 TELEVENTOS LOGSTICOS........................................................................................................51
6.11.1
Temperatura ...................................................................................................................54
6.11.2
Operaes com Alvos ....................................................................................................56
6.11.3
Incio de Atendimento....................................................................................................56
6.11.4
Fim de Atendimento ......................................................................................................56
6.11.5
Eventos de Rastreador Solar ..........................................................................................57
6.11.6
Chegada com Extenso Logstica de Parada .................................................................58
6.11.7
Sada com Extenso Logstica de Parada.......................................................................58
6.11.8
Recepo de mensagem OK ..........................................................................................59
6.11.9
Timeout na recepo de mensagem ...............................................................................60
6.11.10
Erro de processamento da mensagem ........................................................................60
6.11.11
Telemetria MTO ........................................................................................................61
6.12 MENSAGEM LIVRE ..................................................................................................................61
6.13 MENSAGEM PREDEFINIDA .......................................................................................................62
6.14 MENSAGEM BINRIA ..............................................................................................................62
6.15 TELEVENTOS PERSONALIZADOS..............................................................................................62
6.16 LISTA DE RASTREADORES .......................................................................................................67
6.17 TELEEVENTO DE XML INVLIDO ............................................................................................72
6.18 INFORMAES SOBRE AS OPERAES .....................................................................................74
6.19 CONFIRMAO DA ASSOCIAO DA OPERAO .....................................................................75
6.20 INFORMAES SOBRE OS PERFIS DE CONFIGURAO..............................................................76

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

6.21 CONFIRMAO DA ASSOCIAO DE PERFIL DE CONFIGURAO ............................................77


6.22 INFORMAES SOBRE OS PERFIS DE DEFINIO......................................................................78
6.23 INFORMAES SOBRE ALVOS..................................................................................................79
6.24 INFORMAES SOBRE CERCAS ................................................................................................80
6.25 CONFIRMAO DE IMPORTAO E ASSOCIAO DE ALVOS ...................................................81
6.26 CONFIRMAO DE IMPORTAO E ASSOCIAO DOS GRUPOS DE CERCAS ............................82
6.27 CONFIRMAO DE IMPORTAO E ASSOCIAO DE GRUPOS DE ROTAS.................................83
6.28 INFORMAES SOBRE MENSAGENS FORMATADAS..................................................................84
6.29 CONFIRMAO DA SOLICITAO DA TRANSMISSO DA OPERAO .......................................86
6.30 CONFIRMAO DA SOLICITAO DA TRANSMISSO DO PERFIL DE CONFIGURAO ..............87
6.31 CONFIRMAO DA SOLICITAO DA TRANSMISSO DO CONJUNTO DE ALVOS ......................88
6.32 CONFIRMAO DA SOLICITAO DA TRANSMISSO DO CONJUNTO DE CERCAS .....................89
6.33 CONFIRMAO DA SOLICITAO DA TRANSMISSO DE CONJUNTO DE ROTAS .......................89
6.34 STATUS DA TRANSMISSO DA OPERAO ..............................................................................90
6.35 CONFIRMAO DE LOGIN NO IAS...........................................................................................92
6.36 INFORMAES SOBRE MENSAGENS DE EXTENSO LOGSTICA DE PARADA ............................92
6.37 INFORMAES SOBRE MENSAGENS DE EXTENSO LOGSTICA DE PARADA DE UM TERMINAL 93
6.38 CONFIRMAO DE IMPORTAO E ASSOCIAO DE MENSAGENS DE EXTENSO LOGSTICA DE
PARADA ..............................................................................................................................................94
6.39 CONFIRMAO DA SOLICITAO DA TRANSMISSO DAS MENSAGENS DE EXTENSO
LOGSTICA ..........................................................................................................................................95
6.40 LISTA DE MENSAGENS PR-DEFINIDAS ..................................................................................96
6.41 INFORMAES SOBRE OS TELEEVENTOS PERSONALIZADOS DE USURIO................................97
7

APNDICE...................................................................................................................................98
7.1

TELECOMANDOS PERMITIDOS PARA RI 0454 MINI MAX ........................................................98

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

1 OBJETIVO
Este documento tem por objetivo orientar o usurio na criao de aplicaes capazes
de estabelecer conexes socket com o software para Interface de Acesso Central
SaverTurbo (IASTurbo) e processar as informaes por ela enviadas.

2 REGIME
Convenciona-se:
Telecomandos mensagens enviadas dos rastreadores.
Teleeventos mensagens recebidas dos rastreadores.

FORMATO DO TEXTO

Entre o Servidor IASTurbo e Cliente IAS trafegar apenas texto. Ser formatado em
XML (Extended Markup Language) e conter todas as informaes enviadas pelo rastreador
quando ocorre um teleevento ou quando for enviado ao rastreador na ocorrncia de um
telecomando.

4 COMUNICAO
4.1

CONEXO
A conexo com a Central SaverTurbo ser feita via Socket Client. Para estabelecer uma
conexo via socket o usurio dever implementar uma aplicao capaz de instanciar um
objeto do tipo Socket Client informando o nome ou endereo IP da mquina onde o
IASTurbo estiver instalado, bem como a porta em que a mesma est escutando as
conexes (padro 12000). Existem duas maneiras de instanciar sockets clients: bloqueante
e no-bloqueante. Neste caso trabalharemos apenas com sockets no-bloqueantes (veja
Figura 1).

Socket
Server

Socket no-bloqueante
bidirecional

Socket
Client

Cliente IASTurbo

IASTurbo

Figura 1: Comunicao via Socket no-bloqueante bidirecional

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

Basicamente os Sockets Clients so capazes de enviar e receber (bidirecional) dados


de um servidor atravs de uma conexo TCP/IP estabelecida. Em casos de sockets que
enviam e recebem textos, atente para os mtodos SendText e ReceiveText, que so
utilizados para enviar e receber cadeias longas de texto, respectivamente, conforme
apresentado na Figura 1.
Optamos pelo modo no-bloqueante para que a aplicao trabalhe em modo
assncrono, permitindo executar outras tarefas enquanto aguarda eventos de envio e
recepo.
4.2

REQUISITOS DA IMPLEMENTAO DO CLIENTE IAS


Para implementar o Cliente IAS algumas restries devem ser rigorosamente seguidas:

O cliente IAS deve por conexo (Socket Client instanciado) ser capaz de enviar
(Telecomandos) e receber (Teleeventos) no Formato XML ao Servidor IASTurbo.
A estabilidade da conexo um dos fatores predominantes para o desempenho
do sistema e deve ser garantida pelo Cliente IAS, uma vez que sua
responsabilidade estabelec-la e finaliz-la normalmente. Sendo assim para o
Cliente IAS receber e enviar (Telecomandos/Teleeventos) desaconselhado
finalizar a conexo de forma abrupta durante a comunicao. Em suma evite
conexes e desconexes muito freqentes e utilize o mesmo canal de
comunicao (Socket Client instanciado) para enviar e receber dados do Servidor
IASTurbo.
O Envio dos Teleeventos ao Cliente IAS realizada de forma bufferizada, ou
seja, em um buffer de comunicao podem estar contidos vrios Teleeventos.
Dessa forma o Cliente IAS deve implementar dois processos independentes e
assncronos, sendo que um dos processos deve ser responsvel em receber os
Teleeventos e o outro processo em realizar o processamento adequado do buffer
recebido. O processamento do buffer envolve etapas de recorte dos XMLs
contidos no buffer, parser de cada um dos XMLs recortados e processar as
informaes contidas, como por exemplo armazenar os campos em uma tabela
do banco de dados do cliente. Caso esse processos no sejam independentes e
assncronos podem ocorrer falhas de comunicao como por exemplo Stack
Overflow (estouro da pilha) do protocolo TCP/IP.

BUFFER DE MEMRIA
A bufferizao de memria feita para otimizar o uso do canal de comunicao entre
o IASTurbo e Cliente IAS, evitando assim que para cada teleevento recebido da Base Digital
seja gerado um XML e enviado imediatamente. Em vez disso, os XMLs gerados vo para
um buffer em memria e em seguida para os clientes conectados. A transmisso do buffer
ocorre de duas maneiras, sendo disparado pelo evento que ocorrer primeiro:
4.3

1.

XML gerado pelo IASTurbo ir estourar o buffer. medida que os XMLs so


gerados, eles vo para um buffer em memria. No momento que o IASTurbo
percebe que o XML que acabou de ser gerado ir estour-lo, o buffer
transmitido aos clientes conectados, e ento apagado. Aps a transferncia, o
XML que estouraria o buffer copiado para ele e isso se repete na medida que os
teleeventos so recebidos da Base Digital.

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

2.

Timeout de inatividade, configurvel no arquivo IASTurbo.INI (default=60), Se ao


decorrer o Timeout de inatividade, contados partir da ltima atualizao do
buffer, no ocorrer nenhuma variao em seu tamanho, o buffer transmitido
independentemente de ter atingido ou no o seu limite.

O clculo do tamanho do buffer feito dinamicamente pelo IASTurbo, tendo como


base o valor do Buffer Definido em IASTurbo.INI atravs da entrada TAMANHO_BUFFER.
Inicialmente o IASTurbo ir usar este valor como limite do buffer de memria para
transmisso dos XMLs, porm ao final de 20 ciclos de transmisso do buffer, este valor
poder ser aumentado, diminuido ou at mesmo mantido, de acordo com a anlise dos
dados recolhidos cada transmisso. O critrio para variao do tamanho do buffer dado
por:
1. Se a mdia de tentativas de envio das ltimas 20 transmisses for igual a 1, o
IASTurbo considerar que o canal pode estar ocioso e ir diminuir o buffer,
subtraindo dele a metade do valor absouluto da diferena entre o Buffer
Calculado Atual e o Buffer Calculado Anterior.
2.

Se a mdia de tentativas de envio das ltimas 20 transmisses estiver entre 2 e 3,


o IASTurbo considerar que o canal est estvel, mantendo o tamanho do buffer
atual.

3. Se a mdia de tentativas de envio das ltimas 20 transmisses for maior que 3, o


IASTurbo considerar que o canal pode muito ocupado e ir aumentar o buffer,
adicionando a ele a metade do valor absouluto da diferena entre o Buffer
Calculado Atual e o Buffer Calculado Anterior.
Para entender o funcionamento deste algoritmo, considere por exemplo a seguinte
situao:
 Buffer Definido em IASTurbo.INI igual a 64 kbytes
 Aps 20 transmisses o IASTurbo considerou que o canal pode estar muito
ocupado. Assim o tamanho do buffer aumentado para 96 kbytes = 64 + (64
/*buffer calculado atual*/ 0 /*buffer calculado anterior*/) / 2.


Aps mais 20 transmisses o IASTurbo considerou que o canal pode estar muito
ocioso. Assim o tamanho do buffer diminuido para 80 kbytes = 96 (96
/*buffer calculado atual*/ 64 /*buffer calculado anterior*/) / 2.

Aps mais 20 transmisses o IASTurbo considerou que o canal pode estar muito
ocupado. Assim o tamanho do buffer aumentado para 88 kbytes = 80 + (80
/*buffer calculado atual*/ 96 /*buffer calculado anterior*/) / 2.

Aps mais 20 transmisses o IASTurbo considerou que o canal est estvel.


Assim o buffer de 88 kbytes ser mantido at que a mdia de tentativas de
transmisso saia da faixa de 2 a 3.

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

O IASTurbo tentar achar um valor ideal para o tamanho do buffer em at 10


anlises. Se em 10 anlises de 20 transmisses cada, no tenha sido possvel estabilizar o
canal o valor do buffer calculado ir assumir o valor do buffer definido em IASTurbo.INI e o
processo retroceder ao seu incio.
Em outras palavras, se a cada resultado da ltima anlise de 20 transmisses o
buffer for aumentado ou diminuido, o Contador para Restaurar Buffer Definido ser
decrementado, sendo o Buffer Definido resturado, quando este contador chegar a 1.
importante saber que se o IASTurbo detectar que o canal est estvel, este contador ser
incrementado, de forma que uma configurao estvel do buffer seja premiada.
A Figura 2 mostra o andamento deste processo, mantendo um retrato da ltima
anlise de transmisses.

Figura 2: Monitor da comunicao do IASTurbo

5 TELECOMANDOS
O regime para troca de informaes com o IASTurbo consiste no usurio instanciar um
Socket Client e aps receber o status de conectado enviado pelo Socket Server, enviar os
Telecomandos geradas pelo seu sistema. Cada Telecomando recebido pela Interface de
Acesso, ser encaminhado ao rastreador informado no Telecomando.
Para cada Telecomando enviado haver uma resposta de sucesso ou fracasso, e neste
caso devero ser disparadas novamente pelo Cliente IAS, a Central SAVERTurbo faz vrias
tentativas antes de responder negativamente (Veja a Figura 2) .
Envia Buffer de telecomandos
(via socket)

Central
SAVERTurbo

IASTurbo

Cliente IASTurbo
Envia Status do telecomando
(via socket)

Veculo
Figura 3: Envio de um Telecomando ao IASTurbo

A aplicao, aps recebimento do Status do telecomando dever estar preparada


para tratar tal evento. Lembramos, tambm, que a resposta de Telecomando, ser atravs
do Teleevento recebido do veculo, correspondente a este pedido, e est identificado no
corpo da mensagem.

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

10

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

5.1

CABEALHO PADRO DOS TELECOMANDOS

Todos os telecomandos enviados possuem um grupo de informaes que sempre


esto presentes. Observe que a tag <CodMsg> conter o valor que identifica o tipo de
informaes adicionais transportadas no telecomando.
<?xml version = "1.0"?>
<TeleComando>
<!-- Id Sequencia gerado pelo cliente (0..99999) -->
<IdSeqMsg> </IdSeqMsg>
<!-- Modulo de Rastreamento que originara o telecomando -->
<Origem> </Origem>
<!-- Base destino do telecomando -->
<Destino> </Destino>
<!-- Tipo da Mensagem (0 = Controle, 1 = Normal) -->
<TipoMsg> </TipoMsg>
<!-- Identificacao da Mensagem -->
<CodMsg> </CodMsg>
<!-- Data e hora da emissao do telecomando -->
<DataHoraEmissao> </DataHoraEmissao>
<!-- Prioridade do teleevento (no utilizado) -->
<Prioridade> </Prioridade>
<!-- Numero de serie do rastreador como cadastrado na
central (em hexadecimal) -->
<IdTerminal> </IdTerminal>
</TeleComando>

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

11

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

5.2

BLOQUEAR

Abaixo segue a descrio para solicitao de um telecomando de bloqueio do veculo


via XML. O valor da tag <CodMsg> deve ser 15 (hexadecimal).
<!-- Identificacao da Mensagem -->
<CodMsg> 15 </CodMsg>
5.3

DESBLOQUEAR

Abaixo segue a descrio para solicitao de um telecomando de desbloqueio do


veculo via XML. O valor da tag <CodMsg> deve ser 16 (hexadecimal).
<!-- Identificacao da Mensagem -->
<CodMsg> 16 </CodMsg>
5.4

ATIVAR MODO RASTREADO

Abaixo segue a descrio para solicitao de um telecomando de ativao do


rastreador em modo rastreado via XML. O valor da tag <CodMsg> deve ser 2F
(hexadecimal).
<!-- Identificacao da Mensagem -->
<CodMsg> 2F </CodMsg>
5.5

ATIVAR MODO INTERATIVO

Abaixo segue a descrio para solicitao de um telecomando de ativao do


rastreador em modo interativo via XML. O valor da tag <CodMsg> deve ser 52
(hexadecimal).
<!-- Identificacao da Mensagem -->
<CodMsg> 52 </CodMsg>
5.6

DESATIVAR

Abaixo segue a descrio para solicitao de um telecomando de desativao do


rastreador via XML. O valor da tag <CodMsg> deve ser 14 (hexadecimal).
<!-- Identificacao da Mensagem -->
<CodMsg> 14 </CodMsg>

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

12

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

5.7

DESLACRAR BA

Abaixo segue a descrio para solicitao de um telecomando de deslacre de ba via


XML. O valor da tag <CodMsg> deve ser 22 (hexadecimal).
<!-- Identificacao da Mensagem -->
<CodMsg> 22 </CodMsg>
5.8

DESLACRAR CABINE

Abaixo segue a descrio para solicitao de um telecomando de deslacre da cabine


via XML. O valor da tag <CodMsg> deve ser 23 (hexadecimal).
<!-- Identificacao da Mensagem -->
<CodMsg> 23 </CodMsg>
5.9

ENVIAR UM BIP

Abaixo segue a descrio para solicitao de um telecomando de envio de bip via


XML. O valor da tag <CodMsg> deve ser 3F (hexadecimal).
<!-- Identificacao da Mensagem -->
<CodMsg> 3F </CodMsg>
5.10 LACRAR BA
Abaixo segue a descrio para solicitao de um telecomando de lacre de ba via
XML. O valor da tag <CodMsg> deve ser 1F (hexadecimal).
<!-- Identificacao da Mensagem -->
<CodMsg> 1F </CodMsg>
5.11 LACRAR CABINE
Abaixo segue a descrio para solicitao de um telecomando de lacre de cabine via
XML. O valor da tag <CodMsg> deve ser 20 (hexadecimal).
<!-- Identificacao da Mensagem -->
<CodMsg> 20 </CodMsg>

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

13

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

5.12 LACRAR CARRETA


Abaixo segue a descrio para solicitao de um telecomando de lacre de carreta via
XML. O valor da tag <CodMsg> deve ser 21 (hexadecimal).
<!-- Identificacao da Mensagem -->
<CodMsg> 21 </CodMsg>
5.13 DESLACRAR DE CARRETA
Abaixo segue a descrio para solicitao de um telecomando de deslacre de carreta
via XML. O valor da tag <CodMsg> deve ser 24 (hexadecimal).
<!-- Identificacao da Mensagem -->
<CodMsg> 24 </CodMsg>
5.14 DESLACRAR MOTOR
Abaixo segue a descrio para solicitao de um telecomando de deslacre de motor
via XML. O valor da tag <CodMsg> deve ser E8 (hexadecimal).
<!-- Identificacao da Mensagem -->
<CodMsg> E8 </CodMsg>
5.15 LACRAR MOTOR
Abaixo segue a descrio para solicitao de um telecomando de lacre de motor via
XML. O valor da tag <CodMsg> deve ser E6 (hexadecimal).
<!-- Identificacao da Mensagem -->
<CodMsg> E6 </CodMsg>
<!-- Valor que indica o tempo (em segundos) que dever passar
para lacrar o motor aps o veculo desligar a ignio
Valores vlidos: 0 at 1800 -->
<Tempo> </Tempo>

5.16 POSIO AVULSA


Abaixo segue a descrio para solicitao de um telecomando de posio avulsa via
XML. O valor da tag <CodMsg> deve ser 11 (hexadecimal).
<!-- Identificacao da Mensagem -->
<CodMsg> 11 </CodMsg>

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

14

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

5.17 TEMPERATURA AVULSA


Abaixo segue a descrio para solicitao de um telecomando de posio avulsa via
XML. O valor da tag <CodMsg> deve ser 59 (hexadecimal).
<!-- Identificacao da Mensagem -->
<CodMsg> 59 </CodMsg>
5.18 AUTORIZAR
Abaixo segue a descrio para solicitao de um telecomando de autorizao via XML.
Este comando uma resposta a um evento de autorizao enviado pelo motorista. O valor
da tag <CodMsg> indica o tipo de autorizao a ser enviada.
<!-- Identificacao da Mensagem -->
<CodMsg> </CodMsg>
<!-- Valor em hexadecimal que indica o tipo de autorizao a ser
enviada para o rastreador:
17: Chegada
18: Abertura de Ba
1B: Deslacre de Ba
1C: Deslacre de Cabine
1D: Deslacre de Carreta
50: Conexo com Central
1E: Recusar a Autorizao
E9: Deslacre de Motor -->
5.19 TROCA OPERADORA CELULAR (APENAS PARA MODELO RI 1454 MAX)
Abaixo segue a descrio para solicitao de um telecomando de troca de operadora
celular via XML. Este comando realiza a troca da operadora celular para uma operadora
definida. O valor da tag <CodMsg> indica o tipo de autorizao a ser enviada.
<!-- Identificacao da Mensagem -->
<CodMsg> E3 </CodMsg>
<!-- Valor que indica a operadora celular a operar:
1: Tim
2: Claro
3: Oi -->
<OperCelAOperar> </OperCelAOperar>
5.20 CONFIGURAO DA MENSAGEM FORMATADA

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

15

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

Abaixo segue a descrio para solicitao de um telecomando de mensagem


formatada via XML. O valor da tag <CodMsg> deve ser 5C (hexadecimal) e a tag <Texto>
preenchida com o contedo da mensagem.
Observao: O campo NroSeqMacro dever ser gerado pelo solicitante (na
representao hexadecimal), ser nico e exclusivo, para cada mensagem formatada e ser
o identificador do Teleevento recebido associado a ela.
<!-- Identificacao da Mensagem -->
<CodMsg> 5C </CodMsg>
<!-- Marcao do incio da seqncia dos veculos que sero
enviados a mensagem (Opcional) -->
<Veiculo>
<!-- Nmero de srie do rastreador (em hexadecimal)
Nessa situao, ser adicionado o valor 1 no valor do
IdSeqMsg para cada terminal adicional -->
<IdTerminal> </IdTerminal>
</Veiculo>

<!-- Marcao do incio da macro -->


<Macro>
<!-- Seqencial que identifica a Macro hexadecimal-->
<NroSeqMacro> </NroSeqMacro>
<!-- Nome da macro exibida no terminal tam. max 18-->
<NomeMacro> </NomeMacro>
<!-- N de campos da macro em Hexadecimal -->
<NCampos> </NCampos>
<!-- Preenche a Central de destino. 0:Principal,
1:Auxiliar e 2:Ambas -->
<CentralDestino> </CentralDestino>
<! Seta se a macro um teleevento. Ou seja,
habilitado para escrita no veculo:
0: No habilita
1: Habilita (default) -->
<TE> </TE>
<! Seta se a macro um telecomando. Ou seja,
habilitado para escrita na central:
0: No habilita (default)
1: Habilita -->
<TC> </TC>

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

16

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

<! Seta o tipo de terminal que se est realizando


essa configurao:
1: Alfanumrico (default)
2: Compacto
3: Alfanumrico Multimdia
4: Alfanumrico Compacto
5: TVC -->
<Terminal> </Terminal>
<!-- Marcao do incio dos campos
Esta tag se repetir de acordo com a quantidade de
campos que a macro possa ter -->
<Campo>
<!-- Descrio do Campo. Tam. max. 17-->
<NomeCampo> </NomeCampo>
<!-- Tamanho da rea de edio do Campo em
hexadecimal -->
<TamCampo> </TamCampo>
<!-- Linha onde o campo ser editado(no
utilizado) -->
<LinCampo> 1 </LinCampo>
<!-- Coluna onde o campo ser editado(no
utilizado) -->
<ColCampo> 1 </ColCampo>
<!-- Indica se o campo de edio deve ficar
abaixo ou direita do texto descritivo:
0: direita
1: esquerda(no utilizado) -->
<PosEdCampo> 1 </PosEdCampo>
<!-- Indica se o campo deve ser obrigatoriamente
preenchido ou no:
0: no obrigatrio
1: obrigatrio -->
<ObrigCampo> </ObrigCampo>
<!-- Tipo de Campo a ser editado
0: Alfanumrico(Letras e Nmeros)
1: Numrico(Dgitos de 0 a 9)
2: Alfabtico(Somente Letras)
3: nn.nn.nnn/nnn-nn(CNPJ)
4: nnn.nnn.nnn-nn(CPF)
5: dd/mm(Data dia/ms)
6: dd/mm/aa (Data ano 2 dgitos)
7: dd/mm/aaaa (Data ano 4 dgitos)

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

17

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

8: hh:mm (Hora)
9: Moeda (Casa decimal fixa em 2 dgitos)
10: Texto simples(Texto para uso geral)
11: Fracionrio (Permite uso de casa
decimal e sinal -->
<TipoCampo> </TipoCampo>
</Campo>
</Macro>
Observao 1: O maior valor de <TamCampo> depende do tipo de terminal instalado
no veculo: 20 caracteres para terminal compacto e 40 caracteres para terminal
alfanumrico.
Observao 2: O terminal alfanumrico aceita todos os tipos de campos, j o terminal
compacto no aceita os campos tipo 0 (Alfanumrico), 2 (Alfabtico) e 11 (Fracionrio).
A tabela abaixo detalhada com informaes dos campos em relao aos terminais:
Terminal
Tipo

0
1
2
3
4
5
6
7
8
9
10

Input

Descrio

Editvel Alfanumrico Compacto

nnn.nnn.nnn-nn

CPF

dd/mm

Data dia/ms

dd/mm/aa

Data ano 2 dgitos

dd/mm/aaaa

Data ano 4 dgitos

hh:mm

Hora

Moeda

Casa decimal fixa em 2 dgitos

Texto simples

Texto para uso geral

S
S
S
S
S
S
S
S
S
S
N

Permite uso de casa decimal e


sinal

Alfanumrico

Letras e Nmeros

Numrico

Dgitos de 0 a 9

Alfabtico

Somente letras

nn.nnn.nnn/nnn-nn CNPJ

11 Fracionrio

Tamanho
Fixo

40
40
40
18
14
5
8
10
5
40
0

N
20
N
18
14
5
8
10
5
20
0

N
N
N
S
S
S
S
S
S
N
S

40

5.21 MENSAGEM FORMATADA


A tag <CodMsg> que sempre conter o valor 6A (hexadecimal), que identifica um
telecomando Mensagem Formatada.
<!-- Identificacao da Mensagem -->
<CodMsg> 6A </CodMsg>
<!-- Id da Mensagem, gerado pelo cliente entre 0 e 255 Assim que
recebida no terminal, o veiculo responde com um Teleevento
Confirmao de Recebimento de Mensagem, na qual a tag

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

18

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

<IdMsgConfirmacao> conter o mesmo valor enviado pela tag


<IdMensagem> neste telecomando
Importante: O IdMensagem deve ser obritriamente sequncial
para deteco de erros -->
<IdMensagem> </IdMensagem>
<!-- Seqencial que identifica a Mensagem Formatada hexadecimal
-->
<NroSeqMacro> </NroSeqMacro>
<!- Concatenao das informaes enviadas para o Rastreador -->
<Texto> </Texto>
<!-- (Opcional e aceito somente para RI 44XX com verso superior
a 1.16) Solicita um teleevento de confirmacao de
recebimento da mensagem no terminal do veiculo. Os valores
possveis so:
0 = no solicita confirmao de recebimento no veiculo
1 = solicita confirmao de recebimento no veiculo -->
<ConfirmaRecebimento> </ConfirmaRecebimento>

5.22 MENSAGEM LIVRE


Abaixo segue a descrio para solicitao de um telecomando de mensagem livre via
XML. O valor da tag <CodMsg> deve ser 13 (hexadecimal) e a tag <Texto> preenchida
com o contedo da mensagem.
<!-- Identificacao da Mensagem -->
<CodMsg> 13 </CodMsg>
<!-- Texto da Mensagem Livre -->
<Texto> </Texto>
<!-- Id da Mensagem, gerado pelo cliente entre 0 e 255. Assim
que lida ou recebida no terminal, o veiculo responde com um
Teleevento Confirmao de Leitura/Recebimento de Mensagem
Livre, onde a tag <IdMsgConfirmacao> conter o mesmo valor
enviado pela tag <IdMensagem> neste telecomando
Importante: O IdMensagem deve ser obritriamente sequncial
para deteco de erros -->
<IdMensagem> </IdMensagem>
<!-- Solicita um teleevento de confirmacao de leitura da
mensagem no terminal do veiculo. Os valores possveis so:
0 = no solicita confirmao de leitura no terminal do
veiculo
1 = solicita confirmao de leitura no terminal do

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

19

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

veiculo-->
<ConfirmaLeitura> </ConfirmaLeitura>
<!-- (Opcional e aceito somente para RI 44XX com verso superior
a 1.16) Solicita um teleevento de confirmacao de
recebimento da mensagem no terminal do veiculo. Os valores
possveis so:
0 = no solicita confirmao de recebimento no veiculo
1 = solicita confirmao de recebimento no veiculo -->
<ConfirmaRecebimento> </ConfirmaRecebimento>

<!-- Marcao do incio da seqncia dos veculos que sero


enviados a mensagem (Opcional) -->
<Veiculo>
<!-- Nmero de srie do rastreador (em hexadecimal)
Nessa situao, ser adicionado o valor 1 no valor do
IdSeqMsg para cada terminal adicional -->
<IdTerminal> </IdTerminal>
</Veiculo>

5.23 MENSAGEM PR-DEFINIDA


Abaixo segue a descrio para solicitao de um telecomando de mensagem prdefinida via XML. O valor da tag <CodMsg> deve ser 60 (hexadecimal) e Identificador da
mensagem pr-definida informardo atravs do Telecomando -16 (Solicitao da Lista de
Mensagens de Pr-Definidas).
<!-- Identificacao da Mensagem -->
<CodMsg> 60 </CodMsg>
<!-- Idenficador da Mensagem Pr-Definida -->
<IdMensagemPre> </IdMensagemPre>
<! (Opcional) Id da Mensagem, gerado pelo cliente entre 0 e
255. Assim que recebida no terminal, o veiculo responde com
um Teleevento Confirmao de Recebimento de Mensagem, onde
a tag <IdMsgConfirmacao> conter o mesmo valor enviado pela
tag <IdMensagem> neste telecomando
Importante: O IdMensagem deve ser obritriamente sequncial
para deteco de erros -->
<IdMensagem> </IdMensagem>
<! (Opcional e aceito somente para RI 44XX com verso superior
a 1.16) Solicita um teleevento de confirmacao de

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

20

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

recebimento da mensagem no terminal do veiculo. Os valores


possveis so:
0 = no solicita confirmao de recebimento no veiculo
1 = solicita confirmao de recebimento no veiculo -->
<ConfirmaRecebimento> </ConfirmaRecebimento>
<!-- Marcao do incio da seqncia dos veculos que sero
enviados a mensagem (Opcional) -->
<Veiculo>
<!-- Nmero de srie do rastreador (em hexadecimal)
Nessa situao, ser adicionado o valor 1 no valor do
IdSeqMsg para cada terminal adicional -->
<IdTerminal> </IdTerminal>
</Veiculo>
5.24 MENSAGEM BINRIA
Abaixo segue a descrio para solicitao de um telecomando de mensagem binria
via XML. O valor da tag <CodMsg> deve ser 6B (hexadecimal). Esse telecomando ser
enviado para o RI, e este enviar o contedo do campo <Texto> para a serial RS-232.
<!-- Identificacao da Mensagem -->
<CodMsg> 6B </CodMsg>
<!-- Texto da Mensagem Binria em HEXA. -->
<Texto> </Texto>
<! (Opcional) Id da Mensagem, gerado pelo cliente entre 0 e
255. Assim que recebida no terminal, o veiculo responde com
um Teleevento Confirmao de Recebimento de Mensagem, onde
a tag <IdMsgConfirmacao> conter o mesmo valor enviado pela
tag <IdMensagem> neste telecomando
Importante: O IdMensagem deve ser obritriamente sequncial
para deteco de erros -->
<IdMensagem> </IdMensagem>
<! (Opcional e aceito somente para RI 44XX com verso superior
a 1.16) Solicita um teleevento de confirmacao de
recebimento da mensagem no terminal do veiculo. Os valores
possveis so:
0 = no solicita confirmao de recebimento no veiculo
1 = solicita confirmao de recebimento no veiculo -->
<ConfirmaRecebimento> </ConfirmaRecebimento>
<!-- Marcao do incio da seqncia dos veculos que sero
enviados a mensagem (Opcional) -->
<Veiculo>
<!-- Nmero de srie do rastreador (em hexadecimal)

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

21

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

Nessa situao, ser adicionado o valor 1 no valor do


IdSeqMsg para cada terminal adicional -->
<IdTerminal> </IdTerminal>
</Veiculo>
5.25 SOLICITAO DA LISTA DE RASTREADORES DE CENTRAL
Sempre que o cliente desejar obter os rastreadores cadastrados na Central SaverTurbo,
poder faz-lo enviando um telecomando Interface, que consultar o banco de dados da
Central e devolver ao cliente a lista, onde cada linha ser representada por um teleevento
XML. Para cada veiculo cadastrado, a Interface gerar um Teleevento com suas .
<!-- Identificacao da Mensagem -->
<CodMsg> -1 </CodMsg>
<!-- Data inicial em que ocorreu a ltima alterao nos dados do
Rastreador -->
<DataAlteracaoInicio> </DataAlteracaoInicio>
<!-- Data final em que ocorreu a ltima alterao nos dados do
Rastreador -->
<DataAlteracaoFim> </DataAlteracaoFim>
As tags <DataAlteracaoInicio> e <DataAlteracaoFim> so opcionais e
determinam um filtro por data para solicitao da Lista de Rastreadores. Caso no exista
nenhum Rastreador com informaes alteradas no intervalo de datas devolvido um
Televento de XML invlido (<CodMsg> igual a -40) com a tag <StsEnvio> igual a 311 (A
Central no possui rastreadores com informaes alteradas no intervalo de datas
informado).
5.26 SOLICITAO DE INFORMAES SOBRE AS OPERAO
O Cliente pode obter as informaes sobre as Operaes cadastradas na Central
SAVERTurbo. Para tanto, basta enviar um telecomando ao IASTurbo, a interface consultar
o banco de dados da Central e devolver ao Cliente a relao dos Perfis de Configurao,
Grupos de Alvos, Cercas, Rotas, e Mesnsagens Formatadas em um televento XML.
<!-- Identificacao da Mensagem -->
<CodMsg> -2 </CodMsg>
Como os televentos e telecomandos Operao sero trocados somente entre o
IASTurbo e o Cliente o valor da tag <CodMsg> negativo e igual a 2
5.27 ASSOCIAO DE OPERAO
Abaixo segue a descrio para um telecomando para associar uma Operao via XML.
O valor da tag <CodMsg> deve ser -3 e a tag <IdOperacao> preenchida com o
identificador da Operao que se deseja associar aos veculo.

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

22

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

<!-- Identificacao da Mensagem -->


<CodMsg> -3 </CodMsg>
<!-- Data e hora da emissao do telecomando -->
<DataHoraEmissao> </DataHoraEmissao>
<!-- Identificador da Operao -->
<IdOperacao> </IdOperacao >
<!-- Nmero de srie do rastreador (em hexadecimal) -->
<IdTerminal> </IdTerminal>
5.28 SOLICITAO DE INFORMAES SOBRE OS PERFIL DE CONFIGURAO
O Cliente pode obter as informaes sobre os Perfis de Configurao utilizados. Para
tanto, basta enviar um telecomando ao IASTurbo com a tag <CodMsg> igual -4, a interface
consultar o banco de dados da Central e devolver ao Cliente a relao dos Perfis de
Configurao em um televento XML.
<!-- Identificacao da Mensagem -->
<CodMsg> -4 </CodMsg>
5.29 ASSOCIAO DE PERFIL DE CONFIGURAO
Abaixo segue a descrio para um telecomando para associar um Perfil de
Configurao via XML. O valor da tag <CodMsg> deve ser -5 e a tag
<IdPerfilConfiguracao> preenchida com o identificador da Perfil de Configurao que
se deseja associar aos veculo.
<!-- Identificacao da Mensagem -->
<CodMsg> -5 </CodMsg>
<!-- Identificador do Perfil de Configurao -->
< IdPerfilConfiguracao > </ IdPerfilConfiguracao>
<!-0
1
2
3
4
5
6
7
8
9
10
11
12

Tipo de Configurao que o perfil define


= Opes de Segurana;
= Comportamento do veculo nas Excees;
= Configurao do Histrico;
= Atuadores;
= Opes Gerais e Modo Interativo;
= Senhas;
= Telefones Centrais;
= Configurar Comunicao com as Centrais;
= Transmisso de teleeventos (Central Principal);
= Transmisso de teleeventos (Central Auxiliar);
= Opes de Segurana Eletrnica (Central Principal);
= Opes de Segurana Eletrnica (Central Auxiliar);
= Temperatura (Central Principal);

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

23

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

13 = Temperatura (Central Auxiliar);


14 = Opes do Rastreador Solar;
15 = Configurar Extenso Logstica de Parada;
16 = Configurar RI 0454 Mini Max -->
<TipoConfiguracao> </TipoConfiguracao>
<!-- Numero de serie do rastreador (em hexadecimal) -->
<IdTerminal> </IdTerminal>
Observao1: A associao de Configurar Extenso Logstica de Parada (15) no
associar as mensagens para o veculo, para fazer isso, vide item IMPORTAO E
ASSOCIAO DE MENSAGENS DE EXTENSO LOGSTICA DE PARADA.
5.30 SOLICITAO DE INFORMAES SOBRE PERFIL DE DEFINIO
O Cliente pode obter as informaes sobre os Perfis de Definio utilizados para o
cadastro e importao dos alvos e cercas no mdulo de Segurana Eletrnica. Para tanto,
basta enviar um telecomando ao IASTurbo com a tag <CodMsg> igual -6, a interface
consultar o banco de dados da Central e devolver ao Cliente a relao dos Perfis de
Definio em um televento XML.
<!-- Identificacao da Mensagem -->
<CodMsg> -6 </CodMsg>
5.31 SOLICITAO DE INFORMAO SOBRE ALVOS
O Cliente pode obter as informaes sobre os alvos cadastrados no banco de dados da
Central SAVERTurbo. Para tanto, basta enviar um telecomando ao IASTurbo com a tag
<CodMsg> igual -7, a interface consultar o banco de dados da Central e devolver ao
Cliente a relao dos alvos (identificador, nome, latitude e longitude) em um televento XML.
<!-- Identificacao da Mensagem -->
<CodMsg> -7 </CodMsg>
5.32 SOLICITAO DE INFORMAO SOBRE CERCAS
O Cliente pode obter as informaes sobre as cercas cadastradas no banco de dados
da Central SAVERTurbo. Para tanto, basta enviar um telecomando ao IASTurbo com a tag
<CodMsg> igual -8, a interface consultar o banco de dados da Central e devolver ao
Cliente a relao das cercas (identificador, nome, latitude e longitude) em um televento
XML.
<!-- Identificacao da Mensagem -->
<CodMsg> -8 </CodMsg>
5.33 IMPORTAO E ASSOCIAO DE GRUPO DE ALVOS

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

24

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

Abaixo segue a descrio para um telecomando para importar e associar um Conjunto


de Alvos a um veculo. O valor da tag <CodMsg> deve ser -9.
<!-- Identificacao da Mensagem -->
<CodMsg> -9 </CodMsg>
<!-- Ao para os alvos Novos
0 = Incluir,
1 = No Incluir -->
<AcaoNovos> </AcaoNovos>

<!-- Ao para os alvos j cadastrados


0 = Sobrescrever,
1 = Incluir como novo alvo,
2 = No Incluir -->
<AcaoCadastrados> </AcaoCadastrados>
<!- Associao entre alvos e veculos
0 = Excluir associaes de alvos j existentes.
1 = Adicionar alvos importados aos alvos associados.-->
<AssociacaoAlvosVeiculos> </AssociacaoAlvosVeiculos>
<!-- Identificador do Perfil de Definio que ser usado para
complementar as informaes dos alvos importadas. Caso no seja
especificado ser utilizado o Perfil de Definio Padro -->
<IdPerfilDefinicao> </IdPerfilDefinicao>
<!-- Marcao do incio do grupo de alvos -->
<GrupoAlvo>
<!-- Nome do grupo de alvos que ser importado, caso no seja
informado o nome do grupo o IAS definir um nome com a data e
a hora da importao -->
<NomeGrupo></NomeGrupo>
<!-- Marcao do incio da Alvo -->
<Alvo>
<!-- Latitude em graus
- Notao texto. Ex: 2315'28.0" S
- Dcimo de Segundos. Ex: -837280
- Nmero Real. Ex: -23.257800
Campo de preenchimento obrigatrio -->
<Latitude> </Latitude>
<!-- Longitude em graus
- Notao texto. Ex. 4648'03.0" W
- Dcimo de Segundos. Ex: -1684830

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

25

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

- Nmero Real. Ex: -46.800850


Campo de preenchimento obrigatrio -->
<Longitude> </Longitude>
<!-- Nome do alvo, caso no seja informado o nome da alvo
o IAS definir um nome com data e hora da importao -->
<NomeAlvo> </NomeAlvo>
<!-- As tags a seguir so de preenchimento opcional -->
<RuaAvenida></RuaAvenida>
<Bairro> </Bairro>
<Cidade> </Cidade>
<UF> </UF>
<Numero></Numero>
<CEP> </CEP>
<Fone1> </Fone1>
<Fone2> </Fone2>
<Fax> </Fax>
</Alvo>
</GrupoAlvo>
<!-- Marcao do incio da seqncia dos veculos que sero
associados ao alvo (Opcional) -->
<Veiculo>
<!-- Numero de srie do rastreador
(em hexadecimal) -->
<IdTerminal> </IdTerminal>
</Veiculo>
Observao1: A tag <GrupoAlvo> ocorre somente uma vez dentro do dentro do
telecomando. A tag <Alvo> pode ser encadeada vrias vezes dentro da tag <GrupoAlvo>
dependendo da quantidade de Alvos importados.
Observao2: A tag <Veiculo> opcional e define os veculos que sero
associados a aquele grupo de Alvos. Caso a tag seja omitida os Alvos sero importados
somente.
Observao3: Na associao dos Alvos aos veculos permito um conjunto de no
mximo 250 Alvos, caso o nmero de Alvos exceda a quantidade mxima o telecomando
no ir associar nenhum Alvo.

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

26

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

5.34 IMPORTAO E ASSOCIAO DE GRUPOS DE CERCAS


As cercas definidas pelo Cliente sero importadas pelo IASTurbo para o banco de
dados da Central SAVERTurbo, a interface devolver ao Cliente um Teleevento indicando a
quantidade de cercas importadas. Abaixo segue a descrio para um Telecomando que
realiza a importao dos grupos de cercas via XML. A tag da mensagem <CodMsg> tem
valor a -10.
<!-- Identificacao da Mensagem -->
<CodMsg> -10 </CodMsg>

<!-- Marcao do incio do grupo de cercas -->


<GrupoCerca>
<!-- Nome do grupo de cercas que ser importado, caso no
seja informado o nome do grupo o IAS definir um nome com a
data e a hora da importao -->
<NomeGrupo></NomeGrupo>
<!-- Marcao do incio da cerca -->
<Cerca>
<!-- Latitude em graus
- Notao texto. Ex: 2315'28.0" S
- Dcimo de Segundos. Ex: -837280
- Nmero Real. Ex: -23.257800
Campo de preenchimento obrigatrio -->
<Latitude> </Latitude>
<!-- Longitude em graus
- Notao texto. Ex. 4648'03.0" W
- Dcimo de Segundos. Ex: -1684830
- Nmero Real. Ex: -46.800850
Campo de preenchimento obrigatrio -->
<Longitude> </Longitude>
<!-- Nome da cerca, caso no seja informado o nome da alvo
o IAS definir um nome com data e hora da importao -->
<NomeCerca> </NomeCerca>
<!-- As tags a seguir so de preenchimento obrigatrio
opcional -->
<RuaAvenida></RuaAvenida>
<Bairro> </Bairro>
<Cidade> </Cidade>

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

27

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

<UF> </UF>
<CEP> </CEP>
<Numero></Numero>
<Fone1> </Fone1>
<Fone2> </Fone2>
<Fax> </Fax>
<!-- Identificador do Perfil de Definio que ser usado
para complementar as informaes das cercas importadas.
Caso no seja especificado ser utilizado o Perfil de
Definio Padro. Caso no tenha Perfil de Definio
cadastrado como padro so utilizados valores default -->
<IdPerfilDefinicao> </IdPerfilDefinicao>
</Cerca>
</GrupoCerca>
<!-- Marcao do incio da seqncia dos veculos que sero
associados cerca (Opcional) -->
<Veiculo>
<!-- Nmero de srie do rastreador
(em hexadecimal) -->
<IdTerminal> </IdTerminal>
</Veiculo>
Observao1: A tag <GrupoCerca> ocorre somente uma vez dentro do dentro do
telecomando. A tag <Cerca> pode ser encadeada vrias vezes dentro da tag
<GrupoCerca> dependendo da quantidade de Cercas importadas.
Observao2: A tag <Veiculo> opcional e define os veculos que sero
associados a aquele grupo de Cercas. Caso a tag seja omitida as Cercas sero importadas
somente.
Observao3: Na associao das Cercas aos veculos permito um conjunto de no
mximo 100 Cercas, caso o nmero de Cercas exceda a quantidade mxima o telecomando
no ir associar nenhuma Cerca.
5.35 IMPORTAO E ASSOCIAO DE GRUPOS DE ROTAS
As rotas definidas pelo Cliente sero importadas pelo IASTurbo para o banco de dados
da Central SAVERTurbo, a interface devolver ao Cliente um Teleevento indicando a

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

28

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

quantidade de rotas importadas. Abaixo segue a descrio para um Telecomando que


realiza a importao dos grupos de rotas via XML. A tag da mensagem <CodMsg> tem
valor igual a -11.
<!-- Identificacao da Mensagem -->
<CodMsg> -11 </CodMsg>
<!-- Ao para as rotas Novas
0 = Incluir,
1 = No Incluir -->
<AcaoNovos> </AcaoNovos>
<!-- Ao para as rotas j cadastradas
0 = Sobrescrever,
1 = Incluir como nova rota,
2 = No Incluir -->
<AcaoCadastrados> </AcaoCadastrados>
<!- Associao entre rotas e veculos
0 = Excluir associaes de rotas j existentes.
1 = Adicionar rotas importadas s rotas associadas.
-->
<AssociacaoRotasVeiculos> </AssociacaoRotasVeiculos>
<!-- Marcao do incio do grupo de rotas -->
<GrupoRota>
<!-- Nome do grupo de rota que ser importado, caso no seja
informado o nome do grupo o IAS definir um nome com a data e
a hora da importao -->
<NomeGrupo></NomeGrupo>
<!-- Marcao do incio da rota -->
<Rota>
<!-- A tag a seguir de preenchimento opcional, caso no
seja preenchida ser utilizado o valor definido no Perfil
de Definio padro. Caso no seja informado a tolerncia
e no exista um Perfil de definio padro ser utilizada
a tolerncia com valor 0 (=100 metros). Os valores vlidos
so:
0 = 100 metros
1 = 200 metros
2 = 300 metros
3 = 400 metros
4 = 500 metros
5 = 1000 metros
6 = 2000 metros
7 = 5000 metros
8 = 10000 metros

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

29

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

-->
<Tolerancia> </Tolerancia>
<!-- Nome da rota, caso no seja informado o nome da rota
o IAS definir um nome com data e hora da importao -->
<NomeRota> </NomeRota>
<PontoRota>
<!-- Latitude em graus
- Notao texto. Ex: 2315'28.0" S
- Dcimo de Segundos. Ex: -837280
- Nmero Real. Ex: -23.257800
Campo de preenchimento obrigatrio -->
<Latitude> </Latitude>
<!-- Longitude em graus
- Notao texto. Ex. 4648'03.0" W
- Dcimo de Segundos. Ex: -1684830
- Nmero Real. Ex: -46.800850
Campo de preenchimento obrigatrio -->
<Longitude> </Longitude>
</PontoRota>
</Rota>
</GrupoRota>
<!-- Marcao do incio da seqncia dos veculos que sero
associados cerca (Opcional) -->
<Veiculo>
<!-- Nmero de srie do rastreador
(em hexadecimal) -->
<IdTerminal> </IdTerminal>
</Veiculo>

Observao1: A tag <GrupoRota> ocorre somente uma vez dentro do dentro do


telecomando. A tag <Rota> pode ser encadeada vrias vezes dentro da tag <GrupoRota>
dependendo da quantidade de Rotas importadas.
Observao2: A tag <Veiculo> opcional e define os veculos que sero
associados a aquele grupo de Rotas. Caso a tag seja omitida as Rotas sero importados
somente.
Observao3: Na importao e associao das Rotas aos veculos permito uma
Rota com um conjunto de no mximo 5000 pontos, caso o nmero de pontos da Rota
exceda a quantidade mxima o telecomando no ir importar e associar a Rota.

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

30

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

5.36 SOLICITAO DE INFORMAES SOBRE MENSAGENS FORMATADAS


O Cliente pode obter as informaes sobre as mensagens formatadas cadastradas no
banco de dados da Central SAVERTurbo. Para tanto, basta enviar um telecomando ao
IASTurbo com a tag <CodMsg> igual -12, a interface consultar o banco de dados da
Central e devolver ao Cliente a relao das mensagens formatadas com os seus
respectivos campos (nome, tipo, tamanho).
<!-- Identificacao da Mensagem -->
<CodMsg> -12 </CodMsg>

5.37 SOLICITAO DE INFORMAES SOBRE MENSAGENS DE EXTENSO LOGSTICA DE PARADA


O Cliente pode obter as informaes sobre as mensagens de Extenses Logsticas de
Parada cadastradas no banco de dados da Central SAVERTurbo. Para tanto, basta enviar
um telecomando ao IASTurbo com a tag <CodMsg> igual -13, a interface consultar o
banco de dados da Central e devolver ao Cliente a relao das mensagens de Extenses
Logsticas de parada com os seus respectivos campos (mensagem, tipo).
<!-- Identificacao da Mensagem -->
<CodMsg> -13 </CodMsg>

5.38 SOLICITAO DE INFORMAES SOBRE MENSAGENS DE EXTENSO LOGSTICA DE PARADA


ASSOCIADAS A UM TERMINAL

O Cliente pode obter as informaes sobre as mensagens de Extenses Logsticas de


Paradas associadas a um determinado terminal cadastradas no banco de dados da Central
SAVERTurbo. Para tanto, basta enviar um telecomando ao IASTurbo com a tag <CodMsg>
igual -14, a interface consultar o banco de dados da Central e devolver ao Cliente a
relao das mensagens formatadas com os seus respectivos campos (mensagem, tipo). A
tag <IdTerminal> dever ser preenchida com o identificador do terminal do que se deseja
obter as mensagens.
<!-- Identificacao da Mensagem -->
<CodMsg> -14 </CodMsg>
<!-- Nmero de srie do rastreador (em hexadecimal) -->
<IdTerminal> </IdTerminal>
5.39 IMPORTAO E ASSOCIAO DE MENSAGENS DE EXTENSO LOGSTICA DE PARADA

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

31

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

Abaixo segue a descrio para um telecomando para importar e associar um Conjunto


de Mensagens de Extenso Logstica de Parada a um veculo. O valor da tag <CodMsg>
deve ser -15.
<!-- Identificacao da Mensagem -->
<CodMsg> -15 </CodMsg>
<!-- Marcao do incio das mensagens -->
<MensagensELP>

<!-- Cada mensagem ter a tag <MensagemELP> -->


<MensagemELP>
<!-Parada:

Tipo

da

Mensagem

de

Extenso

Logstica

de

0 = Chegada em Atendimento (Lista de Clientes),


1 = Chegada em Parada Tcnica (Natureza da
Operao),
2 = Sada de Atendimento (Parada Tcnica ou
Resultado da Operao) -->
<TipoMsg> </TipoMsg>
<!-- A Mensagem de Extenso Logstica de Parada
cadastrada na Central SAVERTurbo (mximo de 18 caracteres
para cada mensagem) -->
<Mensagem> </Mensagem>
</MensagemELP>

<!-- Marcao do incio da seqncia dos veculos que sero


associados s mensagens(Obrigatrio) -->
<Veiculo>
<!-- Nmero de srie do rastreador
(em hexadecimal) -->
<IdTerminal> </IdTerminal>
</Veiculo>
</MensagensELP>

Observao1: A tag <MensagensELP> ocorre somente uma vez dentro do


telecomando. A tag <MensagemELP> pode ser encadeada vrias vezes dentro da tag
<MensagensELP> dependendo da quantidade de mensagens importadas.

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

32

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

Observao2: A tag <Veiculo> obrigatria e define os veculos que sero


associados s mensagens. Caso no seja enviado nenhum veculo, nenhuma associao
ser feita e uma mensagem de erro ser retornada.
Observao3: O limite de mensagens ser:
- Chegada em Atendimento: 100 Mensagens de 18 caracteres cada
(sequencia de 1 at 100)
- Chegada em Parada Tcnica: 15 Mensagens de 18 caracteres cada
(sequencia de 2 at 16)
- Sada de Atendimento: 16 Mensagens de 18 caracteres cada
(sequencia de 1 at 16)
Observao4: A seqncia para a Parada Tcnica iniciada por 2, pois a primeira
linha ser preenchida com o ttulo da lista de clientes que enviada na transmisso da
configurao. Essa seqncia ser determinada pela ordem do XML. Caso alguma
mensagem no estiver com a configurao correta, ser eliminada e a prxima mensagem
(se houver) receber a seqncia da mensagem anterior.
5.40 SOLICITAO DA LISTA DE MENSAGENS DE PR-DEFINIDAS
O Cliente pode obter a lista das Mensagens Pr-Definidas que podem ser enviadas a
partir da Central SAVERTurbo para os rastreadores DPlus (satlite) com o modelo 1460 e
1480. Para tanto, basta enviar um telecomando ao IASTurbo com a tag <CodMsg> igual
-16, a interface consultar o banco de dados da Central e devolver ao Cliente a relao
das Mensagens Pr-Definidas com os seus respectivos campos (IdMsgPre, Mensagem) no
teleevento -63.
<!-- Identificacao da Mensagem -->
<CodMsg> -16 </CodMsg>

5.41 SOLICITAO DA TRANSMISSO DA OPERAO


Abaixo segue a descrio do telecomando que solicita a transmisso uma Operao,
previamente associada, ao rastreador do veculo. O valor da tag <CodMsg> deve ser igual
-21
<!-- Identificacao da Mensagem -->
<CodMsg> -21 </CodMsg>
<!-- Numero de srie do rastreador
(em hexadecimal) -->
<IdTerminal> </IdTerminal>
Observao: Considera-se que o veculo relacionado possui uma Operao vlida
associada a ele.
5.42 SOLICITAO DA TRANSMISSO DO PERFIL DE CONFIGURAO

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

33

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

Abaixo segue a descrio do telecomando que solicita a transmisso de um Perfil de


Configurao, previamente associado, ao rastreador do veculo. O valor da tag <CodMsg>
deve ser igual -22
<!-- Id Sequencia gerado pelo cliente (0..99999) -->
<IdSeqMsg> </IdSeqMsg>
<!-- Identificacao da Mensagem -->
<CodMsg> -22 </CodMsg>

<!-- Tipo de Configurao que o perfil define para ser


transmitido ao rastreador do veculo
0 = Opes de Segurana;
1 = Comportamento do veculo nas Excees;
2 = Configurao do Histrico;
3 = Atuadores;
4 = Opes Gerais e Modo Interativo;
5 = Senhas;
6 = Telefones Centrais;
7 = Configurar Comunicao com as Centrais;
8 = Transmisso de teleeventos (Central Principal);
9 = Transmisso de teleeventos (Central Auxiliar);
10 = Opes de Segurana Eletrnica (Central Principal);
11 = Opes de Segurana Eletrnica (Central Auxiliar);
12 = Temperatura (Central Principal);
13 = Temperatura (Central Auxiliar);
14 = Opes do Rastreador Solar;
15 = Configurar Extenso Logstica de Parada;
16 = Configurar RI 0454 Mini Max -->
</TipoConfiguracao> </TipoConfiguracao>
<!-- Numero de srie do rastreador
(em hexadecimal) -->
<IdTerminal> </IdTerminal>
5.43 SOLICITAO DA TRANSMISSO DO CONJUNTO DE ALVOS
Abaixo segue a descrio para um telecomando que solicita a transmisso de um
Conjunto de alvos, previamente associados, a um veculo. O valor da tag <CodMsg> deve
ser -23
<!-- Id Sequencia gerado pelo cliente (0..99999) -->
<IdSeqMsg> </IdSeqMsg>
<!-- Identificacao da Mensagem -->
<CodMsg> -23 </CodMsg>

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

34

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

<!-- Caracteristica dos alvos Usado


0 = no-volteis
1 = volteis -->
<Caracteristica> </Caracteristica>
<!-- Incio e fim de atendimento
0 = no utilizar
1 = utilizar -->
<Atendimento> </Atendimento>
<!-- Em caso de sobreposio, usar o alvo
0 = com o centro mais prximo
1 = primeiro alvo da seqncia -->
<Sobreposicao> </Sobreposicao >
<!-- Nmero de srie do rastreador
(em hexadecimal) -->
<IdTerminal> </IdTerminal>
Observao: Considera-se que o veculo relacionado possui um conjunto de alvos
vlidos associados a ele.

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

35

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

5.44 SOLICITAO DA TRANSMISSO DE UM CONJUNTO DE CERCAS


Abaixo segue a descrio para um telecomando que solicita a de um Conjunto de
cercas, previamente associadas, a um veculo. O valor da tag <CodMsg> deve ser -24
<!-- Id Sequencia gerado pelo cliente (0..99999) -->
<IdSeqMsg> </IdSeqMsg>
<!-- Identificacao da Mensagem -->
<CodMsg> -24 </CodMsg>
<!-- Numero de srie do rastreador
(em hexadecimal) -->
<IdTerminal> </IdTerminal>
Observao: Considera-se que o veculos relacionado possui um conjunto de cercas
vlidas associadas a ele.
5.45 SOLICITAO DA TRANSMISSO DO CONJUNTO DE ROTAS
Abaixo segue a descrio para um telecomando que solicita a transmisso de um
Conjunto de Rotas, previamente associada, a um veculo. O valor da tag <CodMsg> deve
ser -25
<!-- Id Sequencia gerado pelo cliente (0..99999) -->
<IdSeqMsg> </IdSeqMsg>
<!-- Identificacao da Mensagem -->
<CodMsg> -25 </CodMsg>
<!-- Nmero de srie do rastreador
(em hexadecimal) -->
<IdTerminal> </IdTerminal>
Observao: Considera-se que o veculo relacionado possui um conjunto de rotas
vlidas associadas a ele.
5.46 SOLICITAO DO STATUS DA TRANSMISSO DA OPERAO
Esse telecomando faz a solicitao do status da ltima (mais recente) Operao
transmitida para um determinado veculo. O valor da tag <CodMsg> deve ser -26 e a tag
<IdTerminal> preenchida com o identificador do terminal do que se deseja obter o status
da transmisso da Operao mais recente.
<!-- Identificacao da Mensagem -->
<CodMsg> -26 </CodMsg>
<!-- Nmero de srie do rastreador (em hexadecimal) -->
<IdTerminal> </IdTerminal>

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

36

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

5.47 LOGIN NO IAS


O IASTurbo a partir da verso 6.00.000 disponibiliza a funcionalidade de login Central
aos seus clientes. Para que o IASTurbo solicite um Operador e Senha vlidos dos seus
clientes no arquivo de configurao (IASTurbo.INI) a tag SOLICITA_LOGIN deve estar com
o valor SIM, veja o exemplo:
SOLICITA_LOGIN = SIM
Dessa forma, aps o Cliente estabelecer a conexo com IAS, dever ser enviado ao
IAS um telecomando com as seguintes informaes Login Operador e Senha, para que a
partir desse ponto todos os outros telecomandos passem a ser logados na Central
SAVERTurbo. Essas informaes sero enviadas em modo texto sem a necessidade de
criptografia, pois a comunicao entre o Cliente e IAS realizada atravs do protocolo SSL
(Secure Sockets Layer) que assegura o trfego seguro de dados.
O IAS responder ao Cliente com um teleevento, em XML, indicando que o Usurio e a
senha so vlidos. Abaixo segue a descrio para um telecomando para realizar Login no
IAS. O valor da tag <CodMsg> deve ser -27
<!-- Identificacao da Mensagem -->
<CodMsg> -27 </CodMsg>
<!-- Login do Operador do IAS -->
<LoginOperador> </LoginOperador>
<!-- Senha do Operador do IAS -->
<Senha> </Senha>
<!-- Nmero do ltimo televento processado no IAS
Armazenado localmento armazenado no Cliente -->
<UltimoTeleEventoProcessado> </UltimoTeleEventoProcessado>
Observao1: A tag <LoginOperador> deve informar o login do operador que foi
cadastrado pelo Mdulo de Rastreamento com opo de Acesso ao IAS habilitada. A tag
<Senha> deve informar a senha do operador EM LETRAS MAISCULAS.
Observao2: A tag <UltimoTeleEventoProcessado> opcional e instru o IAS
a processar os teleeventos a partir do nmero informada na tag.
5.48 SOLICITAO DA TRANSMISSO DAS CONFIGURAES DE EXTENSO LOGSTICA DE PARADA
Abaixo segue a descrio para um telecomando que solicita a transmisso das
configuraes de Extenso Logstica de Parada, previamente associados, a um veculo. O
valor da tag <CodMsg> deve ser -28
<!-- Id Sequencia gerado pelo cliente (0..99999) -->
<IdSeqMsg> </IdSeqMsg>

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

37

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

<!-- Identificacao da Mensagem -->


<CodMsg> -28 </CodMsg>
<!-- Ttulo da lista de paradas a ser apresentado no terminal
>
<TituloListaParadas> </TituloListaParadas>

--

<!-- Tipo de chegada utilizada


0 = No utiliza Extenso Logstica de Parada na Chegada,
1 = Utiliza lista de Mensagens Formatadas
2 = Utiliza as mensagens da Extenso Logstica de parada -->
<TipoChegada> </TipoChegada>
<!-- Tipo de sada utilizada
0 = No utiliza Extenso Logstica de Parada na Sada,
1 = Utiliza lista de Mensagens Formatadas
2 = Utiliza as mensagens da Extenso Logstica de parada -->
<TipoSaida> </TipoSaida>
<!-- Flag de Abertura de ba sob autorizao
0 = No,
1 = Sim -->
<AberturaBauSobAutorizacao> </AberturaBauSobAutorizacao>
<!-- Flag que indica se deve apresentar as opes de sada quando
se opta por alguma opo da lista de paradas
0 = No,
1 = Sim -->
<ListaParadas> </ListaParadas>
<!-- Flag que indica se deve apresentar as opes de sada quando
se opta por alguma opo da natureza da operao (parada tcnica
0 = No,
1 = Sim -->
<NaturezaOperacao> </NaturezaOperacao>

<!-- Nmero de srie do rastreador


(em hexadecimal) -->
<IdTerminal> </IdTerminal>
Observao: Considera-se que o veculo relacionado possui um conjunto de
mensagens vlidas associadas a ele.
5.49 SOLICITAO DOS TELEEVENTOS PERSONALIZADOS DE USURIO
Abaixo segue a descrio para um telecomando que solicita a a lista de teleeventos
personalizados de usurio. O valor da tag <CodMsg> deve ser -30

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

38

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

<!-- Id Sequencia gerado pelo cliente (0..99999) -->


<IdSeqMsg> </IdSeqMsg>
<!-- Identificacao da Mensagem -->
<CodMsg> -30 </CodMsg>

6 TELEEVENTOS
O regime para troca de informaes com a Interface de Acesso Central SaverTurbo
consiste no usurio instanciar um Socket Client e aps receber o status de conectado
enviado pelo Socket Server, aguardar pelos Teleeventos. Cada Teleevento recebido dos
rastreadores pela Central SAVERTurbo ser encaminhado aos Sockets Client que
estiverem conectados. Ocasionalmente, quando a Interface de acesso estiver online e no
houverem Socket Clients conectados, todos os Teleeventos originados dos rastreadores
sero salvos no banco de dados da Central SAVERTurbo e posteriormente enviados para o
primeiro Socket Client que estabelecer uma conexo, que neste caso, potencialmente,
receber vrios Teleeventos acumulados de vrios rastreadores.

Envia buffer de teleeventos

Central
SAVERTurbo

(via socket)

IASTurbo

Cliente IAS

Veculo
Figura 4: Envio de um Teleeventos ao Cliente IAS

6.1

CABEALHO PADRO DOS TELEEVENTOS

Todos os eventos recebidos possuem um grupo de informaes que sempre esto


presentes. Observe que a tag <CodMsg> conter o valor que identifica o tipo de
informaes adicionais transportadas no evento.
<?xml version = "1.0"?>
<TeleEvento>
<!-- Numero do ltimo televento processado no IAS -->
<UltimoTeleEventoProcessado> </UltimoTeleEventoProcessado>
<!-- Id Sequencia gerado pelo sistema (0..99999) -->
<IdSeqMsg> </IdSeqMsg>
<!-- Base de comunicacao que recebeu o teleevento -->

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

39

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

<Origem> </Origem>
<!-- Modulo de Rastreamento destino do teleevento -->
<Destino> </Destino>
<!-- Tipo da Mensagem (0 = Controle, 1 = Normal) -->
<TipoMsg> </TipoMsg>
<!-- Identificacao da Mensagem -->
<CodMsg> </CodMsg>
<! Checar os possveis valores na documentao com os
detalhes para cada evento -->
<!-- Data e hora da emissao do teleevento -->
<DataHoraEmissao> </DataHoraEmissao>
<!-- Prioridade do teleevento (nao utilizado) -->
<Prioridade> </Prioridade>
<!-- Identificacao do rastreador como cadastrado
central (com ate 6 digitos) em hexadecimal -->
<IdTerminal> </IdTerminal>

na

<!-- Latitude em graus (Notacao texto. Ex: 023_32_13_0_S)


Onde: 023 = Graus, 32 = min, 13 = seg, 0 = dcimos de
segundo e S = orientao -->
<Latitude> </Latitude>
<!-- Longitude em graus (Notao texto. Ex. 046_36_40_0_W)
Onde: 046 = Graus, 36 = min, 40 = seg, 0 = dcimos de seg
e W = orientacao -->
<Longitude> </Longitude>
<!-- Estado do GPS no momento da geracao do teleevento:
0 = OK,
1 = Sem Visada,
2 = Sendo Iniciado,
3 = Nao Iniciado,
4 = Nao ha posicao disponivel -->
<Validade> </Validade>
<!-- Data e hora da gerao do teleevento pelo rastreador
-->
<DataHoraEvento> </DataHoraEvento>
<!-- Estado do Rastreador:
0 = Desativado,
1 = Em Local Autorizado,
2 = Em Transito,

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

40

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

3 = Interrompido,
4 = Bloqueado,
5 = Em Manobra,
6 = Rastreado -->
<StatusVeic> </StatusVeic>
<!-- Intervalo de envio de posio automtica pelo
rastreador:
0 = nao enviar,
1 = 1 minuto,
2 = 2 minutos,
3 = 3 minutos,
4 = 5 minutos,
5 = 10 minutos,
6 = 15 minutos,
7 = 20 minutos,
8 = 30 minutos,
9 = 1 hora,
10 = 2 horas,
11 = 3 horas,
12 = 5 horas,
13 = 6 horas,
14 = 12 horas,
15 = 1 dia -->
<Intervalo> </Intervalo>
<!-- Estado da Ignio do Veiculo:
0 = Desligada,
1 = Ligada,
2 = Indefinida -->
<Ignicao> </Ignicao>
<!-- Velocidade do veiculo em Km/h (0..255) -->
<Velocidade> </Velocidade>
<!-- Sentido do veiculo no momento da gerao do
teleevento:
0 = Norte,
1 = Nordeste,
2 = Leste,
3 = Sudeste,
4 = Sul,
5 = Sudoeste,
6 = Oeste,
7 = Noroeste -->
<Rumo> </Rumo>
<!-- Intervalo de envio de posio automtica pelo
rastreador dentro de cercas (veja <Intervalo>) -->

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

41

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

<IntervaloDif> </IntervaloDif>
<!-- Valor do Hodmetro em metros -->
<Hodometro> </Hodometro>
<!-- Data e hora da conexo (valido apenas para
comunicao discada) -->
<DataConexao> </DataConexao>
<! Valor indicado pelo Sensor de Temperatura -->
<Temperatura> </Temperatura>
<!-- Id seqencial gerado pelo rastreador quando a
comunicao foi gerada -->
<IdSeqVeiculo> </IdSeqVeiculo>
<!Distncia at o Ponto de Referncia cadastrado mais
prximo ou o Centro da Cidade, caso no haja Ponto de
Referncia ou este esteja mais prximo da localizao
atual -->
<Localizacao> </Localizacao>
<!- Informa a tecnologia utilizada na comunicao do
rastreador
0 = Comunicao discada
1 = Comunicao via mensagem de texto
2 = Comunicao celular
3 = Comunicao satlite -->
<Tecnologia> </Tecnologia>
<!-- Operadora:
0 = No Informado,
1 = Tim,
2 = Claro,
3 = Oi,
100 = Skywave,
101 = Sectrack,
102 = Iridium -->
<Operadora> </Operadora>
<!-- Modelo do Rastreador:
0 = No Informado,
1 = RI 1450,
2 = RI 1460 MAX (Skywave),
3 = RI 1460 MAX (Sectrack),
4 = RI 1480 MAX,
5 = RI 1454 MAX
6 = RI 4464
7 = RI 4484
8 = RI 4454

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

42

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

<ModeloRastreador> </ ModeloRastreador>


<!-- Validade da data hora da gerao do teleevento via
satlite
0 = vlida
1 = invlida -->
<UsandoDataHoraLES> </UsandoDataHoraLES>
<!-- DataHora LES (Skywave e SecTrack apenas para
teleeventos) -->
<DataHoraLES> <DataHoraLES>
<!-- Assume os valores
0 = Padro
1 = Diferenciado -->
<Intervalo_OP> </Intervalo_OP>
<!-- Assume os valores
2 = Celular
3 = Satelite -->
<TecnologiaIntervalo> </TecnologiaIntervalo>

<!-- Caso TecnologiaIntervalo = 2 (Celular) devolve um


tempo em segungos
Caso TecnologiaIntervalo = 3 (Satelite) devolve os
seguintes valores
0 = Nunca
1 = 5 min
2 = 10 min
3 = 15 min
4 = 20 min
5 = 30 min
6 = 45 min
7 = 1 h
8 = 1:30 h
9 = 2 h
10 = 3 h
11 = 5 h
12 = 6 h
13 = 12 h
14 = 1 dia
15 = def -->
<Intervalo_IP_SMS> </Intervalo_IP_SMS>

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

43

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

<!-- Assume os valores


0= No Lacrado
1= Lacrado pelo Motorista
2= Lacrado pela Central -->
<LacreCarreta> </LacreCarreta>
<!-- Assume os valores
0= No Lacrado
1= Lacrado pelo Motorista
2= Lacrado pela Central -->
<LacreCabine> </LacreCabine>
<!-- Assume os valores
0= No Lacrado
1= Lacrado pelo Motorista
2= Lacrado pela Central -->
<LacreBau> </LacreBau>
<!-- Assume os valores
0= No
1= Sim -->
<FalhaAbend> </FalhaAbend>
<!-- Assume os valores
0= No
1= Sim -->
<FalhaFlash> </FalhaFlash>
<!-- Assume os valores
0= No
1= Sim -->
<HodoInop> </HodoInop>
<!-- Assume os valores
0= No
1= Sim -->
<PerdaGPS> </PerdaGPS>
<!-- Assume os valores
0= No pressionado
1= pressionado -->
<BotaoPanico> </BotaoPanico>
<!-- Assume os valores
0= Aberta
1= Fechada -->
<PortaBau> </PortaBau>

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

44

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

<!-- Assume os valores


0= Aberta
1= Fechada -->
<PortaDireita> </PortaDireita>
<!-- Assume os valores
0= Aberta
1= Fechada -->
<PortaEsquerda> </PortaEsquerda>
<!-- Assume os valores
0= No engatada
1= Engatada -->
<EngateCarreta> </EngateCarreta>
<!-- Assume os valores
0= No acionada
1= Acionada -->
<ChaveDesbloqueio> </ChaveDesbloqueio>
<!-- Assume os valores
0= No pressionado
1= Pressionado
2= No instalado -->
<BotaoBau> </BotaoBau>
<!-- Assume os valores
0= Desconectado
1= Conectado -->
<EstadoTerminal> </EstadoTerminal>
<!-- Assume os valores
0= No
1= Sim
1= No instalada -->
<FalhaTravaMot> <FalhaTravaMot>
<!-- Assume os valores
0= No
1= Sim -->
<BatExtOut> </BatExtOut>
<!-- Assume os valores
0= No
1= Sim -->
<BatIntOut> </BatIntOut>

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

45

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

<!-- Assume os valores


0= No acionada
1= Acionada -->
<ChaveArmadilha> </ChaveArmadilha>
<!-- Assume os valores
0= No
1= Sim -->
<Historico> </Historico>

<\TeleEvento>
6.2

CONFIRMAO DE OPERAO REMOTA


<!-- Identificacao da Mensagem -->
<CodMsg> 9A </CodMsg>
<!Identificao da Operao Remota -->
<IdOperacaoRemota> </IdOperacaoRemota>
<!Diagnstico de Operao Remota -->
<DiagnosticoOpRemota> </DiagnosticoOpRemota >
O-bservao:
A
combinao
das
tags
<IdOperacaoRemota>
e
<DiagnosticoOpRemota> indicam o resultado da operao remota que est sendo
confirmada:
Se a tag <DiagnosticoOpRemota> apresentar um valor diferente de zero, e a tag
<IdOperacaoRemota> corresponder a uma identificao de operao remota que
estava pendente na Central SaverTurbo, este teleevento indica que o terminal
recebeu corretamente o telecomando, mas no foi capaz de efetivar a operao
remota.
Se a tag <DiagnosticoOpRemota> apresentar um valor diferente de zero, e o
campo <IdOperacaoRemota> corresponder a um dos valores reservados de
identificao de operao remota, associados a confirmaes negativas, este
teleevento indica que o terminal no conseguiu processar o telecomando, tendo
sido apenas capaz de identificar que tipo de operao remota se desejava
realizar.

Se a tag <DiagnosticoOpRemota> apresentar o valor zero, a tag


<IdOperacaoRemota> corresponder a uma identificao de operao remota que estava
pendente na Central SaverTurbo. Neste caso, o terminal recebeu e interpretou corretamente
o telecomando.
Se o valor retornado em <IdOperacaoRemota> for negativo, significa que o
rastreador desprezou o pacote e considerou que nem mesmo este ID confivel. Sendo
Assim, o valor retornado indica o comando que resultou em falha, como segue:

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

46

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

Valor
-15
-16
-17
6.3

Telecomando
Configurao de Mensagem Predefinidas
Configurao de Chamadas de Longa Distncia
Configurao de Mensagem Formatadas

STATUS DE ENVIO DE TELECOMANDO

Este teleevento a resposta para todo telecomando enviado ao rastreador pelo


cliente. O teleevento Status de Envio de Telecomando gerado pela Base Digital e
repassado aos clientes conectados Interface, sempre que houver sucesso ou falha na
tentativa de enviar um telecomando qualquer ao rastreador. Cada telecomando, como visto
anteriormente, possui uma chamada <IdSeqMsg>, um nmero sequencial que varia de 0 a
99999 e gerado pelo cliente. O teleevento Status de Envio de Telecomando carrega uma
tag chamada <IdStatus> contendo o mesmo valor que a tag <IdSeqMsg> possuia
quando o telecomando foi gerado. O que aconteceu de fato ao telecomando definido pela
tag <StsEnvio>. Veja o formato deste teleevento:
<!-- Identificacao da Mensagem -->
<CodMsg> 81 </CodMsg>
<!-- Identifica a tag <IdSeqMsg> gerada pelo cliente quando
enviou o telecomando para o IASTURBO -->
<IdStatus> </IdStatus>
<!-- Status do envio de um telecomando:
0 = Envio OK,
1 = Tentativas esgotadas,
16 = Armazenado na Base,
132 = Telecomando descartado,
257 = Terminal desconhecido,
258 = Uso no autorizado do terminal,
259 = Telecomando desconhecido -->
<StsEnvio> </StsEnvio>
<!-- Tamanho da mensagem do telecomando enviado, em bytes, que
foi trafegada via satlite (apenas para comunicao satelital)
-->
<TamanhoMensagem> </TamanhoMensagem>

Repare que a identificao do teleevento dada pela tag <CodMsg>, que neste caso
contm o valor 81 (hexadecimal). Note tambm que os valores desta tag sempre so
representados na forma hexadecimal. Outro detalhe deste teleevento que seu tipo de
controle, portanto, a tag <TipoMsg> sempre ser igual a 0.

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

47

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

6.4

MENSAGEM FORMATADA

A tag <CodMsg> que sempre conter o valor A2 (hexadecimal), que identifica um


teleevento Mensagem Formatada.
<!-- Identificacao da Mensagem -->
<CodMsg> A2 </CodMsg>
<!-- Seqencial que identifica a Mensagem Formatada hexadecimal
-->
<NroSeqMacro > </NroSeqMacro>
<!- Concatenao das informaes enviadas pelo Rastreador -->
<Texto> </Texto>
6.5

SOLICITAO DE AUTORIZAO

A tag <CodMsg> conter o valor 93 (hexadecimal), que identifica um teleevento de


Solicitao de Autorizao. A tag <CausaAutorizacao> informa qual tipo de autorizao est
sendo solicitada.
<!-- Identificacao da Mensagem -->
<CodMsg> 93 </CodMsg>
<!-- Identifica o tipo de autorizao sendo solicitada:
1: Chegada Forada
3: Abertura de Ba
5: Deslacre de Ba
6: Deslacre de Cabine
7: Deslacre de Carreta
8: Desengate de Carreta
9: Conexo de Rastreador
10: Deslacre de Motor
129: Chegada Forada mediante senha de pnico
131: Abertura de Ba mediante senha de pnico
133: Deslacre de Ba mediante senha de pnico
134: Deslacre de Cabine mediante senha de pnico
135: Deslacre de Carreta mediante senha de pnico
136: Desengate de Carreta mediante senha de pnico
137: Conexo de Rastreador mediante senha de pnico
138: Deslacre de Motor Sob Senha de Pnico-->
<CausaAutorizacao> </ CausaAutorizacao >

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

48

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

6.6

SINAL DE VIDA

A tag <CodMsg> conter o valor 9F (hexadecimal), que identifica um teleevento de


Sinal de Vida.
<!-- Identificacao da Mensagem -->
<CodMsg> 9F </CodMsg>
6.7

POSIO AVULSA

A tag <CodMsg> conter o valor 91 (hexadecimal), que identifica um teleevento de


Posio Avulsa.
<!-- Identificacao da Mensagem -->
<CodMsg> 91 </CodMsg>
6.8

POSIO AUTOMTICA

A tag <CodMsg> conter o valor 92 (hexadecimal), que identifica um teleevento de


Posio Automtica.
<!-- Identificacao da Mensagem -->
<CodMsg> 92 </CodMsg>
6.9

TELEVENTO DE EXCEO

A tag <CodMsg> conter o valor 94 (hexadecimal), que identifica um teleevento de


Exceo. A tag <Ocorrencia> informa qual tipo de ocorrncia que foi gerada, e a tag
<Excecao> informa o tipo da exceo gerada.
<!-- Identificacao da Mensagem -->
<CodMsg> 94 </CodMsg>
<!-- Identifica o tipo de ocorrncia gerada:
0: Parada No Permitida
1: Partida Suspeita
2: Perda da Console
3: Perda da Bateria
4: Sada de rea
5: Entrada de rea
6: Abertura de Porta Esquerda No Autorizada
7: Arrombamento de Ba
8: Estouro de Senha do Motorista
9: Tempo de Manobra Excedido
10: Distncia de Manobra Excedida
11: Timeout de Ba
12: Bloqueio Remoto

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

49

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

13: Estouro de Senha de Desbloqueio


15: Passageiro Adicional
17: Perda do GPS
18: Alarme 4 (configurvel)
19:
20: Jammer Celular Ativo
22: GPS Inoperante
23: Desengate No Autorizado de Carreta
24: Falha Antena GPS Interno
26: Sada de rea de Ptio com Senha de Manobrista
28: Alarme 1 (configurvel)
29: Alarme 2 (configurvel)
30: Alarme 3 (configurvel)
31: Abertura de Porta Direita No Autorizada -->
<Ocorrencia> </Ocorrencia>
<!-- Identifica o tipo de exceo gerada:
1: Teleevento
2: Alerta
3: Alarme
4: Bloqueio -->
<Excecao> </Excecao>
6.10 CONFIRMAO DE LEITURA DE MENSAGEM LIVRE
Este teleevento est diretamente relacionado ao Telecomando Mensagem Livre, visto
na seo 4.1. Sempre quando for enviado um Telecomando Mensagem Livre para o
terminal do rastreadoir marcado com confirmao de leitura (tag <ConfirmacaoLeitura>
igual a 1), assim que a mensagem for lida, o rastreador responder com um Teleevento
Confirmao de Leitura de Mensagem Livre. O valor da tag <CodMsg> para este teleevento
99 (hexadecimal).
<!-- Identificacao da Mensagem -->
<CodMsg> 99 </CodMsg>
<!-- Id da Mensagem Livre da Mensagem lida no Terminal do
Veiculo. Veja a tag <IdMensagem> do Telecomando Mensagem Livre.
Os valores permitidos sao de 0 a 255 -->
<IdMsgConfirmacao> </IdMsgConfirmacao>

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

50

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

6.11 TELEVENTOS LOGSTICOS


Teleeventos Logsticos so aqueles identificados pela tag <CodMsg> 95
(hexadecimal). Para diferenciar um teleevento logstico basta analisar o contedo da tag
<Evento>, que possuir um valor nico. A tabela a seguir contm apenas a listagem geral,
porm os detalhes de cada teleevento (quando houverem), podero ser vistos nas sees
subseqentes.
<!-- Identificacao da Mensagem -->
<CodMsg> 95 </CodMsg>
Evento
Descrio
0 Ignio Ligada
1 Ignio Desligada
2 Ativao
3 Desativao
4 Chegada
5 Sada
8 Chegada Forada
10 Desbloqueio
11 Inicio de Manobra
12 Fim de Manobra
13 Abertura de Ba
14 Fechamento de Ba
15 Desbloqueio pelo Motorista
16 Velocidade Excedida
17 Desativao pelo Motorista
18 Desativao por Fim de Percurso
19 Desativao pelo Supervisor
20 Boto de Pnico
21 Distncia ou Tempo Mximo sem GPS
22 Entrada de rea
23 Sada de rea
24 Engate de Carreta
25 Desengate de Carreta
26 Entrada de rea - Ptio
27 Sada de rea - Ptio
28 Chegada em Ptio
29 Sada em Ptio
30 Ba Lacrado pela Central
31 Cabine Lacrada pela Central
32 Carreta Lacrada pela Central
33 Ba Lacrado pelo Motorista
34 Cabine Lacrada pelo Motorista

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

51

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

35 Carreta Lacrada pelo Motorista


37 Ba Deslacrado pela Central
38 Cabine Deslacrada pela Central
39 Carreta Deslacrada pela Central
40 Ba Deslacrado por Autorizao
41 Cabine Deslacrada por Autorizao
42 Carreta Deslacrada por Autorizao
43 Senha de Pnico
44 Fechamento de Porta Direita
45 Abertura de Porta Direita
46 Fechamento de Porta Esquerda
47 Abertura de Porta Esquerda
48 Possvel Pane Eltrica
49 Abertura no Autorizada de Porta
51 Chave Armadilha Desarmada
52 Chave Armadilha Armada
53 Temperatura
54 Status de Comunicao
55 Incio de Desconexo
56 Fim de Desconexo
57 Incio do Modo Sleep
58 Desbloqueio Recusado - Ba Aberto
59 Desbloqueio Recusado - Carreta Desengatada
60 Desbloqueio Recusado - Portas de Cabine Abertas
61 Falha no Hodmetro - Calculando Valores pelo GPS
62 Possvel Falha na Comunicao com Outra Central
63 Comunicao com Outra Central Restabelecida
64 Incio de Chamada de Voz - Microfone Oculto
65 Fim de Chamada de Voz - Microfone Oculto
66 Falha de Execuo do Microfone Oculto
67 Microfone Oculto
68 Troca para Gerenciadora
69 Troca de Gerenciadora Efetuada com Erros
70 ERRO na Troca para Gerenciadora
71 Desconexo ABORTADA
72 ERRO na Desconexo
73 ERRO na Conexo
74 Conexo REJEITADA
82 Tempo de Abertura da Trava Solenide Fixado em 30s
83 ltima Posio Vlida do GPS
92 Mensagem Predefinida Invlida
93 Troca de Gerenciadora Efetuada em Modo Satlite
94 Troca de Gerenciadora Abortada em Modo Satlite

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

52

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

95 Incio de Desconexo dessa Central via Satlite


96 Rastreador Reconfigurado para Outra Central
97 Entrada em Cerca de Sada Restrita via Satlite
98 Entrada em Cerca de Entrada Restrita via Satlite
99 Entrada em Cerca de Ptio via Satlite
100 Entrada em Cerca de Passagem via Satlite
101 Entrada em Rota via Satlite
102 Sada de Cerca de Sada Restrita via Satlite
103 Sada de Cerca de Entrada Restrita via Satlite
104 Sada de Cerca de Ptio via Satlite
105 Sada de Cerca de Passagem via Satlite
106 Sada de Rota via Satlite
107 Recuperao do Mdulo Satlite
108 Falha Interna com o Multiplexador
109 Normalizada Operao com o Multiplexador
110 ERRO na Troca para Gerenciadora em Modo Satlite
111 Troca de Ger. Efetuada com Erros via Satlite
113 Posio Automtica - Rastreador Solar
114 Posio Avulsa - Rastreador Solar
120 Entrada na rea de Alvo
121 Sada da rea de Alvo
122 Comando Chegada no Alvo
123 Comando Sada no Alvo
124 Incio de Atendimento
125 Fim de Atendimento
126 Lacre Automtico de Ba
127 Lacre Automtico de Cabine
128 Lacre Automtico de Carreta
129 Deslacre Automtico de Ba
130 Deslacre Automtico de Cabine
131 Deslacre Automtico de Carreta
132 Desligamento do Rastreador por Bateria Crtica
133 Nvel de Bateria Baixo
134 Nvel de Bateria Voltou ao Normal
135 Pos. Automtica - Rastreador Solar: Bateria Baixa
136 Trava de 5 Roda Liberada
137 Trava de 5 Roda Fechada
138 Pos. Automtica - Rastreador Solar: Bateria Normal
139 Atualizao de Posio Satlite
140 Falha de Desconexo com a Central Auxiliar Antiga
141 IP Alternativo do Site Reserva igual ao Principal
142 Troca Operadora: Falha na Comun. na Nova Operadora
143 Troca Operadora: Abortado - Falha na Comun. GPRS

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

53

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

144 Troca Operadora: Operadora Desejada No Encontrada


145 Troca Operadora: Falha na Troca do SIM Card
146 Sucesso na Troca de Operadora Celular
147 Microfone Oculto No Instalado
148 Chegada com Extenso Logstica de Parada
149 Sada com Extenso Logstica de Parada
150 Motor Lacrado pelo Motorista
151 Motor Deslacrado pelo Motorista
152 Motor Lacrado pela Central
153 Motor Deslacrado pela Central
154 Motor Deslacrado Automaticamente pelo RI
155 Estouro de Memria Flash para armazenar FPs
156 Excedido o limite mximo de FPs simultneas
157 Excedido o limite de linhas da Tab. de Transies
158 Recepo de Telecomando Satlite OK no Rastreador
159 Teste de Comunicao Satlite
160 Funes Programveis Inibidas no Rastreador
161 Funes Programveis Inibidas e Apagadas no RI
162 Funes Programveis Liberadas no Rastreador
163 Motorista no identificado
164 Motorista entrou ID invlida mais que 5 vezes
165 Telemetria entrou em falha
166 Telemetria recuperou-se da falha
169 Recepo de mensagem OK
170 Atuador 1 ligado
171 Atuador 2 ligado
172 Atuador 1 desligado
173 Atuador 2 desligado
178 Timeout na recepo de mensagem
179 Erro de processamento da mensagem
180 Deteco de Jamming Celular
181 Fim de deteco de Jamming Celular
193 Telemetria MTO

6.11.1 Temperatura
Quando a tag <Evento> contiver o valor 53 (decimal), ento o XML identifica um
teleevento logstico de temperatura. A seguir, temos as tags que os clientes conectados ao
IASTurbo recebero sempre quando um teleevento de temperatura for recebido pela Central
SaverTurbo.
<!-- Tipo do Evento Recebido (decimal) -->
<Evento> 53 </Evento>

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

54

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

<!-- Validade da Temperatura:


0: Leitura Invlida
1: Leitura Vlida -->
<Temperatura_Validade> </Temperatura_Validade>
<!-- Controle de Temperatura:
0: Desabilitado
1: Habilitado -->
<Temperatura_Controle> </Temperatura_Controle>
<!-- Meio de Comunicao no qual o rastreador gerou o
teleevento de temperatura:
0: Celular
1: SMS
2: Discado -->
<Temperatura_Tecnologia> </Temperatura_Tecnologia>
<!-- Freqncia configurada no rastreador para envio de
teleeventos de temperatura, em segundos -->
<Temperatura_Intervalo> </Temperatura_Intervalo>
<!-- Valor da Temperatura em ponto flutuante, com preciso de 1
(uma) casa decimal -->
<Temperatura_Valor> </Temperatura_Valor>
<!-- Nvel de importncia do teleevento reportando pelo
rastreador, de acordo com a configurao recebida da
Central SaverTurbo:
1: Normal (nenhuma luz acesa na Torre de Alertas da
Central)
2: Alerta (luz amarela piscante)
3: Alarme (luz vermelha piscante) -->
<Temperatura_AcaoAlarme> </Temperatura_AcaoAlarme>
<!-- Cdigo de Ocorrncia na Leitura da Temperatura:
0: Normal
1: Defeito no Sensor
2: Temperatura Mxima Excedida
3: Temperatura Mnima Excedida
4: Temperatura Automtica
5: Temperatura Avulsa
6: Temperatura do Ba Desceu para Dentro dos Limites de
operao
7: Temperatura do Ba Subiu para Dentro dos Limites de
operao
8: Funcionamento Normal do Sensor -->
<Temperatura_Codigo> </Temperatura_Codigo>

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

55

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

6.11.2 Operaes com Alvos


Os teleeventos Logsticos 120, 121, 122 e 123 identificam operaes relacionadas
aos Alvos Eletrnicos enviados aos Rastreadores. Tais teleeventos carregaro duas tags
adicionais chamadas <OrdemEnvioAlvo> e <Nome_Alvo>. A primeira, diz a seqncia
do alvo na lista recebida pelo Rastreador. Essa lista possuir a mesma ordem em que os
Alvos aparecem na tela de Configurao de Alvos da Central SaverTurbo. A segunda, como
o prprio nome diz, informa o nome do Alvo como foi gravado no Segurana Eletrnica.
<!-- Tipo do Evento Recebido: 120,121,122,123 (decimal) -->
<Evento> </Evento>
<!-- Ordem de envio do Alvo -->
<OrdemEnvioAlvo> </OrdemEnvioAlvo>
<!-- Nome do Alvo -->
<Nome_Alvo> </Nome_Alvo>
6.11.3 Incio de Atendimento
Este teleevento, identificado pela tag <Evento> 124 indica o incio do processo de
atendimento dentro de um alvo e tem os mesmos campos que os eventos 120, 121, 122 e
123. Veja a seguir:
<!-- Tipo do Evento Recebido: 124 (decimal) -->
<Evento> 124 </Evento>
<!-- Ordem de envio do Alvo -->
<OrdemEnvioAlvo> </OrdemEnvioAlvo>
<!-- Nome do Alvo -->
<Nome_Alvo> </Nome_Alvo>
6.11.4 Fim de Atendimento
Este teleevento, identificado pela tag <Evento> 125 possui alm das tags
carregadas nas demais opes com alvos, a tag <Resultado_Operacao>. Veja a
seguir:
<!-- Tipo do Evento Recebido: 125 (decimal) -->
<Evento> 125 </Evento>
<!-- Ordem de envio do Alvo -->
<OrdemEnvioAlvo> </OrdemEnvioAlvo>
<!-- Nome do Alvo -->
<Nome_Alvo> </Nome_Alvo>

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

56

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

<!-- Resultado da Operao:


0: normal
7: finalizacao automtica por sada do alvo (o motorista
no fez o procedimento)-->
<Resultado_Operacao> </Resultado_Operacao>

6.11.5 Eventos de Rastreador Solar


Estes teleeventos so identificado pela tags <Evento> 57 (somente
rastreadores modelo 1550 ou 1560), 113, 114, 132, 133 e 134 ,
possuem alm das tags carregadas nas demais opes com alvos, as tags
<RISOLAR_Tensao_Bat>,<RISOLAR_Tensao_Painel>,<RISOLAR_Corrente_Bat>,
<RISOLAR_Temperatura>, <RISOLAR_Alimentacao>, <RISOLAR_Carregador>,
<RISOLAR_Nivel_Bateria>. Veja a seguir:
<!-- Tipo do Evento Recebido: 57,113,114,132,133,134 (decimal)
-->
<Evento> 134 </Evento>
<!Tenso da Bateria do Rastreador Solar (em Volts) -->
<RISOLAR_Tensao_Bat>3,4</RISOLAR_Tensao_Bat>
<!Tenso do Painel do Rastreador Solar (em Volts) -->
<RISOLAR_Tensao_Painel>10,0</RISOLAR_Tensao_Painel>
<!Corrente da Bateria do Rastreador Solar (em mA) -->
< RISOLAR_Corrente_Bat >70</RISOLAR_Corrente_Bat>
<!Temperatura do Painel do Rastreador Solar (em C) -->
<RISOLAR_Temperatura>25</RISOLAR_Temperatura>
<!Fonte de Energia do Rastreador Solar
0 ou 3 : Pelo Painel
1 : Pela Bateria
2 : Desligada -->
<RISOLAR_Alimentacao >2</RISOLAR_Alimentacao>
<!Estado do Carregador de Bateria do Rastreador Solar
0 ou 1 : Ligado
2 : Desligado
3 : Erro -->
<RISOLAR_Carregador>3</RISOLAR_Carregador>
<!Nvel da Bateria do Rastreador Solar
0 : Normal
1 : Baixo
2 : Crtico -->

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

57

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

< RISOLAR_Nivel_Bateria >1</ RISOLAR_Nivel_Bateria >


6.11.6 Chegada com Extenso Logstica de Parada
Este teleevento, identificado pela tag <Evento> 148 indica a chegada com
Extenso Logstica de Parada, que pode ser de atendimento ao cliente ou de parada
tcnica. Veja a seguir:
<!-- Tipo do Evento Recebido: 148 (decimal) -->
<Evento> 148 </Evento>
<!-- Tipo da Mensagem de Extenso Logstica de Parada:
0 = Chegada em Atendimento (Lista de Clientes),
1 = Chegada em Parada Tcnica (Natureza da Operao) -->
<TipoMsg> </TipoMsg>
<!-- Nmero seqencial gravado para
especfico. -->
<SequenciaChegada> </SequenciaChegada>

tipo

de

mensagem

Observao1: O limite de mensagens ser:


- Chegada em Atendimento: 100 Mensagens de 18 caracteres cada
(sequencia de 1 at 100)
- Chegada em Parada Tcnica: 15 Mensagens de 18 caracteres cada
(sequencia de 2 at 16)
- Sada de Atendimento: 16 Mensagens de 18 caracteres cada
(sequencia de 1 at 16)
Observao2: A seqncia para a Parada Tcnica iniciada por 2 pois a primeira
linha ser preenchida com o ttulo da lista de clientes que enviada na transmisso da
configurao.
6.11.7 Sada com Extenso Logstica de Parada
Este teleevento, identificado pela tag <Evento> 149 indica a chegada com
Extenso Logstica de Parada, que pode ser de atendimento ao cliente ou de parada
tcnica. Veja a seguir:
<!-- Tipo do Evento Recebido: 149 (decimal) -->
<Evento> 149 </Evento>
<!-- Tipo da Mensagem de Extenso Logstica de Parada:
0 = Chegada em Atendimento (Lista de Clientes),
1 = Chegada em Parada Tcnica (Natureza da Operao) -->
<TipoMsg> </TipoMsg>
<!-- Nmero seqencial
especfico. -->

gravado

para

tipo

de

mensagem

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

58

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

<SequenciaChegada> </SequenciaChegada>
<!-- Nmero seqencial gravado para o tipo de mensagem igual a
2. -->
<SequenciaSaida> </SequenciaSaida>

Observao1: O limite de mensagens ser:


- Chegada em Atendimento: 100 Mensagens de 18 caracteres cada
(sequencia de 1 at 100)
- Chegada em Parada Tcnica: 15 Mensagens de 18 caracteres cada
(sequencia de 2 at 16)
- Sada de Atendimento: 16 Mensagens de 18 caracteres cada
(sequencia de 1 at 16)
Observao2: A seqncia para a Parada Tcnica iniciada por 2 pois a primeira
linha ser preenchida com o ttulo da lista de clientes que enviada na transmisso da
configurao.
6.11.8 Recepo de mensagem OK
Este teleevento, identificado pela tag <Evento> 169 indica a recepo pelo
rastreador de uma mensagem. A definio das propriedades da mensagem recebida so
descritas pelas tokens abaixo. Veja a seguir:
<!-- Tipo do Evento Recebido: 169 (decimal) -->
<Evento> 169 </Evento>
<!-- Tipo da Mensagem que foi recebida:
0: Mensagem Formatada
1: Mensagem Livre
2: Mensagem Pr-Definida
3: Mensagem Binria -->
<TipoMensagem> </TipoMensagem>
<!-- Id da Mensagem, gerado pelo cliente entre 0 e 255. Assim
que recebida no terminal, o veiculo responde com um
Teleevento Confirmao de Recebimento de Mensagem com o Id
da Mensagem enviado no telecomando -->
<IdMsgConfirmacao> </IdMsgConfirmacao>
Este eleveevento gerado quando todas as partes de uma mesma mensagem so
entregue com sucesso, caso esse teleevento no seja gerado em at 15 minutos pode-se
considerar que houve uma falha no envio da mensagem e o cliente pode retransmitir a
mensagem.

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

59

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

6.11.9 Timeout na recepo de mensagem


Este teleevento, identificado pela tag <Evento> 178 indica timeout a recepo pelo
rastreador de uma mensagem. A definio das propriedades da mensagem recebida so
descritas pelas tokens abaixo. Veja a seguir:
<!-- Tipo do Evento Recebido: 169 (decimal) -->
<Evento> 178 </Evento>
<!-- Tipo da Mensagem que foi recebida:
0: Mensagem Formatada
1: Mensagem Livre
2: Mensagem Pr-Definida
3: Mensagem Binria -->
<TipoMensagem> </TipoMensagem>
<!-- Id da Mensagem, gerado pelo cliente entre 0 e 255. Assim
que recebida no terminal, o veiculo responde com um
Teleevento Confirmao de Recebimento de Mensagem com o Id
da Mensagem enviado no telecomando -->
<IdMsgConfirmacao> </IdMsgConfirmacao>
Este televeevento gerado quando uma das as partes de uma mensagem no
conseguirem ser entregues em um intervalo de tempo de no mximo 15 minutos.
6.11.10 Erro de processamento da mensagem
Este teleevento, identificado pela tag <Evento> 179 indica erro no processamento
de um mensagem pelo rastreador. A definio das propriedades da mensagem recebida
so descritas pelas tokens abaixo. Veja a seguir:
<!-- Tipo do Evento Recebido: 169 (decimal) -->
<Evento> 179 </Evento>
<!-- Tipo da Mensagem que foi recebida:
0: Mensagem Formatada
1: Mensagem Livre
2: Mensagem Pr-Definida
3: Mensagem Binria -->
<TipoMensagem> </TipoMensagem>
<!-- Id da Mensagem, gerado pelo cliente entre 0 e 255. Assim
que recebida no terminal, o veiculo responde com um
Teleevento Confirmao de Recebimento de Mensagem com o Id
da Mensagem enviado no telecomando -->
<IdMsgConfirmacao> </IdMsgConfirmacao>

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

60

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

Este televeevento gerado quando partes distintas de mensagens diferentes


chegam fora de ordem ao rastreador.
6.11.11 Telemetria MTO
Este teleevento, identificado pela tag <Evento> 184 identifica um teleevento
logstico de telemetria MTO. A seguir, temos as tags que os clientes conectados ao
IASTurbo recebero sempre quando esse teleevento for recebido pela Central SaverTurbo.
<!-- Tipo do Evento Recebido: 184 (decimal) -->
<Evento> 184 </Evento>
<!-- Tipo da Infrao recebida:
0:Velocidade mxima excedida
1:Velocidade mxima sob chuva excedida
2:Rotao mxima excedida
3:Acelerao brusca
4:Freada brusca
5:Veculo parado em marcha lenta
6:Veculo desengrenado -->
<TipoInfracao> </TipoInfracao>
<!-- Valor mximo medido, esta tag deve ser considerada para os
seguintes Tipos da Infraes:
0:Velocidade mxima excedida (valor em Km/h)
1:Velocidade mxima sob chuva excedida (valor em Km/h)
2:Rotao mxima excedida (valor em RPM j multiplicado por
100)
Para os outros Tipos de Infraes o valor informado 0 e
deve ser desconsiderado -->
<ValorMaximoMedido> </ValorMaximoMedido>
<!-- Durao da Infrao um valor em segundos e esta tag deve
ser considerada para todas as Infraes, exceto as
infraes 3 e 4, nesse caso o valor zero informado e deve
ser desconsiderado -->
<DuracaoInfracao> </DuracaoInfracao>
6.12 MENSAGEM LIVRE
Texto digitado no terminal instalado no veculo. A tag <Texto> contm o texto
digitado e a tag <CodMsg> para este teleevento 97 (hexadecimal).
<!-- Identificacao da Mensagem -->
<CodMsg> 97 </CodMsg>
<!Texto da Mensagem Livre enviada pelo Rastreador-->
<Texto> </Texto>

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

61

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

6.13 MENSAGEM PREDEFINIDA


Texto selecionado no terminal instalado no veculo e enviado para a Central
SaverTurbo. A tag <Texto> contm o texto digitado, a tag <IdMsgPre> possui o cdigo da
mensagem dentro do cadastro da Central SaverTurbo e a tag <CodMsg> para este
teleevento A4 (hexadecimal).
<!-- Identificacao da Mensagem Predefinida-->
<CodMsg> A4 </CodMsg>
<!-- Id da Mensagem Predefinida enviada pelo Rastreador -->
<IdMsgPre> </IDMsgPre>
<!-- Texto da Mensagem Predefinida enviada pelo Rastreador -->
<Texto> </Texto>
6.14 MENSAGEM BINRIA
Texto que foi enviado para o RI atravs da porta RS-232. A tag <Texto> contm o texto
recebido e a tag <CodMsg> para este teleevento 6C (hexadecimal).
<!-- Identificacao da Mensagem -->
<CodMsg> 6C </CodMsg>
<! Id da Mensagem, gerado pelo RI entre 0 e 255. -->
<IdMensagem> </IdMensagem>
<!-- Texto da Mensagem Binria em HEXA. -->
<Texto> </Texto>
6.15 TELEVENTOS PERSONALIZADOS
Teleeventos Personalizados so aqueles identificados pela tag <CodMsg> 68
(hexadecimal). Para diferenciar um teleevento personalizado basta analisar o contedo da
tag <IdEvtPersonalizado>, que possuir um valor nico para cada categoria definida
na tag <EvtSistema>. A tabela a abaixo contm a listagem geral.
<!-- Identificacao da Mensagem -->
<CodMsg> 68 </CodMsg>
<!-- Identificador do Teleevento Personalizado -->
<IdEvtPersonalizado> </IdEvtPersonalizado>
<!-- Descrio do Teleevento Personalizado -->
<DescEvtPersonalizado> </DescEvtPersonalizado>

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

62

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

<!-- Se um Teleevento Personalizado de Sistema


0 = Teleevento Personalizado de Usurio
1 = Teleevento Personalizado de Sistema -->
<EvtSistema> </EvtSistema>
<!-- Tipo do Teleevento Personalizado
0 = Teleevento Normal
1 = Alerta
2 = Alarme
3 = Bloqueio
4 = Solicitao Autorizao -->
<TipoEvtPersonalizado> </TipoEvtPersonalizado>
<!-- Complementos do Televento Personalizado -->
<Complemento>
<Complemento1> </Complemento1>
....
<ComplementoN> </ComplementoN>
</Complemento>
ID Descrio
0 Temperatura Automtica
de Mltiplos Sensores

1
2
3
4
5
6
7

Tipo Complemento
0 <!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA1> </TEMPERATURA1>
<!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA2> </TEMPERATURA2>
<!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA3> </TEMPERATURA3>
<!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA4> </TEMPERATURA4>
<!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA5> </TEMPERATURA5>
Excedida Temperatura
1 <!-- Inteiro de 16 bits com sinal -->
Mxima do Sensor 1
<TEMPERATURA1> </TEMPERATURA1>
Excedida Temperatura
1 <!-- Inteiro de 16 bits com sinal -->
Mxima do Sensor 2
<TEMPERATURA2> </TEMPERATURA2>
Excedida Temperatura
1 <!-- Inteiro de 16 bits com sinal -->
Mxima do Sensor 3
<TEMPERATURA3> </TEMPERATURA3>
Excedida Temperatura
1 <!-- Inteiro de 16 bits com sinal -->
Mxima do Sensor 4
<TEMPERATURA4> </TEMPERATURA4>
Excedida Temperatura
1 <!-- Inteiro de 16 bits com sinal -->
Mxima do Sensor 5
<TEMPERATURA5> </TEMPERATURA5>
Temperatura do Sensor 1
1 <!-- Inteiro de 16 bits com sinal -->
Abaixo da Mnima
<TEMPERATURA1> </TEMPERATURA1>
Temperatura do Sensor 2
1 <!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA2> </TEMPERATURA2>
Abaixo da Mnima

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

63

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

8 Temperatura do Sensor 3
Abaixo da Mnima
9 Temperatura do Sensor 4
Abaixo da Mnima
10 Temperatura do Sensor 5
Abaixo da Mnima
11 Retorno Faixa Normal
de Temperatura 1

12 Retorno Faixa Normal


de Temperatura 2

<!-- Inteiro de 16 bits com sinal -->


<TEMPERATURA2> </TEMPERATURA2>

13 Retorno Faixa Normal


de Temperatura 3

<!-- Inteiro de 16 bits com sinal -->


<TEMPERATURA3> </TEMPERATURA3>

14 Retorno Faixa Normal


de Temperatura 4

<!-- Inteiro de 16 bits com sinal -->


<TEMPERATURA4> </TEMPERATURA4>

15 Retorno Faixa Normal


de Temperatura 5

<!-- Inteiro de 16 bits com sinal -->


<TEMPERATURA5> </TEMPERATURA5>

16 Excedida Temperatura
Mxima do Sensor 1
17 Excedida Temperatura
Mxima do Sensor 2
18 Excedida Temperatura
Mxima do Sensor 3
19 Excedida Temperatura
Mxima do Sensor 4
20 Excedida Temperatura
Mxima do Sensor 5
21 Temperatura do Sensor 1
Abaixo da Mnima
22 Temperatura do Sensor 2
Abaixo da Mnima
23 Temperatura do Sensor 3
Abaixo da Mnima
24 Temperatura do Sensor 4
Abaixo da Mnima
25 Temperatura do Sensor 5
Abaixo da Mnima
26 Temperatura do Sensor 1
Abaixo da Mnima
27 Temperatura do Sensor 2
Abaixo da Mnima
28 Temperatura do Sensor 3
Abaixo da Mnima

<!-- Inteiro de 16 bits com sinal -->


<TEMPERATURA1> </TEMPERATURA1>
<!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA2> </TEMPERATURA2>
<!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA3> </TEMPERATURA3>
<!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA4> </TEMPERATURA4>
<!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA5> </TEMPERATURA5>
<!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA1> </TEMPERATURA1>
<!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA2> </TEMPERATURA2>
<!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA3> </TEMPERATURA3>
<!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA4> </TEMPERATURA4>
<!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA5> </TEMPERATURA5>
<!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA1> </TEMPERATURA1>
<!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA2> </TEMPERATURA2>
<!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA3> </TEMPERATURA3>

1
1
0

0
0
0
0
0
0
0
0
0
2
2
2

<!-- Inteiro de 16 bits com sinal -->


<TEMPERATURA3> </TEMPERATURA3>
<!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA4> </TEMPERATURA4>
<!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA5> </TEMPERATURA5>
<!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA1> </TEMPERATURA1>

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

64

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

29 Temperatura do Sensor 4
Abaixo da Mnima
30 Temperatura do Sensor 5
Abaixo da Mnima
31 Excedida Temperatura
Mxima do Sensor 1
32 Excedida Temperatura
Mxima do Sensor 2
33 Excedida Temperatura
Mxima do Sensor 3
34 Excedida Temperatura
Mxima do Sensor 4
35 Excedida Temperatura
Mxima do Sensor 5
36 Nenhum sensor de
temperatura foi lido. Este
pode ser um problema de
instalao ou a
configurao no se
aplica a este RI
37 Temperaturas

38 Erro de Leitura no Sensor


de Temperatura 1

39 Erro de Leitura no Sensor


de Temperatura 2

40 Erro de Leitura no Sensor


de Temperatura 3

41 Erro de Leitura no Sensor


de Temperatura 4

42 Erro de Leitura no Sensor


de Temperatura 5

43 Sensor de Temperatura 1
Fora da Faixa -55.0 C
125.0 C

2
2
2
2
2
2

<!-- Inteiro de 16 bits com sinal -->


<TEMPERATURA4> </TEMPERATURA4>
<!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA5> </TEMPERATURA5>
<!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA1> </TEMPERATURA1>
<!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA2> </TEMPERATURA2>
<!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA3> </TEMPERATURA3>
<!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA4> </TEMPERATURA4>
<!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA5> </TEMPERATURA5>

<!-- Inteiro de 16 bits com sinal -->


<TEMPERATURA1> </TEMPERATURA1>
<!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA2> </TEMPERATURA2>
<!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA3> </TEMPERATURA3>
<!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA4> </TEMPERATURA4>
<!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA5> </TEMPERATURA5>

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

65

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

44 Sensor de Temperatura 2
Fora da Faixa -55.0 C
125.0 C
45 Sensor de Temperatura 3
Fora da Faixa -55.0 C
125.0 C
46 Sensor de Temperatura 4
Fora da Faixa -55.0 C
125.0 C
47 Sensor de Temperatura 5
Fora da Faixa -55.0 C
125.0 C
48 Temperatura avulsta de
mltiplos sensores

<!-- Inteiro de 16 bits com sinal -->


<TEMPERATURA1> </TEMPERATURA1>
<!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA2> </TEMPERATURA2>
<!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA3> </TEMPERATURA3>
<!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA4> </TEMPERATURA4>
<!-- Inteiro de 16 bits com sinal -->
<TEMPERATURA5> </TEMPERATURA5>

Observao: Para o caso dos Eventos Personalizados de Temperatura as tags


<Complenento>
so
substitudas
pelas
tokens
<TEMPERATURA1>
at
<TEMPERATURA5>, sendo que cada uma dessas tags traz um valor inteiro de um sensor de
temperatura, o valor da temperatura apresentado como em potncia de 10, ou seja, para
se ter o valor real basta dividi-lo por 10. Caso ocorra algum erro na leitura dos sensores de
temperatura sero reportados os seguintes valores para as tags <TEMPERATURA>:

32767 = No Lido
32766 = Erro de Leitura
32765 = Fora de Faixa

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

66

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

6.16 LISTA DE RASTREADORES


Assim que a Interface recebe um telecomando Solicitao da Lista de Rastreadores,
ela ir enviar para o Cliente uma seqncia de teleeventos Item Lista de Rastreadores para
cada rastreador cadastrado na Central SaverTurbo. Esta lista conter apenas os
rastreadores cujo modelo pode estar entre 1450, 1454, 1460, 1464, 1480, 1484, 1550, 1560,
1630, 1640, 3450, 0454, 4454, 4464, 4484. A lista tambm ser gerada alfabeticamente
seguindo a ordem Transportadora, Frota e Veculo.
Note que a identificao deste teleevento 20, seguindo o mesmo raciocnio do
telecomando Solicitao da Lista de Rastreadores, identificado como 1. Convencionamos
assim, que eventos trocados apenas entre a Interface e o Cliente sero identificados por
valores negativos (decimal) da tag <CodMsg>.
<?xml version = "1.0"?>
<TeleEvento>
<!-- Data e hora da emissao -->
<DataHoraEm> </DataHoraEm>
<!-- Identificacao da mensagem -->
<CodMsg> -20 </CodMsg>
<!-- Transportadora em que o rastreador esta cadastrado -->
<Transportadora> </Transportadora>
<!-- Frota em que o rastreador esta cadastrado -->
<Frota> </Frota>
<!-- Data da ltima alterao no cadastrado do Rastreador -->
<DataAlteracao> </DataAlteracao>
<!-- Numero de Serie do rastreador -->
<IdTerminal> </IdTerminal>
<!-- Nome do Veiculo -->
<Veiculo> </Veiculo>
<!-- Marca -->
<Marca> </Marca>
<!-- Modelo -->
<Modelo> </Modelo>
<!-- Tipo -->
<Tipo> </Tipo>
<!-- Cor -->
<Cor> </Cor>
<!-- Ano -->
<Ano> </Ano>

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

67

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

<!-- Placa -->


<Placa> </Placa>
<!-- Chassi -->
<Chassi> </Chassi>
<!-- Cidade -->
<Cidade> </Cidade>
<!-- UF -->
<UF> </UF>
<!-- Tipo de Comunicacao:
0 = Celular Digital (Vivo)
3 = Celular GSM (Tim e Claro) -->
<TipoComunicacao> </TipoComunicacao>
<!-- Nmero do telefone do rastreador -->
<Telefone> </Telefone>
<!-- Se possui terminal no rastreador:
0 = Nao
1 = Sim -->
<Terminal> </Terminal>
<!-- Se possui sensor de bau instalado:
0 = Nao
1 = Sim -->
<TipoTerminal> </TipoTerminal>
<!-- Se possui sensor de bau instalado:
1 = Alfa(at 40 caracteres)
2 = Compacto(at 20 caracteres) -->
<SensorBau> </SensorBau>
<!-- Se possui sensor de carreta instalado:
0 = Nao
1 = Sim -->
<SensorCarreta> </SensorCarreta>
<!-- Se possui sensor de portas instalado:
0 = Nao
1 = Sim -->
<SensorPortas> </SensorPortas>
<!-- Se possui bloqueador de combustivel instalado:
0 = Nao
1 = Sim -->
<BloqCombustivel> </BloqCombustivel>
<!-- Tipo do bloqueador:

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

68

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

0 = Eletrnico
1 = Solenide -->
<TipoBloqueador> </TipoBloqueador>
<!-- Se possui atuador de sirene instalado:
0 = No
1 = Sim -->
<Sirene> </Sirene>
<!-- Se possui atuador de pisca alerta instalado:
0 = No
1 = Sim -->
<Pisca> </Pisca>
<!-- Se possui boto de pnico instalado:
0 = No
1 = Sim -->
<BotaoPanico> </BotaoPanico>
<!-- Se possui hodmetro:
0 = No
1 = Sim -->
<Hodometro> </Hodometro>
<!-- Tipo do Hodmetro:
0 = Eletrnico
1 = Mecnico -->
<TipoHodometro> </TipoHodometro>
<!-- Se possui Nobreak:
0 = No
1 = Sim -->
<Nobreak> </Nobreak>
<!-- Verso de software do rastreador -->
<Versao> </Versao>
<!-- Modelo do Rastreador: 1450, 1454, 1460, 1464, 1480, 1484,
1550, 1560, 1630, 1640, 3450, 4454, 4464, 4484-->
<ModeloRastreador> </ModeloRastreador>
<!-- Se possui chave armadilha:
0 = No
1 = Sim -->
<ChaveArmadilha> </ChaveArmadilha>
<!-- Se possui chave desbloqueio:
0 = No
1 = Sim -->
<ChaveDesbloqueio> </ChaveDesbloqueio>

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

69

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

<!-- Se engate da carreta esta identificado:


0 = No
1 = Sim -->
<CarretaId> </CarretaId>
<!-- Se possui trava do ba:
0 = No
1 = Sim -->
<TravaBau> </TravaBau>
<!-- Tipo da Trava:
0 = Solenide
1 = Motorizada -->
<TipoTrava> </TipoTrava>
<!-- Se possui alerta audivel no rastreador (MMA):
0 = No
1 = Sim -->
<AlertaAudivel_MMA> </AlertaAudivel_MMA>
<!-- Se possui sensor de temperatura:
0 = No
1 = Sim -->
<SensorTemperatura> </SensorTemperatura>
<!-- Operadora de telefnica celular:
15 = Vivo
41 = Tim
31 = Oi
36 = Claro -->
<OperadoraCEL> </OperadoraCEL>
<!-- Login Satlite -->
<Login_Sat> </Login_Sat>
<!-- Senha Satlite -->
<Password_Sat> </Password_Sat>
<!-- Endereo Destino Satlite -->
<Endereco_Destino_Sat> </Endereco_Destino_Sat>
<!-- Identificao do Terminal -->
<Identificacao_Terminal_Sat> </Identificacao_Terminal_Sat>
<!-- Indica se a central est configurada como Principal ou
Auxiliar no Rastreador:
1:Principal
0:Auxiliar -->
<Central_Principal_Auxiliar_Sat>
</Central_Principal_Auxiliar_Sat>

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

70

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

<!-- Indica se o RI est equipado com boto de bau:


0:NO possui boto de bau
1:Possui boto de ba -->
<BotBau> </BotBau>
<!-- Indica se o RI operar ou no com Funes Programveis:
0:NO Opera Funes Programveis
1:Opera Funes Programveis-->
<UsaFP> </UsaFP>
<! Campos Sensor1 a Sensor4: Se estiverem preenchidos,
representam o respectivos sensores instalados junto ao RI -->
<Sensor1> </Sensor1>
<Sensor2> </Sensor2>
<Sensor3> </Sensor3>
<Sensor4> </Sensor4>
<! Indica se o RI possui Bloqueador Inteligente instalado:
0:NO possui Bloqueador Inteligente instalado
1:Possui Bloqueador Inteligente instalado -->
< BloqInt> </BloqInt>
<! Indica se o RI possui Detector de Jammer celular:
0:NO possui Detector de Jammer celular
1:Possui Detector de Jammer celular -->
< DetectJamm > </DetectJamm >
<! Indica se o RI possui funcionalidade de telemetria:
0:NO possui telemetria
1:Possui telemetria-->
< Telemetria> </Telemtria>
<! Indica Tipo de Bloqueio Inteligente:
0: insdisponvel ou invlido
1: Single Range
2: Full Range-->
< TipoBloqInt> </TipoBloqInt >
<! Indica Tipo Deteco de Jammer:
0:NO identificado
1:BGS3
2: MC39 -->
< TipoDetectJamm> </TipoDetectJamm>
<! Indica Verso Complemento -->
< VersaoCompl> </VersaoCompl>
<! Indica Verso Hardware -->

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

71

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

< VersoHW> </VersoHW>


</TeleEvento>
6.17 TELEEVENTO DE XML INVLIDO
Este teleevento a resposta para um telecomando considerado invlido pelo
IASTURBO. Basicamente as situes que o IASTURBO considera o XML de um teleevento
invlido so:
Caso o XML Recebido tiver erros de sintaxe ou campos com valores invlidos;
Caso o telecomando no esteja na lista de telecomandos permitidos no arquivo de
configurao do IAS (IASTURBO.INI);e
Terminal desconhecido ou modelo incompativel para esse telecomando.
Os telecomandos de configurao (CodMsg>0), como visto anteriormente, possuem
uma tag chamada <IdSeqMsg>, um nmero sequencial que varia de 0 a 99999 e gerado
pelo cliente. Assim, somente para os televentos de configurao o IASTURBO O teleevento
de XML invlido carrega uma tag chamada <IdStatus> contendo o mesmo valor que a tag
<IdSeqMsg> possuia quando o telecomando foi gerado. Na tag <MsgErro> informado o
erro ocorrido no processamento do XML recebido. Note que este teleevento identificado
com a tag <CodMsg> igual a 40, veja o formato deste teleevento:
<!-- Nmero do ltimo televento processado no IAS
Armazenado localmento armazenado no Cliente -->
<UltimoTeleEventoProcessado> </UltimoTeleEventoProcessado>
<!-- Data e hora da emissao -->
<DataHoraEm> </DataHoraEm>
<!-- Identificacao da mensagem -->
<CodMsg> 40. </CodMsg>
<!-- Identifica a tag <IdSeqMsg> gerada pelo cliente quando
enviou o telecomando de configurao (CodMsg>0) para o
IASTURBO -->
<IdStatus> </IdStatus>
<!-- Numero de serie do rastreador como cadastrado na central
(em hexadecimal) -->
<IdTerminal> </IdTerminal>
<!- Valor Indicativo da falha ocorrida-->
<StsEnvio> </StsEnvio >
<!-- informado o erro ocorrido no processamento do XML recebido
-->
<MsgErro> </MsgErro>
Possveis valores para o campo StsEnvio:

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

72

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

StsEnvio
301
302
303
304
305
306
307
308
309
310
311

Descrio
RI sem comunicacao GPRS e o telecomando e no permitido envio via Satlite
Veculo no cadastrado na central
IAS detectou que falta o endereo IP no comando
IAS detectou que falta a Porta de comunicao no comando
IAS detectou que falta Operao no comando
Base fora do ar, no possvel transmitir do telecomando
Telecomando no configurado no ini do IAS
RI esta em modo economia (ModoSleep)
IdTerminal no possui mensagem formatada associada com o valor do hash
informado.
Mensagem formatada com token em branco ou com valor invlido.
A Central no possui rastreadores com informaes alteradas no intervalo de
datas informado.

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

73

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

6.18 INFORMAES SOBRE AS OPERAES


Assim que o IAS recebe um telecomando de Solicitao de Informaes sobre as
Operaes, ele envia para o Cliente um teleevento no formato XML com as informaes das
Operaes cadastradas no banco de dados da Central SAVERTurbo. Note que este
teleevento identificado com a tag <CodMsg> igual a 41.
<!-- Data e hora da emissao -->
<DataHoraEm> </DataHoraEm>
<!-- Identificacao da mensagem -->
<CodMsg> -41 </CodMsg>
<!-- Marcao do incio da Operao -->
<Operacao>
<!-- Identificador da Operao -->
<IdOperacao> </IdOperacao>
<!-- Nome da Operao -->
<NomeOperacao> </NomeOperacao>
<!-- Marcao do incio dos Itens (Perfil de Configurao ou
Grupo de Alvos, Cercas, Rotas ou Mensagens Formatadas). Esta
tag se repetir de acordo com a quantidade de itens associados
Operao -->
<Item>
<!-- Identificador do Item -->
<IdItem> </IdItem>
<!-- Nome do Item -->
<NomeItem> </NomeItem>
<!-- Tipo do item de Configurao: Perfil de Configurao
ou Grupo de Mensagens Formatadas, Alvos, Cercas ou Rotas
0 = Opes de Segurana;
1 = Comportamento do veculo nas Excees;
2 = Configurao do Histrico;
3 = Atuadores;
4 = Opes Gerais e Modo Interativo;
5 = Senhas;
6 = Telefones Centrais;
7 = Configurar Comunicao com as Centrais;
8 = Transmisso de teleeventos (Central Principal);
9 = Transmisso de teleeventos (Central Auxiliar);
10 = Opes de Segurana Eletrnica (Central
Principal);

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

74

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

11 = Opes de Segurana Eletrnica (Central Auxiliar);


12 = Temperatura (Central Principal);
13 = Temperatura (Central Auxiliar);
14 = Opes do Rastreador Solar;
15 = Configurar Extenso Logstica de Parada;
16 = Configurar RI 0454 Mini Max;
20 = Mensagens Predefinidas;
21 = Mensagens Formatadas;
22 = Alvos Eletrnicos;
23 = Cercas Eletrnicas;
24 = Rotas Eletrnicas; -->
<IdTipoItem> </TipoItem>
<!-- Nome do Tipo do Item de Configurao-->
<NomeTipoItem> </NomeTipoItem>
</Item>
</Operacao>
Observao: A tag <Operacao> pode se repetir vrias vezes dentro de teleevento
dependendo do nmero de Operaes armazenadas no banco de dados da Central
SAVERTurbo. Conseqentemente, a tag <Item> pode ser encadeada vrias vezes dentro
da tag <Operacao> dependendo da quantidade de itens associados Operao.
6.19 CONFIRMAO DA ASSOCIAO DA OPERAO
Este teleevento est diretamente relacionado ao Telecomando de Associao de
Operao. Sempre que for enviado esse Telecomando para a interface, o IAS devolver um
Televento de confirmao se os itens da Operao foram associados aos veculos . O valor
da tag <CodMsg> para este teleevento -42.
<!-- Data e hora da emissao -->
<DataHoraEm> </DataHoraEm>
<!-- Identificacao da Mensagem -->
<CodMsg> -42 </CodMsg>
<!-- Identificador da Operao -->
<IdOperacao> </IdOperacao >
<!-- Numero de srie do rastreador (em hexadecimal) -->
<IdTerminal> </ IdTerminal >
<!-- Status da associao da Operao:
0 = Associacao OK,
1 = IdOperacao desconhecido,
2 = Terminal desconhecido, -->
<StsAssociacao> </StsAssociacao>

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

75

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

Observao: A tag <StsAssociacao> indica o status para associao da Operao


o veculos no telecomando de Associao de Operao.
6.20 INFORMAES SOBRE OS PERFIS DE CONFIGURAO
Assim que a Interface recebe um telecomando de Solicitao de Informaes sobre
os Perfis de Configurao, ela enviar para o Cliente um teleevento no formato XML com as
informaes dos Perfis de Configurao cadastrados no banco de dados da Central
SAVERTurbo. Note que este teleevento identificado com a tag <CodMsg> igual a 43.
<!-- Data e hora da emissao -->
<DataHoraEm> </DataHoraEm>
<!-- Identificacao da mensagem -->
<CodMsg> -43 </CodMsg>
<!-- Marcao do incio dos Perfis de Configurao -->
<PerfilConfiguracao>
<!-- Idenficador do Perfil de Configuracao -->
<IdPerfilConfiguracao> </IdPerfilConfiguracao>
<!-- Nome do Perfil de Configurao -->
<NomePerfilConfigura> </ NomePerfilConfigura >
<!-0 =
1 =
2 =
3 =
4 =
5 =
6 =
7 =
8 =
9 =
10 =
11 =
12 =
13 =
14 =
15 =
16 =
20 =
21 =
22 =
23 =

Configurao que o perfil define


Opes de Segurana;
Comportamento do veculo nas Excees;
Configurao do Histrico;
Atuadores;
Opes Gerais e Modo Interativo;
Senhas;
Telefones Centrais;
Configurar Comunicao com as Centrais;
Transmisso de teleeventos (Central Principal);
Transmisso de teleeventos (Central Auxiliar);
Opes de Segurana Eletrnica (Central Principal);
Opes de Segurana Eletrnica (Central Auxiliar);
Temperatura (Central Principal);
Temperatura (Central Auxiliar);
Opes do Rastreador Solar;
Configurar Extenso Logstica de Parada;
Configurar RI 0454 Mini Max;
Mensagens Predefinidas;
Mensagens Formatadas;
Alvos Eletrnicos;
Cercas Eletrnicas;

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

76

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

24 = Rotas Eletrnicas; -->


</TipoConfiguracao> </TipoConfiguracao>
</PerfilDefinicao>
Observao: A tag <PerfilConfiguracao> pode se repetir dentro de teleevento
dependendo do nmero de Perfis de Configurao armazenados no banco de dados da
Central SAVERTurbo.
6.21 CONFIRMAO DA ASSOCIAO DE PERFIL DE CONFIGURAO
Este teleevento est diretamente relacionado ao Telecomando de Associao de
Perfil de Configurao. Sempre que for enviado esse Telecomando para a interface, o IAS
devolver um Televento de confirmao se o Perfil de Configurao foi associado
corretamente aos veculos. O valor da tag <CodMsg> para este teleevento -44.
<!-- Data e hora da emissao -->
<DataHoraEm> </DataHoraEm>
<!-- Identificacao da Mensagem -->
<CodMsg> -44 </CodMsg>
<!-- Identificador do Perfil de Configurao -->
< IdPerfilConfiguracao > </ IdPerfilConfiguracao>
<!-0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
20
21
22
23

Configurao que o perfil define


= Opes de Segurana;
= Comportamento do veculo nas Excees;
= Configurao do Histrico;
= Atuadores;
= Opes Gerais e Modo Interativo;
= Senhas;
= Telefones Centrais;
= Configurar Comunicao com as Centrais;
= Transmisso de teleeventos (Central Principal);
= Transmisso de teleeventos (Central Auxiliar);
= Opes de Segurana Eletrnica (Central Principal);
= Opes de Segurana Eletrnica (Central Auxiliar);
= Temperatura (Central Principal);
= Temperatura (Central Auxiliar);
= Opes do Rastreador Solar;
= Configurar Extenso Logstica de Parada;
= Configurar RI 0454 Mini Max
= Mensagens Predefinidas;
= Mensagens Formatadas;
= Alvos Eletrnicos;
= Cercas Eletrnicas;

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

77

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

24 = Rotas Eletrnicas; -->


<TipoConfiguracao> </TipoConfiguracao>
<!-- Numero de serie do rastreador (em hexadecimal) -->
<IdTerminal> </IdTerminal>
<!-- Status da associao do Perfil de Configurao:
0 = Envio OK,
1 = Terminal desconhecido,
2 = Perfil de Configurao desconhecido
3 = Tipo de Configurao desconhecido -->
<StsAssociacao> </StsAssociacao>

Observao: A tag <StsAssociacao> indica o status para associao do Perfil de


Configurao para cada o veculo indicado no telecomando que gerou o teleevento.
6.22 INFORMAES SOBRE OS PERFIS DE DEFINIO
Assim que a Interface recebe um telecomando de Solicitao de Informaes sobre
os Perfis de Definio, ela enviar para o Cliente um teleevento no formato XML com as
informaes dos Perfis de Definio cadastrados na Central SAVERTurbo. Note que este
teleevento identificado com a tag <CodMsg> igual a 45.
<!-- Data e hora da emissao -->
<DataHoraEm> </DataHoraEm>
<!-- Identificacao da mensagem -->
<CodMsg> -45 </CodMsg>
<!-- Marcao do incio dos Perfis de Definio -->
<PerfilDefinicao>
<!-- Idenficador do Perfil de Definio -->
<IdPerfilDefinicao> </IdPerfilDefinicao>
<!-- Nome do Perfil de Definio -->
<NomePerfilDefinicao> </NomePerfilDefinicao>
<!-- Item do segurana eletrnica que o Perfil de
est associado
0 = Alvos
1 = Cercas -->
<Item> </Item>
</PerfilDefinicao>

Definio

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

78

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

Observao: A tag <PerfilDefinicao> pode se repetir dentro de teleevento


dependendo do nmero de Perfis de Definio armazenados no banco de dados da Central
SAVERTurbo.
6.23 INFORMAES SOBRE ALVOS
Assim que a Interface recebe um telecomando de Solicitao de Informaes sobre
Alvos, ela enviar para o Cliente um teleevento no formato XML com as informaes dos
Alvos organizados em Grupos da forma em que foram cadastrados na Central
SAVERTurbo. Note que este teleevento identificado com a tag <CodMsg> igual a 46.
<!-- Data e hora da emissao -->
<DataHoraEm> </DataHoraEm>
<!-- Identificacao da mensagem -->
<CodMsg> -46 </CodMsg>

<!-- Marcao do incio do grupo de alvos -->


<GrupoAlvo>
<!-- Nome do grupo de alvos cadastrado -->
<NomeGrupo></NomeGrupo>
<!-- Marcao do incio do alvo -->
<Alvo>
<!-- Identificador do alvo -->
<IdAlvo> </IdAlvo>
<!-- Nome do alvo -->
<NomeAlvo> </NomeAlvo>
<!-- Latitude em graus -->
<Latitude> </Latitude>
<!-- Longitude em graus -->
<Longitude> </Longitude>
</Alvo>
</GrupoAlvo>
<!Informa a quantidade de alvos listados no XML -->
<NumAlvosXML><NumAlvosXML>
Observao: A tag <GrupoAlvo> pode se repetir dentro do teleevento dependendo
do nmero de Grupos de Alvos cadastrados no banco de dados da Central SAVERTurbo.
Conseqentemente, a tag <Alvo> pode ser encadeada vrias vezes dentro da tag

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

79

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

<GrupoAlvo> dependendo da quantidade de alvos armazenados. A tag <NumAlvosXML>


informa a quantidade de alvos listados no XML, limitada em 1000 alvos por XML, caso a
quantidade de alvos na Central SAVERTurbo ultrapasse o limite ser gerado outros XMLs
at que toda lista seja enviada
6.24 INFORMAES SOBRE CERCAS
Assim que a Interface recebe um telecomando de Solicitao de Informaes sobre
Cercas, ela enviar para o Cliente um teleevento no formato XML com as informaes das
Cercas organizadas em Grupos da forma em que foram cadastrados na Central
SAVERTurbo. Note que este teleevento identificado com a tag <CodMsg> igual a 47.
<!-- Data e hora da emissao -->
<DataHoraEm> </DataHoraEm>
<!-- Identificacao da mensagem -->
<CodMsg> -47 </CodMsg>
<!-- Marcao do incio do grupo de cercas -->
<GrupoCerca>
<!-- Nome do grupo de cercas cadastrado -->
<NomeGrupo></NomeGrupo>
<!-- Marcao do incio do cerca -->
<Cerca>
<!-- Identificador da cerca -->
<IdCerca> </IdCerca>
<!-- Nome da cerca -->
<NomeCerca> </NomeCerca>
<!-- Latitude em graus -->
<Latitude> </Latitude>
<!-- Longitude em graus -->
<Longitude> </Longitude>
</Cerca>
</GrupoCerca>
<!Informa a quantidade de cercas listadas no XML -->
<NumAlvosXML><NumAlvosXML>
Observao: A tag <GrupoCerca> pode se repetir dentro do teleevento dependendo
do nmero de Grupos de Cercas cadastrados no banco de dados da Central SAVERTurbo.
Conseqentemente, a tag <Cerca> pode ser encadeada vrias vezes dentro da tag
<GrupoCerca> dependendo da quantidade de cercas armazenadas. A tag

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

80

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

<NumCercasXML> informa a quantidade de cercas listadas no XML, limitada em 1000


cercas por XML, caso a quantidade de cercas na Central SAVERTurbo ultrapasse o limite
ser gerado outros XMLs at que toda lista seja enviada
6.25 CONFIRMAO DE IMPORTAO E ASSOCIAO DE ALVOS
Este teleevento est diretamente relacionado ao Telecomando de Importao e
Associao de Grupos de Alvos, sendo gerado um teleevento para cada um dos grupos de
alvos importados. O valor da tag <CodMsg> para este teleevento -48.
<!-- Identificacao da Mensagem -->
<CodMsg> -48 </CodMsg>

<!-- Marcao do incio do grupo de alvos -->


<GrupoAlvo>
<!Data e Hora de processamento -->
<DataHoraEm></DataHoraEm>
<!-- Nome do grupo de alvos confirmados na importao de
alvos -->
<NomeGrupo></NomeGrupo>
<!-- Marcao do incio da Alvo -->
<Alvo>
<!-- Nome do alvo -->
<NomeAlvo> </NomeAlvo>
<!-- Latitude -->
<Latitude> </Latitude>
<!-- Longitude -->
<Longitude> </Longitude>
<!-- Status de Importacao:
0 = Sucesso na importao,
1 = No importado -->
<StsImportacao> </StsImportacao>
</Alvo>
<Veiculo>
<!-- Numero de srie do rastreador
(em hexadecimal) -->
<IdTerminal> </IdTerminal>
<!-- Status de Associao:
0 = Sucesso na Associacao,

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

81

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

1 = Falha na Associacao -->


<StsAssociacao> </StsAssociacao>
</Veiculo>
</GrupoAlvo>
Observao1:. Dentro da tag <GrupoAlvo> a tag <Alvo> pode ser repetida vrias
vezes, dependendo da quantidade de alvos relacionados na importao. Para cada alvo
importado, caso tenha-se solicitado a associao, apresentado uma lista dos veculos em
que a associao teve sucesso ou no.
Observao2: Na associao dos Alvos aos veculos permito um conjunto de no
mximo 250 alvos, caso o nmero de Alvos exceda a quantidade mxima o telecomando
no ir associar nenhum Alvo e a tag <StsAssociacao> vir com o valor 1 para os
veculos.
6.26 CONFIRMAO DE IMPORTAO E ASSOCIAO DOS GRUPOS DE CERCAS
Este teleevento est diretamente relacionado ao Telecomando de Importao e
Associao de Grupos de Cercas, sendo gerado um teleevento para cada um dos grupos
de cercas importados. O valor da tag <CodMsg> para este teleevento -49.
<!-- Identificacao da Mensagem -->
<CodMsg> -49 </CodMsg>
<!-- Marcao do incio do grupo de cercas -->
<GrupoCerca>
<!-- Nome do grupo de cercas que ser importado, caso no
seja informado o nome do grupo o IAS definir um nome com a
data e a hora da importao -->
<NomeGrupo></NomeGrupo>
<!-- Marcao do incio da cerca -->
<Cerca>
<!-- Nome da cerca -->
<NomeCerca> </NomeCerca>
<!-- Latitude em graus
- Notao texto. Ex: 2315'28.0" S
- Dcimo de Segundos. Ex: -837280
- Nmero Real. Ex: -23.257800
Campo de preenchimento obrigatrio -->
<Latitude> </Latitude>
<!-- Longitude em graus
- Notao texto. Ex. 4648'03.0" W
- Dcimo de Segundos. Ex: -1684830
- Nmero Real. Ex: -46.800850

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

82

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

Campo de preenchimento obrigatrio -->


<Longitude> </Longitude>
<!-- Status de Importacao:
0 = Sucesso na importao,
1 = No importado -->
<StsImportacao> </StsImportacao>
<Veiculo>
<!-- Numero de srie do rastreador
(em hexadecimal) -->
<IdTerminal> </IdTerminal>
<!-- Status de Associao:
0 = Sucesso na Associacao,
1 = Falha na Associacao -->
<StsAssociacao> </StsAssociacao>

</Veiculo>
</GrupoCerca>
Observao1:. Dentro da tag <GrupoCerca> a tag <Cerca> pode ser repetida vrias
vezes, dependendo da quantidade de cercas relacionadas na importao. Para cada cerca
importada, caso tenha-se solicitado a associao, apresentado uma lista dos veculos em
que a associao teve sucesso ou no
Observao2: Na associao das Cercas aos veculos permito um conjunto de no
mximo 100 cercas, caso o nmero de Cercas exceda a quantidade mxima o telecomando
no ir associar nenhuma Cerca e a tag <StsAssociacao> vir com o valor 1 para os
veculos.
6.27 CONFIRMAO DE IMPORTAO E ASSOCIAO DE GRUPOS DE ROTAS
Este teleevento est diretamente relacionado ao Telecomando de Importao e
Associao de Grupos de Rotas. Sempre que for enviado esse Telecomando para o IAS ele
devolver um Televento de confirmao de importao e associao das rotas. O valor da
tag <CodMsg> para este teleevento -50.
<!-- Identificao da Mensagem -->
<CodMsg> -50 </CodMsg>
<!-- Marcao do incio do grupo de rotas -->
<GrupoRota>
<!-- Nome do grupo de rota que ser importado, caso no seja
informado o nome do grupo o IAS definir um nome com a data e
a hora da importao -->

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

83

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

<NomeGrupo></NomeGrupo>
<!-- Nmero de rotas importadas pelo IAS -->
<NrRotasImportadas> </NrRotasImportadas>
<!-- Marcao do incio da rota -->
<Rota>
<!-- Nome da rota -->
<NomeRota> </NomeRota>
<!-- Status de Importacao:
0 = Sucesso na importao,
1 = Solicitada a no incluso de uma rota nova (veja a
tag <AcaoNovos> no telecomando -11)
2 = Solicitada a no incluso de um rota cadastrada
(veja a tag <AcaoCadastrados> no telecomando -11)
3 = rota excede mais de 5000 pontos -->
<StsImportacao> </StsImportacao>
<Veiculo>
<!-- Numero de srie do rastreador
(em hexadecimal) -->
<IdTerminal> </IdTerminal>
<!-- Status de Associao:
0 = Sucesso na Associao,
1 = Falha na Associao -->
<StsAssociacao> </StsAssociacao>
</Veiculo>
</GrupoRota>
Observao:. Dentro da tag <GrupoRota> a tag <Rota> pode ser repetida vrias
vezes, dependendo da quantidade de rotas relacionadas na importao. Para cada rota
importada, caso tenha-se solicitado a associao, apresentado uma lista dos veculos em
que a associao teve sucesso ou no
Observao2: Na importao de uma Rota caso ocorra alguma falha a associao da
Rota ao veculo no processado. Na tag <StsAssociacao> informado a falha
ocorrida.
Observao2: Na associao das Rotas aos veculos permitido uma Rota com
conjunto de no mximo 5000 pontos, caso o nmero de pontos exceda a quantidade
mxima o telecomando no ir associar a Rota e a tag <StsAssociacao> vir com o
valor 1 para os veculos.
6.28 INFORMAES SOBRE MENSAGENS FORMATADAS

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

84

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

Assim que a Interface recebe um telecomando de Solicitao de Informaes sobre


Mensagens Formatadas, ela enviar para o Cliente um teleevento no formato XML com as
informaes dos campos das Mensagens Formatadas cadastradas na Central
SAVERTurbo. Note que este teleevento identificado com a tag <CodMsg> igual a 51.
<!-- Data e hora da emissao -->
<DataHoraEm> </DataHoraEm>
<!-- Identificao da mensagem -->
<CodMsg> -51 </CodMsg>
<!-- Marcao do incio das mensagens -->
<MensagemFormatada>
<!-- Identificador da mensagem formatada
cadastrada -->
<IdMensagemFormatada> </IdMensagemFormatada>
<!-- Seqencial que identifica a Mensagem Formatada
hexadecimal -->
<NroSeqMacro > </NroSeqMacro>
<!-- Nome da mensagem formatada cadastrada -->
<NomeMensagemFormatada> </NomeMensagemFormatada>

<! Verifica se a macro um teleevento. Ou seja,


habilitado para escrita no veculo:
0: No habilita
1: Habilita -->
<TE> </TE>
<! Verifica se a macro um telecomando. Ou seja,
habilitado para escrita na central:
0: No habilita
1: Habilita -->
<TC> </TC>
<!-- Marcao do incio dos campos
Esta tag se repetir de acordo com a quantidade de campos
que a macro possa ter -->
<Campo>
<!-- Idnetificador do Campo. -->
<IdCampo> </IdCampo>
<!-- Descrio do Campo. -->
<NomeCampo> </NomeCampo>

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

85

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

<!-- Tamanho da rea de edio do Campo em hexadecimal ->


<TamCampo> </TamCampo>
<!-- Indica se o campo deve ser obrigatoriamente
preenchido ou no:
0: no obrigatrio
1: obrigatrio -->
<ObrigCampo> </ObrigCampo>
<!-- Tipo de Campo a ser editado
0: Alfanumrico(Letras e Nmeros)
1: Numrico(Dgitos de 0 a 9)
2: Alfabtico(Somente Letras)
3: nn.nn.nnn/nnn-nn(CNPJ)
4: nnn.nnn.nnn-nn(CPF)
5: dd/mm(Data dia/ms)
6: dd/mm/aa (Data ano 2 dgitos)
7: dd/mm/aaaa (Data ano 4 dgitos)
8: hh:mm (Hora)
9: Moeda (Casa decimal fixa em 2 dgitos)
10: Texto simples(Texto para uso geral)
11: Fracionrio (Permite uso de casa decimal e sinal -->
<TipoCampo> </TipoCampo>
</Campo>
</MensagemFormatada>

Observao: A tag <MensagemFormatada> pode se repetir dentro do teleevento


dependendo do nmero de Mensagens Formatadas cadastradas no banco de dados da
Central SAVERTurbo. Conseqentemente, a tag <Campo> pode ser encadeada vrias
vezes dentro da tag <MensagemFormatada> dependendo da quantidade de campos
cadastrados para a Mensagem Formatada.
6.29 CONFIRMAO DA SOLICITAO DA TRANSMISSO DA OPERAO
Este teleevento est diretamente relacionado ao Telecomando de Solicitao da
Transmisso da Operao. Sempre que for enviado esse Telecomando para o IAS ser
devolvido um Televento de confirmao da solicitao da transmisso dos itens da
Operao. O valor da tag <CodMsg> para este teleevento -52.
<!-- Data e hora da emissao -->
<DataHoraEm> </DataHoraEm>
<!-- Identificacao da Mensagem -->
<CodMsg> -52 </CodMsg>
<!-- Numero de srie do rastreador

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

86

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

(em hexadecimal) -->


<IdTerminal> </IdTerminal>
<!-- Status do transmisso da Operao:
0 = Solicitao da Transmisso OK,
1 = Terminal desconhecido,
2 = No existe Operao associado a esse veculo
3 = No possvel transmitir a Operao (Base fora do ar)
4 = No possvel transmitir a Operao (Veculo em
satlite) -->
<StsTransmissao> </StsTransmissao>
Observao: A tag <StsTransmissao> indica o status para transmisso de toda
operao para Telecomando que gerou esse teleevento.
6.30 CONFIRMAO DA SOLICITAO DA TRANSMISSO DO PERFIL DE CONFIGURAO
Este teleevento est diretamente relacionado ao Telecomando de Solicitao da
Transmisso do Perfil de Configurao. Sempre que for enviado esse Telecomando para o
IAS ser devolvido um Televento de confirmao se a solicitao da transmisso do Perfil
de Configurao. O Status se transmisso foi enviada com sucesso para o rastreador do
veculo ser realizada pelo teleevento Status de Envio de Telecomando (CodMsg = 81) com
tag <IdStatus> contendo o mesmo valor que a tag <IdSeqMsg> possuia quando o
telecomando foi gerado. O valor da tag <CodMsg> para este teleevento -53.
<!-- Data e hora da emissao -->
<DataHoraEm> </DataHoraEm>
<!-- Identificacao da Mensagem -->
<CodMsg> -53 </CodMsg>
<!-0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

Configurao que o perfil define


= Opes de Segurana;
= Comportamento do veculo nas Excees;
= Configurao do Histrico;
= Atuadores;
= Opes Gerais e Modo Interativo;
= Senhas;
= Telefones Centrais;
= Configurar Comunicao com as Centrais;
= Transmisso de teleeventos (Central Principal);
= Transmisso de teleeventos (Central Auxiliar);
= Opes de Segurana Eletrnica (Central Principal);
= Opes de Segurana Eletrnica (Central Auxiliar);
= Temperatura (Central Principal);
= Temperatura (Central Auxiliar);
= Opes do Rastreador Solar;
= Configurar Extenso Logstica de Parada;

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

87

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

16 = Configurar RI 0454 Mini Max; -->


<TipoConfiguracao> </TipoConfiguracao>
<!-- Numero de serie do rastreador (em hexadecimal) -->
<IdTerminal> </IdTerminal>
<!-- Status da transmissao do Perfil de Configurao:
0 = Solicitao da Transmisso OK,
1 = Terminal desconhecido,
2 = Tipo de Configurao desconhecida
3 = No existe perfil de configurao associado a esse
veculo
4 = Perfil incompatvel para o modelo do rastreador do
terminal (Caso da Temperatura)
5 = No possvel transmitir a configurao (Base fora do
ar)
6 = No possvel transmitir a configurao (Veculo em
satlite) -->
<StsTransmissao> </StsTransmissao>

Observao:
A tag <StsTransmissao> indica o status da solicitao de
transmisso do Perfil de Configurao previamente associado ao veculo.
6.31 CONFIRMAO DA SOLICITAO DA TRANSMISSO DO CONJUNTO DE ALVOS
Este teleevento est diretamente relacionado ao Telecomando de Solicitao da
Transmisso do Conjunto de Alvos. Sempre que for enviado esse Telecomando para o IAS
ser devolvido um Televento de confirmao solicitao da transmisso do conjunto de
alvos. O Status se transmisso foi enviada com sucesso para o rastreador do veculo ser
realizada pelo teleevento Status de Envio de Telecomando (CodMsg = 81) com tag
<IdStatus> contendo o mesmo valor que a tag <IdSeqMsg> possuia quando o
telecomando foi gerado. O valor da tag <CodMsg> para este teleevento -54.
<!-- Data e hora da emissao -->
<DataHoraEm> </DataHoraEm>
<!-- Identificacao da Mensagem -->
<CodMsg> -54 </CodMsg>
<!-- Numero de srie do rastreador
(em hexadecimal) -->
<IdTerminal> </IdTerminal>
<!-- Status do envio do Conjunto de Alvos:
0 = Solicitao da Transmisso OK
1 = Terminal desconhecido
2 = No existem Alvos associados a esse veculo,

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

88

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

3 = No possvel transmitir os Alvos (Base fora do ar)


4 = No possvel transmitir os Alvos (Veculo em satlite).->
<StsTransmissao> </StsTransmissao>
Observao: A tag <StsTransmissao> indica o status para transmisso do
Conjunto de Alvos o veculo relacionado no Telecomando que gerou esse Teleevento.
6.32 CONFIRMAO DA SOLICITAO DA TRANSMISSO DO CONJUNTO DE CERCAS
Este teleevento est diretamente relacionado ao Telecomando de Solicitao da
Transmisso do Conjunto de Cercas. Sempre que for enviado esse Telecomando para o
IAS ser devolvido um Televento de confirmao solicitao transmisso do conjunto de
cerca. O Status se transmisso foi enviada com sucesso para o rastreador do veculo ser
realizada pelo teleevento Status de Envio de Telecomando (CodMsg = 81) com tag
<IdStatus> contendo o mesmo valor que a tag <IdSeqMsg> possuia quando o
telecomando foi gerado. O valor da tag <CodMsg> para este teleevento -55.
<!-- Data e hora da emissao -->
<DataHoraEm> </DataHoraEm>
<!-- Identificacao da Mensagem -->
<CodMsg> -55 </CodMsg>
<!-- Numero de srie do rastreador
(em hexadecimal) -->
<IdTerminal> </IdTerminal>
<!-- Status do envio do Conjunto de Alvos:
0 = Solicitao da Transmisso OK
1 = Terminal desconhecido
2 = No existem Cercas associadas a esse veculo
3 = No possvel transmitir as Cercas (Base fora do ar)
4 = No possvel transmitir oa Cercas (Veculo em satlite).->
<StsTransmissao> </StsTransmissao>
Observao: A tag <StsTransmissao> indica o status para transmisso do
Conjunto de Cercas o veculo relacionado no Telecomando que gerou esse Teleevento.
6.33 CONFIRMAO DA SOLICITAO DA TRANSMISSO DE CONJUNTO DE ROTAS
Este teleevento est diretamente relacionado ao Telecomando de Solicitao da
Transmisso do Conjunto de Rotas. Sempre que for enviado esse Telecomando para o IAS
ser devolvido um Televento de confirmao Soliciao transmisso do conjunto de rotas. O
Status se transmisso foi enviada com sucesso para o rastreador do veculo ser realizada

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

89

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

pelo teleevento Status de Envio de Telecomando (CodMsg = 81) com tag <IdStatus>
contendo o mesmo valor que a tag <IdSeqMsg> possuia quando o telecomando foi gerado.
O valor da tag <CodMsg> para este teleevento -56.
<!-- Data e hora da emissao -->
<DataHoraEm> </DataHoraEm>
<!-- Identificacao da Mensagem -->
<CodMsg> -56 </CodMsg>
<!-- Numero de srie do rastreador
(em hexadecimal) -->
<IdTerminal> </IdTerminal>
<!-- Status do envio do Conjunto de Alvos:
0 = Solicitao da Transmisso OK,
1 = Terminal desconhecido
2 = No existem Rotas associados a esse veculo
3 = No possvel transmitir as Rotas (Base fora do ar)
4 = No possvel transmitir as Rotas (Veculo em satlite).->
<StsTransmissao> </StsTransmissao>
Observao: A tag <StsTransmissao> indica o status para transmisso do
Conjunto de Rotas o veculo relacionado no Telecomando que gerou esse Teleevento..
6.34 STATUS DA TRANSMISSO DA OPERAO
Este teleevento est diretamente relacionado ao Telecomando de Solicitao de
Status da Operao. E informa o status da ltima Operao transmitida para o veculo
relacionado no Telecomando. O valor da tag <CodMsg> para este teleevento -57.
<!-- Data e hora da emissao -->
<DataHoraEm> </DataHoraEm>
<!-- Identificacao da Mensagem -->
<CodMsg> -57 </CodMsg>
<!-- Nmero de srie do rastreador (em hexadecimal) -->
<IdTerminal> </IdTerminal>
<!-- Status da solicitao da transmisso da Operao:
0 = Solicitao da transmisso da Operao OK
1 = Terminal de Operao
2 = No existe Operao transmitida para esse
veculo
<StsOperacao> </StsOperacao>

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

90

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

<!-- Identificador da Operao -->


<IdOperacao> </IdOperacao>
<!-- Nome da Operao -->
<NomeOperacao> </NomeOperacao>

<!-- Marcao do incio dos Itens (Perfil de Configurao ou


Grupo de Alvos, Cercas, Rotas ou Mensagens Formatadas). Esta
tag se repetir de acordo com a quantidade de itens associados
Operao -->
<Item>
<!-- Identificador do Item -->
<IdItem> </IdItem>
<!-- Nome do Item -->
<NomeItem> </NomeItem>
<!-- Tipo do item: Perfil de Configurao ou Grupo de
Mensagens Formatadas, Alvos, Cercas ou Rotas
0 = Opes de Segurana;
1 = Comportamento do veculo nas Excees;
2 = Configurao do Histrico;
3 = Atuadores;
4 = Opes Gerais e Modo Interativo;
5 = Senhas;
6 = Telefones Centrais;
7 = Configurar Comunicao com as Centrais;
8 = Transmisso de teleeventos (Central Principal);
9 = Transmisso de teleeventos (Central Auxiliar);
10 = Opes de Segurana Eletrnica (Central Principal);
11 = Opes de Segurana Eletrnica (Central Auxiliar);
12 = Temperatura (Central Principal);
13 = Temperatura (Central Auxiliar);
14 = Opes do Rastreador Solar;
15 = Configurar Extenso Logstica de Parada;
16 = Configurar RI 0454 Mini Max;
20 = Mensagens Predefinidas;
21 = Mensagens Formatadas;
22 = Alvos Eletrnicos;
23 = Cercas Eletrnicas;
24 = Rotas Eletrnicas. -->
<TipoItem> </TipoItem>
<!-- Descrio do Item de configurao -->
<DescItem> </DescItem>

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

91

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

<!-- Descrio do Status da transmisso do Item de


Configurao-->
<StatusItem> </StatusItem>
</Item>
6.35 CONFIRMAO DE LOGIN NO IAS
Este teleevento est diretamente relacionado ao Telecomando de Login no IAS. E
informa se usurio foi logado com sucesso ou no. O valor da tag <CodMsg> para este
teleevento -58.
<!-- Data e hora da emissao -->
<DataHoraEm> </DataHoraEm>
<!-- Identificacao da Mensagem -->
<CodMsg> -58 </CodMsg>
<!-- Nome do Operador do IAS -->
<NomeOperador> </NomeOperador>
<!-- Status do login:
0 = Sucesso no Login,
1 = Operador no cadastrado,
2 = Senha invlida,
3 = Operador no autorizado utilizar o IAS,
4 = Operador bloqueado -->
<StsLogin> </StsLogin>
6.36 INFORMAES SOBRE MENSAGENS DE EXTENSO LOGSTICA DE PARADA
Assim que a Interface recebe um telecomando de Solicitao de Informaes sobre
Extenso Logstica de Parada, ela enviar para o Cliente um teleevento no formato XML
com as informaes dos campos das Mensagens de Exteses Logsticas de Paradas
cadastradas na Central SAVERTurbo. Note que este teleevento identificado com a tag
<CodMsg> igual a 59.
<!-- Data e hora da emissao -->
<DataHoraEm> </DataHoraEm>
<!-- Identificao da mensagem -->
<CodMsg> -59 </CodMsg>
<!-- Marcao do incio das mensagens -->
<MensagensELP>

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

92

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

<!-- Cada mensagem ter a tag <MensagemELP> -->


<MensagemELP>
<!-Parada:

Tipo

da

Mensagem

de

Extenso

Logstica

de

0 = Chegada em Atendimento (Lista de Clientes),


1 = Chegada em Parada Tcnica (Natureza da
Operao),
2 = Sada de Atendimento (Parada Tcnica ou
Resultado da Operao) -->
<TipoMsg> </TipoMsg>
<!-- A Mensagem de Extenso Logstica de Parada
cadastrada na Central SAVERTurbo -->
<Mensagem> </Mensagem>
</MensagemELP>

</MensagensELP>

Observao: A tag <MensagemELP> pode se repetir dentro do teleevento


dependendo do nmero de Mensagens Formatadas cadastradas no banco de dados da
Central SAVERTurbo.
6.37 INFORMAES SOBRE MENSAGENS DE EXTENSO LOGSTICA DE PARADA DE UM TERMINAL
Assim que a Interface recebe um telecomando de Solicitao de Informaes sobre
Extenso Logstica de Parada de um determinado terminal, ela enviar para o Cliente um
teleevento no formato XML com as informaes dos campos das Mensagens de Exteses
Logsticas de Parada associados a esse terminal. Note que este teleevento identificado
com a tag <CodMsg> igual a 60.
<!-- Data e hora da emissao -->
<DataHoraEm> </DataHoraEm>
<!-- Identificacao da Mensagem -->
<CodMsg> -60 </CodMsg>
<!-- Nmero de srie do rastreador (em hexadecimal) -->
<IdTerminal> </IdTerminal>
<!-- Status da solicitao das mensagens ELP:
0 = Solicitao de mensagens ELP OK
1 = Terminal desconhecido pela Central
2 = No existe mensagens associadas a esse terminal

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

93

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

<StsMensagemELP> </StsMensagemELP>
<!-- Marcao do incio das mensagens -->
<MensagensELP>

<!-- Cada mensagem ter a tag <MensagemELP> -->


<MensagemELP>
<!-Parada:

Tipo

da

Mensagem

de

Extenso

Logstica

de

0 = Chegada em Atendimento (Lista de Clientes),


1 = Chegada em Parada Tcnica (Natureza da
Operao),
2 = Sada de Atendimento (Parada Tcnica ou
Resultado da Operao) -->
<TipoMsg> </TipoMsg>
<!-- Nmero seqencial que determina a seqncia de
apresentao no terminal do veculo e responsvel pela
identificao (juntamente com o TipoMsg) da mensagem
selecionada pelo motorista. Iniciada por 1 ou 2 (para
cada TipoMsg) at o limite de cada tipo de mensagem -->
<Sequencia> </Sequencia>

<!-- A Mensagem de Extenso Logstica de Parada


cadastrada na Central SAVERTurbo -->
<Mensagem> </Mensagem>
</MensagemELP>
</MensagensELP>
Observao1: O limite de mensagens ser:
- Chegada em Atendimento: 100 Mensagens de 18 caracteres cada
(sequencia de 1 at 100)
- Chegada em Parada Tcnica: 15 Mensagens de 18 caracteres cada
(sequencia de 2 at 16)
- Sada de Atendimento: 16 Mensagens de 18 caracteres cada
(sequencia de 1 at 16)
Observao2: A seqncia para a Parada Tcnica iniciada por 2 pois a primeira
linha ser preenchida com o ttulo da lista de clientes que enviada na transmisso da
configurao.
6.38 CONFIRMAO DE IMPORTAO E ASSOCIAO DE MENSAGENS DE EXTENSO LOGSTICA DE
PARADA

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

94

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

Este teleevento est diretamente relacionado ao Telecomando de Importao e


Associao de Mensagens de Extenso Logstica de Parada, sendo gerado um teleevento
para cada uma das configuraes de Mensagens de Extenso Logstica de Parada. O valor
da tag <CodMsg> para este teleevento -61.
<!-- Identificacao da Mensagem -->
<CodMsg> -61 </CodMsg>

<!-- Marcao do incio do grupo de alvos -->


<MensagensELP>
<!Data e Hora de processamento -->
<DataHoraEm></DataHoraEm>
<Veiculo>
<!-- Numero de srie do rastreador
(em hexadecimal) -->
<IdTerminal> </IdTerminal>
<!-- Status de Associao:
0 = Sucesso na Associacao,
1 = Falha na Associacao,
2 = Sucesso parcial (nem todas as mensagens foram
includas) -->
<StsAssociacao> </StsAssociacao>
</Veiculo>
</MensagensELP>
Observao1: Dentro da tag <MensagensELP> a tag <Veiculo> pode ser repetida
vrias vezes pois apresentada uma lista dos veculos em que a associao teve sucesso
ou no.

6.39 CONFIRMAO DA SOLICITAO DA TRANSMISSO DAS MENSAGENS DE EXTENSO


LOGSTICA
Este teleevento est diretamente relacionado ao Telecomando de Solicitao da
Transmisso da Configuraes de Extenso Logstica de Parada. Sempre que for enviado
esse Telecomando para o IAS ser devolvido um Televento de confirmao da solicitao
da transmisso da Configuraes de Extenso Logstica de Parada. O Status de que a
transmisso foi enviada com sucesso para o rastreador do veculo ser realizada pelo
teleevento Status de Envio de Telecomando (CodMsg = 81) com tag <IdStatus>
contendo o mesmo valor que a tag <IdSeqMsg> possuia quando o telecomando foi gerado.
O valor da tag <CodMsg> para este teleevento -62.
<!-- Data e hora da emissao -->

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

95

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

<DataHoraEm> </DataHoraEm>
<!-- Identificacao da Mensagem -->
<CodMsg> -62 </CodMsg>
<!-- Numero de srie do rastreador
(em hexadecimal) -->
<IdTerminal> </IdTerminal>
<!-- Status do envio do Conjunto de Alvos:
0 = Solicitao da Transmisso OK
1 = Terminal desconhecido
2 = No existem Mensagens (quando necessrio) associados a esse
veculo,
3 = No possvel transmitir a configurao de Extenso
Logstica de Parada(Base fora do ar)
4 = No possvel transmitir a configurao de Extenso
Logstica de Parada (Veculo em satlite).-->
<StsTransmissao> </StsTransmissao>
Observao: A tag <StsTransmissao> indica o status para transmisso da
configurao da extenso logstica de parada o veculo relacionado no Telecomando que
gerou esse Teleevento.
6.40 LISTA DE MENSAGENS PR-DEFINIDAS
Assim que a Interface recebe um telecomando de Solicitao Mensagens PrDefinidas, ela enviar para o Cliente um teleevento no formato XML com todas as
Mensagens Pr-Definidas que podem ser enviadas da Central SAVERTurbo para os
Rastreadores DPlus (satlite) com o modelo 1460 e 1480. Note que este teleevento
identificado com a tag <CodMsg> igual a 63
<!-- Data e hora da emissao -->
<DataHoraEm> </DataHoraEm>
<!-- Identificacao da mensagem -->
<CodMsg> -63 </CodMsg>
<!-- Marcao do incio de uma mensagem pr-definida -->
<MensagemPre>
<!-- Idenficador da Mensagem Pr-Definida -->
< IdMensagemPre > </IdMensagemPre>
<!-- Mensagem Pr-Definida -->
<Mensagem> </Mensagem>
</MensagemPre>

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

96

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

Observao: A tag <MensagemPre> pode se repetir dentro de teleevento


dependendo do nmero de Mensagens Pr-Definidas armazenados no banco de dados da
Central SAVERTurbo.
6.41 INFORMAES SOBRE OS TELEEVENTOS PERSONALIZADOS DE USURIO
Assim que a Interface recebe um telecomando de Solicitao dos Teleeventos
Personalizados de Usurio, ela enviar para o Cliente um teleevento no formato XML com
as informaes dos Teleeventos Personalizados de Usurio cadastrados na Central
SAVERTurbo. Note que este teleevento identificado com a tag <CodMsg> igual a 65.
<!-- Data e hora da emissao -->
<DataHoraEm> </DataHoraEm>
<!-- Identificacao da mensagem -->
<CodMsg> -65 </CodMsg>
<!-- Identificacao da mensagem -->
<EventoPersonalizado>
<!-- Identificador do Teleevento Personalizado -->
<IdEvtPersonalizado> </IdEvtPersonalizado>
<!-- Descrio do Teleevento Personalizado -->
<DescEvtPersonalizado> </DescEvtPersonalizado>
<!-- Tipo do Teleevento Personalizado
0 = Teleevento Normal
1 = Alerta
2 = Alarme
3 = Bloqueio
4 = Solicitao Autorizao -->
<TipoEvtPersonalizado> </TipoEvtPersonalizado>
<!-- Complementos do Televento Personalizado -->
<Complemento>
<!-- Tipo do Complemento conforme
tabela descrita abaixo -->
<Tipo> </Tipo>
<!-- Nome da tag do complemento -->
<Nome> </Nome>
....
</Complemento>
</EventoPersonalizado>
Tipo

Descrio

1 Inteiro de 8 bits com sinal

Tamanho
Valor Mnimo Valor Mximo
em Bytes
1
-128
127

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

97

IAS - Interface de Acesso ao Saver Turbo - Verso 6.0 - Reviso 2.8.doc

2
3
4
5
6
7
8
9
10
12
13
14

Inteiro de 8 bits sem sinal


Inteiro de 16 bits com sinal
Inteiro de 16 bits sem sinal
Inteiro de 32 bits com sinal
Inteiro de 32 bits sem sinal
Caracter ASCII de 8 bits
Real de 32 bits
Real de 64 bits
Booleano
Tipo Hora
Tipo Data
Tipo Data e Hora

1
0
2
-32768
2
0
4
-2,15E+09
4
0
1
0
4 1.5 * 10^45
8 5.0 * 10^324
1
4
4
4

255
32767
65335
2,147E+09
4,295E+09
255
3.4 * 10^38
1.7 * 10^308

Observao: A tag <EventoPersonalizado> encadeada vrias vezes dentro de


teleevento dependendo do nmero de Teleeventos Personalizados armazenados no banco
de dados da Central SAVERTurbo.

7 APNDICE
7.1

TELECOMANDOS PERMITIDOS PARA RI 0454 MINI MAX


Os telecomandos que podero ser enviados atravs do IAS para o RI 0454 Mini Max
esto listados abaixo:

Bloquear (0x15);

Desbloquear (0x16);

Posio Avulsa (0x11);

Mensagem Livre (0x13);

Lacrar Motor (0xE6);

Deslacrar Motor (0xE8);

Configurao de Mensagem Formatada (0x5C);

Solicitao da Transmisso do Perfil de Configurao: Perfil (Configurar RI 0454 Mini


Max) (-22). Lembrando que antes de transmitir o Perfil deve ser associado ao RI (-5)

Confidencial - Documento para uso Interno


No pode ser copiado, totalmente ou em parte, sem autorizao expressa da Omnilink Tecnologia

98

S-ar putea să vă placă și