Точка доступа Wi-Fi (программная точка доступа)

Android обеспечивает поддержку точки доступа Wi-Fi (Soft AP), включая привязку через точку доступа Wi-Fi и локальные точки доступа Wi-Fi.

Функция программной точки доступа позволяет настроить следующее:

  • SSID и BSSID
  • Тип безопасности (включая WPA3)
  • Скрытый SSID
  • Рабочий диапазон и канал (включая АСУ)
  • Максимальное количество разрешенных клиентов
  • Значение тайм-аута автоматического выключения
  • Список разрешенных и черный список, позволяющий пользователю контролировать связанные устройства.
  • Уровень рандомизации MAC для BSSID точки доступа
  • 802.11ax и 802.11be

Возможности устройства определяют доступность этих элементов управления. В Android 11 представлены API для получения этих возможностей. Производители устройств также могут указывать базовые возможности устройства с помощью наложений.

Обратите внимание, что некоторые из API являются системными API и ограничены разрешениями, поэтому доступ к ним может получить только приложение «Настройки системы».

Разрабатывайте приложения с помощью API-интерфейсов точек доступа.

Реализация привязанной точки доступа Wi-Fi по умолчанию предоставляется приложением «Настройки AOSP», однако оно не использует все API-интерфейсы для настройки программной точки доступа.

Для поддержки модема через точку доступа или локальную точку доступа приложение должно выполнять следующие функции:

  1. Зарегистрируйте обратный вызов, чтобы получить возможности устройства, используя WifiManager#registerSoftApCallback для привязанной точки доступа или WifiManager#registerLocalOnlyHotspotSoftApCallback для локальной точки доступа.

    Обратный вызов SoftApCallback предоставляет следующие методы:

    • SoftApCallback#onCapabilityChanged : предоставляет информацию о возможностях устройства, включая максимальное количество поддерживаемых клиентов, а также о том, поддерживаются ли SAE или ACS.
    • SoftApCallback#onInfoChanged : предоставляет информацию о работающей программной точке доступа (действительна только после запуска), включая информацию о полосе и частоте.
    • SoftApCallback#onConnectedClientsChanged : предоставляет список подключенных клиентов. Для каждого клиента вы можете получить MAC-адрес. Чтобы получить информацию об IP, используйте обратный вызов TetheringEventCallback#onClientsChanged .
    • SoftApCallback#onStateChanged : предоставляет обновления о состоянии программной точки доступа при ее включении и отключении.
    • SoftApCallback#onBlockedClientConnecting : предоставляет информацию о заблокированном клиенте по одной из следующих причин блокировки: устройство достигло максимального количества клиентов, которые оно может поддерживать, или клиент явно не авторизован для подключения.

Для привязанной точки доступа:

  1. Настройте мягкую конфигурацию точки доступа для привязки, вызвав метод WifiManager#setSoftApConfiguration и предоставив экземпляр SoftApConfiguration . Создайте SoftApConfiguration , используя класс SoftApConfiguration.Builder .
  2. Запустите привязку, вызвав метод привязки по адресу TetheringManager#startTethering .

Для локальной точки доступа:

  1. Запустите локальную точку доступа с определенной конфигурацией программной точки доступа, вызвав метод WifiManager#startLocalOnlyHotspot .

Внедрить списки разрешенных и заблокированных

Типичное требование оператора связи — предоставить пользователю элементы управления устройствами, которым разрешено подключаться к программной точке доступа. Для этого существует несколько механизмов:

  • Ограничьте максимальное количество устройств, которые могут быть связаны с программной точкой доступа, с помощью SoftApConfiguration.Builder#setMaxNumberOfClients . Обязательно укажите число, меньшее максимального количества клиентов, поддерживаемых устройством. Максимальное количество можно получить из SoftApCapability#getMaxSupportedClients .

  • Обеспечьте динамический контроль с помощью списков разрешений и блокировок:

    • Конфигурация программной точки доступа по умолчанию позволяет всем устройствам подключаться к программной точке доступа, за исключением устройств, MAC-адреса которых добавлены в SoftApConfiguration.Builder#setBlockedClientList .

    • Если программная точка доступа настроена с помощью SoftApConfiguration.Builder#setClientControlByUserEnabled( true ) , используется список разрешений.

      • Все устройства, MAC-адреса которых находятся в SoftApConfiguration.Builder#setBlockedClientList блокируются от ассоциации.
      • Всем устройствам, MAC-адреса которых указаны в SoftApConfiguration.Builder#setAllowedClientList , разрешена ассоциация.
      • Все остальные устройства (то есть устройства, MAC-адреса которых не включены в список разрешенных или заблокированных) блокируются от ассоциации, но вызывается SoftApCallback#onBlockedClientConnecting , что позволяет управляющему приложению (то есть приложению «Настройки») выполнить действие, например Например, запрос у пользователя подтверждения, а затем добавление устройства в список разрешенных или в список заблокированных в зависимости от поведения пользователя.

    Обратите внимание, что устройства могут использовать функцию списка разрешенных только в том случае, если она поддерживается на устройстве. Вы можете проверить поддержку устройства, используя SoftApCapability#areFeaturesSupported( SOFTAP_FEATURE_CLIENT_FORCE_DISCONNECT ) .

Выполнение

Для поддержки модема через точку доступа или поддержки локальной точки доступа производители устройств должны предоставить приложение «Настройки», платформу и поддержку HAL/прошивки:

Кастомизация

Чтобы настроить реализацию, производители устройств должны настроить следующие наложения и конфигурации оператора связи, которые описаны в packages/modules/Wifi/service/ServiceWifiResources/res/values/config.xml :

  • config_wifiFrameworkSoftApShutDownTimeoutMilliseconds : интервал ожидания завершения работы по умолчанию. Действует только в том случае, если включен SoftApConfiguration#setAutoShutdownEnabled . Можно переопределить с помощью SoftApConfiguration#setShutdownTimeoutMillis .
  • config_wifiHardwareSoftapMaxClientCount : аппаратное ограничение максимального количества поддерживаемых клиентов. Максимальное количество клиентов, которое поддерживает устройство, — это минимальное количество ограничений оборудования и оператора связи (указанное CarrierConfigManager.Wifi#KEY_HOTSPOT_MAX_CLIENT_COUNT ). Конечный результат предоставляется приложению с помощью SoftApCapabilities#getMaxSupportedClients .
  • config_wifiSofapClientForceDisconnectSupported : имеет ли устройство возможность принудительно отключить клиента. Требуется для включения списков разрешенных и заблокированных файлов. Обмен данными с управляющим приложением (приложением «Настройки») через SoftApCapabilities#areFeaturesSupported( SOFTAP_FEATURE_CLIENT_FORCE_DISCONNECT ) .
  • (Доступно с 13-й версии) config_wifiSoftapPassphraseAsciiEncodableCheck : требуется ли кодировка кодовой фразы программной точки доступа в формате ASCII.
  • config_wifiSoftapAutoUpgradeToBridgedConfigWhenSupported : следует ли автоматически обновлять конфигурацию настроек диапазона до двухдиапазона во время восстановления облачной конфигурации, когда поддерживается новое устройство.
  • (Доступно с версии 13) config_wifiSoftapAutoAppendLowerBandsToBandConfigurationEnabled : добавляет ли платформа автоматически нижние диапазоны к конфигурации диапазонов, чтобы избежать обработки сосуществования.
  • config_wifiSoftApDynamicCountryCodeUpdateSupported : поддерживается ли на устройстве динамическое обновление кода страны в режиме AP.
  • Поддержка каналов: config_wifiSoftap2gChannelList , config_wifiSoftap5gChannelList , config_wifiSoftap6gChannelList и config_wifiSoftap60gChannelList .
  • Поддержка восстановления, указывающая, сбрасываются ли соответствующие записи к значениям по умолчанию при восстановлении конфигурации точки доступа на новом устройстве: config_wifiSoftapResetChannelConfig , config_wifiSoftapResetHiddenConfig , config_wifiSoftapResetUserControlConfig , config_wifiSoftapResetAutoShutdownTimerConfig , config_wifiSoftapResetMaxClientSettingConfig . Обратите внимание, что по умолчанию для них установлено значение true , что означает, что значения сбрасываются. Это очень важно, если новое устройство не поддерживает данную конфигурацию.
  • Аппаратные возможности:
    • config_wifi_softap_acs_supported
    • config_wifi_softap_sae_supported
    • (Доступно с 13) config_wifiSoftapOweTransitionSupported
    • (Доступно с 13) config_wifiSoftapOweSupported
    • config_wifi_softap_ieee80211ac_supported
    • config_wifiSoftapIeee80211axSupported
    • (Доступно с 13) config_wifiSoftapIeee80211beSupported
    • config_wifiSoftapMacAddressCustomizationSupported
    • config_wifiSoftapHeSuBeamformerSupported
    • config_wifiSoftapHeSuBeamformeeSupported
    • config_wifiSoftapHeMuBeamformerSupported
    • config_wifiSoftapHeTwtSupported
    • config_wifiSoftap24ghzSupported
    • config_wifiSoftap5ghzSupported
    • config_wifiSoftap6ghzSupported
    • config_wifiSoftap60ghzSupported
    • config_wifiSoftapAcsIncludeDfs

Валидация

Android предоставляет набор модульных тестов и тестов совместимости (CTS) для проверки функции точки доступа. Функцию точки доступа также можно протестировать с помощью Vendor Test Suite (VTS).

Модульные тесты

Проверьте пакет точки доступа, используя следующие тесты.

  • Сервисные тесты:

    atest packages/modules/Wifi/service/tests/wifitests/

  • Менеджер тестирует:

    atest packages/modules/Wifi/framework/tests/

Тесты набора тестов совместимости (CTS)

Используйте тесты CTS для проверки функции точки доступа. CTS определяет, когда эта функция включена, и автоматически включает соответствующие тесты.

Чтобы запустить тесты CTS, запустите:

atest android.net.wifi.cts.WifiManagerTest

Набор тестов поставщиков (VTS)

Если интерфейс HIDL реализован, запустите:

atest VtsHalWifiHostapdV1_2Target

Если интерфейс AIDL реализован, запустите:

atest VtsHalHostapdTargetTest