Manual de configuração — Getrak iTR120

Guia para instalar e configurar o rastreador Getrak iTR120 na plataforma Rekta, por SMS ou por comando de string livre (GPRS).

Fonte: documento do fabricante winktracker-docs/Getrak/Protocolo-ITR120.pdf (v7.0.2, cap. 5 "Commands") e driver com.winksys.gateway.getrak.Itr120Driver.

1. Dados de conexão

Item	Valor
Protocolo	TCP (binário 0x28 0x28)
Porta do gateway	5036 (winktracker-gateway/conf/driver-config.xml)
Tipo de equipamento	GK — Getrak iTR120
Número do equipamento na plataforma	GK + IMEI de 15 dígitos (ex.: GK352544071677471)
Fuso para o Brasil (Brasília)	GMT,W,3,0,0#

O IMEI pode ser lido na etiqueta ou com o comando IMEI?.

2. Regras gerais dos comandos

• O mesmo texto de comando vale para SMS, GPRS (string livre) e USB. A resposta também é igual nos três canais.
• Comandos terminados em # executam ou alteram algo. Comandos terminados em ? consultam o valor atual.
• A palavra-chave não diferencia maiúsculas de minúsculas (STATUS? = status?). Os parâmetros diferenciam (APN,CMNET# ≠ APN,cmnet#).
• Não use espaços entre os parâmetros.
• As configurações ficam gravadas na memória flash e sobrevivem a reinícios.

Envio por SMS

1. Envie o comando como texto simples para o número do chip instalado no rastreador.
2. O equipamento responde por SMS para o número de origem, por exemplo SET APN OK ou SET APN Error.

Se o equipamento tiver senha, é preciso fazer login antes de enviar comandos por SMS. A sessão expira após 15 minutos sem uso. Números cadastrados como gerente não precisam de login.

Comando	Função	Resposta
LOGIN,[SENHA]#	Entra na sessão	Login OK / Login Error
LOGOUT#	Sai da sessão	Logout OK / Logout Error
PASSWORD,[SENHA ANTIGA],[SENHA NOVA]#	Troca a senha	SET PASSWORD OK / SET PASSWORD Error

O manual do fabricante não informa a senha de fábrica. O cadastro do tipo GK na plataforma também não define senha padrão (senha_padrao = NULL).

Envio por string livre (plataforma)

Com o equipamento conectado ao gateway, qualquer comando deste manual pode ser enviado pela plataforma:

1. Abra o veículo e escolha o comando Texto livre (tipo 35).
2. No parâmetro, digite o comando exatamente como seria enviado por SMS, por exemplo STATUS? ou IDLETIME,300,5,0,0#.
3. O gateway envia o texto sem alteração no pacote de instrução 0x80, usando o id do comando como UID.
4. A resposta do equipamento é gravada como mensagem do veículo. Se ela contiver Error, o comando fica como rejeitado.

A string livre só funciona com o equipamento online. Para o primeiro cadastro (APN e servidor), use SMS.

Cuidado ao enviar SERVER ou APN pela plataforma: um valor errado desconecta o equipamento do gateway, e a correção só será possível por SMS.

3. Configuração inicial (passo a passo)

Envie por SMS, na ordem abaixo, conferindo cada resposta OK.

Passo	Comando	Resposta esperada
1. Conferir IMEI e firmware	VERSION?	IMEI:... IMSI:... ICCID:... SYSTEM:... VERSION:...
2. APN da operadora	APN,smart.m2m.vivo.com.br,,#	SET APN OK
3. Servidor	SERVER,tcp://acesso2.sistemarodar.com.br:5036#	SET SERVER OK
4. Fuso de Brasília	GMT,W,3,0,0#	SET GMT OK
5. Intervalo de envio	COLLECT,600,0,0,30,1#	SET COLLECT OK
6. Heartbeat	HBT,3#	SET HBT OK
7. Hodômetro atual do veículo	MILEAGE,125430#	SET MILEAGE OK
8. Conferir tudo	PARAM?	IMEI / APN / SERVER / COLLECT / LANG / GMT / SAVING
9. Conferir conexão	STATUS?	GPRS:SUCCESS e GPS:FIXED,n

Depois cadastre na plataforma o equipamento GK + IMEI e vincule-o ao veículo. As posições começam a chegar após o login do equipamento no gateway.

Troque smart.m2m.vivo.com.br pela APN do chip usado. Usuário e senha da APN são opcionais: deixe os campos vazios quando a operadora não exigir.

4. Comandos de configuração

4.1 Rede e servidor

Comando	Consulta	Parâmetros
APN,[APN],[USUARIO],[SENHA]#	APN?	APN da operadora; usuário e senha podem ficar vazios
SERVER,tcp://[HOST]:[PORTA]#	SERVER?	Endereço e porta do gateway. Use udp:// apenas para UDP (não suportado pelo driver)
HBT,[MINUTOS]#	HBT?	Intervalo do heartbeat em minutos (aceita decimal)
DELAY,[SEGUNDOS]#	DELAY?	Tempo até atender uma chamada recebida

SERVER? responde SERVER:tcp://host:porta(IP). O IP só aparece quando o equipamento está conectado.

4.2 Transmissão de posições

COLLECT,[INTERVALO],[DISTANCIA],[CURVA],[ATIVO],[QUANTIDADE]# — consulta: COLLECT?

Parâmetro	Significado	Valores
INTERVALO	Envio com o veículo parado / ignição desligada (s)	0 ou 300–65535
DISTANCIA	Envio a cada N metros percorridos	0 ou 500–65535
CURVA	Envio ao virar mais que N graus	0 ou 30–180
ATIVO	Envio com o veículo em movimento / ignição ligada (s)	0 ou 10–65535
QUANTIDADE	Posições acumuladas antes de enviar	1–10

Valor 0 desativa a estratégia. Com várias estratégias ativas, gera posição quando qualquer uma é atingida.

Exemplo: COLLECT,600,0,30,30,1# envia a cada 10 min parado, a cada 30 s em movimento e em curvas acima de 30°.

STORED,[MODO]# — consulta: STORED? — define como as posições guardadas na memória são descarregadas:

• 0 (padrão): descarrega o histórico sem misturar com as posições em tempo real.
• 1: descarrega o histórico junto com as posições em tempo real.

SLEEP,[STATUS],[TEMPO_TX],[TEMPO_PARA_DORMIR]# — consulta: SLEEP?

Parâmetro	Valores
STATUS	0 desativa, 1 ativa
TEMPO_TX	Intervalo de envio durante o sono: 0 ou 300–43200 s
TEMPO_PARA_DORMIR	Tempo com ignição desligada e sem movimento até dormir: 180–3600 s

Exemplos: SLEEP,1,600,180# (dorme após 3 min e envia a cada 10 min) e SLEEP,0,0,0# (desativa).

O equipamento acorda com ignição ligada, entrada 1 ativa, corte de energia ou movimento detectado pelo acelerômetro.

4.3 Data, hora e hodômetro

Comando	Consulta	Parâmetros
GMT,[E/W],[HORA],[MINUTO],[HORARIO_VERAO]#	GMT?	E leste / W oeste; hora -12–12; minuto 0, 15, 30, 45; verão 0, 1, 2
MILEAGE,[KM]#	MILEAGE?	Hodômetro inicial em km. Depois ele incrementa sozinho com GPS fixo
LANG,0#	LANG?	Idioma (0 = inglês, único disponível)

Fusos do Brasil: Brasília GMT,W,3,0,0#, Amazonas GMT,W,4,0,0#, Acre GMT,W,5,0,0#, Fernando de Noronha GMT,W,2,0,0#.

4.4 Ignição virtual

VIRTUALIGN,[TEMPO_PARADO],[TEMPO_MOVIMENTO],[MODO]# — consulta: VIRTUALIGN?

Usa o acelerômetro para simular a ignição quando o fio de ignição não está ligado.

Parâmetro	Significado	Valores
TEMPO_PARADO	Tempo sem movimento para considerar ignição desligada	1–1800 s
TEMPO_MOVIMENTO	Tempo com movimento para considerar ignição ligada	1–1800 s
MODO	0 desativa, 1 ativa	0 / 1

Exemplo recomendado: VIRTUALIGN,120,10,1#.

4.5 Saída (bloqueio)

Comando	Função
RELAY,1#	Ativa a saída (bloqueia) imediatamente
RELAY,2#	Bloqueio seguro: só ativa abaixo de 20 km/h (ou parado, sem GPS)
RELAY,3#	Bloqueio muito seguro: só ativa abaixo de 5 km/h
RELAY,0#	Desativa a saída (desbloqueia)
RELAY?	Consulta: RELAY:ON / RELAY:OFF
INRELAY,[MODO]#	Lógica da saída: 0 normal, 1 invertida (RELAY,1# desliga). Consulta INRELAY?
SIMDETECT,[MODO]#	1 aciona a saída quando o chip é retirado; 0 desativa. Consulta SIMDETECT?

Respostas possíveis do bloqueio seguro: Relay enable Delayed: Too fast (>20km/h), Relay enable Delayed: Moving ou Relay enable Error: .... Em "Delayed", o bloqueio será feito quando a condição de velocidade for atendida.

4.6 Alertas

Comando	Consulta	Função
SPEED,[BAIXA],[ALTA],[BLOQUEIO]#	SPEED?	Alerta de subvelocidade, excesso de velocidade e bloqueio por velocidade (km/h, 0–255; 0 desativa cada um)
MOTION,[SENSIBILIDADE],[ATRASO]#	MOTION?	Alerta de vibração: 0 desativa, 1 (mais sensível) a 9; atraso em segundos
SHIFT,[RAIO]#	SHIFT?	Cerca automática com ignição desligada: 0 desativa, 50–1000 m
IDLETIME,[TEMPO],[VELOCIDADE],[ACELEROMETRO],[SAIDA]#	IDLETIME?	Alerta de ociosidade com ignição ligada

Exemplos de SPEED:

• SPEED,0,100,0# — alerta acima de 100 km/h.
• SPEED,30,100,0# — alerta abaixo de 30 e acima de 100 km/h.
• SPEED,0,0,80# — aciona a saída acima de 80 km/h.
• SPEED# — desativa os alertas de velocidade.

Parâmetros de IDLETIME:

• TEMPO: segundos parado para gerar o alerta (0 desativa).
• VELOCIDADE: velocidade até a qual o veículo é considerado parado (km/h).
• ACELEROMETRO: 1 considera vibração como movimento.
• SAIDA: 1 aciona a saída ao gerar o alerta.

Exemplo: IDLETIME,300,5,0,0# gera alerta após 5 min abaixo de 5 km/h, sem acionar a saída.

4.7 Cercas eletrônicas

Até 8 cercas, circulares ou retangulares.

Formato	Uso
FENCE,[N],[FLAG],[LNG],[LAT],[RAIO],[BLOQUEIO]#	Cerca circular (raio em metros)
FENCE,[N],[FLAG],[LNG1],[LAT1],[LNG2],[LAT2]#	Cerca retangular (canto superior esquerdo e inferior direito)
FENCE,[N]# / FENCE,0#	Remove a cerca N / todas
FENCE,[N]? / FENCE,0?	Consulta a cerca N / todas

FLAG combina o tipo e o formato:

• Tipo: O alerta ao sair, I alerta ao entrar, C alerta nos dois sentidos.
• Formato: R circular, S retangular.

Longitude vem antes da latitude, em graus decimais. Sem coordenadas, a cerca circular usa a última posição válida.

Exemplos:

• FENCE,1,OR,,,500# — cerca de saída com 500 m em volta da posição atual.
• FENCE,2,CR,-49.2733,-25.4284,1000,80# — cerca nos dois sentidos com 1 km de raio, acionando a saída acima de 80 km/h.

5. Ações e consultas

Comando	Função
RESET#	Reinicia o equipamento
PAGING#	Pede uma posição imediata
CLEAR#	Apaga as posições pendentes na memória (elas não serão enviadas)
FACTORY#	Volta todas as configurações para o padrão de fábrica
SHUTDOWN#	Desliga o equipamento (só com a alimentação principal removida)
UPGRADE,[ARQUIVO],[HOST],[PORTA]#	Atualiza o firmware; acompanhe com UPGRADE?
IMEI?	IMEI do equipamento
VERSION?	IMEI, IMSI, ICCID e versões de firmware
PARAM?	Principais parâmetros: APN, servidor, COLLECT, idioma, fuso
STATUS?	Bateria, GPRS, sinal GSM, GPS, ignição, saída e alimentação
WHERE?	Última coordenada, velocidade e data/hora
URL#	Link do Google Maps com a posição atual

Leitura do STATUS?:

Campo	Valores
GPRS	SUCCESS conectado, FAILED falha, CLOSED desligado
GSM	Qualidade (HIGH, MED, LOW, NONE) e nível (0 = -110 dB, 50 = -60 dB)
GPS	FIXED / UNFIXED e número de satélites
ACC	Ignição ON / OFF
POWER	Alimentação externa OK / NC (desconectada)

6. Comandos prontos da plataforma

Estes tipos de comando têm tela própria na plataforma. O gateway converte o parâmetro no texto do iTR120. Qualquer outro comando vai por Texto livre (tipo 35).

Tipo	Comando na plataforma	Parâmetro	Texto enviado
1	Bloqueio	vazio, 2 ou 3	RELAY,1# / RELAY,2# / RELAY,3#
2	Desbloqueio	—	RELAY,0#
13	Reset	—	RESET#
14	Servidor	porta;host (ex.: 5036;gateway.empresa.com.br)	SERVER,tcp://host:porta#
15	Velocidade máxima	km/h (0 desativa)	SPEED,0,<km/h>,0#
16	Intervalo de transmissão	ligada,desligada em segundos (ex.: 30,600)	COLLECT,<desligada>,0,0,<ligada>,1#
19	Heartbeat	minutos	HBT,<min>#
20	Fuso	W;3 ou -3	GMT,W,3,0,0#
23	Hodômetro	km	MILEAGE,<km>#
33	Solicitar posição	—	PAGING#
35	Texto livre	comando completo	enviado sem alteração
55	APN	apn;usuario;senha	APN,apn,usuario,senha#
56	Ignição virtual	vazio ou parado,movimento,modo	VIRTUALIGN,120,10,1# ou os valores informados
57	Sleep	tempo_tx,tempo_para_dormir (0 desativa)	SLEEP,1,tx,dormir# / SLEEP,0,0,0#

No intervalo de transmissão (16), use ligada de 10 a 65535 s e desligada de 300 a 65535 s. Sem o segundo valor, a desligada fica em 300 s.

7. Solução de problemas

Sintoma	Verificar
Não responde SMS	Chip com crédito e sinal; senha ativa (enviar LOGIN,[SENHA]# antes)
GPRS:FAILED ou CLOSED no STATUS?	APN do chip (APN?); plano de dados ativo
GPRS:SUCCESS, mas sem posições na plataforma	SERVER? com host e porta 5036; equipamento cadastrado como GK + IMEI
Horário das posições deslocado	GMT? deve responder W3.00 para Brasília
GPS:UNFIXED	Posição da antena/equipamento; céu aberto para o primeiro fix
Ignição sempre desligada	Fio de ignição ou ativar VIRTUALIGN,120,10,1#
Bloqueio responde Delayed	Normal no RELAY,2# / RELAY,3#: aguarda o veículo reduzir a velocidade
Comando da plataforma fica rejeitado	A resposta do equipamento contém Error: revisar o formato dos parâmetros