Wi-Fi Direct

O recurso Wi-Fi Direct, também conhecido como Wi-Fi P2P, permite que dispositivos compatíveis se descubram e se conectem diretamente usando o protocolo Wi-Fi Direct sem acesso à Internet ou a uma rede celular. Esse recurso, criado com base na Wi-Fi Alliance (WFA, na sigla em inglês) especificação Wi-Fi Direct permite o compartilhamento de dados de alta capacidade entre dispositivos e apps confiáveis que estão fora da rede.

Exemplos e origem

Para usar esse recurso, os fabricantes de dispositivos precisam implementar as interfaces HAL do fornecedor e do solicitante do Wi-Fi.

No Android 13, a interface do solicitante usa a AIDL para a definição da HAL. No Android 14 e versões mais recentes, a interface da HAL do fornecedor usa a AIDL. No Android 12 e versões anteriores, as interfaces de Supplicant e HAL do fornecedor são definidas usando a HIDL.

As seguintes plataformas HAL do Wi-Fi são necessárias para empregar o recurso Wi-Fi Direct:

  • hardware/interfaces/wifi/aidl ou hardware/interfaces/wifi/1.3 ou mais recente
  • hardware/interfaces/wifi/supplicant/aidl ou hardware/interfaces/wifi/supplicant/1.2 ou mais recente

Implementação

Os fabricantes de dispositivos precisam oferecer suporte a framework e HAL/firmware:

  • Framework:
    • Código do AOSP
    • Ativar o Wi-Fi Direct: requer uma flag de recurso
  • Suporte a HAL do Wi-Fi Direct (P2P), o que implica suporte a firmware

Para implementar esse recurso, os fabricantes de dispositivos implementam as interfaces Wi-Fi HIDL ou AIDL e ativam a flag de recurso para o Wi-Fi Direct. Em device.mk, localizado em device/<oem>/<device>, modifique a variável de ambiente PRODUCT_COPY_FILES para incluir suporte ao recurso Wi-Fi Direct:

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

Todos os outros requisitos para oferecer suporte ao Wi-Fi Direct estão incluídos no AOSP.

Ordem aleatória de MAC

O Android exige que o endereço do dispositivo e o endereço da interface do Wi-Fi Direct sejam aleatórios. Eles precisam ser diferentes do endereço MAC real do dispositivo e atender aos seguintes requisitos:

  • O endereço do dispositivo Wi-Fi Direct precisa ser randomizado na criação da interface se não houver um grupo persistente salvo. Caso contrário, o endereço do dispositivo precisa continuar usando o último endereço MAC gerado.
  • O endereço da interface do Wi-Fi Direct, também conhecido como endereço de grupo, precisa ser randomizado sempre que uma conexão é estabelecida.

A ordenação aleatória de MAC do Wi-Fi Direct é implementada em "wpa_supplicant" e controlada por duas configurações, p2p_device_random_mac_addr e p2p_interface_random_mac_addr.

Para ativar esse recurso, os fabricantes dos dispositivos precisam:

  • Implemente a API ISupplicantP2pIface::setMacRandomization do solicitante do Wi-Fi. Dependendo da interface implementada, isso está em:
    • hardware/interface/wifi/supplicant/1.2 para HIDL
    • hardware/interface/wifi/supplicant/aidl para AIDL
  • Defina config_wifi_p2p_mac_randomization_supported como "true" em uma sobreposição personalizada do dispositivo.

Validação

O Android oferece um conjunto de testes de unidade, testes do conjunto de teste de compatibilidade (CTS, na sigla em inglês) e testes do CTS Verifier para validar o recurso Wi-Fi Direct. O Wi-Fi Direct também pode ser testado usando o Conjunto de teste de fornecedor (VTS).

Testes de unidade

Verifique o pacote Wi-Fi Direct usando os seguintes testes.

Testes de serviço:

atest com.android.server.wifi.p2p

Testes do administrador:

atest android.net.wifi.p2p

Testes do conjunto de teste de compatibilidade (CTS)

Use os testes CTS para validar o recurso Wi-Fi Direct. O CTS detecta quando o recurso está ativado e inclui automaticamente os testes associados.

Para acionar os testes de CTS, execute:

% atest android.net.wifi.p2p.cts

Testes do CTS Verifier

Os testes do verificador CTS validam o comportamento do Wi-Fi Direct usando dois dispositivos: um dispositivo de teste e um dispositivo conhecido como bom. Para executar os testes, abra o CTS Verifier e navegue até a seção "Wi-Fi Direct Tests".