Wi-Fi RTT (IEEE 802.11mc, IEEE 802.11az)

Fitur Wi-Fi Round Trip Time (RTT) di Android 9 memungkinkan perangkat pendukung untuk mengukur jarak ke perangkat pendukung lainnya: baik itu Titik Akses (AP) maupun peer Wi-Fi Aware (jika Wi-Fi Aware didukung di perangkat). Fitur ini, yang dibuat berdasarkan protokol IEEE 802.11mc dan IEEE 802.11az (tersedia dari Android 15), memungkinkan aplikasi menggunakan akurasi dan kesadaran lokasi yang ditingkatkan.

Contoh dan sumber

Untuk menggunakan fitur ini, terapkan antarmuka HAL Vendor. Di Android 14 dan yang lebih baru, antarmuka HAL Vendor ditentukan menggunakan AIDL. Di Android 13 dan yang lebih lama, antarmuka HAL Vendor ditentukan menggunakan HIDL. Di Android 8.0, HIDL menggantikan struktur Hardware Abstraction Layer (HAL) sebelumnya yang digunakan untuk menyederhanakan implementasi dengan menentukan jenis dan panggilan metode yang dikumpulkan ke dalam antarmuka dan paket.

Ikuti antarmuka Wi-Fi untuk menggunakan fitur Wi-Fi RTT. Bergantung pada antarmuka yang diterapkan, ini adalah:

  • AIDL: hardware/interfaces/wifi/aidl
  • HIDL: hardware/interfaces/wifi/1.0 atau yang lebih baru.

Anda dapat merujuk ke HAL Wi-Fi lama untuk melihat korelasi dengan antarmuka AIDL dan HIDL: hardware/libhardware_legacy/+/main/include/hardware_legacy/rtt.h.

Implementasi

Untuk menerapkan RTT Wi-Fi, Anda harus menyediakan dukungan framework dan HAL/firmware:

  • Framework:

    • Kode AOSP
    • Mengaktifkan RTT Wi-Fi: memerlukan tombol fitur

  • Dukungan HAL Wi-Fi RTT (IEEE 802.11mc atau IEEE 802.11az) (yang menyiratkan dukungan firmware)

Untuk mengimplementasikan fitur ini, terapkan antarmuka Wi-Fi AIDL atau HIDL, dan aktifkan flag fitur:

  • Di device.mk yang terletak di device/<oem>/<device>, ubah variabel lingkungan PRODUCT_COPY_FILES untuk menyertakan dukungan bagi fitur RTT Wi-Fi:

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

Jika tidak, semua yang diperlukan untuk fitur ini akan disertakan dalam AOSP.

Pengacakan MAC

Untuk meningkatkan privasi, alamat MAC yang digunakan selama transaksi RTT Wi-Fi harus diacak, yaitu tidak boleh cocok dengan alamat MAC native antarmuka Wi-Fi. Namun, sebagai pengecualian, saat perangkat dikaitkan dengan AP, perangkat dapat menggunakan alamat MAC yang terkait untuk transaksi RTT dengan AP tersebut atau dengan AP lain.

Validasi

Pengujian Android Compatibility Test Suite (CTS) tersedia untuk fitur ini. CTS mendeteksi saat fitur diaktifkan dan otomatis menyertakan pengujian terkait. Fitur ini juga dapat diuji menggunakan Vendor Test Suite (VTS).

Pengujian unit

Pengujian paket Wi-Fi RTT dijalankan menggunakan:

Pengujian layanan:

atest com.android.server.wifi.rtt

Pengujian pengelola:

atest android.net.wifi.rtt

CTS

Pengujian Android Compatibility Test Suite (CTS) tersedia untuk fitur ini. CTS mendeteksi saat fitur diaktifkan dan otomatis menyertakan pengujian terkait. Titik Akses yang mendukung Wi-Fi RTT (IEEE 802.11mc) harus berada dalam jangkauan perangkat yang sedang diuji.

Pengujian CTS dapat dipicu menggunakan:

atest WifiRttTest

Kalibrasi

Agar RTT Wi-Fi berperforma baik, rentang yang ditampilkan dalam protokol 802.11mc atau 802.11az harus akurat dalam indikator performa utama (KPI) seperti yang dijelaskan di bagian ini.

Untuk protokol 11mc, pada bandwidth yang tercantum (80 MHz, 40 MHz, 20 MHz) dan ukuran burst 8, KPI untuk estimasi rentang diharapkan mencapai akurasi berikut pada persentil ke-90 error.

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

Untuk protokol 11az, konfigurasi MIMO antena dan pengulangan medan pelatihan panjang (LTF) memengaruhi akurasi. Dengan ponsel biasa (menggunakan 2 antena) dan titik akses (4 antena), sistem memiliki konfigurasi MIMO 2x4. Untuk konfigurasi tersebut yang menggunakan faktor pengulangan LTF dua dan pada bandwidth yang tercantum (160 MHz, 80 MHz, 40 MHz, 20 MHz), KPI untuk estimasi rentang diharapkan akan mencapai akurasi berikut pada persentil ke-90 error.

  • 160 MHz: 0,5 meter
  • 80 MHz: 1 meter
  • 40 MHz: 2 meter
  • 20 MHz: 4 meter

Untuk memastikan penerapan fitur berfungsi dengan benar, pengujian kalibrasi diperlukan.

Hal ini dapat dicapai dengan membandingkan rentang kebenaran dasar dengan rentang estimasi RTT pada jarak yang semakin meningkat. Untuk kesesuaian dasar, Anda harus memvalidasi solusi terhadap perangkat yang diketahui dikalibrasi RTT. Kalibrasi rentang harus diuji dalam kondisi berikut:

  1. Laboratorium terbuka yang besar, atau koridor yang tidak memiliki banyak objek logam yang dapat menyebabkan kemunculan multi-jalur yang sangat tinggi.
  2. Minimal jalur atau lintasan Jalur Penglihatan (LOS) yang membentang sejauh 25 m.
  3. Penanda dengan kelipatan 0,5 meter dari satu ujung jalur ke ujung lainnya.

  4. Tempat untuk mengamankan titik akses yang kompatibel dengan RTT di salah satu ujung jalur yang dipasang 20 cm di atas lantai, dan dudukan yang dapat dipindahkan untuk ponsel Android (atau perangkat seluler Android lainnya yang sedang diuji) yang dapat dipindahkan di sepanjang jalur, dan disejajarkan dengan penanda 0,5 m, juga 20 cm di atas lantai.

  5. 50 hasil pengukuran rentang harus dicatat di setiap penanda, beserta jarak dari titik akses. Statistik, seperti rata-rata dan varian rentang, harus dihitung untuk setiap posisi penanda.

Dari hasil di langkah 5, diagram dapat digambar untuk kebenaran dasar (sumbu x) terhadap perkiraan rentang (sumbu y) dan garis regresi yang paling sesuai. Kalibrasi perangkat yang ideal akan menghasilkan garis gradien 1,0, dengan offset 0,0 m pada sumbu y. Penyimpangan dari nilai ini dapat diterima jika berada dalam KPI untuk bandwidth yang sesuai. Jika hasilnya berada di luar KPI, fitur perangkat harus dikalibrasi ulang untuk mendapatkan hasil dalam spesifikasi KPI.