Testez, déboguez et réglez le Wi-Fi

Cette page explique comment tester, déboguer et régler l'implémentation du Wi-Fi à l'aide des outils fournis dans AOSP.

Tests

Pour tester le framework Wi-Fi, AOSP propose une combinaison de tests unitaires et de tests CTS.

Tests unitaires

AOSP inclut des tests fonctionnels et unitaires pour le framework Wi-Fi par défaut, à la fois pour le Gestionnaire Wi-Fi (code côté application) et le service Wi-Fi.

Tests du Gestionnaire Wi-Fi:

• Situé à packages/modules/Wifi/framework/tests/

• Exécutez à l'aide de l'exécutable shell suivant (consultez le fichier pour en savoir plus sur les options d'exécution):

  atest FrameworksWifiApiTests
  

Tests du service Wi-Fi:

• Situé à packages/modules/Wifi/service/tests/wifitests/

• Exécutez à l'aide de l'exécutable shell suivant (consultez le fichier pour en savoir plus sur les options d'exécution):

  atest FrameworksWifiTests
  

Tests CTS

La suite de tests de compatibilité (CTS) inclut des tests pour le framework Wi-Fi. Ils se trouvent dans cts/tests/tests/net/src/android/net/wifi. Les tests CTS Wi-Fi exigent que l'appareil testé soit associé à un point d'accès au début de l'exécution du test.

Options de journalisation améliorées pour le débogage

Android 9 a amélioré la journalisation du Wi-Fi pour faciliter le débogage des problèmes de Wi-Fi. Sous Android 9 ou version ultérieure, les tampons de sonnerie du pilote ou du micrologiciel peuvent toujours être activés. Les rapports de bug peuvent être automatiquement déclenchés lorsqu'un état incorrect est détecté (uniquement dans les builds userdebug et eng). Lorsque le HAL Wi-Fi (AIDL ou HIDL version 1.2 ou ultérieure) est utilisé, les tampons de débogage du micrologiciel sont stockés dans le HAL plutôt que dans le framework pour réduire les coûts d'IPC.

Implémentation

Pour une implémentation de référence, consultez l'implémentation par défaut dans la HAL du fournisseur.

Vous pouvez désactiver la journalisation du micrologiciel en définissant la ressource config_wifi_enable_wifi_firmware_debugging sur "false".

Test manuel

Exécutez ce test manuel pour vérifier que les anciens fichiers du répertoire tombstone sont bien supprimés.

1. Activez le Wi-Fi.
2. Connectez-vous à un réseau.
3. Générez un rapport de bug.

4. Inspectez le fichier ZIP du rapport de bug et vérifiez que les journaux de micrologiciel archivés existent. Les journaux se trouvent aux emplacements suivants:

   • AIDL HAL: section dumpsys du fichier bugreport principal
   • HIDL HAL: /lshal-debug/android.hardware.wifi@1.x::IWifi_default.txt

Ajustement de la configuration

Pour contrôler l'intensité du signal à partir duquel un appareil s'associe à un réseau ou s'en dissocie, le framework Wi-Fi utilise les seuils RSSI d'entrée et de sortie.

Les seuils entrée et sortie sont stockés en tant que paramètres de configuration surchargeables avec les noms suivants (le paramètre bad fait référence au seuil RSSI de sortie):

• 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

Les paramètres sont stockés dans <root>/frameworks/base/core/res/res/values/config.xml et peuvent être surchargés à l'aide du fichier de superposition <root>/device/<dev_dir>/overlay/frameworks/base/core/res/res/values/config.xml.

Remarque :Les paramètres de configuration bad (pour les bandes 2,4 GHz et 5 GHz) ont été introduits avant Android 8.1. Les paramètres de configuration entry ont été introduits dans Android 8.1 avec des valeurs par défaut égales aux paramètres incorrects correspondants. Ces valeurs par défaut entraînent un comportement antérieur à Android 8.1, où aucune hystérésis n'est utilisée dans la sélection de réseau. Pour profiter de la fonctionnalité d'hystérèse introduite dans Android 8.1, définissez les paramètres entry sur 3 dB ou plus au-dessus des paramètres bad à l'aide du fichier de superposition spécifié ci-dessus.

Vous pouvez tester de nouveaux seuils en configurant l'appareil à l'aide de commandes adb. Vous pouvez également créer un build avec de nouvelles superpositions, mais les commandes adb permettent de réaliser des tests plus rapidement.

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

Par exemple, la commande suivante configure de nouveaux paramètres de seuil (les valeurs utilisées dans cet exemple de commande sont les valeurs par défaut configurées dans le codebase AOSP):

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

Pour restaurer les valeurs de paramètre intégrées (c'est-à-dire supprimer les forçages), utilisez la commande adb suivante:

adb shell settings delete global wifi_score_params