本页介绍了如何使用 ASOP 中提供的工具测试、调试和调整 WLAN 实现。
测试
为了测试 Wi-Fi 框架,AOSP 提供了一系列单元测试和 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
CTS 测试
兼容性测试套件 (CTS) 包括针对 Wi-Fi 框架的测试。这些测试位于以下位置:cts/tests/tests/net/src/android/net/wifi
。WLAN CTS 测试要求在测试开始运行时将被测设备与接入点相关联。
针对调试的增强型日志记录选项
Android 9 改进了 Wi-Fi 日志记录功能,以便更轻松地调试 Wi-Fi 问题。在 Android 9 或更高版本中,驱动程序/固件环形缓冲区可以始终处于开启状态。检测到错误状态时,可以自动触发错误报告(仅限 userdebug build 和 eng build)。如果您使用的是 Wi-Fi HAL(AIDL 或 HIDL 1.2 版或更高版本),则固件调试缓冲区存储在 HAL 中而不是框架内,以节省 IPC 开销。
实现
有关参考实现,请参阅供应商 HAL 中的默认实现。
将资源 config_wifi_enable_wifi_firmware_debugging
设置为 false 可以停用固件日志记录。
手动测试
运行以下手动测试,以验证 tombstone 目录中的旧文件是否已被删除。
- 开启 WLAN。
- 连接到网络。
- 生成错误报告。
检查 bug 报告 ZIP 文件,并验证已归档的固件日志是否存在。日志位于以下位置:
- AIDL HAL:主 bug 报告文件的
dumpsys
部分 - HIDL HAL:
/lshal-debug/android.hardware.wifi@1.x::IWifi_default.txt
- AIDL HAL:主 bug 报告文件的
配置调整
为了控制设备在与网络建立关联和取消关联时采用的信号强度,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