测试、调试和调整 WLAN

本页介绍了如何使用 ASOP 中提供的工具测试、调试和调整 WLAN 实现。

测试

为了测试 WLAN 框架,AOSP 提供了一系列单元测试、集成测试 (ACTS) 和 CTS 测试。

单元测试

AOSP 包括针对默认 WLAN 框架的功能测试和单元测试:这两项测试均适用于 WLAN Manager(应用端代码)和 WLAN 服务。

WLAN 管理器测试:

  • 位于 packages/modules/Wifi/framework/tests/
  • 使用以下 shell 可执行文件运行(有关更多执行选项,请参阅文件):

    atest FrameworksWifiApiTests
    

WLAN 服务测试:

  • 位于 packages/modules/Wifi/service/tests/wifitests/
  • 使用以下 shell 可执行文件运行(有关更多执行选项,请参阅文件):

    atest FrameworksWifiTests
    

Android 通讯测试套件

Android 通讯测试套件 (ACTS) 可以对连接堆栈(例如 WLAN、蓝牙和移动网络服务)自动进行测试。该测试工具需要 adb 和 Python,您可以在以下位置找到该工具:tools/test/connectivity/acts

您可以在以下位置找到针对 WLAN 的 ACTS 测试:tools/test/connectivity/acts_tests/tests/google/wifi,而且同一目录下还包含以下示例测试配置:example_config.json

CTS 测试

兼容性测试套件 (CTS) 包括针对 Wi-Fi 框架的测试。这些测试位于以下位置:cts/tests/tests/net/src/android/net/wifi。WLAN CTS 测试要求在测试开始运行时将被测设备与接入点相关联。

针对调试的增强型日志记录选项

Android 9 改进了 WLAN 日志记录功能,以便更轻松地调试 WLAN 问题。在 Android 9 或更高版本中,驱动程序/固件环形缓冲区可以始终处于开启状态。检测到错误状态时,可以自动触发错误报告(仅限 userdebug build 和 eng build)。如果您使用的是 WLAN HAL(1.2 版或更高版本),则固件调试缓冲区存储在 HAL 中而不是框架内,以节省 IPC 开销。

实现

如需查看参考实现,请参阅供应商 HAL 中的默认实现

将资源 config_wifi_enable_wifi_firmware_debugging 设置为 false 可以停用固件日志记录。

集成测试 (ACTS)

您可以在以下位置找到集成测试:/tools/test/connectivity/acts_tests/tests/google/wifi/WifiDiagnosticsTest.py

对于 userdebug build,已验证的固件转储会保留在闪存中相应的 tombstone 目录下。在创建 bug 报告时,Dumpstate 从这个目录收集相应信息。

手动测试

运行以下手动测试,以验证 tombstone 目录中的旧文件是否已被删除。

  1. 开启 WLAN。
  2. 连接到网络。
  3. 生成错误报告
  4. 检查 bugreport zip 文件并验证 /lshal-debug/android.hardware.wifi@1.2__IWifi_default.txt 中是否包含已归档的固件日志。

配置调整

为了控制设备在与网络建立关联和取消关联时采用的信号强度,Wi-Fi 框架使用了“entry”和“exit”RSSI 阈值。

系统会将“entry”和“exit”阈值存储为可重载的配置参数,并使用以下名称(其中 bad 参数是指“exit”RSSI 阈值):

  • 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

这些参数存储在 <root>/frameworks/base/core/res/res/values/config.xml 中,您可以使用覆盖文件 <root>/device/<dev_dir>/overlay/frameworks/base/core/res/res/values/config.xml 重载这些参数。

您可以使用 adb 命令配置设备,对新的阈值进行测试。(或者,您也可以使用新的覆盖文件创建一个 build,但使用 adb 命令可以加快测试周期)。

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

例如,以下命令可以配置新的阈值参数(此示例命令中使用的值是 AOSP 代码库中配置的默认值):

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

如需恢复内置的参数值(即取消替换),请使用以下 abd 命令:

adb shell settings delete global wifi_score_params