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

Fitur Wi-Fi Round Trip Time (RTT) di Android 9 memungkinkan perangkat yang didukung mengukur jarak ke perangkat lain yang didukung: baik berupa Titik Akses (AP) atau perangkat peer Wi-Fi Aware (jika Wi-Fi Aware didukung di perangkat). Fitur ini, yang dibangun 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 tinggi, antarmuka Vendor HAL ditentukan menggunakan AIDL. Di Android 13 dan yang lebih rendah, antarmuka HAL Vendor ditentukan menggunakan HIDL. Di Android 8.0, HIDL menggantikan struktur Hardware Abstraction Layer (HAL) sebelumnya yang digunakan untuk menyederhanakan penerapan 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 korelasinya dengan antarmuka AIDL dan HIDL: hardware/libhardware_legacy/+/android16-release/include/hardware_legacy/rtt.h.

Implementasi

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

  • Framework:

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

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

Untuk mengimplementasikan fitur ini, implementasikan antarmuka AIDL atau HIDL Wi-Fi, dan aktifkan tanda fitur:

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

    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 disertakan dalam AOSP.

Pengacakan MAC

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

Validasi

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

Pengujian unit

Pengujian paket Wi-Fi RTT dieksekusi menggunakan:

Uji layanan:

atest com.android.server.wifi.rtt

Pengujian pengelola:

atest android.net.wifi.rtt

CTS

Pengujian Android Compatibility Test Suite (CTS) ada untuk fitur ini. CTS mendeteksi saat fitur diaktifkan dan secara 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 Wi-Fi RTT berfungsi dengan 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 error ke-90.

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

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

  • 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 perkiraan RTT pada jarak yang semakin jauh. Untuk kepatuhan dasar, Anda harus memvalidasi solusi terhadap perangkat yang diketahui telah dikalibrasi RTT. Kalibrasi rentang harus diuji dalam kondisi berikut:

  1. Laboratorium terbuka yang besar, atau koridor yang tidak memiliki banyak benda logam yang dapat menyebabkan terjadinya multi-path yang sangat tinggi.
  2. Setidaknya jalur atau lintasan Line-Of-Sight (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 lain 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 jarak harus dicatat di setiap penanda, beserta jarak dari titik akses. Statistik, seperti rata-rata dan varians rentang, harus dihitung untuk setiap posisi penanda.

Dari hasil pada langkah 5, diagram dapat dibuat untuk kebenaran nyata (sumbu x) terhadap perkiraan rentang (sumbu y) dan perkiraan 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 agar hasilnya sesuai dengan spesifikasi KPI.