Wi-Fi Direct

O recurso Wi-Fi Direct, também conhecido como Wi-Fi P2P, permite que os 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) 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 de fornecedor e suplicante de Wi-Fi.

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

As seguintes interfaces HAL do Wi-Fi são necessárias para usar 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 ao framework e ao HAL/firmware:

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

Para implementar esse recurso, os fabricantes de dispositivos implementam as interfaces HIDL ou AIDL do Wi-Fi 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 verdadeiro 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 Wi-Fi Direct, também conhecido como endereço de grupo, precisa ser aleatório sempre que uma conexão é estabelecida.

A ordem aleatória de MAC do Wi-Fi Direct é implementada no "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 de dispositivos precisam:

  • Implemente a API ISupplicantP2pIface::setMacRandomization do suplicante 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) e testes do CTS Verifier para validar o recurso Wi-Fi Direct. O Wi-Fi Direct também pode ser testado usando o Vendor Test Suite (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 de gerente:

atest android.net.wifi.p2p

Testes do conjunto de teste de compatibilidade (CTS)

Use testes do 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 do CTS, execute:

% atest android.net.wifi.p2p.cts

Testes do CTS Verifier

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