Integracao IoT Omni

Dispositivos IoT Omni fornecem conectividade de veiculos atraves do protocolo SCOR TCP. Este guia cobre configuracao de dispositivos, comandos disponiveis, interpretacao de codigos de erro e opcoes de configuracao.

Visao Geral

Dispositivos IoT Omni se comunicam usando o protocolo SCOR, habilitando:

• Bloqueio/Desbloqueio - Controle remoto do veiculo
• Rastreamento de Localizacao - Atualizacoes de posicao GPS
• Monitoramento de Status - Dados de bateria, velocidade, hodometro
• Relatorio de Erros - Alertas de mau funcionamento do controlador
• Configuracoes do Veiculo - Farol, acelerador, modo de velocidade

Arquitetura do Protocolo

Painel Levy Fleets
         ↓
    Protocolo SCOR TCP
         ↓
    Dispositivo IoT Omni
         ↓
    Interface UART
         ↓
  Controlador do Veiculo

O dispositivo IoT traduz entre SCOR (TCP) e UART (Controlador), tratando o protocolo de comunicacao para ambas as direcoes.

Configuracao do Dispositivo

Adicionando um Dispositivo Omni

Informacoes do Dispositivo

Comandos do Protocolo SCOR

Bloquear e Desbloquear

Os comandos primarios para controle do veiculo:

Desbloquear Veiculo

*SCOS,OM,<IMEI>,S25,1,1,0#

Inicia o handshake R0 → L0 para desbloquear o patinete.

Bloquear Veiculo

*SCOS,OM,<IMEI>,S25,1,1,1#

Inicia o handshake R0 → L1 para bloquear o patinete.

Handshake de Chave de Operacao

Para operacoes manuais de bloqueio/desbloqueio, o protocolo SCOR usa uma troca de chaves:

Formato do Comando R0:

*SCOS,OM,<IMEI>,R0,<OPERACAO>,<VALIDADE_CHAVE>,<ID_USUARIO>,<TIMESTAMP>#

Status e Localizacao

Solicitar Status do Veiculo (S6)

*SCOS,OM,<IMEI>,S6#

Retorna nivel de bateria, estado de bloqueio, status de ignicao, velocidade e hodometro.

Solicitar Localizacao (D0)

*SCOS,OM,<IMEI>,D0#

Retorna coordenadas GPS com a ultima fixacao.

Configuracao de Heartbeat

Definir Configuracoes de Heartbeat (S5)

*SCOS,OM,<IMEI>,S5,0,<S6_DESBLOQUEADO>,<SEGUNDOS_HEARTBEAT>,<INTERVALO_S6>#

Configuracoes do Veiculo

Configurar Configuracoes do Veiculo (S7)

*SCOS,OM,<IMEI>,S7,<FAROL>,<MODO_VELOCIDADE>,<MODO_ACELERADOR>,<LUZ_TRASEIRA>#

Tons de Aviso

Acionar Aviso (V0)

*SCOS,OM,<IMEI>,V0,<CODIGO_TOM>#

Firmware e Diagnosticos

Obter Versao do Firmware (G0)

*SCOS,OM,<IMEI>,G0#

Retorna detalhes da versao do firmware do controlador.

Solicitar Codigos de Erro (E0)

*SCOS,OM,<IMEI>,E0#

Retorna codigos de erro atuais do controlador.

Codigos de Erro

Niveis de Gravidade de Erro

Codigos de Erro Comuns

Resposta de Codigo de Erro

Ao solicitar codigos de erro via E0, a resposta contem:

{
  "code": "4",
  "hex": "0x04",
  "description": "Problema no hall do motor",
  "severity": "critical",
  "userFriendlyMessage": "Mau funcionamento do sensor do motor - nao pilote",
  "technicalDetails": "Falha do sensor de efeito hall do motor detectada"
}

Acoes para Erros Criticos

Quando um erro critico e detectado:

1. Definir imediatamente para Manutencao - Remover da visualizacao do cliente
2. Registrar o erro - Gravar para rastreamento de manutencao
3. Alertar operacoes - Notificar equipe de campo
4. Agendar inspecao - Organizar verificacao fisica

Dados de Telemetria

Frame de Status S6

O frame S6 fornece status abrangente do veiculo:

Frame de Localizacao D0

O frame D0 fornece dados GPS:

Frequencia de Atualizacao de Dados

Operacoes do Painel

Enviando Comandos

Na pagina de detalhes do veiculo:

Visualizando Telemetria

O painel exibe telemetria em tempo real:

• Nivel de Bateria - Porcentagem de carga atual
• Status de Bloqueio - Indicador Bloqueado/Desbloqueado
• Ultima Localizacao - Coordenadas GPS e timestamp
• Velocidade - Velocidade atual ou ultima reportada
• Hodometro - Leitura de distancia total
• Status de Erro - Quaisquer codigos de erro ativos

Historico de Comandos

Visualize comandos recentes enviados ao dispositivo:

1. Va para Detalhes do Veiculo → IoT
2. Clique em Historico de Comandos
3. Revise comandos enviados e respostas
4. Verifique quaisquer comandos com falha

Solucao de Problemas

Dispositivo Nao Respondendo

Problemas de Conexao

1. Verificar ativacao do SIM - Garantir que plano celular esta ativo
2. Verificar sinal - Dispositivo precisa de cobertura adequada
3. Reiniciar - Pode resolver problemas temporarios
4. Atualizacao de firmware - Firmware desatualizado pode ter bugs

Falhas de Comando

Alertas de Codigo de Erro

Quando codigos de erro sao reportados:

1. Verificar gravidade - Erros criticos precisam atencao imediata
2. Revisar historico - E um problema recorrente?
3. Referenciar cruzado - Verificar anomalias de telemetria relacionadas
4. Agendar servico - Despachar tecnico se necessario

Melhores Praticas

Configuracao de Dispositivo

1. Habilitar S6 durante viagens - Definir S6_DESBLOQUEADO=2 para rastreamento de hodometro
2. Definir heartbeat apropriado - Equilibrar bateria vs. frescor de dados
3. Monitorar codigos de erro - Configurar alertas para erros criticos
4. Rastrear versoes de firmware - Manter dispositivos atualizados

Diretrizes Operacionais

1. Testar apos instalacao - Verificar se bloqueio/desbloqueio funciona
2. Monitorar novos dispositivos - Observar problemas iniciais
3. Verificacoes regulares de saude - Revisar conectividade de dispositivos
4. Documentar problemas - Rastrear problemas recorrentes

Consideracoes de Seguranca

1. Tratamento seguro de IMEI - Nao expor identificadores de dispositivos
2. Monitorar comandos incomuns - Observar acesso nao autorizado
3. Auditar logs de comandos - Revisar quem envia quais comandos
4. Atualizar credenciais - Rotacionar quaisquer segredos compartilhados

Referencia da API

Enviar Comando

POST /api/iot/scor
{
  "imei": "123456789012345",
  "command": "*SCOS,OM,123456789012345,S6#"
}

Resposta de Comando

{
  "success": true,
  "command_id": "cmd_abc123",
  "sent_at": "2025-01-15T10:30:00Z",
  "response": {
    "received": true,
    "data": { /* telemetria */ }
  }
}

Webhook de Telemetria

Atualizacoes de telemetria podem acionar webhooks:

{
  "event": "vehicle.location_updated",
  "data": {
    "vehicle_id": "uuid",
    "latitude": 40.7128,
    "longitude": -74.0060,
    "battery_percent": 85,
    "lock_status": 1
  }
}