Tujuan Waktu Round Trip (RTT) Wi-Fi di Android 9 memungkinkan perangkat pendukung untuk mengukur jarak ke perangkat pendukung lainnya: apakah perangkat itu merupakan Titik Akses (AP) (AP) atau rekan Wi-Fi Aware (jika Wi-Fi Aware didukung di perangkat). Fitur ini, dibuat berdasarkan IEEE 802.11mc dan protokol IEEE 802.11az (tersedia dari Android 15), memungkinkan aplikasi menggunakan akurasi dan kesadaran lokasi yang ditingkatkan.
Contoh dan sumber
Untuk menggunakan fitur ini, implementasikan antarmuka Vendor HAL. Di Android 14 dan yang lebih tinggi, antarmuka Vendor HAL didefinisikan menggunakan AIDL. Di Android 13 dan yang lebih lama, antarmuka Vendor HAL ditentukan menggunakan HIDL. Di Android 8.0, HIDL menggantikan struktur {i>Hardware Abstraksi Layer<i} (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 diimplementasikan, hal ini adalah:
- AIDL:
hardware/interfaces/wifi/aidl - HIDL:
hardware/interfaces/wifi/1.0atau yang lebih baru.
Anda dapat merujuk ke Wi-Fi HAL lama untuk melihat korelasinya dengan Antarmuka AIDL dan HIDL: hardware/libhardware_legacy/+/main/include/hardware_legacy/rtt.h.
Implementasi
Untuk menerapkan Wi-Fi RTT, Anda harus menyediakan framework dan HAL/firmware dukung:
Kerangka kerja:
- Kode AOSP
- Mengaktifkan Wi-Fi RTT: memerlukan tombol fitur
Wi-Fi RTT (IEEE 802.11mc atau IEEE 802.11az) dukungan HAL (yang menyiratkan dukungan firmware)
Untuk menerapkan fitur ini, implementasikan antarmuka Wi-Fi AIDL atau HIDL, dan aktifkan tombol fitur:
Di
device.mkyang berada didevice/<oem>/<device>, ubah Variabel lingkunganPRODUCT_COPY_FILESuntuk menyertakan dukungan Wi-Fi Fitur 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 sudah 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 asli jaringan Wi-Fi dalam antarmuka berbasis web yang sederhana. Namun, sebagai pengecualian, ketika perangkat dikaitkan dengan AP, dapat menggunakan alamat MAC yang terkait dengan transaksi RTT apa pun dengan AP itu atau dengan AP lainnya.
Validasi
Terdapat uji coba Compatibility Test Suite (CTS) Android untuk fitur ini. Mendeteksi CTS 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
Pengelola menguji:
atest android.net.wifi.rtt
CTS
Terdapat uji coba Compatibility Test Suite (CTS) Android untuk fitur ini. Mendeteksi CTS saat fitur diaktifkan dan otomatis menyertakan pengujian terkait. Channel Titik Akses yang mendukung Wi-Fi RTT (IEEE 802.11mc) harus berada dalam jangkauan perangkat yang sedang diuji.
Uji CTS dapat dipicu menggunakan:
atest WifiRttTest
Kalibrasi
Agar Wi-Fi RTT berperforma baik, rentang yang ditampilkan di 802.11mc atau 802.11az protokol harus akurat dalam indikator kinerja utama (KPI) karena 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 diperkirakan akan mencapai akurasi berikut pada persentil error ke-90.
- 80 MHz: 2 meter
- 40 MHz: 4 meter
- 20 MHz: 8 meter
Untuk protokol 11az, konfigurasi antena MIMO dan sesi pelatihan pengulangan bidang (LTF) memengaruhi akurasi. Dengan ponsel biasa (menggunakan 2 antena) dan titik akses (4 antena), sistem memiliki MIMO 2x4 konfigurasi Anda. Untuk konfigurasi tersebut, menggunakan faktor pengulangan LTF dua dan pada bandwidth yang tercantum (160 MHz, 80 MHz, 40 MHz, 20 MHz), KPI untuk estimasi rentang diharapkan mencapai hal berikut akurasi 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, kalibrasi pengujian diperlukan.
Hal ini dapat dicapai dengan membandingkan rentang kebenaran dasar dengan perkiraan RTT dengan jarak yang semakin tinggi. Untuk kesesuaian dasar, Anda harus memvalidasi pada perangkat yang diketahui dikalibrasi RTT. Kalibrasi rentang seharusnya diuji dalam kondisi berikut:
- Laboratorium terbuka yang besar, atau koridor yang tidak memiliki banyak logam objek yang dapat mengakibatkan kemunculan multi-jalur yang sangat tinggi.
- Setidaknya jalur Line-Of-Sight (LOS) atau jalur yang membentang sepanjang 25 m.
- Penanda dengan kelipatan 0,5 meter dari satu ujung trek ke ujung lainnya.
Tempat untuk mengamankan titik akses yang mendukung RTT di salah satu ujung jalur dipasang 20 cm di atas lantai, dan penyangga yang dapat dipindah untuk ponsel Android (atau perangkat seluler Android lain yang sedang diuji) yang dapat dipindahkan sepanjang jalur, dan sejajar dengan penanda 0,5 m, juga pada ketinggian 20 cm di atas lantai.
50 hasil rentang harus dicatat pada setiap penanda, bersama dengan jarak dari titik akses. Statistik, seperti rata-rata rentang dan varians, 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 estimasi garis regresi yang paling sesuai. Ideal kalibrasi perangkat akan menghasilkan garis gradien 1,0, dengan offset 0,0 m pada sumbu y. Penyimpangan dari nilai-nilai ini dapat diterima jika nilai tersebut berada dalam KPI untuk bandwidth yang sesuai. Jika hasilnya di luar KPI, fitur perangkat harus dikalibrasi ulang untuk memberikan hasil yang sesuai dengan KPI spesifikasi pendukung.