Reconocimiento de Wi-Fi

La función de reconocimiento de Wi-Fi que se agregó en Android 8.0 permite que los dispositivos compatibles se descubran, conecten y alcancen (se agregó en Android 9) entre sí directamente con el protocolo de reconocimiento de Wi-Fi sin acceso a Internet ni a una red móvil. Esta función, compilada según la especificación de reconocimiento de Wi-Fi de Wi-Fi Alliance (WFA) (versiones 2.0, 3.0, 3.1 y 4.0), permite compartir fácilmente datos de alta capacidad de procesamiento entre dispositivos y apps de confianza que de otro modo estarían fuera de la red.

Ejemplos y fuente

Para usar esta función, los fabricantes de dispositivos deben implementar la HAL del proveedor de Wi-Fi. En Android 14 y versiones posteriores, la interfaz de la HAL del proveedor se define con el AIDL. En el caso de Android 13 y versiones anteriores, la interfaz de la HAL del proveedor se define con el HIDL.

Sigue la interfaz de Wi-Fi para usar la función Wi-Fi Aware. Según la interfaz que esté implementada, esto puede ocurrir de las siguientes maneras:

• AIDL: hardware/interfaces/wifi/aidl
• HIDL: hardware/interfaces/wifi/1.2 o versiones posteriores

Puedes consultar el HAL de Wi-Fi heredado para ver cómo se correlaciona con las interfaces AIDL y HIDL: hardware/libhardware_legacy/+/main/include/hardware_legacy/wifi_nan.h.

Implementación

Los fabricantes de dispositivos deben proporcionar compatibilidad con el framework y con HAL/firmware:

• Framework:
  • Código del AOSP
  • Habilita Aware: Requiere una marca de función y una marca de compilación.
• Compatibilidad con HAL de Wi-Fi Aware (NAN) (lo que implica compatibilidad con firmware)

Para implementar esta función, los fabricantes de dispositivos implementan la interfaz Wi-Fi y habilitan dos marcas de función:

• En BoardConfig.mk o BoardConfig-common.mk ubicado en device/<oem>/<device>, agrega la siguiente marca:

  WIFI_HIDL_FEATURE_AWARE := true
  

• En device.mk, ubicado en device/<oem>/<device>, modifica la variable de entorno PRODUCT_COPY_FILES para incluir compatibilidad con la función Wi-Fi Aware:

  PRODUCT_COPY_FILES +=
  frameworks/native/data/etc/android.hardware.wifi.aware.xml:$(TARGET_COPY_OUT_VENDOR)/etc/permissions/android.hardware.wifi.aware.xml
  

El reconocimiento de Wi-Fi incluye el rango de dispositivos con intercambio de tráfico a través del protocolo IEEE 802.11mc, también conocido como tiempo de ida y vuelta (RTT). Esta subfunción de Wi-Fi Aware depende de que el dispositivo admita la función Wi-Fi RTT, es decir, requiere que el dispositivo admita Wi-Fi Aware y Wi-Fi RTT. Para obtener más detalles, consulta RTT de Wi-Fi.

De lo contrario, todo lo necesario para esta función se incluye en el AOSP.

La marca WIFI_HIDL_FEATURE_AWARE se ignora si se especifica la marca WIFI_HAL_INTERFACE_COMBINATIONS. Para obtener más información, consulta Simultaneidad de varias interfaces de Wi-Fi.

Aleatorización de MAC

Android requiere que la dirección MAC del descubrimiento de Wi-Fi Aware (NMI) y las interfaces de datos (NDP) sean aleatorias y no sean idénticas a la dirección MAC real del dispositivo. Las direcciones MAC deben cumplir con los siguientes requisitos:

• Se aleatoriza cada vez que se habilita o se vuelve a habilitar Wi-Fi Aware.

• Cuando el reconocimiento de Wi-Fi está habilitado, la dirección MAC debe aleatorizarse a un intervalo regular configurado por el parámetro NanConfigRequest.macAddressRandomizationIntervalSec. El framework lo configura de forma predeterminada en 30 minutos.

  Nota: Según la especificación de reconocimiento de Wi-Fi, la aleatorización puede suspenderse mientras se configura una NDP. La suspensión no implica que se use la dirección MAC de fábrica (nunca se debe usar para Wi-Fi Aware), sino que la dirección MAC se vuelve a aleatorizar con menos frecuencia de lo que se requiere.

Suspender y reanudar

En Android 14 y versiones posteriores, Wi-Fi Aware admite que las apps con privilegios suspendan y reanuden las sesiones de descubrimiento activas (incluidas todas las rutas de datos asociadas con esas sesiones). La compatibilidad con esta función permite que los dispositivos reanuden las sesiones de descubrimiento más rápido y usen menos energía, ya que las sesiones de descubrimiento se pueden suspender.

Si un dispositivo admite esta función de suspensión y reanudación, el firmware suspende la sesión de Wi-Fi Aware cuando una app con privilegios suspende la sesión de descubrimiento. Cuando una sesión de descubrimiento está suspendida, el dispositivo no transmite ni recibe tramas para esa sesión, incluidos los NDP activos en esa sesión. Si se suspenden todas las sesiones de descubrimiento, el dispositivo no transmite ni recibe tramas de Wi-Fi Aware.

Cuando una app con privilegios reanuda una sesión de descubrimiento suspendida, el framework devuelve la sesión a su estado anterior, incluidas todas las sesiones de NDP asociadas. La reanudación de una sesión de descubrimiento suspendida es más rápida que abrir Wi-Fi Aware y crear una sesión de descubrimiento nueva.

Para admitir la capacidad de suspender y reanudar las sesiones de descubrimiento, los fabricantes de dispositivos deben proporcionar compatibilidad con HAL y firmware. Para obtener más información, consulta IWifiNanIface.java.

Los fabricantes de dispositivos pueden usar comunicaciones fuera de banda (por ejemplo, BLE) para sincronizar la suspensión y la reanudación en varios dispositivos.

Nota: Según la especificación de Wi-Fi Aware, si un dispositivo NAN transmite un atributo de programación no alineado que indica que no está disponible en ventanas no alineadas (ULW) especificadas en cualquier banda o canal, otros dispositivos NAN que reciban dichos atributos de programación no alineados no deben transmitir ninguna trama al dispositivo NAN durante las ULW especificadas.

Validación

Android proporciona un conjunto de pruebas de unidades, pruebas del Conjunto de pruebas de compatibilidad (CTS) y pruebas del verificador del CTS para validar la función Wi-Fi Aware. Wi-Fi Aware también se puede probar con el Conjunto de pruebas de proveedores (VTS).

Pruebas de unidades

Las pruebas de paquetes de Wi-Fi Aware se ejecutan con lo siguiente:

Pruebas de servicio:

atest com.android.server.wifi.aware

Pruebas del administrador:

atest android.net.wifi.aware

Pruebas del conjunto de pruebas de compatibilidad (CTS)

Usa pruebas de CTS para validar la función de reconocimiento de Wi-Fi. El CTS detecta cuándo la función está habilitada y, luego, incluye automáticamente las pruebas asociadas.

Las pruebas del CTS se pueden activar usando lo siguiente:

atest SingleDeviceTest

Pruebas del verificador del CTS

Las pruebas del verificador del CTS validan el comportamiento de reconocimiento de Wi-Fi mediante dos dispositivos: uno de prueba y uno bien conocido. Para ejecutar las pruebas, abre CTS Verifier y navigate a la sección titulada Wi-Fi Aware Tests.