測試、偵錯及調整 Wi-Fi

本頁面說明如何使用 AOSP 提供的工具測試、偵錯及調整 Wi-Fi 實作。

測試

為了測試 Wi-Fi 架構，Android 開放原始碼計畫提供單元測試和 CTS 測試。

單元測試

AOSP 包含預設 Wi-Fi 架構的功能和單元測試：針對 Wi-Fi 管理工具 (應用程式端程式碼) 和 Wi-Fi 服務。

Wi-Fi Manager 測試：

  • 位於packages/modules/Wifi/framework/tests/

  • 使用下列殼層可執行檔執行 (請參閱檔案，瞭解更多執行選項)：

    atest FrameworksWifiApiTests

Wi-Fi 服務測試：

  • 位於packages/modules/Wifi/service/tests/wifitests/

  • 使用下列殼層可執行檔執行 (請參閱檔案，瞭解更多執行選項)：

    atest FrameworksWifiTests

CTS 測試

Compatibility Test Suite (CTS) 包含 Wi-Fi 架構的測試。這些檔案位於 cts/tests/tests/net/src/android/net/wifi 中。Wi-Fi CTS 測試要求測試中的裝置在測試開始時與存取點建立關聯。

偵錯的強化記錄選項

Android 9 改善了 Wi-Fi 記錄功能，方便您更輕鬆地對 Wi-Fi 問題進行偵錯。在 Android 9 以上版本中，驅動程式或韌體環形緩衝區一律會開啟。偵測到不良狀態時，系統會自動觸發錯誤回報 (僅限 userdebug 和 eng 版本)。使用 Wi-Fi HAL (AIDL 或 HIDL 1.2 以上版本) 時，韌體偵錯緩衝區會儲存在 HAL 中，而非架構中，以節省 IPC 成本。

實作

如需實作參考資料，請參閱供應商 HAL 中的預設實作項目。

您可以將資源 config_wifi_enable_wifi_firmware_debugging 設為 false，停用韌體記錄功能。

手動測試

請執行這項手動測試，確認系統是否刪除墓碑目錄中的舊檔案。

  1. 開啟 Wi-Fi。
  2. 連線至網路。
  3. 產生錯誤報告。

  4. 檢查錯誤報告 ZIP 檔案，確認是否有封存的韌體記錄。記錄檔位於下列位置：

    • AIDL HAL：主要錯誤報告檔案的 dumpsys 部分
    • HIDL HAL：/lshal-debug/android.hardware.wifi@1.x::IWifi_default.txt

設定調整

為控制裝置連結或解除連結網路的信號強度，Wi-Fi 架構會使用進入和離開 RSSI 閾值。

進入和退出門檻會儲存為可過載的設定參數，並以以下名稱儲存 (其中 bad 參數是指退出 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 指令設定裝置，以便測試新的閾值。(或者，您也可以使用新的疊加層建立版本，但使用 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

如要還原內建參數值 (也就是移除覆寫值)，請使用下列 ADB 指令：

adb shell settings delete global wifi_score_params