Saiba como coletar informações de depuração de telefones IP Android, como GP32i, BX7A, BF600S, BJ7A e Bi56A, incluindo syslog, pacotes de depuração, capturas de pacotes, logs ADB e capturas de tela.
Quando ocorre um problema durante testes internos ou implantação em cliente de telefones IP Android, a equipe técnica pode precisar fornecer informações de depuração para solução de problemas e análise. Este guia explica como coletar os arquivos de diagnóstico necessários.
GP32i, BX7A, BF600S, BJ7A, Bi56A
1. Preparar um telefone IP Android, um pendrive USB e um switch PoE ou fonte de alimentação DC. Conectar o telefone ao switch.
2. Preparar um PC para depuração e conectá-lo ao mesmo switch. Certificar-se de que o PC e o telefone possam se comunicar pela rede.
Conectar o telefone IP Android (usa-se o A32i como exemplo aqui) ao switch, e conectar o PC ao mesmo switch. Certificar-se de que a rede entre o PC e o dispositivo esteja acessível. O exemplo de conexão é mostrado na Figura 1.
Figura 1. Diagrama de conexão do dispositivo e do PC
Dependendo do problema, diferentes tipos de informações de diagnóstico podem ser necessários para análise. As seções a seguir explicam quais arquivos devem ser fornecidos em diferentes circunstâncias.
Na maioria dos casos, três arquivos devem ser coletados e fornecidos à equipe de P&D:
1. Arquivo Syslog de depuração
Acessar a interface web do telefone e ir para System > Support Page, então encontrar System Log.
Configurar as seguintes configurações:
1) Habilitar Syslog
2) Definir o Endereço do servidor como o endereço IP do PC local
3) Definir a Porta do servidor como 514
4) Definir o Nível de log do sistema como Debug
5) Habilitar Exportar log
6) Após reproduzir o problema, clicar em Exportar log para baixar o arquivo Syslog
Figura 2. Exportando o syslog de depuração
2. Pacote de depuração
O pacote de depuração contém logs em cache, informações de execução, detalhes de firmware e outros dados de diagnóstico internos do telefone. Ele pode ser exportado da interface web.
Ir para System > Support Tool, encontrar a opção Exportar informações de depuração com um clique e clicar em Exportar. Este processo pode levar cerca de um minuto para ser concluído.
Figura 3. Exportando o pacote de depuração
3. Arquivo de captura de pacotes de rede
Um arquivo de captura de pacotes registra os pacotes de rede transmitidos e recebidos e pode ser usado para análise em ferramentas como o Wireshark.
Para capturar o tráfego de rede:
1) Clicar em Iniciar e aguardar a página da web iniciar o processo de captura
2) Reproduzir o problema
3) Após reproduzir o problema, clicar em Parar
4) Abrir a página de downloads do navegador para localizar o arquivo de pacotes capturados
Figura 4. Capturando pacotes de rede
Após fornecer os três arquivos descritos acima, informações adicionais ainda podem ser necessárias em algumas situações.
Após revisar o Syslog de depuração, o pacote de depuração e a captura de pacotes, a equipe de P&D pode solicitar logs em tempo real do Android para apoiar uma análise mais aprofundada. A seção a seguir explica como coletar logs em tempo real do Android usando o ADB.
Log em tempo real do Android
A plataforma Android emite continuamente logs de execução enquanto o telefone está funcionando. Esses logs podem ajudar os engenheiros a identificar e analisar problemas.
1. Instalar a ferramenta ADB no PC
Você pode baixar a ferramenta ADB apropriada para seu sistema operacional em:
https://developer.android.google.cn/studio/releases/platform-tools
Após a instalação, adicione o caminho de instalação do ADB às variáveis de ambiente do sistema. No Windows, vá para Este PC > Propriedades > Configurações avançadas do sistema > Avançado > Variáveis de Ambiente, então adicione o caminho absoluto do diretório ADB à variável Path.
Figura 5. Adicionando o caminho do ADB
Abra um prompt de comando no PC e insira o comando adb. Se o comando for executado com sucesso, o ADB foi instalado corretamente.
Figura 6. Instalação bem-sucedida do ADB
2. Habilitar a depuração USB no telefone
Para o firmware Android lançado após 1º de dezembro de 2020, a depuração ADB está desabilitada por padrão e deve ser habilitada manualmente.
Insira um pendrive USB no telefone, depois vá para Configurações > Sobre o dispositivo e toque cinco vezes no número de versão do firmware para habilitar o Modo Desenvolvedor.
Figura 7. Habilitando o modo desenvolvedor
Depois vá para Configurações > Sistema > Opções de Desenvolvedor e ligue o Depuração USB.
Figura 8. Habilitando a depuração USB
3. Alterar o nível de log de depuração
O nível de log padrão do telefone é normalmente definido como Notice, que registra apenas informações essenciais. Para capturar logs mais detalhados, altere o nível de log para Trace.
Vá para Configurações do telefone > Manutenção do sistema > Ferramentas e defina o nível de log como Trace.
Figura 9. Alterando o nível de log
4. Capturar logs em tempo real
Use os seguintes comandos ADB:
adb connect 172.18.8.28
Substitua 172.18.8.28 pelo endereço IP real do telefone. Este comando se conecta ao telefone pela rede.
adb devices
Este comando lista os dispositivos conectados e permite verificar se o telefone está conectado com sucesso.
adb logcat -G 16M
Este comando aumenta o tamanho do buffer de log para que mais conteúdo de log possa ser armazenado.
adb logcat > logcat-202111051708.log
Este comando salva a saída do log em tempo real em um arquivo no PC. Um formato de nomenclatura recomendado é: ano + mês + dia + hora + minuto + segundo + .log
Figura 10. Capturando logs em tempo real
Após a conclusão do log, execute:
adb disconnect 172.18.8.28
Isso desconecta o PC do telefone. Você pode então encontrar o arquivo de log em tempo real gerado no diretório correspondente do seu PC.
Figura 11. Caminho do arquivo de log em tempo real
Se o problema estiver relacionado à tela LCD ou ao comportamento de exibição, um arquivo de captura de tela também deve ser fornecido.
Acesse a interface web do telefone e vá para System > Support Page, então encontre Screen Screenshot. Clique em Salvar imagem para baixar e salvar a captura de tela.
Figura 12. Salvando uma captura de tela
