Hotspot de Wi-Fi (PA secundario)

Android admite hotspots de Wi-Fi (AP en segundo plano), incluida la conexión mediante dispositivo móvil a través de hotspots de Wi-Fi y hotspots de Wi-Fi solo locales.

La función de AP virtual permite configurar lo siguiente:

  • SSID y BSSID
  • Tipo de seguridad (incluido WPA3)
  • SSID oculto
  • Banda y canal de operación (incluido ACS)
  • Cantidad máxima de clientes permitidos
  • Valor de tiempo de espera para el cierre automático
  • Lista de dispositivos permitidos y bloqueados para que los usuarios controlen los dispositivos asociados
  • Nivel de aleatorización de MAC para el BSSID del AP
  • 802.11ax y 802.11be

Las capacidades del dispositivo determinan la disponibilidad de estos controles. Android 11 presenta APIs para obtener estas capacidades. Los fabricantes de dispositivos también pueden especificar las capacidades básicas del dispositivo con superposiciones.

Ten en cuenta que algunas de las APIs son del sistema y están restringidas a través de permisos para que solo la app de Configuración del sistema pueda acceder a ellas.

Desarrolla apps con las APIs de hotspots

La app de configuración de AOSP proporciona una implementación predeterminada de un hotspot de Wi-Fi con conexión mediante dispositivo móvil. Sin embargo, no usa todas las APIs para la configuración de AP en segundo plano.

Para admitir la conexión mediante un hotspot o un hotspot solo local, la app debe realizar las siguientes funciones:

  1. Registra una devolución de llamada para obtener las capacidades del dispositivo con WifiManager#registerSoftApCallback para un hotspot con dispositivo móvil o WifiManager#registerLocalOnlyHotspotSoftApCallback para un hotspot solo local.

    La devolución de llamada SoftApCallback proporciona los siguientes métodos:

    • SoftApCallback#onCapabilityChanged: Proporciona información sobre las capacidades del dispositivo, incluida la cantidad máxima de clientes compatibles y si se admiten SAE o ACS.
    • SoftApCallback#onInfoChanged: Proporciona información sobre el AP virtual en ejecución (solo es válida una vez que se inicia), incluida la información de banda y frecuencia.
    • SoftApCallback#onConnectedClientsChanged: Proporciona una lista de clientes conectados. Para cada cliente, puedes obtener la dirección MAC. Para obtener la información de IP, usa la devolución de llamada TetheringEventCallback#onClientsChanged.
    • SoftApCallback#onStateChanged: Proporciona actualizaciones sobre el estado del AP virtual a medida que se habilita y se inhabilita.
    • SoftApCallback#onBlockedClientConnecting: Proporciona la información del cliente bloqueado con uno de los siguientes motivos del bloqueo: el dispositivo alcanzó la cantidad máxima de clientes que puede admitir o el cliente no tiene autorización explícita para conectarse.

Para un hotspot con conexión mediante dispositivo móvil:

  1. Para configurar el AP virtual para el uso compartido de la conexión, llama al método WifiManager#setSoftApConfiguration y proporciona una instancia de SoftApConfiguration. Crea SoftApConfiguration con la clase SoftApConfiguration.Builder.
  2. Para iniciar el tethering, llama al método de tethering en TetheringManager#startTethering.

Para hotspot solo local:

  1. Para iniciar el hotspot solo local con una configuración específica de AP virtual, llama al método WifiManager#startLocalOnlyHotspot.

Implementa listas de entidades permitidas y bloqueadas

Un requisito típico de los operadores es proporcionarle al usuario controles de los dispositivos que se pueden asociar al AP virtual. Existen varios mecanismos para hacerlo:

  • Limita la cantidad máxima de dispositivos que se pueden asociar al AP virtual con SoftApConfiguration.Builder#setMaxNumberOfClients. Asegúrate de especificar un número que sea inferior a la cantidad máxima de clientes que admite el dispositivo. Puedes obtener la cantidad máxima en SoftApCapability#getMaxSupportedClients.

  • Proporciona un control dinámico con listas de entidades permitidas y bloqueadas:

    • La configuración predeterminada de un PA secundario permite que todos los dispositivos se asocien a él, excepto los dispositivos cuyas direcciones MAC se agregan a SoftApConfiguration.Builder#setBlockedClientList.

    • Si el PA secundario se configura con SoftApConfiguration.Builder#setClientControlByUserEnabled(true), se usa la lista de permitidos.

      • Se bloquea la asociación de todos los dispositivos cuyas direcciones MAC se encuentran en SoftApConfiguration.Builder#setBlockedClientList.
      • Se permite la asociación de todos los dispositivos cuyas direcciones MAC están en SoftApConfiguration.Builder#setAllowedClientList.
      • Todos los demás dispositivos (es decir, aquellos cuyas direcciones MAC no están en la lista de direcciones permitidas o bloqueadas) están bloqueados, pero se llama a SoftApCallback#onBlockedClientConnecting, lo que permite que la app de control (es decir, la app de Configuración) realice una acción, por ejemplo, solicitarle confirmación al usuario y, luego, agregar el dispositivo a la lista de entidades permitidas o bloqueadas, según su comportamiento.

    Ten en cuenta que los dispositivos solo pueden usar la funcionalidad de la lista de entidades permitidas si esta es compatible con ellos. Puedes verificar la compatibilidad del dispositivo con SoftApCapability#areFeaturesSupported(SOFTAP_FEATURE_CLIENT_FORCE_DISCONNECT).

Implementación

Para admitir la conexión mediante un hotspot o un hotspot solo local, los fabricantes de dispositivos deben proporcionar compatibilidad con la app de Configuración, el framework y la HAL o el firmware:

  • App de configuración: La app de Configuración del AOSP proporciona un modelo de referencia para configurar un hotspot de conexión mediante dispositivo móvil con SSID y credenciales de seguridad. Este código se puede usar como está o modificarse para proporcionar capacidades adicionales, como se describe en Cómo desarrollar apps con las APIs de hotspot.

  • Framework: El código del framework del AOSP admite todas las funciones que se describen en Cómo desarrollar apps con APIs de hotspot.

  • HAL o firmware para hotspot: HIDL IHostapd.hal versión 1.2 o posterior, o AIDL IHostapd.aidl

Personalización

Para personalizar la implementación, los fabricantes de dispositivos deben configurar las siguientes superposiciones y configuraciones de operador, que se documentan en packages/modules/Wifi/service/ServiceWifiResources/res/values/config.xml:

  • config_wifiFrameworkSoftApShutDownTimeoutMilliseconds: Es el intervalo de tiempo de espera de apagado predeterminado. Solo es válido si SoftApConfiguration#setAutoShutdownEnabled está habilitado. Se puede anular con SoftApConfiguration#setShutdownTimeoutMillis.
  • config_wifiHardwareSoftapMaxClientCount: La limitación de hardware para la cantidad máxima de clientes admitidos. La cantidad máxima de clientes que admite el dispositivo es la mínima de las restricciones de hardware y operador (especificadas por CarrierConfigManager.Wifi#KEY_HOTSPOT_MAX_CLIENT_COUNT). El resultado final se proporciona a la app con SoftApCapabilities#getMaxSupportedClients.
  • config_wifiSofapClientForceDisconnectSupported: Indica si el dispositivo puede forzar la desconexión de un cliente. Es obligatorio para habilitar las listas de entidades permitidas y bloqueadas. Se comunica con la app de control (app de Configuración) a través de SoftApCapabilities#areFeaturesSupported(SOFTAP_FEATURE_CLIENT_FORCE_DISCONNECT).
  • (Disponible a partir de la versión 13) config_wifiSoftapPassphraseAsciiEncodableCheck: Indica si la frase de contraseña del AP virtual debe ser codificable en ASCII.
  • config_wifiSoftapAutoUpgradeToBridgedConfigWhenSupported: Indica si se debe actualizar automáticamente la configuración de banda a doble banda durante el restablecimiento de la configuración de la nube cuando se admite un dispositivo nuevo.
  • (Disponible a partir de la versión 13) config_wifiSoftapAutoAppendLowerBandsToBandConfigurationEnabled: Indica si el framework agrega automáticamente bandas inferiores a la configuración de banda para evitar el manejo de coexistencia.
  • config_wifiSoftApDynamicCountryCodeUpdateSupported: Indica si el dispositivo admite o no la actualización dinámica del código de país en modo AP.
  • Compatibilidad con canales: config_wifiSoftap2gChannelList, config_wifiSoftap5gChannelList, config_wifiSoftap6gChannelList y config_wifiSoftap60gChannelList.
  • Se restableció la compatibilidad para especificar si las entradas correspondientes se restablecen a la configuración predeterminada cuando se restablece la configuración del hotspot en un dispositivo nuevo: config_wifiSoftapResetChannelConfig, config_wifiSoftapResetHiddenConfig, config_wifiSoftapResetUserControlConfig, config_wifiSoftapResetAutoShutdownTimerConfig y config_wifiSoftapResetMaxClientSettingConfig. Ten en cuenta que estos se establecen en true de forma predeterminada, lo que significa que los valores se restablecen. Esto es fundamental si el dispositivo nuevo no admite la configuración.
  • Funciones de hardware:
    • config_wifi_softap_acs_supported
    • config_wifi_softap_sae_supported
    • (Disponible a partir de la versión 13) config_wifiSoftapOweTransitionSupported
    • (Disponible a partir de 13) config_wifiSoftapOweSupported
    • config_wifi_softap_ieee80211ac_supported
    • config_wifiSoftapIeee80211axSupported
    • (Disponible 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

Validación

Android proporciona un conjunto de pruebas de unidades y pruebas del Conjunto de pruebas de compatibilidad (CTS) para validar la función de hotspot. La función de hotspot también se puede probar con el paquete de pruebas del proveedor (VTS).

Pruebas de unidades

Verifica el paquete de hotspot con las siguientes pruebas.

  • Pruebas de servicio:

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

  • Pruebas del administrador:

    atest packages/modules/Wifi/framework/tests/

Pruebas del conjunto de pruebas de compatibilidad (CTS)

Usa pruebas CTS para validar la función de hotspot. CTS detecta cuándo se habilita la función y, luego, incluye automáticamente las pruebas asociadas.

Para activar las pruebas de CTS, ejecuta lo siguiente:

atest android.net.wifi.cts.WifiManagerTest

Conjunto de pruebas de proveedores (VTS)

Si se implementó la interfaz HIDL, ejecuta lo siguiente:

atest VtsHalWifiHostapdV1_2Target

Si se implementa la interfaz del AIDL, ejecuta el siguiente comando:

atest VtsHalHostapdTargetTest