Verificar e depurar

Para verificar e depurar a pilha Bluetooth, use as ferramentas fornecidas em Testes do AOSP e do Bluetooth Special Interest Group (SIG).

Testar e verificar

Para testar a pilha Bluetooth, o AOSP oferece uma combinação de testes de unidade, Testes de CTS e ferramentas para o Bluetooth Profile Tuning Suite.

Testes de unidade no AOSP

O AOSP inclui testes funcionais e de unidade para o padrão pilha de Bluetooth. Esses testes estão localizados em /packages/modules/Bluetooth/system/test/. Para executar os testes do AOSP, faça o seguinte:

  1. Interrompa o ambiente de execução do Android: 
    adb shell stop
  2. No diretório de teste, execute o arquivo executável do shell e inclua opções se quiser executar um teste ou pacote de testes específico: 
    ./run_unit_tests.sh TEST_GROUP_NAME TEST_NAME OPTIONS
  3. Quando os testes terminarem, reative o Android Runtime: 
    adb shell start

A lista de nomes de testes pode ser encontrada em /packages/modules/Bluetooth/system/test/README.md.

Pacote de ajuste de perfis

O Bluetooth SIG fornece o Bluetooth Profile Tuning Suite (PTS), uma ferramenta de teste para interoperabilidade de protocolo e perfil. Para mais informações, consulte a site do Pacote de ajuste de perfis Bluetooth.

Testes CTS

O conjunto de teste de compatibilidade (CTS) inclui testes para a pilha Bluetooth. Eles ficam neste local: cts/apps/CtsVerifier/src/com/android/cts/verifier/bluetooth.

Opções de depuração

O AOSP oferece diferentes métodos de depuração do Pilha Bluetooth, incluindo registros e relatórios de bugs. Esses métodos podem não funcione para problemas que não possam ser reproduzidos ou para problemas de áudio, que pode ser afetado por várias partes da plataforma e do dispositivo.

Como depurar com relatórios de bugs

Para conferir o status do serviço Bluetooth usando dumpsys: use este comando:

adb shell dumpsys bluetooth_manager

Por padrão, todas as mensagens de registro são de nível de trace 2. Para saber mais sobre os níveis de registro e alterar os níveis de registro Para perfis diferentes, procure em system/bt/conf/bt_stack.conf.

Para extrair os registros de espionagem do relatório do bug, use o btsnooz.

  1. Baixe o btsnooz.py.
  2. Extraia a versão em texto do relatório do bug.
  3. Execute btsnooz.py na versão em texto do relatório do bug: 
    btsnooz.py BUG_REPORT.txt > BTSNOOP.log

Como depurar com registros

No Android 4.4 e posterior, é possível coletar manualmente os registros do BTSnoop, semelhante ao formato de espionagem na RFC 1761. Esses registros capturam pacotes da Interface de controlador do host (HCI). Na maioria dos dispositivos Android, os registros são armazenados data/misc/bluetooth/logs:

Por motivos de privacidade, sempre ativado, "na memória" Registros somente do BTSnoop informações e eventos não pessoais. Para registrar todos os dados, o usuário precisa para ativar a espionagem do Bluetooth HCI da seguinte forma:

  1. Ative as Opções do desenvolvedor no dispositivo.
  2. No menu Opções do desenvolvedor, ative as Botão Ativar registro de rastreamento Bluetooth HCI.
  3. Reinicie o Bluetooth para que o registro entre em vigor.