Wi-Fi Aware

Funkcja Wi-Fi Aware, dodana w Androidzie 8.0, umożliwia urządzeniom obsługującym tę funkcję wykrywanie innych urządzeń, nawiązywanie z nimi połączenia i wyznaczanie ich zasięgu (dodano w Androidzie 9) bezpośrednio za pomocą protokołu Wi-Fi Aware bez dostępu do internetu lub sieci komórkowej. Ta funkcja oparta na specyfikacji Wi-Fi Alliance (WFA) Wi-Fi Aware (w wersjach 2.0, 3.0, 3.1 i 4.0) umożliwia łatwe udostępnianie danych o dużej przepustowości między zaufanymi urządzeniami i aplikacjami, które są poza siecią.

Przykłady i źródło

Aby korzystać z tej funkcji, producenci urządzeń powinni zaimplementować interfejs HAL dostawcy Wi-Fi. W Androidzie 14 i nowszych interfejs HAL dostawcy jest definiowany za pomocą AIDL. Na Androidzie 13 lub starszym interfejs HAL dostawcy jest definiowany za pomocą HIDL.

Aby korzystać z funkcji Wi-Fi Aware, postępuj zgodnie z instrukcjami w interfejsie Wi-Fi. W zależności od zaimplementowanego interfejsu może to być:

  • AIDL: hardware/interfaces/wifi/aidl
  • HIDL: hardware/interfaces/wifi/1.2 lub nowsza wersja

Aby sprawdzić, jak interfejs AIDL i HIDL się wzajemnie uzupełniają, możesz zapoznać się ze starszą wersją interfejsu HAL Wi-Fi: hardware/libhardware_legacy/+/main/include/hardware_legacy/wifi_nan.h.

Implementacja

Producenci urządzeń muszą zapewnić obsługę zarówno frameworku, jak i HAL/firmware:

  • Platforma:
    • Kod AOSP
    • Enable Aware: wymaga flagi funkcji i flagi kompilacji.
  • Obsługa interfejsu HAL Wi-Fi Aware (NAN) (co oznacza obsługę oprogramowania układowego)

Aby wdrożyć tę funkcję, producenci urządzeń muszą wdrożyć interfejs Wi-Fi i włączyć 2 flagi funkcji:

  • W elemencie BoardConfig.mk lub BoardConfig-common.mk w pliku device/<oem>/<device> dodaj tę flagę:

    WIFI_HIDL_FEATURE_AWARE := true

  • W pliku device.mk w folderze device/<oem>/<device> zmień zmienną środowiskową PRODUCT_COPY_FILES, aby uwzględnić obsługę funkcji 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

Wi-Fi Aware obejmuje pomiar odległości do urządzeń peerów za pomocą protokołu IEEE 802.11mc, znanego również jako czas dojścia i powrotu (RTT). Ta funkcja podrzędna Wi-Fi Aware jest zależna od urządzenia obsługującego funkcję Wi-Fi RTT, co oznacza, że urządzenie musi obsługiwać zarówno Wi-Fi Aware, jak i Wi-Fi RTT. Więcej informacji znajdziesz w artykule Wi-Fi RTT.

W innych przypadkach wszystko, czego potrzeba do tej funkcji, jest zawarte w AOSP.

Flaga WIFI_HIDL_FEATURE_AWARE jest ignorowana, jeśli podana jest flaga WIFI_HAL_INTERFACE_COMBINATIONS. Więcej informacji znajdziesz w artykule Wi-Fi: równoczeczność wielu interfejsów.

losowego generowania adresu MAC.

Android wymaga, aby adres MAC interfejsu wykrywania Wi-Fi Aware (NMI) i interfejsów danych (NDP) był losowy i nie identyczny z prawdziwym adresem MAC urządzenia. Adresy MAC muszą:

  • losowo, gdy włączysz lub ponownie włączysz Wi-Fi Aware;

  • Gdy włączona jest funkcja Wi-Fi Aware, adres MAC musi być losowo generowany w regularnych odstępach czasu określonych przez parametr NanConfigRequest.macAddressRandomizationIntervalSec. Domyślnie framework konfiguruje ten parametr na 30 minut.

Wstrzymywanie i wznawianie

W Androidzie 14 i nowszych funkcja Wi-Fi Aware umożliwia aplikacjom uprzywilejowanym zawieszanie i wznawianie aktywnych sesji wykrywania (wraz ze wszystkimi ścieżkami danych powiązanymi z tymi sesjami). Dzięki tej funkcji urządzenia mogą szybciej wznowić sesje wyszukiwania i zużywać mniej energii, ponieważ sesje wyszukiwania mogą być zawieszone.

Jeśli urządzenie obsługuje tę funkcję wstrzymywania i wznawiania, oprogramowanie zawiesza sesję Wi-Fi Aware, gdy aplikacja z przywilejami zawiesza sesję wyszukiwania. Gdy sesja wyszukiwania jest zawieszona, urządzenie nie przesyła ani nie odbiera żadnych ramek w ramach tej sesji, w tym żadnych aktywnych NDP. Jeśli wszystkie sesje wykrywania są zawieszone, urządzenie nie transmituje ani nie odbiera żadnych ramek Wi-Fi Aware.

Gdy aplikacja z przywilejami wznowi zawieszoną sesję wyszukiwania, framework przywróci sesję do poprzedniego stanu, w tym wszystkie powiązane sesje NDP. Wznowienie zawieszonej sesji wyszukiwania jest szybsze niż wywołanie Wi-Fi Aware i utworzenie nowej sesji wyszukiwania.

Aby umożliwić zawieszanie i wznawianie sesji wyszukiwania, producenci urządzeń muszą zapewnić obsługę HAL i oprogramowania układowego. Więcej informacji znajdziesz w sekcji IWifiNanIface.java.

Producenci urządzeń mogą używać komunikacji pozapasmowej (np. BLE) do synchronizowania zawieszania i wznawiania na wielu urządzeniach.

Weryfikacja

Android udostępnia zestaw testów jednostkowych, testów Compatibility Test Suite (CTS) i testów CTS Verifier, aby sprawdzić poprawność funkcji Wi-Fi Aware. Wi-Fi Aware można też przetestować za pomocą pakietu testów dostawców (VTS).

Testy jednostkowe

Testy pakietu Wi-Fi Aware są wykonywane za pomocą:

Testy usługi:

atest com.android.server.wifi.aware

Testy menedżera:

atest android.net.wifi.aware

testy Compatibility Test Suite (CTS),

Użyj testów CTS do weryfikacji funkcji Wi-Fi Aware. CTS wykrywa, kiedy funkcja jest włączona, i automatycznie uwzględnia powiązane testy.

Testy CTS można uruchamiać za pomocą:

atest SingleDeviceTest

Testy weryfikatora CTS

Testy CTS Verifier weryfikują działanie Wi-Fi Aware za pomocą 2 urządzeń: testowego i sprawdzonego. Aby przeprowadzić testy, otwórz narzędzie CTS Verifier i przejdź do sekcji Wi-Fi Aware Tests.