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 Wi-Fi Manager (code côté application) et pour le service Wi-Fi.
Tests Wi-Fi Manager:
- Situé à
packages/modules/Wifi/framework/tests/
Exécutez-le à l'aide de l'exécutable suivant (lire le fichier pour accéder à d'autres options d'exécution):
atest FrameworksWifiApiTests
Tests du service Wi-Fi:
- Situé à
packages/modules/Wifi/service/tests/wifitests/
Exécutez-le à l'aide de l'exécutable suivant (lire le fichier pour accéder à d'autres 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 Wi-Fi CTS nécessitent d'associer l'appareil testé à 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 Wi-Fi pour faciliter le débogage des problèmes liés au Wi-Fi. Sous Android 9 ou version ultérieure, les tampons en anneau 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.
- Activez le Wi-Fi.
- Connectez-vous à un réseau.
- Générez un rapport de bug.
Inspectez le fichier ZIP du rapport de bug et vérifiez que les journaux archivés du micrologiciel existent. Les journaux se trouvent aux emplacements suivants:
- AIDL HAL: section
dumpsys
du fichier de rapport de bug principal - HIDL HAL:
/lshal-debug/android.hardware.wifi@1.x::IWifi_default.txt
- AIDL HAL: section
Réglage 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 d'entrée et de sortie sont stockés en tant que paramètres de configuration pouvant être surchargés et portent les noms suivants (où le paramètre bad
fait référence au seuil RSSI de 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
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
.
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ètres intégrées (c'est-à-dire supprimer les forçages), utilisez la commande adb suivante:
adb shell settings delete global wifi_score_params