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

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

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

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

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

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

Разработка приложений с API точек доступа

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Выполнение

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

  • Приложение «Настройки»: приложение «Настройки AOSP» предоставляет базовые возможности для настройки точки доступа с помощью SSID и учётных данных безопасности. Этот код можно использовать как есть или модифицировать для расширения возможностей, как описано в разделе «Разработка приложений с API точек доступа» .

  • Фреймворк: Код фреймворка AOSP поддерживает все функции, описанные в разделе Разработка приложений с API точек доступа .

  • HAL/прошивка для точки доступа: либо HIDL IHostapd.hal версии 1.2 или выше, либо AIDL IHostapd.aidl .

Настройка

Чтобы настроить реализацию, производители устройств должны настроить следующие наложения и конфигурации несущих, которые задокументированы в 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 : Поддерживается ли на устройстве динамическое обновление кода страны в режиме точки доступа.
  • Поддержка каналов: 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 предоставляет набор модульных тестов и тестов Compatibility Test Suite (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