Точка доступа 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/прошивки:

• Приложение «Настройки». Приложение «Настройки 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 предоставляет набор модульных тестов и тестов совместимости (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