Wi-Fi RTT (IEEE 802.11mc)

Android 9'daki Wi-Fi Gidiş-Dönüş Süresi (RTT) özelliği, destekleyen cihazların diğer destekleyici cihazlara olan mesafeyi ölçmesine olanak tanır: Erişim Noktaları (AP'ler) veya Wi-Fi Uyumlu eşler ( Wi-Fi Aware Wi-Fi uyumlu eşler ) olup olmadığı cihaz). IEEE 802.11mc protokolü üzerine inşa edilen bu özellik, uygulamaların gelişmiş konum doğruluğu ve farkındalığını kullanmasına olanak tanır.

Örnekler ve kaynak

Bu özelliği kullanmak için Satıcı HAL arayüzünü uygulayın. Android 14 ve üzeri sürümlerde Satıcı HAL arayüzü AIDL kullanılarak tanımlanır. Android 13 ve önceki sürümlerde Satıcı HAL arayüzü HIDL kullanılarak tanımlanır. Android 8.0'da HIDL, arayüzlerde ve paketlerde toplanan türleri ve yöntem çağrılarını belirleyerek uygulamaları kolaylaştırmak için kullanılan önceki Donanım Soyutlama Katmanı (HAL) yapısının yerini aldı.

Wi-Fi RTT özelliğini kullanmak için Wi-Fi arayüzünü takip edin. Hangi arayüzün uygulandığına bağlı olarak bu:

  • AIDL: hardware/interfaces/wifi/aidl
  • HIDL: hardware/interfaces/wifi/1.0 veya üstü.

AIDL ve HIDL arayüzleriyle nasıl ilişkili olduğunu görmek için eski Wi-Fi HAL'ye başvurabilirsiniz: hardware/libhardware_legacy/+/main/include/hardware_legacy/rtt.h .

Uygulama

Wi-Fi RTT'yi uygulamak için hem çerçeve hem de HAL/ürün yazılımı desteği sağlamanız gerekir:

  • Çerçeve:

    • AOSP kodu
    • Wi-Fi RTT'yi etkinleştir: bir özellik işareti gerektirir
  • Wi-Fi RTT (IEEE 802.11mc) HAL desteği (bu, donanım yazılımı desteği anlamına gelir)

Bu özelliği uygulamak için Wi-Fi AIDL veya HIDL arayüzünü uygulayın ve özellik işaretini etkinleştirin:

  • device/<oem>/<device> dizininde bulunan device.mk dosyasında, Wi-Fi RTT özelliği desteğini içerecek şekilde PRODUCT_COPY_FILES ortam değişkenini değiştirin:

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

Aksi takdirde bu özellik için gereken her şey AOSP'ye dahildir.

MAC rastgeleleştirmesi

Gizliliği artırmak için, Wi-Fi RTT işlemleri sırasında kullanılan MAC adresinin rastgele seçilmesi gerekir, yani Wi-Fi arayüzünün yerel MAC adresiyle eşleşmemelidir. Ancak istisna olarak, bir cihaz bir AP ile ilişkilendirildiğinde, o AP veya diğer AP'lerle yapılan herhangi bir RTT işlemi için ilişkilendirildiği MAC adresini kullanabilir.

Doğrulama

Bu özellik için Android Uyumluluk Test Paketi (CTS) testleri mevcuttur. CTS, özelliğin ne zaman etkinleştirildiğini algılar ve ilgili testleri otomatik olarak dahil eder. Bu özellik aynı zamanda Vendor Test Suite (VTS) ve kapsamlı entegrasyon testleri yürüten bir test paketi olan act/sl4a kullanılarak da test edilebilir.

Birim testleri

Wi-Fi RTT paketi testleri aşağıdakiler kullanılarak gerçekleştirilir:

Servis testleri:

atest com.android.server.wifi.rtt

Yönetici testleri:

atest android.net.wifi.rtt

Entegrasyon (ACTS) testleri

/tools/test/connectivity/acts_tests/tests/google/wifi/rtt/README.md adresinde açıklanan act/sl4a test paketi işlevsellik, performans ve stres testleri sağlar.

CTS

Bu özellik için Android Uyumluluk Test Paketi (CTS) testleri mevcuttur. CTS, özelliğin ne zaman etkinleştirildiğini algılar ve ilgili testleri otomatik olarak dahil eder. Wi-Fi RTT'yi (IEEE 802.11mc) destekleyen bir Erişim Noktası, test edilen cihazın kapsama alanı içinde olmalıdır.

CTS testleri aşağıdakiler kullanılarak tetiklenebilir:

atest WifiRttTest

Kalibrasyon

Wi-Fi RTT'nin iyi performans göstermesi için 802.11mc protokolünde döndürülen aralıklar, Temel Performans Göstergesi (KPI) dahilinde ideal olarak doğrudur. Listelenen bant genişliklerinde %90 CDF hatası için, aralık tahmini için önerilen KPI'nın aşağıdaki toleranslara sahip olması beklenir:

  • 80MHz: 2 metre
  • 40MHz: 4 metre
  • 20MHz: 8 metre

Özelliğin uygulanmasının doğru çalıştığından emin olmak için kalibrasyon testi gereklidir.

Bu, artan mesafelerde yer gerçeği aralığını RTT tahmin aralığıyla karşılaştırarak başarılabilir. Temel uyumluluk için çözümünüzü RTT kalibreli olduğu bilinen bir cihazla doğrulamanız gerekir. Aralık kalibrasyonu aşağıdaki koşullar altında test edilmelidir:

  1. Büyük bir açık laboratuvar veya çok fazla metal nesnenin bulunmadığı bir koridor, alışılmadık derecede yüksek çoklu yol oluşumuna neden olabilir.
  2. En az 25 m boyunca uzanan bir Görüş Hattı (LOS) yolu/yolu.
  3. Pistin bir ucundan diğer ucuna 0,5 metrelik artışlarla işaretler.
  4. Rayın bir ucunda yerden 20 cm yüksekte monte edilmiş, RTT özellikli bir erişim noktasının sabitleneceği bir yer ve bir Android telefon (veya test edilen diğer Android mobil cihaz) için ray boyunca hareket ettirilebilen ve rayla hizalanabilen hareketli bir montaj parçası. 0,5 m işaretleyiciler, ayrıca yerden 20 cm yükseklikte. Not: Bu tekrarlanan görev küçük bir robot tarafından gerçekleştirilebilir ancak bir insan operatör de bunu yapabilir.
  5. Erişim noktasına olan mesafeyle birlikte her işaretleyicide 50 ölçüm sonucu kaydedilmelidir. Her işaretleyici konumu için aralık ortalaması ve varyans gibi istatistikler hesaplanmalıdır.

5. adımdaki sonuçlardan, tahmini aralığa (y ekseni) karşı zemin gerçeği (x ekseni) ve tahmin edilen en uygun regresyon çizgisi için bir grafik çizilebilir. İdeal cihaz kalibrasyonu, y ekseninde 0,0 m ofset ile 1,0 eğim çizgisiyle sonuçlanacaktır. Bu değerlerden sapmalar, karşılık gelen bant genişliğine ilişkin KPI dahilindeyse kabul edilebilir. Sonuçlar KPI'nın dışındaysa, sonuçları KPI spesifikasyonuna getirecek şekilde cihaz özelliği yeniden kalibre edilmelidir.