Ponto de acesso Wi-Fi (AP suave)

O Android fornece suporte para ponto de acesso Wi-Fi (Soft AP), incluindo tethering por meio de um ponto de acesso Wi-FI e pontos de acesso Wi-Fi somente locais.

O recurso soft AP permite a configuração do seguinte:

  • SSID e BSSID
  • Tipo de segurança (incluindo WPA3)
  • SSID oculto
  • Banda operacional e canal (incluindo ACS)
  • Número máximo de clientes permitidos
  • Valor de tempo limite de desligamento automático
  • Lista de permissão e lista de bloqueio para permitir o controle do usuário de dispositivos associados
  • Nível de randomização MAC para o AP BSSID
  • 802.11ax e 802.11be

Os recursos do dispositivo determinam a disponibilidade desses controles. O Android 11 apresenta APIs para obter esses recursos. Os fabricantes de dispositivos também podem especificar os recursos básicos do dispositivo usando sobreposições.

Observe que algumas das APIs são APIs do sistema e são restritas por meio de permissões para que apenas o aplicativo Configurações do sistema possa acessá-las.

Desenvolvendo aplicativos com APIs de ponto de acesso

Uma implementação padrão de um ponto de acesso Wi-Fi conectado é fornecida pelo aplicativo AOSP Settings, mas não exerce todas as APIs para configuração de Soft AP.

Para oferecer suporte ao tethering por meio de um ponto de acesso ou ponto de acesso apenas local, o aplicativo deve executar as seguintes funções:

  1. Registre um retorno de chamada para obter os recursos do dispositivo usando WifiManager#registerSoftApCallback para um ponto de acesso conectado ou WifiManager#registerLocalOnlyHotspotSoftApCallback para um ponto de acesso somente local.

    O retorno de chamada SoftApCallback fornece os seguintes métodos:

    • SoftApCallback#onCapabilityChanged : Fornece informações sobre os recursos do dispositivo, incluindo o número máximo de clientes suportados e se SAE ou ACS são suportados.
    • SoftApCallback#onInfoChanged : Fornece informações sobre o Soft AP em execução (válido apenas uma vez iniciado), incluindo informações de banda e frequência.
    • SoftApCallback#onConnectedClientsChanged : Fornece uma lista de clientes conectados. Para cada cliente, você pode obter o endereço MAC. Para obter as informações de IP, use o retorno de chamada TetheringEventCallback#onClientsChanged .
    • SoftApCallback#onStateChanged : Fornece atualizações sobre o estado do Soft AP à medida que ele é habilitado e desabilitado.
    • SoftApCallback#onBlockedClientConnecting : Fornece as informações do cliente bloqueado com um dos seguintes motivos para o bloqueio: o dispositivo atingiu o número máximo de clientes que pode suportar ou o cliente não está explicitamente autorizado a se conectar.

Para um ponto de acesso conectado:

  1. Defina a configuração de soft AP para tethering chamando o método WifiManager#setSoftApConfiguration e fornecendo uma instância SoftApConfiguration . Construa SoftApConfiguration usando a classe SoftApConfiguration.Builder .
  2. Inicie o tethering chamando o método tethering em TetheringManager#startTethering .

Para ponto de acesso somente local:

  1. Inicie o ponto de acesso somente local com uma configuração de AP suave específica chamando o método WifiManager#startLocalOnlyHotspot .

Implementando listas de permissões e bloqueios

Um requisito típico da operadora é fornecer ao usuário controles dos dispositivos que podem ser associados ao Soft AP. Existem vários mecanismos para fazer isso:

  • Limite o número máximo de dispositivos que podem associar ao AP flexível usando SoftApConfiguration.Builder#setMaxNumberOfClients . Certifique-se de especificar um número inferior ao número máximo de clientes suportados pelo dispositivo. Você pode obter o número máximo de SoftApCapability#getMaxSupportedClients .

  • Forneça controle dinâmico usando listas de permissões e bloqueios:

    • A configuração padrão de um Soft AP permite que todos os dispositivos se associem ao soft AP, exceto para dispositivos cujos endereços MAC são adicionados a SoftApConfiguration.Builder#setBlockedClientList .

    • Se o Soft AP estiver configurado com SoftApConfiguration.Builder#setClientControlByUserEnabled( true ) , a lista de permissões será usada.

      • Todos os dispositivos cujos endereços MAC estão em SoftApConfiguration.Builder#setBlockedClientList são bloqueados para associação.
      • Todos os dispositivos cujos endereços MAC estão em SoftApConfiguration.Builder#setAllowedClientList têm permissão de associação.
      • Todos os outros dispositivos (ou seja, dispositivos cujos endereços MAC não estão na lista de permissão ou bloqueio) são bloqueados para associação, mas SoftApCallback#onBlockedClientConnecting é chamado, permitindo que o aplicativo de controle (ou seja, o aplicativo Configurações) execute uma ação, por por exemplo, pedindo a confirmação do usuário e, em seguida, adicionando o dispositivo à lista de permissões ou à lista de bloqueios, dependendo do comportamento do usuário.

    Observe que os dispositivos só podem usar a funcionalidade da lista de permissões se ela for compatível com o dispositivo. Você pode verificar o suporte do dispositivo usando SoftApCapability#areFeaturesSupported( SOFTAP_FEATURE_CLIENT_FORCE_DISCONNECT ) .

Implementação

Para dar suporte ao tethering por meio de um ponto de acesso ou para dar suporte a um ponto de acesso somente local, os fabricantes de dispositivos devem fornecer suporte ao aplicativo Settings, framework e HAL/firmware:

Costumização

Para personalizar a implementação, os fabricantes de dispositivos devem configurar as seguintes sobreposições e configurações de operadora, documentadas em packages/modules/Wifi/service/ServiceWifiResources/res/values/config.xml :

  • config_wifiFrameworkSoftApShutDownTimeoutMilliseconds : O intervalo de tempo limite de desligamento padrão. Válido apenas se SoftApConfiguration#setAutoShutdownEnabled estiver ativado. Pode ser substituído usando SoftApConfiguration#setShutdownTimeoutMillis .
  • config_wifiHardwareSoftapMaxClientCount : A limitação de hardware para o número máximo de clientes suportados. O número máximo de clientes que o dispositivo suporta é o mínimo das restrições de hardware e operadora (especificado por CarrierConfigManager.Wifi#KEY_HOTSPOT_MAX_CLIENT_COUNT ). O resultado final é fornecido ao aplicativo com SoftApCapabilities#getMaxSupportedClients .
  • config_wifiSofapClientForceDisconnectSupported : se o dispositivo tem a capacidade de forçar a desconexão de um cliente. Necessário para habilitar listas de permissões e bloqueios. Comunicado ao aplicativo de controle (aplicativo de configurações) por meio de SoftApCapabilities#areFeaturesSupported( SOFTAP_FEATURE_CLIENT_FORCE_DISCONNECT ) .
  • (Disponível a partir de 13) config_wifiSoftapPassphraseAsciiEncodableCheck : Se a senha do AP flexível deve ou não ser codificada em ASCII.
  • config_wifiSoftapAutoUpgradeToBridgedConfigWhenSupported : se deve ou não atualizar automaticamente a configuração de configuração de banda para bandas duplas durante a restauração da configuração de nuvem quando um novo dispositivo é suportado.
  • (Disponível a partir de 13) config_wifiSoftapAutoAppendLowerBandsToBandConfigurationEnabled : se a estrutura anexa automaticamente bandas inferiores à configuração de banda para evitar manipulação de coexistência.
  • config_wifiSoftApDynamicCountryCodeUpdateSupported : se a atualização dinâmica do código do país no modo AP é suportada ou não no dispositivo
  • Suporte de canal: config_wifiSoftap2gChannelList , config_wifiSoftap5gChannelList , config_wifiSoftap6gChannelList e config_wifiSoftap60gChannelList .
  • Restaurar suporte especificando se as entradas correspondentes são redefinidas para o padrão ao restaurar a configuração do ponto de acesso para um novo dispositivo: config_wifiSoftapResetChannelConfig , config_wifiSoftapResetHiddenConfig , config_wifiSoftapResetUserControlConfig , config_wifiSoftapResetAutoShutdownTimerConfig , config_wifiSoftapResetMaxClientSettingConfig . Observe que eles são definidos como true por padrão, o que significa que os valores são redefinidos. Isso é crítico se o novo dispositivo não for compatível com a configuração.
  • Recursos de hardware:
    • config_wifi_softap_acs_supported
    • config_wifi_softap_sae_supported
    • (Disponível a partir de 13) config_wifiSoftapOweTransitionSupported
    • (Disponível a partir de 13) config_wifiSoftapOweSupported
    • config_wifi_softap_ieee80211ac_supported
    • config_wifiSoftapIeee80211axSupported
    • (Disponível a partir de 13) config_wifiSoftapIeee80211beSupported
    • config_wifiSoftapMacAddressCustomizationSupported
    • config_wifiSoftapHeSuBeamformerSupported
    • config_wifiSoftapHeSuBeamformeeSupported
    • config_wifiSoftapHeMuBeamformerSupported
    • config_wifiSoftapHeTwtSupported
    • config_wifiSoftap24ghzSupported
    • config_wifiSoftap5ghzSupported
    • config_wifiSoftap6ghzSupported
    • config_wifiSoftap60ghzSupported
    • config_wifiSoftapAcsIncludeDfs

Validação

O Android fornece um conjunto de testes de unidade, testes de integração (Android Connectivity Test Suite ou ACTS) e testes de Compatibility Test Suite (CTS) para validar o recurso de ponto de acesso. O recurso de ponto de acesso também pode ser testado usando o Vendor Test Suite (VTS).

testes de unidade

Verifique o pacote de ponto de acesso usando os testes a seguir.

  • Testes de serviço:

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

  • Testes de gerente:

    atest packages/modules/Wifi/framework/tests/

Testes de integração (ACTS)

O conjunto de testes ACTS hotspot, localizado em tools/test/connectivity/acts_tests/tests/google/wifi/WifiSoftApTest.py , implementa testes funcionais do recurso hotspot.

Testes do Conjunto de Testes de Compatibilidade (CTS)

Use testes CTS para validar o recurso de ponto de acesso. O CTS detecta quando o recurso está habilitado e inclui automaticamente os testes associados.

Para acionar os testes CTS, execute:

atest android.net.wifi.cts.WifiManagerTest

Conjunto de teste do fornecedor (VTS)

Se a interface HIDL for implementada, execute:

atest VtsHalWifiHostapdV1_2Target

Se a interface AIDL for implementada, execute:

atest VtsHalHostapdTargetTest