ComandosTracker: Difference between revisions

From QuatenusWiki
No edit summary
No edit summary
Line 3: Line 3:




DOCUMENTO
DOCUMENTO: Manual de INSTALAÇÃO Tracker 5.0 (Android)


Manual de INSTALAÇÃO Tracker 5.0 (Android)
CRIADO: QUATENUS® internacional - OPERATIONS


Versão: V 2.01


 
Data: Julho de 2025
CRIADO                            
 
QUATENUS® internacional - OPERATIONS
 
Versão
 
V 2.01
 
Data
 
Julho de 2025


INFO@QUATENUS.EU
INFO@QUATENUS.EU
Line 30: Line 20:




ÍNDICE


Conteúdos
Conteúdos

Revision as of 15:41, 2 July 2025


DOCUMENTO: Manual de INSTALAÇÃO Tracker 5.0 (Android)

CRIADO: QUATENUS® internacional - OPERATIONS

Versão: V 2.01

Data: Julho de 2025

INFO@QUATENUS.EU

WWW.QUATENUS.EU


“Este documento é confidencial e contém informação exclusiva e reservada Quatenus® destinando-se apenas à entidade a que está endereçado, não podendo o seu conteúdo ser utilizado para qualquer outro fim. Consideramos de natureza estritamente confidencial, não só a informação constante do presente documento, mas também a que vier a ser disponibilizada ou de que os proponentes vierem a tomar conhecimento no decorrer dos futuros contactos e negociações, não podendo as mesmas ser divulgadas ou partilhadas com terceiros, sem o prévio consentimento da Quatenus® Internacional dado por escrito “


Conteúdos


1.  Configurações do dispositivo. 2

2. Tracker 5.0 (versão Android) 4

3. Actualização do Tracker 3.0. 8

4. Configuration over the air 10

5. Informações Adicionais. 11


1.      Configurações do dispositivo

Para o seu correto funcionamento esta aplicação necessita que o sistema Android tenha o fuso horário da área de utilização definido e a data e hora acertadas.

O Tracker depende da data e hora do sistema, bem como do fuso horário, para funcionar corretamente. É, por isso, necessário configurar o dispositivo por forma a que este tenha o fuso horário adequado ao local da utilização bem como a data e hora locais acertadas.

Normalmente a definição de data e hora podem ser obtidas através da rede automaticamente, no entanto em condições especificas podem ser definidas manualmente, no entanto deve ter sempre em consideração que é esta definição que o Quatenus Tracker irá utilizar para o envio de eventos referentes ao dispositivo


Tracker 5.0 (versão Android)

      Esta aplicação não se encontra disponível no Android Market, fazendo parte da suite de produtos Quatenus®. Deve ser instalada num contexto de utilização mais alargada e terá que ser utilizada num dispositivo registado na plataforma Quatenus® para que as suas funcionalidades possam ser integradas na solução de gestão global.


O Tracker funcionará como um serviço a correr dentro do sistema operativo Android e deverá ser instalado a partir da execução do APK[1] respectivo. Após a sua instalação o serviço é iniciado de forma automática. Após a instalação do Tracker terá que efectuar a actualização do mesmo a partir das suas configurações como descrito posteriormente neste documento. Poderá também ser necessário alterar algumas das outras configurações disponíveis para que funcione de acordo com as necessidades.


Para aceder às configurações pode fazê-lo a partir da configuração do MyFleet ou requerer ao seu parceiro uma app especifica para o efeito (Quatenus Tracker Configurator).


Aceder as configurações exige a introdução de um PIN de segurança que será solicitado logo de seguida. Deverá introduzir o PIN correcto e pressionar o botão OK. O PIN por omissão é ‘0000’

Por motivos de segurança é importante que altere o PIN de acesso na primeira vez que o acede as configurações. A funcionalidade de alteração de PIN está embebida numa das configurações.


Após aceder com sucesso às configurações do Tracker aparecerá uma lista com todas as opções disponíveis.

     Poderá ter que arrastar o ecrã para conseguir visualizar todas as opções disponíveis.

     

2.     Actualização do Tracker 5.0

Para actualizar o Tracker deverá realizar os seguintes passos:

1 – Aceder às configurações como descrito anteriormente

2 – Seleccionar a opção Actualizar Quatenus® Tracker

Ao realizar este passo deverá aparecer o seguinte nas notificações do dispositivo

Entre nas Notificações do dispositivo e clique nos dois updates do Quatenus® existentes. Clique em cada uma das notificações com a indicação da existência de nova versão do Quatenus® Tracker.

Para cada uma das notificações será indicado que irá ocorrer uma substituição da aplicação. Deverá pressionar o botão “OK”


3.     Configuration over the air

O Quatenus® Tracker permite ser configurado remotamente a partir de comandos QOSD.

Para tal deve ser utilizado o GTi a partir da central de mensagens, por questões de compatibilidade com versões anteriores deve ser enviado o pin a “0000”


Figura 1 - Exemplo de configuração over the air


Os comandos que podem ser enviados têm o seguinte formato:

#QMXC, <cmd>, <args0,arg1,arg2,…>

Onde os comandos <cmd> podem ser:

Comando Descrição
sys.primaryserver [url] [porto] [pin] Muda servidor primário
sys.forcesync [pin] Força o sincronismo das localizações
sys.clearlogfile [pin] Limpa o ficheiro de log
sys.stop [pin] Pára o Tracker
sys.stoplogfile [pin] Pára a escrita para o log
sys.status [pin] Envia um evento com o status (estatísticas) do dispositivo
sys.start [pin]  Inicía o Tracker
sys.startlogfile [pin] Começa a recolher o log
sys.sendlogfile [mailto] [pin] Envia o ficheiro de log para o email dado
sys.secondaryserver [url] [porto] [pin] Muda servidor secundário
sys.restart [pin] Stop  + Start do Tracker
sys.resetprefs [pin] Restaura configurações de origem
sys.sendconfig [pin] Envia as configurações atuais para o Quatenus através do evento 9020 [TRACKER: CONFIGURATION INFO (9020)], as configurações são enviadas no campo Texto #3 que pode ser consultado na pesquisa avançada
sys.writeconfig json [pin] Permite alterar parâmetros da configuração com o mesmo formato do comando sys.sendconfig, não sendo necessário enviar toda a configuração mas somente os que se querem alterar, por exemplo: #QMXC, sys.writeconfig, {"keepalivewhencharging": "0"}, 0000


O estado de execução do comando pode ser acompanhado na lista de eventos, através dos seguintes eventos:

Evento Descrição
TRACKER: SERVICE COMMAND (QOSD COMMAND) RECEIVED O comando foi recebido pelo Tracker
TRACKER: REMOTE CONFIGURATION SAVED As configurações foram guardas no Tracker e as novas configurações foram enviadas em Texto #3
TRACKER: INVALID SERVICE COMMAND O comando a ser executados é inválido
TRACKER: CONFIGURATION INFO Devolve as configurações do Tracker em Texto #3

Figura 2 - Exemplo de consulta de escrita de configuração correta

Figura 3 - Exemplo de comando inválido

4.     Informações Adicionais

Para informações adicionais por favor contacte o seu parceiro local



[1] APK – Ficheiros de instalação de software para o Android. Deverá ser copiado para o dispositivo móvel e executado a partir deste. O Sistema Operativo efectuará todas as operações necessárias para a instalação do software








QuatenusWiki® Core :: © QUATENUS 2015-2025:: en-us