Protocolo de Comunicação

Os dispositivos Rinho utilizam um protocolo derivado de TAIP (Trimble ASCII Interface Protocol), padrão da indústria AVL.

Estrutura de Mensagens

Toda mensagem começa com > (0x3E) e termina com < (0x3C):


>TIPO_DADOS;#NNNN;ID=XXXX;*CC<

Elemento	Descrição	Obrigatório
`>`	Header (início)	✅ Sempre
`TIPO`	Prefixo + comando	✅ Sempre
`DADOS`	Conteúdo variável	✅ Sempre
`;#NNNN`	Número da mensagem (hex)	Apenas GPRS
`;ID=XXXX`	Identificador do equipamento	Apenas GPRS
`;*CC`	Checksum XOR (hex)	Apenas GPRS
`<`	Footer (fim)	✅ Sempre

Prefixo	Nome	Descrição
S	Set	Escreve/configura parâmetros
Q	Query	Consulta parâmetros
R	Response	Resposta a S ou Q

O checksum é o XOR de todos os bytes desde > até * (incluído), expresso em 2 caracteres hexadecimais.

Requer ID, número de mensagem e checksum:


// Consulta
>QID;#8001;ID=1234;*7C<
 
// Resposta
>RID1234;#8001;ID=1234;*7B<

Não requer ID nem checksum:


// Consulta
>QID<
 
// Resposta  
>RID1234;ID=1234;*7B<

Não requer checksum. O equipamento responde com ID:


// Consulta
>QIO<
 
// Resposta
>RIO;IGN1;IN1111110;XP010;V127;VBU420;ID=1234;*1B<

Podem-se enviar múltiplos comandos em uma única transmissão:


>QPWRINHO<>SSSXP0011<

Resposta:


>RPWOK;ID=1234;*71<>RSSXP0011;ID=1234;*6D<

Útil quando se usa password de acesso, especialmente via SMS.

Identificador ordinal hexadecimal para confirmar recepção de relatórios.

Faixa	Uso
`0x0000` - `0x7FFF`	Relatórios do equipamento → servidor
`0x8000` - `0xFFFF`	Comandos do servidor → equipamento

Envio desde servidor:


>SSSXP0011;#8001;ID=1234;*6A<

Resposta do equipamento:


>RSSXP0011;#8001;ID=1234;*6B<

O servidor sabe que o comando #8001 foi executado.

Para confirmar recepção de um relatório, o servidor responde:


>ACK;#NNNN;ID=XXXX;*CC<

Onde #NNNN é o número da mensagem recebida.