Testar, depurar e ajustar o Wi-Fi

Esta página descreve como testar, depurar e ajustar a implementação do Wi-Fi usando as ferramentas fornecidas no AOSP.

Teste

Para testar o framework Wi-Fi, o AOSP oferece uma combinação de testes de unidade e do CTS.

Testes de unidade

O AOSP inclui testes funcionais e de unidade para o framework Wi-Fi padrão: tanto para o Wi-Fi Manager (código do lado do app) quanto para o serviço Wi-Fi.

Testes do gerenciador de Wi-Fi:

  • Localizado em packages/modules/Wifi/framework/tests/

  • Execute usando o seguinte executável de shell (leia o arquivo para mais opções de execução):

    atest FrameworksWifiApiTests

Testes do serviço de Wi-Fi:

  • Localizado em packages/modules/Wifi/service/tests/wifitests/

  • Execute usando o seguinte executável de shell (leia o arquivo para mais opções de execução):

    atest FrameworksWifiTests

Testes do CTS

O conjunto de teste de compatibilidade (CTS) inclui testes para o framework Wi-Fi. Eles estão localizados em cts/tests/tests/net/src/android/net/wifi. Os testes do CTS de Wi-Fi exigem que o dispositivo em teste esteja associado a um ponto de acesso no início da execução do teste.

Opções de registro aprimoradas para depuração

O Android 9 melhorou a geração de registros de Wi-Fi para facilitar a depuração de problemas de Wi-Fi. No Android 9 ou versões mais recentes, os buffers circulares de firmware ou driver podem estar sempre ativados. Os relatórios de bugs podem ser acionados automaticamente quando um estado ruim é detectado (somente em builds userdebug e eng). Quando a HAL do Wi-Fi (AIDL ou HIDL versão 1.2 ou mais recente) é usada, os buffers de depuração do firmware são armazenados na HAL em vez do framework para economizar custos de IPC.

Implementação

Para uma implementação de referência, consulte a implementação padrão no HAL do fornecedor.

Para desativar o registro de firmware, defina o recurso config_wifi_enable_wifi_firmware_debugging como "false".

Teste manual

Execute esse teste manual para verificar se os arquivos antigos no diretório de lápides estão sendo excluídos.

  1. Ative o Wi-Fi.
  2. Conecte-se a uma rede.
  3. Gere um relatório do bug.

  4. Inspecione o arquivo ZIP do relatório do bug e verifique se os registros de firmware arquivados existem. Os registros são encontrados nos seguintes locais:

    • HAL da AIDL: seção dumpsys do arquivo principal de bugreport
    • HIDL HAL: /lshal-debug/android.hardware.wifi@1.x::IWifi_default.txt

Ajuste de configuração

Para controlar a intensidade do sinal em que um dispositivo se associa ou se dissocia de uma rede, o framework Wi-Fi usa os limites de RSSI de entrada e saída.

Os limites de entrada e saída são armazenados como parâmetros de configuração substituíveis com os seguintes nomes (em que o parâmetro bad se refere ao limite de RSSI de saída):

  • config_wifi_framework_wifi_score_bad_rssi_threshold_5GHz
  • config_wifi_framework_wifi_score_entry_rssi_threshold_5GHz
  • config_wifi_framework_wifi_score_bad_rssi_threshold_24GHz
  • config_wifi_framework_wifi_score_entry_rssi_threshold_24GHz

Os parâmetros são armazenados em <root>/frameworks/base/core/res/res/values/config.xml e podem ser sobrecarregados usando o arquivo de sobreposição <root>/device/<dev_dir>/overlay/frameworks/base/core/res/res/values/config.xml.

Você pode testar novos limites configurando o dispositivo com comandos adb. Como alternativa, crie um build com novas sobreposições, mas use comandos adb para agilizar o teste.

adb shell settings put global wifi_score_params \
                             [rssi2|rssi5]=<bad>:<entry>:<low>:<good>

Por exemplo, o comando a seguir configura novos parâmetros de limite. Os valores usados neste comando de amostra são os padrões configurados na base de código do AOSP:

adb shell settings put global wifi_score_params \
                       rssi2=-85:-85:-73:-60,rssi5=-82:-82:-70:-57

Para restaurar os valores de parâmetro integrados (ou seja, remover as substituições), use o seguinte comando adb:

adb shell settings delete global wifi_score_params