Wi-Fi Direct

La funzionalità Wi-Fi Direct, nota anche come Wi-Fi P2P, consente ai dispositivi supportati di rilevarsi e connettersi direttamente tra loro utilizzando il protocollo Wi-Fi Direct senza accesso a internet o alla rete cellulare. Questa funzionalità, basata sulla Wi-Fi Alliance (WFA) specifica Wi-Fi Direct consente la condivisione di dati ad alta velocità effettiva tra dispositivi e app attendibili che altrimenti non sono connessi alla rete.

Esempi e origine

Per utilizzare questa funzionalità, i produttori di dispositivi devono implementare le interfacce HAL fornitore e supplicant Wi-Fi.

In Android 13, l'interfaccia Supplicant utilizza AIDL per la definizione HAL. In Android 14 e versioni successive, l'interfaccia HAL del fornitore utilizza AIDL. In Android 12 e versioni precedenti, le interfacce Supplicant e Vendor HAL sono definite utilizzando HIDL.

Per utilizzare la funzionalità Wi-Fi Direct sono necessarie le seguenti interfacce HAL Wi-Fi:

  • hardware/interfaces/wifi/aidl o hardware/interfaces/wifi/1.3 o superiore
  • hardware/interfaces/wifi/supplicant/aidl o hardware/interfaces/wifi/supplicant/1.2 o superiore

Implementazione

I produttori di dispositivi devono fornire supporto sia per il framework sia per HAL/firmware:

  • Framework:
    • Codice AOSP
    • Attiva Wi-Fi Direct: richiede un flag funzionalità
  • Supporto HAL Wi-Fi Direct (P2P) (che implica il supporto del firmware)

Per implementare questa funzionalità, i produttori di dispositivi implementano le interfacce Wi-Fi HIDL o AIDL e attivano il flag della funzionalità per Wi-Fi Direct. In device.mk che si trova in device/<oem>/<device>, modifica la variabile di ambiente PRODUCT_COPY_FILES per includere il supporto della funzionalità 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
```

Tutti gli altri requisiti per il supporto di Wi-Fi Direct sono inclusi in AOSP.

Randomizzazione dell'indirizzo MAC

Android richiede che l'indirizzo del dispositivo e l'indirizzo dell'interfaccia Wi-Fi Direct siano randomizzati. Devono essere diversi dall'indirizzo MAC effettivo del dispositivo e devono soddisfare i seguenti requisiti:

  • L'indirizzo del dispositivo Wi-Fi Direct deve essere randomizzato al momento della creazione dell'interfaccia se non è stato salvato alcun gruppo persistente; in caso contrario, l'indirizzo del dispositivo deve continuare a utilizzare l'ultimo indirizzo MAC generato.
  • L'indirizzo dell'interfaccia Wi-Fi Direct, noto anche come indirizzo di gruppo, deve essere randomizzato ogni volta che viene stabilita una connessione.

La randomizzazione MAC Wi-Fi Direct è implementata in "wpa_supplicant" e controllata da due configurazioni, p2p_device_random_mac_addr e p2p_interface_random_mac_addr.

Per attivare questa funzionalità, i produttori di dispositivi devono:

  • Implementa l'API ISupplicantP2pIface::setMacRandomization Wi-Fi Supplicant. A seconda dell'interfaccia implementata, si trova in:
    • hardware/interface/wifi/supplicant/1.2 per HIDL
    • hardware/interface/wifi/supplicant/aidl per AIDL
  • Imposta config_wifi_p2p_mac_randomization_supported su "true" in un overlay personalizzato del dispositivo.

Convalida

Android fornisce una serie di test unitari, test Compatibility Test Suite (CTS) e test CTS Verifier per convalidare la funzionalità Wi-Fi Direct. Il Wi-Fi Direct può essere testato anche utilizzando la Vendor Test Suite (VTS).

Test delle unità

Verifica il pacchetto Wi-Fi Direct utilizzando i seguenti test.

Test del servizio:

atest com.android.server.wifi.p2p

Test del gestore:

atest android.net.wifi.p2p

Test della suite di test di compatibilità (CTS)

Utilizza i test CTS per convalidare la funzionalità Wi-Fi Direct. CTS rileva quando la funzionalità è abilitata e include automaticamente i test associati.

Per attivare i test CTS, esegui:

% atest android.net.wifi.p2p.cts

Test di CTS Verifier

I test CTS Verifier convalidano il comportamento di Wi-Fi Direct utilizzando due dispositivi: un dispositivo di test e un dispositivo funzionante. Per eseguire i test, apri CTS Verifier e vai alla sezione intitolata Test Wi-Fi Direct.