Rinho no Wialon

Esta nota reúne tudo o que é necessário para cadastrar e aproveitar um equipamento Rinho no Wialon : qual tipo de dispositivo escolher, como apontar o equipamento, com que nome aparece cada dado no Wialon e como adicionar dados próprios sem pedir mudanças na plataforma.

1. Duas formas de conectar

Na maioria dos casos convém TAIP: é o protocolo nativo do equipamento, o Wialon o decodifica completo e com o campo AP é possível publicar qualquer dado adicional sem mudar de protocolo. Com os templates desta nota, os dois protocolos publicam os dados com os mesmos nomes: é possível passar de um para o outro sem mexer no Wialon.

2. Tipos de dispositivo e portas

Tipos Rinho disponíveis no Wialon Hosting:

• Servidor do Wialon Hosting: o que o Wialon indica para cada tipo de dispositivo. Os equipamentos de teste desta nota reportam a nl.gpsgsm.org. No Wialon Local ou em um servidor de um integrador, o host e a porta são definidos por quem administra esse servidor.
• ID único da unidade: o que o equipamento envia no campo ID= de cada trama. Nos modelos IoT é o IMEI. Consulta-se com >QID<.
• Todos os modelos usam o mesmo protocolo: o tipo de dispositivo define a porta e o nome do modelo no Wialon, mas os dados são decodificados igual (Spider e Zero publicaram exatamente o mesmo em todos os testes).

3. Receita: cadastrar um equipamento no Wialon

Com o protocolo Rinho TAIP (recomendado)

1. No Wialon, criar a unidade:

2. No equipamento, apontá-lo para a porta do tipo de dispositivo (exemplo para um Zero IoT):

>SIP0"nl.gpsgsm.org",22912<   // servidor principal
>SIP1"nl.gpsgsm.org",22912<   // servidor principal redundante
>SCXIPPP5<                    // TAIP por UDP no canal principal e no de backup

3. Template de relatório: o relatório de usuário padrão com campo AP (vem na configuração Wialon do configurador). No Spider IoT e no Smart IoT, para os dados do motor, a regra periódica precisa gerar um relatório ER (J1939) ou EQ (OBD-II).

4. Importar o template WLP do modelo (seção 10).

5. Verificar: no Wialon aparecem mensagens novas, e no equipamento >QBU< responde RBUOK00000 (nada esperando confirmação).

Com Wialon IPS

1. No Wialon, criar a unidade com tipo de dispositivo Rinho IPS, ID único = IMEI. A senha pode ficar vazia ou ter uma: o equipamento precisa enviar a mesma (passo 2).

2. No equipamento (exemplo para um Zero IoT):

>SCXIPWP5<                    // Wialon IPS no canal principal, TAIP UDP no de backup
>SIP0"nl.gpsgsm.org",22500<   // porta do tipo "Rinho IPS"
>SIP1"nl.gpsgsm.org",22500<
>SWLNA<                       // unidade sem senha no Wialon: NA. Se tiver, SWL<a senha>
>SUC00 QWD0| $rep_num:1:| #| $,cel_level:1:'CSQ',pwr_int:2:'V/100'<

Para Spider IoT e Smart IoT, o template com os dados do motor:

>SUC00 QWD0| $rep_num:1:| #| $,cel_level:1:'CSQ',pwr_int:2:'V/100',rpm:1:'ECU(0;0)',fuel_lvl:2:'ECU(2;0)',odometer:2:'ECU(3;0)',odoliter:2:'ECU(4;0)',refr_temp:1:'ECU(6;0)',oil_press:1:'ECU(7;0)',trip_time:2:'ECU(10;0)'<

As regras que o equipamento já tem não são alteradas: continuam gerando o relatório de usuário GU0…, que agora sai em Wialon IPS.

3. Importar o mesmo template WLP do modelo (seção 10): não há um template separado para Rinho IPS. Os templates de equipamento acima usam os mesmos nomes de parâmetros que TAIP, então os sensores são os mesmos.

4. Verificar: >QBU< em RBUOK00000 e >QDL< sem pendentes (o segundo número em 00000).

Mudar de protocolo com o equipamento instalado

Os relatórios que o equipamento já tem na fila ficaram montados para o protocolo anterior e o servidor novo não os confirma: travam todos os que vêm atrás. Antes de mudar, revisar >QBU< e >QDL<. Se ficarem pendentes e puderem ser descartados, depois da mudança:

>CBU<    // esvazia a fila de envio
>SDLC<   // esvazia o datalog

Notas

• Transporte: TAIP usa UDP (o de fábrica). Wialon IPS usa TCP.
• Confirmação (TAIP): o Wialon responde >ACK;#<nro>;ID=<id>;*<checksum>< a cada trama. O equipamento reenvia até recebê-la e só então descarrega sua fila: sem cobertura não se perde nada. Desde abril de 2025 o Wialon confirma também as tramas com data e hora em zero.
• Keep-alive: se estiver configurado (>SKA120,B<, por exemplo), cada keep-alive usa um número de mensagem. Por isso no Wialon mess_num “pula” um número de vez em quando: não é uma trama perdida.

4. O que o Wialon decodifica de cada trama

5. Parâmetros base

Todas as tramas publicam:

Além disso, o Wialon obtém da trama a velocidade, o rumo, a quantidade de satélites e as entradas e saídas. As tramas TAIP não trazem altitude: no Wialon aparece 0.

Entradas e saídas

O byte de entradas da trama (HH) é publicado tal qual nas entradas do Wialon, e o de saídas (II) nas saídas:

Verificado com uma trama com entradas A5 e saídas 02: o Wialon mostrou entradas 165 (in1, in3, in6, in8) e saídas 2 (out2). Para um sensor de ignição no Wialon usa-se in8.

6. CAN: nomes no Wialon

ER — CAN J1939

EQ — OBD-II

Para qualquer outro dado da ECU (consumo instantâneo, torque, etc.) usa-se um relatório de usuário com ECU dentro do campo AP.

7. Dados próprios: o campo AP

O Wialon decodifica um campo opcional AP (parâmetros adicionais) em qualquer trama TAIP, com o mesmo esquema do Wialon IPS. Cada parâmetro aparece no Wialon com o nome que o equipamento lhe dá: serve para sensores BLE, contadores, horímetro, bateria interna, temperaturas ou qualquer valor de EVAL, sem pedir mudanças no parser.

>RCQ00…<dados do relatório>;AP=temp1:2:25.50,door:1:1,driver:3:JUAN;#0017;ID=865413053386354;*26<

Como o Wialon se comporta

Montar o AP no equipamento

O AP é montado com um relatório de usuário que copia uma trama nativa e lhe adiciona o campo. O padrão serve para qualquer família ($RCQ| #| QCQ,5,100, $RER| #| QER,5,200, $RBQ| #| QBQ,5,120, …):

// UC00: trama CQ com sinal, tensão, velocidade, entrada 0 e canal de envio
>SUC00 $RCQ| #| QCQ,5,100| $;AP=rpt:1:| $'RNU'| $,csq:1:| $'CSQ'| $,vcc:1:| $'V'| $,in0:1:| $'IN(0)'| $,pwr:2:| $'V/100'| $,vel:2:| $'VEL'| $,canal:3:| $'CHN'<
 
// Relatório cada vez que TD00 vence com a ignição ligada
>SRL00E;TRG=TD00+;CND=IGN;ACC={GU000L;@LOG}<

No Wialon aparecem rpt, csq, vcc, in0, pwr, vel e canal (WIFI ou GPRS).

Exemplos prontos no configurador: o nível das réguas de combustível BLE (;AP=fl1:1:2997,ag1:1:3,…) e o resto das receitas que reportam ao Wialon.

8. Wialon IPS em detalhe

Os modelos IoT (Zero, Spider e Smart) falam também Wialon IPS: login #L#, dados #D# e dados curtos #SD#, por TCP. Está disponível desde o firmware 1.09.19; recomenda-se 1.09.24 ou superior, que completa os comandos SWL, QWL e QWD. A receita está na seção 3.

Porta e login

Respostas do Wialon Hosting ao login de um equipamento cadastrado como Rinho IPS sem senha:

• A porta é a do tipo de dispositivo: 22500 para Rinho IPS. A 20332 é a do tipo genérico Wialon IPS e rejeita uma unidade cadastrada como Rinho IPS.
• Sem senha no Wialon, o equipamento precisa enviar NA (>SWLNA<). Com senha, a mesma nos dois lados.
• Um login rejeitado não deixa rastro no Wialon: a unidade simplesmente não recebe mensagens. No equipamento percebe-se porque >QBU< ou >QDL< não baixam. Depois de 5 tentativas o equipamento espera 60 segundos e tenta pelo outro canal (WiFi ou celular).

O que o Wialon publica

Do pacote #D#, sempre:

E os parâmetros do template, com o nome que se lhes dê. Os templates desta nota usam os mesmos nomes que o Wialon dá ao TAIP (rep_num, cel_level, pwr_int, rpm, fuel_lvl, …): o mesmo template WLP serve para os dois protocolos, e é possível mudar de protocolo sem mexer nos sensores.

O template do equipamento

QWD0 monta o pacote #D# completo e termina em NA;. O que segue nos trechos $ são os parâmetros, com o formato nome:tipo:valor do campo AP:

>SUC00 QWD0| $rep_num:1:| #| $,cel_level:1:'CSQ',pwr_int:2:'V/100'<
#D#101126;140806;2746.8504;S;06415.5070;W;0;358;199;12;0.1;131;0;11.73,3.91;NA;rep_num:1:00,cel_level:1:99,pwr_int:2:11.67

Para ver a trama que o equipamento enviaria, sem enviá-la: >QWD0<.

9. Número do evento

O Wialon não lê o número do evento da mesma forma em todas as tramas:

Em TAIP ocorre com e sem AP, e já foi informado ao Wialon. Enquanto isso:

• Para eventos do 00 ao 09 não há diferença.
• Ao traduzir eventos no Wialon (sensor sobre rep_num), carregar o valor conforme a família de trama: em CQ e EQ, o número lido em hexadecimal.

10. Templates WLP por modelo

Templates de unidade para importar no Wialon (Propriedades da unidade → Importar de WLP). Cada um serve para TAIP e para Wialon IPS (com os templates de equipamento da seção 3): uma unidade Rinho IPS usa o mesmo template que uma TAIP do mesmo modelo.

Os templates foram testados no Wialon Hosting:

• TAIP, em uma unidade Spider IoT: com uma trama ER de valores conhecidos, o Wialon calculou RPM 1234, combustível 50 %, temperatura 85 °C, pressão 300 kPa, odômetro 20000 km, horas de motor 1500 e consumo 10000 L.
• Wialon IPS, em uma unidade Rinho IPS: ignição, tensão, bateria de backup, entradas, sinal, evento e os sensores CAN calcularam com os templates de equipamento da seção 3.

Notas:

• Saídas: a trama traz XP0 e XP1, por isso os templates do Spider e do Smart incluem duas.
• O sensor Evento vai sem tabela de textos: os números de evento dependem de como cada equipamento esteja configurado. Carregá-los conforme as regras do equipamento e a nota sobre o número do evento.
• Os demais parâmetros do campo AP (sensores BLE, contadores…) são adicionados como sensores novos com o nome que o relatório de usuário do equipamento usar.

11. Comandos a partir do Wialon

O Wialon pode enviar comandos ao equipamento, em TAIP e em Wialon IPS: são definidos na unidade como mensagem personalizada (custom_msg) com o comando Rinho completo, por exemplo >QVR<. Verificado nos dois protocolos com um comando >STAG…< enviado a partir do Wialon, que mudou a etiqueta do equipamento.

Os templates incluem dois comandos de consulta: Versão do equipamento (>QVR<) e Posição atual (>QCQ<).

• Em TAIP (UDP) o comando sai quando o equipamento volta a se comunicar (com o próximo relatório ou keep-alive): um equipamento que reporta a cada poucos segundos o recebe logo.
• O Wialon registra o envio do comando, mas não guarda a resposta do equipamento (RVR…) como mensagem. Para lê-la, usar o configurador ou uma regra que envie a informação em um relatório.

12. Se algo não aparece no Wialon

1. Não chega nada (TAIP): >QIP0< e >QCXIP<. A porta precisa ser a do tipo de dispositivo da unidade, e o ID único o que o equipamento envia em ID= (>QID<).
2. Não chega nada (Wialon IPS): quase sempre é o login. >QWL< precisa devolver a senha da unidade, ou NA se não tiver; a porta, 22500 para Rinho IPS.
3. A fila não baixa (>QBU< ou >QDL< com pendentes): o servidor não confirma. Se acabou de mudar de protocolo, ver mudar de protocolo.
4. Chegam tramas repetidas ou com atraso: o equipamento não recebe a confirmação e reenvia. Revisar o tipo de dispositivo da unidade e que a porta seja a desse tipo.
5. Falta um parâmetro: ver a tabela da seção 4. O que o Wialon não publica é enviado no campo AP.
6. Um parâmetro AP não aparece: valor vazio, tipo errado ou nome com mais de 32 caracteres.
7. O evento não coincide: ver número do evento.
8. Para ver a trama exata: >QWD0< em Wialon IPS; >QCQ<, >QER<, etc. em TAIP.

Veja Também

• Relatório CQ - Formato da trama base
• Relatório ER - CAN J1939
• Relatório EQ - OBD-II
• Relatórios de usuário - Montar o campo AP
• Confirmação de recepção - ACK
• Comando WL - Senha do Wialon IPS