Kablosuz RTT (IEEE 802.11mc)

Android 9'daki Kablosuz Gidiş Dönüş Süresi (RTT) özelliği, desteklenen cihazların diğer desteklenen cihazlara olan mesafesini ölçmesine olanak tanır. Bu cihazlar Erişim Noktası (AP) veya Wi-Fi Aware eşleri (cihazda Wi-Fi Aware destekleniyorsa) olabilir. IEEE 802.11mc protokolü temel alınarak geliştirilen bu özellik, uygulamaların gelişmiş konum doğruluğu ve farkındalığını kullanmasını sağlar.

Örnekler ve kaynak

Bu özelliği kullanmak için Tedarikçi HAL arayüzünü uygulayın. Android 14 ve sonraki sürümlerde Tedarikçi HAL arayüzü AIDL kullanılarak tanımlanır. Android 13 ve önceki sürümlerde Tedarikçi HAL arayüzü, HIDL kullanılarak tanımlanır. Android 8.0'da HIDL, arayüzler ve paketlerde toplanan türleri ve yöntem çağrılarını belirterek uygulamaları basitleştirmek için kullanılan önceki Donanım Soyutlama Katmanı (HAL) yapısının yerini almıştır.

Kablosuz RTT özelliğini kullanmak için kablosuz ağ arayüzünü izleyin. Uygulanan arayüzün türüne bağlı olarak bu ayar aşağıdaki gibidir:

  • AIDL: hardware/interfaces/wifi/aidl
  • HIDL: hardware/interfaces/wifi/1.0 veya sonrası.

AIDL ve HIDL arayüzleriyle ilişkisini görmek için eski kablosuz HAL'ye bakabilirsiniz: hardware/libhardware_legacy/+/main/include/hardware_legacy/rtt.h.

Uygulama

Kablosuz RTT'yi uygulamak için hem çerçeve hem de HAL/donanım yazılımı desteği sağlamanız gerekir:

  • Çerçeve:

    • AOSP kodu
    • Kablosuz RTT'yi etkinleştir: Bir özellik bayrağı gerektirir
  • Kablosuz RTT (IEEE 802.11mc) HAL desteği (donanım desteği anlamına gelir)

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

  • device/<oem>/<device> bölgesinde bulunan device.mk ürününde, PRODUCT_COPY_FILES ortam değişkenini kablosuz RTT özelliğini destekleyecek şekilde 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 rastgele hale getirme

Gizliliği artırmak için kablosuz RTT işlemleri sırasında kullanılan MAC adresi rastgele belirlenmelidir. Yani, kablosuz arayüzün yerel MAC adresiyle eşleşmemelidir. Ancak istisnai olarak, bir cihaz bir erişim noktası ile ilişkilendirildiğinde, söz konusu AP veya diğer AP'lerle yapılan tüm RTT işlemleri için ilişkilendirildiği MAC adresini kullanabilir.

Doğrulama

Bu özellik için Android Compatibility Test Suite (CTS) testleri mevcuttur. CTS, özelliğin etkinleştirildiğini algılar ve ilgili testleri otomatik olarak dahil eder. Bu özellik, Tedarikçi Test Paketi (VTS) kullanılarak da test edilebilir.

Birim testleri

Wi-Fi RTT paketi testleri şunlar kullanılarak yürütülür:

Hizmet testleri:

atest com.android.server.wifi.rtt

Yönetici tarafından test edilir:

atest android.net.wifi.rtt

CTS

Bu özellik için Android Compatibility Test Suite (CTS) testleri mevcuttur. CTS, özelliğin etkinleştirildiğini algılar ve ilgili testleri otomatik olarak dahil eder. Kablosuz RTT'yi (IEEE 802.11mc) destekleyen bir Erişim Noktası, test altındaki cihazın kapsama alanında olmalıdır.

CTS testleri şunlar kullanılarak tetiklenebilir:

atest WifiRttTest

Kalibrasyon

Kablosuz 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. %90 CDF hatası için listelenen bant genişliklerinde, aralık tahmini için önerilen TPG'nin aşağıdaki toleranslara sahip olması beklenir:

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

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

Bu, kesin referans aralığı, artan mesafelerde RTT tahmini aralığıyla karşılaştırılarak elde edilebilir. Temel uygunluk için çözümünüzü RTT kalibre edilmiş 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 sayıda metal nesne içermeyen koridor, çok yollu yolların olağan dışı bir şekilde yüksek olmasına yol açabilir.
  2. En azından 25 m uzunluğunda bir Görüş Hattı (LOS) parkuru veya yolu.
  3. Parkurun bir ucundan diğerine 0,5 metrelik işaretçiler.
  4. Yolun bir ucunda yerden 20 cm'ye monte edilmiş şekilde RTT özellikli bir erişim noktası ve Android telefon (veya test edilen başka bir Android mobil cihaz) için parkur boyunca taşınabilen ve yine yerden 20 cm yüksekte 0,5 m işaretçilerle hizalanabilen taşınabilir bir montaj noktası sabitleme yeri.

  5. Her işaretçi için, erişim noktasından uzaklıkla birlikte 50 aralık sonucu kaydedilmelidir. Aralık ortalaması ve varyansı gibi istatistikler, her işaretçi konumu için hesaplanmalıdır.

5. adımdaki sonuçlardan, tahmini aralığa (y ekseni) ve tahmini en uygun regresyon çizgisine göre kesin referans (x ekseni) için bir grafik çizilebilir. İdeal cihaz kalibrasyonu, y ekseninde 0,0 m ofset ile 1,0 oranında bir gradyan çizgisiyle sonuçlanır. Bu değerlerden sapmalar, karşılık gelen bant genişliğinin TPG'si dahilindeyse kabul edilebilir. Sonuçlar TPG'nin dışındaysa cihaz özelliği, sonuçları TPG spesifikasyonuna dahil etmek için yeniden kalibre edilmelidir.