Solucao de Problemas de Dispositivos IoT
Este guia fornece procedimentos abrangentes de solucao de problemas para problemas de dispositivos IoT no Levy Fleets. Esteja voce enfrentando problemas de conectividade, erros de comando ou falhas de telemetria - siga estas abordagens sistematicas para diagnosticar e resolver problemas.
Importante
Antes de solucionar problemas de dispositivos IoT, certifique-se de ter acesso fisico ao veiculo se necessario e de ter as permissoes apropriadas (funcao de Admin, Gerente de Frota ou Tecnico de Servico).
Checklist de Diagnostico Rapido
Antes de investigar problemas especificos, passe por este checklist rapido:
| Verificacao | Como verificar | Acao se falhar |
|---|---|---|
| Dispositivo Online | Pagina IoT mostra indicador verde | Veja secao "Dispositivo mostra Offline" |
| Sinal atual | Ultimo visto dentro de 5 minutos | Verificar celular/alimentacao |
| IMEI correto | IMEI do veiculo corresponde ao dispositivo IoT | Revincular se nao corresponder |
| Senha correta | Configuracoes > Veiculos mostra senha | Atualizar para senha correta |
| Nivel de bateria | Bateria do veiculo e do IoT | Carregar se baixa |
Dispositivo Mostra Offline
Sintomas
- Indicador de status do dispositivo esta cinza/vermelho
- Timestamp "Ultimo visto" tem horas ou dias de idade
- Veiculo nao responde a nenhum comando
- Nenhum dado de telemetria sendo recebido
Possiveis Causas
| Causa | Probabilidade | Descricao |
|---|---|---|
| Bateria IoT descarregada | Alta | Bateria interna do modulo IoT esgotou |
| Bateria do veiculo descarregada | Alta | Bateria principal do veiculo muito fraca para alimentar IoT |
| Sem cobertura celular | Media | Dispositivo em area com sinal fraco/nenhum |
| Problema de cartao SIM | Media | SIM desativado, expirado ou danificado |
| Falha de hardware | Baixa | Modulo IoT fisicamente danificado |
| Configuracao de servidor errada | Baixa | Dispositivo apontando para servidor errado |
Solucoes
Verificar ultima localizacao conhecida
Na pagina de detalhes do dispositivo IoT, note as ultimas coordenadas GPS. Determine se o veiculo esta em uma area com cobertura sabidamente ruim (porao, estacionamento subterraneo, area rural).
Verificar bateria do veiculo
Se tiver acesso ao veiculo, verifique o nivel da bateria principal. Se abaixo de 10%, o modulo IoT pode ter desligado para economizar energia. Carregue o veiculo.
Reiniciar veiculo
Desligue o veiculo completamente, aguarde 30 segundos e ligue novamente. Isso reinicia o modulo IoT.
Verificar alimentacao do modulo IoT
Inspecione se o modulo IoT esta recebendo energia. Procure por LEDs indicadores no dispositivo. Sem luzes = sem energia.
Verificar cartao SIM
Contate seu provedor IoT para verificar se o cartao SIM esta ativo e tem dados. SIMs podem ser desativados por falta de pagamento ou inatividade.
Mover veiculo para melhor cobertura
Se estiver em area de sinal fraco, mova o veiculo para area aberta ou area com cobertura sabidamente boa e aguarde 5 minutos.
Quando Escalar
Se o dispositivo permanecer offline apos verificar alimentacao e cobertura, o modulo IoT pode precisar ser substituido. Contate o suporte com:
- IMEI do dispositivo
- Data da ultima comunicacao boa conhecida
- Resultados da inspecao fisica
- Passos ja tentados
Comandos Nao Sao Recebidos
Sintomas
- Comandos de bloquear/desbloquear falham silenciosamente
- "Comando enviado" aparece mas nada acontece
- Veiculo nao responde a comandos de som/bip
- Comandos expiram por timeout apos 30 segundos
Possiveis Causas
| Causa | Probabilidade | Descricao |
|---|---|---|
| Senha incorreta | Alta | Senha IoT nas configuracoes nao corresponde ao dispositivo |
| Dispositivo Offline | Alta | Nao pode receber comandos quando offline |
| Acumulo na fila de comandos | Media | Muitos comandos pendentes |
| Incompatibilidade de protocolo | Baixa | Tipo de IoT errado selecionado para o dispositivo |
Solucoes
Verificar se dispositivo esta online
Verifique a pagina de dispositivos IoT para confirmar que o dispositivo mostra como online. Comandos nao podem ser enviados para dispositivos offline.
Verificar senha IoT
Va para Configuracoes > Veiculos e verifique a senha para seu tipo de dispositivo:
| Tipo de Dispositivo | Senha Padrao |
|---|---|
| Okai | zk200 |
| Queclink | ks600 |
| Segway | 0000 |
| Omni | 0000 |
| ZIMO | (varia) |
Enviar comando de teste
Tente enviar um comando STATUS ou HEARTBEAT primeiro. Estes nao alteram o estado do veiculo e ajudam a testar a comunicacao.
Verificar feed de telemetria
Na pagina de detalhes do veiculo, expanda Comandos IoT e observe o feed de telemetria. Procure por ACK (confirmacao) ou respostas de erro.
Aguardar resposta
Alguns dispositivos, especialmente baseados em SMS (Okai, Queclink), podem levar 30-60 segundos para responder. Nao envie multiplos comandos em rapida sucessao.
Verificar tipo de IoT
Confirme que o tipo de IoT do dispositivo corresponde ao hardware real. Um dispositivo Queclink configurado como "Okai" nao recebera comandos corretamente.
Problemas de Comando Especificos por Dispositivo
Dispositivos TCP Segway
- Comandos sao enviados via conexao TCP direta
- Resposta normalmente dentro de 5 segundos
- Se falhar, verifique se IP/porta do dispositivo esta acessivel
Okai/Queclink (Baseados em SMS)
- Comandos sao enviados via SMS para o SIM do dispositivo
- Resposta pode levar 30-60 segundos
- Verifique se capacidade SMS esta habilitada para o SIM
- Verifique se a cota de SMS foi excedida
Dispositivos ZIMO MQTT
- Comandos sao enviados via broker MQTT
- Resposta quase em tempo real esperada
- Verifique conectividade do broker MQTT
- Verifique assinatura do dispositivo para topico de comando
Dispositivos Omni SCOR
- Protocolo bidirecional em tempo real
- Resposta imediata esperada
- Nao requer senha para a maioria dos comandos
- Verifique status da conexao WebSocket
Dados de Telemetria Nao Atualizam
Sintomas
- Nivel de bateria nao mudou por horas
- Localizacao mostra coordenadas antigas
- Leitura de quilometragem esta desatualizada
- Timestamp "Ultima atualizacao" nao esta atual
Possiveis Causas
| Causa | Probabilidade | Descricao |
|---|---|---|
| Intervalo de reporte | Alta | Dispositivo configurado para atualizacoes pouco frequentes |
| Dispositivo em modo de dormir | Alta | Dispositivo em modo de economia de energia |
| Perda de sinal GPS | Media | Nao consegue obter localizacao por satelite |
| Conectividade parcial | Media | Heartbeat funciona mas pacotes de dados falham |
| Atraso de processamento do servidor | Baixa | Dados recebidos mas ainda nao processados |
Solucoes
Verificar status de heartbeat
Mesmo que os dados nao estejam atualizando, o dispositivo deveria estar enviando heartbeats. Verifique se heartbeats estao sendo recebidos (visivel no feed de telemetria).
Solicitar atualizacao de status
Envie um comando STATUS para forcar o dispositivo a reportar valores atuais.
Verificar qualidade do GPS
Verifique a telemetria atual para valores de precisao GPS. Veiculos em ambientes internos/subterraneos podem ter GPS ruim.
Verificar configuracao de reporte
Alguns dispositivos sao configurados para reportar menos frequentemente quando parados. Este e um comportamento normal para economizar energia.
Verificar pipeline de dados
Se muitos dispositivos sao afetados, pode haver um atraso de processamento em todo o sistema. Verifique o status do sistema ou contate o suporte.
Entendendo Intervalos de Reporte
| Estado do Dispositivo | Intervalo Tipico | Notas |
|---|---|---|
| Em viagem | 10-30 segundos | Atualizacoes frequentes para rastreamento |
| Ocioso (Disponivel) | 5-15 minutos | Conserva bateria |
| Modo de dormir | 1-4 horas | Consumo minimo de energia |
| Carregando | 1-5 minutos | Mais frequente durante carregamento |
Dados de Localizacao Incorretos
Sintomas
- Veiculo mostra em localizacao errada no mapa
- Localizacao pula erraticamente
- Coordenadas GPS nao correspondem a posicao real
- Veiculo aparece em locais impossiveis (oceano, outra cidade)
Possiveis Causas
| Causa | Probabilidade | Descricao |
|---|---|---|
| Sinal GPS ruim | Alta | Ambiente interno, subterraneo ou canyon urbano |
| Periodo de aquecimento do GPS | Alta | Dispositivo recem ligado precisa obter localizacao por satelite |
| Localizacao em cache | Media | Dispositivo reportando ultima localizacao boa conhecida |
| Problema de hardware | Baixa | Antena GPS danificada ou desconectada |
Solucoes
Verificar timestamp da localizacao
Na pagina de detalhes do veiculo, verifique quando a localizacao foi atualizada pela ultima vez. Timestamps antigos indicam dados desatualizados.
Revisar historico de localizacao
Olhe a trilha GPS. Pontos dispersos indicam sinal ruim; trilhas suaves indicam bom rastreamento.
Mover veiculo para area aberta
Se o veiculo esta em ambiente interno ou subterraneo, GPS e impreciso. Mova-o para area com ceu aberto.
Aguardar fix de GPS
Apos reiniciar, dispositivos precisam de 2-5 minutos para obter boa localizacao GPS. Aguarde antes de confiar na localizacao.
Verificar valor de precisao GPS
Alguns dispositivos reportam precisao/HDOP GPS. Valores acima de 10 indicam precisao ruim.
Inspecionar antena GPS
Se persistentemente impreciso, a antena GPS pode estar danificada ou bloqueada. Verifique a instalacao fisica.
Precisao GPS por Ambiente
| Ambiente | Precisao Esperada | Notas |
|---|---|---|
| Ceu aberto | 2-5 metros | Melhor caso |
| Area urbana | 5-15 metros | Reflexoes de edificios |
| Sob arvores | 10-30 metros | Atenuacao de sinal |
| Perto de edificios | 15-50 metros | Erros de multiplos caminhos |
| Subterraneo/Interno | 50+ metros ou nenhum | GPS geralmente inutilizavel |
Leituras de Bateria Incorretas
Sintomas
- Bateria mostra 100% mas veiculo nao anda
- Bateria pula repentinamente de alta para baixa
- Valor de bateria trava em um nivel
- Bateria do veiculo vs. bateria IoT nao correspondem
Possiveis Causas
| Causa | Probabilidade | Descricao |
|---|---|---|
| Problema de calibracao | Alta | Indicador de bateria precisa recalibracao |
| Baterias diferentes | Alta | Veiculo e IoT tem baterias separadas |
| Atraso de comunicacao | Media | Valor esta em cache/antigo |
| Problema de BMS | Media | Sistema de gerenciamento de bateria reportando incorretamente |
| Bateria danificada | Baixa | Celulas de bateria danificadas |
Solucoes
Entender as duas baterias
A maioria dos veiculos tem DUAS baterias:
- Bateria do Veiculo: Alimenta o motor (o que os motoristas se importam)
- Bateria IoT: Alimenta o modulo de rastreamento (o que mantem o dispositivo online)
Estas sao reportadas separadamente e descarregam independentemente.
Solicitar valor atualizado
Envie um comando STATUS para obter valores de bateria atuais.
Comparar com estado real
Se possivel, verifique o indicador de bateria fisico ou display do painel do veiculo.
Executar ciclo de carga completo
Carregue a bateria ate 100%, depois deixe descarregar ate vazia. Isso recalibra o indicador.
Verificar status de carregamento
Verifique se o indicador "Carregando" corresponde a se o veiculo esta realmente conectado.
Reporte de Bateria por Tipo de Dispositivo
| Tipo de Dispositivo | Reporta Bateria do Veiculo | Reporta Bateria IoT | Notas |
|---|---|---|---|
| Segway | Sim | Sim | Ambos os valores confiaveis |
| Okai | Sim | As vezes | Bateria IoT pode nao ser reportada |
| Queclink | Sim | Sim | IoT mostra como "interna" |
| ZIMO | Sim | Sim | Ambos normalmente precisos |
| Omni | Sim | Nao | Apenas bateria do veiculo mostrada |
Status de Bloquear/Desbloquear Nao Corresponde
Sintomas
- Painel mostra bloqueado mas veiculo esta desbloqueado
- Comando de desbloquear enviado mas ainda mostra bloqueado
- Status alterna inesperadamente
- Cliente relata que veiculo esta bloqueado durante viagem
Possiveis Causas
| Causa | Probabilidade | Descricao |
|---|---|---|
| Atraso de sincronizacao de status | Alta | Comando funcionou mas status nao atualizou |
| Comando falhou silenciosamente | Media | Comando nao alcancou o dispositivo |
| Override fisico | Baixa | Trava mecanica foi acionada manualmente |
| Falha de hardware | Baixa | Mecanismo de trava danificado |
Solucoes
Aguardar atualizacao de status
Apos enviar bloquear/desbloquear, aguarde 30-60 segundos para atualizacao de status. Force atualizacao da pagina.
Solicitar status
Envie um comando STATUS para obter o estado de trava real atual do dispositivo.
Verificar feed de telemetria
Procure por confirmacao de comando no feed de telemetria. Verifique por codigos de erro.
Tentar comando novamente
Se o status nao atualizou, reenvie o comando. Alguns comandos requerem multiplas tentativas em cobertura ruim.
Inspecao fisica
Se comandos falham persistentemente, inspecione fisicamente o mecanismo de trava para danos ou obstrucao.
Nao Consigo Vincular Dispositivo ao Veiculo
Sintomas
- Dispositivo IoT criado mas nao consegue vincular ao veiculo
- Veiculo mostra "Sem dispositivo IoT"
- Erro de incompatibilidade de IMEI
- Telemetria chega mas nao esta vinculada ao veiculo
Possiveis Causas
| Causa | Probabilidade | Descricao |
|---|---|---|
| Incompatibilidade de IMEI | Alta | IMEI digitado incorretamente |
| Dispositivo em subconta errada | Media | Dispositivo e veiculo em subcontas diferentes |
| IMEI ja vinculado | Media | Outro veiculo usando o mesmo IMEI |
| Dispositivo nao criado | Media | Dispositivo nao esta no registro IoT |
Solucoes
Verificar formato do IMEI
IMEI deve ter exatamente 15 digitos. Sem espacos, hifens ou letras. Verifique por erros de digitacao.
Verificar ambos os registros
Verifique se o IMEI corresponde exatamente tanto no registro do dispositivo IoT QUANTO no campo iot_imei do veiculo.
Verificar subcontas
Certifique-se de que o dispositivo IoT e o veiculo estao na mesma subconta.
Verificar vinculos duplicados
Busque o IMEI em todos os veiculos. Outro veiculo pode ja estar vinculado.
Verificar dispositivos nao mapeados
Se o dispositivo esta comunicando mas nao vinculado, pode aparecer na lista "Dispositivos nao mapeados".
Dispositivos Nao Mapeados Aparecem
Sintomas
- Dispositivos na lista "Nao mapeados"
- IMEIs desconhecidos comunicando com o servidor
- Contagem de dispositivos maior que esperado
Possiveis Causas
| Causa | Probabilidade | Descricao |
|---|---|---|
| Novos dispositivos | Alta | Dispositivos instalados mas nao registrados |
| Erro de digitacao de IMEI | Media | Registrado com IMEI errado |
| Dispositivos antigos | Baixa | Dispositivos de veiculos desativados |
| Servidor errado | Baixa | Dispositivos de outra frota apontando para ca |
Solucoes
Identificar dispositivo
Verifique o IMEI contra seu inventario de dispositivos. Corresponda a um dispositivo fisico conhecido.
Registrar novos dispositivos
Se for um dispositivo novo legitimo, clique em "Registrar" para adiciona-lo a sua frota.
Corrigir erros de IMEI
Se um dispositivo existente foi registrado com IMEI errado, atualize o registro do dispositivo IoT.
Ignorar/excluir dispositivos antigos
Dispositivos nao mapeados de equipamentos antigos podem ser ignorados. Eles pararao de aparecer quando o dispositivo for desativado.
Solucao de Problemas Especifica por Protocolo
Problemas TCP Segway
Problemas comuns:
- Timeout de conexao
- Falha de autenticacao
- Incompatibilidade de firmware
Solucoes:
- Verifique se o dispositivo esta usando versao de firmware compativel
- Verifique conectividade de porta TCP (normalmente porta 8084)
- Verifique senha IoT Segway nas configuracoes
- Verifique se firewall esta bloqueando conexoes TCP
- Contate suporte Segway para atualizacoes de firmware
Problemas SMS Okai/Queclink
Problemas comuns:
- SMS nao entregue
- Respostas atrasadas (mais de 60 segundos)
- Comandos rejeitados
Solucoes:
- Verifique se capacidade SMS esta habilitada para o SIM
- Verifique saldo/cota do SIM para SMS de saida
- Verifique numero de telefone correto na configuracao do dispositivo
- Verifique por bloqueio de SMS no nivel da operadora
- Tente reenviar comando fora do horario de pico
Problemas MQTT ZIMO
Problemas comuns:
- Conexao MQTT cai
- Mensagens nao sao publicadas
- Erros de assinatura
Solucoes:
- Verifique credenciais do broker MQTT
- Verifique status e conectividade do broker
- Verifique se assinaturas de topico estao corretas
- Verifique por incompatibilidades de QoS
- Verifique logs do cliente MQTT por erros
Problemas SCOR Omni
Problemas comuns:
- Conexao WebSocket cai
- Atualizacoes em tempo real nao funcionam
- Erros de comunicacao bidirecional
Solucoes:
- Verifique status da conexao WebSocket
- Verifique compatibilidade de versao do protocolo SCOR
- Verifique por interferencia de proxy/firewall
- Verifique logs de conexao por codigos de erro
- Reinicie o servico IoT se necessario
Referencia de Codigos de Erro
Codigos de Erro IoT Comuns
| Codigo | Significado | Solucao |
|---|---|---|
| E01 | Autenticacao falhou | Verificar senha do dispositivo |
| E02 | Timeout de comando | Tentar comando novamente |
| E03 | Dispositivo ocupado | Aguardar 30 segundos, tentar novamente |
| E04 | Comando invalido | Verificar sintaxe do comando |
| E05 | Bateria baixa | Carregar antes de tentar novamente |
| E06 | GPS indisponivel | Mover para area com ceu aberto |
| E07 | Falha no mecanismo de trava | Inspecao fisica necessaria |
| E08 | Erro de comunicacao | Verificar conectividade |
| E09 | Erro de firmware | Atualizacao pode ser necessaria |
| E10 | Falha de hardware | Substituicao do dispositivo necessaria |
Interpretando Codigos de Erro de Telemetria
Ao visualizar telemetria, procure por:
- ACK - Comando confirmado com sucesso
- NAK - Comando rejeitado (verificar codigo de erro)
- TIMEOUT - Sem resposta do dispositivo
- ERROR_XXX - Codigo de erro reportado pelo dispositivo
Manutencao Preventiva
Verificacoes Diarias
- Revisar contagem de dispositivos offline
- Verificar dispositivos com timestamps "Ultimo visto" antigos
- Revisar lista de dispositivos nao mapeados
Verificacoes Semanais
- Verificar niveis de bateria dos dispositivos
- Revisar taxas de sucesso de comandos
- Verificar dispositivos em estado errado
Verificacoes Mensais
- Revisar versoes de firmware
- Auditar vinculos dispositivo-veiculo
- Verificar status de cartao SIM
- Revisar padroes de erro de dispositivos
Quando Substituir Dispositivos
Considere substituicao de dispositivo quando:
- Persistentemente offline por mais de 7 dias apesar da solucao de problemas
- Taxa de sucesso de comando consistentemente abaixo de 50%
- Dano fisico visivel (entrada de agua, dano de antena)
- Firmware nao pode ser atualizado para versao necessaria
- Bateria nao mantem carga (bateria IoT interna)
- GPS nunca obtem localizacao mesmo em areas abertas
Recursos de Suporte
Para suporte especifico de dispositivo:
- Segway: Contate equipe de suporte IoT Segway
- Okai: Contate suporte tecnico Okai
- Queclink: Contate atendimento ao cliente Queclink
- Problemas gerais: E-mail para support@levyelectric.com com IMEI do dispositivo e descricao do problema