Testare, eseguire il debug e ottimizzare il Wi-Fi

In questa pagina viene descritto come testare, eseguire il debug e ottimizzare l'implementazione del Wi-Fi utilizzando gli strumenti forniti in AOSP.

Test

Per testare il framework Wi-Fi, AOSP fornisce un mix di test delle unità e CTS.

Test delle unità

AOSP include test delle funzionalità e delle unità per il framework Wi-Fi predefinito: sia per Wi-Fi Manager (codice lato app) sia per il servizio Wi-Fi.

Test di Wi-Fi Manager:

• Si trova presso packages/modules/Wifi/framework/tests/

• Esegui utilizzando la seguente shell eseguibile (leggi il file per ulteriori opzioni di esecuzione):

  atest FrameworksWifiApiTests
  

Test del servizio Wi-Fi:

• Si trova presso packages/modules/Wifi/service/tests/wifitests/

• Esegui utilizzando la seguente shell eseguibile (leggi il file per ulteriori opzioni di esecuzione):

  atest FrameworksWifiTests
  

Test CTS

La Compatibility Test Suite (CTS) include test per il framework Wi-Fi. Questi si trovano in cts/tests/tests/net/src/android/net/wifi. I test CTS Wi-Fi richiedono l'associazione del dispositivo in fase di test a un punto di accesso all'inizio dell'esecuzione del test.

Opzioni di logging avanzate per il debug

Android 9 ha migliorato il logging del Wi-Fi per semplificare il debug dei problemi relativi al Wi-Fi. In Android 9 o versioni successive, i buffer di anello del driver o del firmware possono essere sempre attivi. Le segnalazioni di bug possono essere attivate automaticamente quando viene rilevato uno stato non valido (solo nelle build userdebug ed eng). Quando si utilizza l'HAL Wi-Fi (AIDL o HIDL versione 1.2 o successive), i buffer di debug del firmware vengono memorizzati nell'HAL anziché nel framework per risparmiare sui costi IPC.

Implementazione

Per un'implementazione di riferimento, consulta l'implementazione predefinita nell'HAL del fornitore.

Puoi disabilitare il logging del firmware impostando la risorsa config_wifi_enable_wifi_firmware_debugging su false.

Test manuale

Esegui questo test manuale per verificare che i file precedenti nella directory tombstone vengano eliminati.

1. Attiva il Wi-Fi.
2. Collegati a una rete.
3. Genera una segnalazione di bug.

4. Controlla il file ZIP della segnalazione di bug e verifica che esistano i log del firmware archiviati. I log si trovano nelle seguenti posizioni:

   • AIDL HAL: sezione dumpsys del file principale della segnalazione di bug
   • HIDL HAL: /lshal-debug/android.hardware.wifi@1.x::IWifi_default.txt

Ottimizzazione della configurazione

Per controllare l'intensità del segnale con cui un dispositivo si associa o si dissoci da una rete, il framework Wi-Fi utilizza le soglie RSSI entry e exit.

Le soglie entry ed exit sono archiviate come parametri di configurazione sovraccabili con i seguenti nomi (in cui il parametro bad si riferisce alla soglia RSSI exit):

• 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

I parametri vengono memorizzati in <root>/frameworks/base/core/res/res/values/config.xml e potrebbero essere sovraccaricati dal file dell'overlay <root>/device/<dev_dir>/overlay/frameworks/base/core/res/res/values/config.xml.

Nota: i parametri di configurazione bad (per le bande a 2,4 GHz e 5 GHz) sono stati introdotti nelle versioni precedenti ad Android 8.1. I parametri di configurazione entry sono stati introdotti in Android 8.1 con i valori predefiniti corrispondenti ai parametri non validi corrispondenti. Queste impostazioni predefinite comportano un comportamento precedente ad Android 8.1 in cui non viene utilizzata alcuna isteresi nella selezione della rete. Per sfruttare la funzionalità di isteresi introdotta in Android 8.1, imposta i parametri entry su 3 dB o più superiori ai parametri bad utilizzando il file overlay specificato sopra.

Puoi testare nuove soglie configurando il dispositivo tramite i comandi ADB. In alternativa, puoi creare una build con nuovi overlay, ma l'utilizzo dei comandi adb consente di velocizzare i tempi di test.

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

Ad esempio, il seguente comando configura nuovi parametri di soglia (i valori utilizzati in questo comando di esempio sono i valori predefiniti configurati nel codebase AOSP):

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

Per ripristinare i valori dei parametri integrati (ovvero rimuovere gli override), utilizza il seguente comando adb:

adb shell settings delete global wifi_score_params