Тестирование, отладка и настройка Wi-Fi

На этой странице описывается, как тестировать, отлаживать и настраивать реализацию Wi-Fi с помощью инструментов, предоставленных в AOSP.

Тестирование

Для тестирования инфраструктуры Wi-Fi AOSP предоставляет сочетание модульных тестов и тестов 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.

Выполнение

Для справочной реализации см. реализацию по умолчанию в Vendor 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