Kalibrasi kehadiran

Halaman ini memberikan petunjuk penyiapan dan kalibrasi untuk persyaratan kalibrasi kehadiran bagi perangkat yang menjalankan Android 14 dan yang lebih baru.

Untuk memastikan perangkat smart pengguna berfungsi dengan baik, semua perangkat dalam ekosistem Android harus dapat menentukan kedekatan relatif antarperangkat. Android 14 memperkenalkan persyaratan kalibrasi kehadiran yang menguraikan performa yang dapat diterima dari teknologi radio yang tersedia yang digunakan untuk menentukan kedekatan, seperti Ultra Wideband (UWB), Wi-Fi, dan Bluetooth Hemat Energi (BLE).

Perangkat referensi

Untuk mengkalibrasi perangkat agar memenuhi persyaratan kehadiran, gunakan salah satu perangkat referensi berikut untuk semua kalibrasi.

  • (Direkomendasikan) Ponsel Pixel
  • Jika tidak menggunakan ponsel Pixel, gunakan perangkat dengan merek dan model yang sama dengan perangkat yang sedang diuji.

Faktor bentuk

Kalibrasi kehadiran penting untuk perangkat Android dari semua faktor bentuk. Untuk faktor bentuk selain ponsel, guna menentukan penyiapan kalibrasi yang sesuai untuk perangkat, pertimbangkan bagaimana pengguna yang memegang ponsel (perangkat referensi) akan diposisikan saat berinteraksi dengan perangkat yang diuji (DUT). Misalnya, saat mengkalibrasi TV, tempatkan TV dan ponsel pada jarak yang sesuai satu sama lain dan arahkan perangkat seluler sehingga menghadap ke tengah depan layar TV.

Pengujian akurasi pengukuran jarak

Untuk perangkat yang menjalankan Android 17 dan yang lebih baru, modul CtsMultiDeviceGenericRangingAccuracyTests menyertakan kasus pengujian yang memverifikasi persyaratan kalibrasi kehadiran di halaman ini. Modul ini adalah pengujian multidevice sisi host CTS Verifier (CTS-V) otomatis yang berjalan dari mesin host yang terhubung ke DUT dan perangkat referensi. Modul ini menggantikan pengujian kehadiran manual di CTS-V. Untuk perangkat yang menjalankan Android 16 dan yang lebih rendah, gunakan pengujian kehadiran dalam rilis CTS dan CTS-V untuk versi Android tersebut.

Untuk menjalankan pengujian akurasi pengukuran jarak:

  1. Siapkan mesin host, lalu siapkan CTS-V di DUT dan perangkat referensi. Untuk mengetahui detailnya, lihat Menyiapkan pengujian multiperangkat sisi host.

  2. Tempatkan DUT dan perangkat referensi dengan jarak 1 meter, seperti yang dijelaskan dalam Menyiapkan pengujian akurasi pengukuran jarak dan dalam penyiapan kalibrasi untuk setiap teknologi di halaman ini.

  3. Hubungkan kedua perangkat ke mesin host menggunakan kabel USB.

  4. Dari direktori tempat Anda mengekstrak paket CTS-V, luncurkan konsol host CTS-V:

    ./android-cts-verifier/android-cts-v-host/tools/cts-v-host-tradefed
  5. Di konsol host CTS-V, jalankan pengujian akurasi pengukuran jarak:

    run cts-v-host -m CtsMultiDeviceGenericRangingAccuracyTests
    

    Hasil pengujian akan muncul di aplikasi CTS-V pada DUT di bagian Host-side Tests > UWB Tests > CtsMultiDeviceGenericRangingAccuracyTests.

Setiap kasus pengujian dalam modul mengumpulkan pengukuran menggunakan satu teknologi, menghitung metrik akurasi dari pengukuran, dan mencatat metrik ke dalam log. Kasus pengujian berhasil jika berhasil mengumpulkan pengukuran, meskipun metriknya tidak memenuhi target. Untuk memverifikasi kepatuhan, bandingkan metrik log dengan target yang dijelaskan di bagian berikut. Jika DUT atau perangkat referensi tidak mendukung teknologi, kasus pengujian untuk teknologi tersebut akan dilewati.

Persyaratan UWB

Lihat CDD bagian 7.4.9 untuk mengetahui persyaratan UWB.

Penyiapan kalibrasi UWB

Gunakan penyiapan berikut untuk mengkalibrasi perangkat Anda agar memenuhi persyaratan UWB.

Persyaratan penyiapan umum

  • Diperlukan dua perangkat dengan hardware UWB, satu sebagai DUT dan satu sebagai perangkat referensi.

  • Dua tripod untuk menahan perangkat diperlukan.

  • DUT dan perangkat referensi harus ditempatkan dalam jarak 1 meter di lingkungan ruang pandang di ruang non-reflektif. Kedua perangkat harus diposisikan dalam orientasi potret dengan layar saling membelakangi.

Contoh penyiapan kalibrasi UWB ditampilkan di Gambar 1 dan Video 1.

Penyiapan referensi untuk kalibrasi BLE

Gambar 1. Penyiapan referensi untuk kalibrasi UWB.

Video 1. Penyiapan referensi untuk kalibrasi UWB.

Memverifikasi kepatuhan CDD 7.4.9 [C-1-6] dan [C-1-7]

Untuk memverifikasi kepatuhan terhadap CDD 7.4.9 [C-1-6] dan [C-1-7], jalankan pengujian akurasi pengukuran jarak dan periksa metrik yang dicatat oleh kasus pengujian test_uwb_ranging.

Kasus pengujian memulai sesi pengukuran jarak UWB antara DUT dan perangkat referensi, serta melakukan 1.000 pengukuran dengan setiap perangkat. Untuk pengukuran dari setiap perangkat, kasus pengujian melakukan hal berikut:

  1. Menghitung rentang sebagai: rentang = pengukuran persentil ke-97,5 - pengukuran persentil ke-2,5. Untuk memenuhi persyaratan, rentang harus kurang dari atau sama dengan 30 cm.

  2. Menghitung pengukuran median. Untuk memenuhi persyaratan, median harus berada di antara 0,75 m dan 1,25 m inklusif.

Persyaratan Neighbor Awareness Networking Wi-Fi

CDD bagian 2.2.1. Hardware mencakup persyaratan untuk kepatuhan Neighbor Awareness Networking (NAN) Wi-Fi.

Memverifikasi kepatuhan CDD 2.2.1 [7.4.2.5/H-1-1]

Untuk memverifikasi kepatuhan terhadap CDD 2.2.1 [7.4.2.5/H-1-1], jalankan pengujian akurasi pengukuran jarak dan periksa metrik yang dicatat ke dalam log oleh kasus pengujian test_wifi_rtt_ranging.

Kasus pengujian memulai sesi rentang NAN Wi-Fi antara DUT dan perangkat referensi, serta melakukan 100 pengukuran RTT Wi-Fi. Kasus pengujian kemudian menghitung persentase pengukuran yang berada dalam ±2 m dari jarak sebenarnya, yaitu 1 m. Untuk memenuhi persyaratan bandwidth 80 MHz, setidaknya 68% pengukuran harus berada dalam rentang ±2 m.

Persyaratan RSSI BLE

CDD pasal 7.4.3. Bluetooth mencakup persyaratan untuk kepatuhan RSSI BLE.

Penyiapan kalibrasi

Gunakan penyiapan berikut untuk mengkalibrasi perangkat Anda agar memenuhi persyaratan BLE RSSI.

Persyaratan penyiapan umum

  • Untuk hasil yang optimal, gunakan ruang anechoic untuk meminimalkan interferensi dengan pengukuran.

    Jika tidak menggunakan ruang anechoic, siapkan satu tripod yang menahan perangkat referensi dan satu tripod yang menahan perangkat DUT 1,5 meter dari permukaan tanah, dengan jarak yang sama dari langit-langit.

  • Siapkan perangkat referensi dan perangkat DUT:

    • Pastikan daya kedua perangkat terisi cukup untuk menyelesaikan pengujian.
    • Cabut kedua perangkat selama pengujian.
    • Lepaskan semua casing, kabel yang terpasang, dan aksesori lain yang dapat memengaruhi performa frekuensi radio (RF).
  • Pasang setiap perangkat ke tripod dengan penahan perangkat.

    • Tripod dan dudukan perangkat harus memiliki logam sesedikit mungkin.
    • Pegas logam kecil di penahan perangkat tidak masalah.
  • Singkirkan semua benda logam di antara kedua perangkat.

Penyiapan referensi untuk kalibrasi BLE

Gambar 2. Penyiapan referensi untuk kalibrasi BLE.

Memverifikasi kepatuhan CDD 7.4.3 [C-10-1]

Untuk memverifikasi kepatuhan terhadap CDD 7.4.3 [C-10-1], jalankan pengujian akurasi pengukuran jarak dengan perangkat yang ditempatkan sesuai dengan penyiapan kalibrasi BLE, dan periksa metrik yang dicatat dalam log oleh kasus pengujian test_ble_rssi_ranging.

Kasus pengujian menetapkan perangkat referensi untuk memberitahukan di ADVERTISE_TX_POWER_HIGH, dan mengumpulkan 1.000 pemindaian pada DUT. Kasus pengujian kemudian menghitung rentang 95% tengah pengukuran RSSI. Untuk memenuhi persyaratan, rentang harus kurang dari atau sama dengan 18 dB.

Memverifikasi kepatuhan CDD 7.4.3 [C-10-2]

Untuk memverifikasi kepatuhan terhadap CDD 7.4.3 [C-10-2]: Vendor chip dapat mengukur kerataan saluran dan mengidentifikasi perbedaan antara core dan saluran.

Berikut adalah tips tentang cara mengidentifikasi masalah pada inti yang tidak dikalibrasi dan saluran yang tidak dikalibrasi, yang merupakan dua kemungkinan penyebab penyebaran RSSI yang besar.

Inti yang belum dikalibrasi

Jika antena Bluetooth di perangkat memiliki beberapa inti, inti tersebut mungkin memiliki kalibrasi yang berbeda. Lakukan beberapa pengukuran (setidaknya selama 1 menit) dan periksa data pemindaian. Jika Anda melihat pola yang mirip dengan yang ditunjukkan pada Gambar 3, yang memiliki puncak reguler (seperti yang ditunjukkan oleh lingkaran) karena pemindaian pada beberapa inti, kemungkinan ada masalah dengan inti yang tidak dikalibrasi dan penyelidikan lebih lanjut diperlukan.

Contoh data pemindaian untuk perangkat dengan inti yang tidak dikalibrasi

Gambar 3. Contoh data pemindaian untuk perangkat dengan inti yang tidak dikalibrasi.

Saluran yang tidak dikalibrasi

Transmisi pada BLE klasik terjadi di tiga saluran. Setiap saluran mungkin memiliki perbedaan yang terkait dengannya. Saluran dirotasi pada interval tetap. Lakukan beberapa pengukuran (setidaknya selama 1 menit) dan periksa data pemindaian. Jika Anda melihat pola yang mirip dengan yang ditunjukkan pada Gambar 4, kemungkinan ada masalah kesalahan kalibrasi pada berbagai saluran dan diperlukan penyelidikan lebih lanjut.

Contoh data pemindaian untuk perangkat dengan saluran yang tidak dikalibrasi

Gambar 4. Contoh data pemindaian untuk perangkat dengan saluran yang tidak dikalibrasi.

Memverifikasi kepatuhan CDD 7.4.3 [C-10-3] dan [C-10-4]

Meskipun chip radio BLE dikalibrasi dengan sempurna, RSSI yang diamati oleh perangkat tertentu bergantung pada kualitas antena dan penempatan antena pada produk tertentu (model perangkat). Hal ini menimbulkan masalah untuk interoperabilitas antarperangkat.

Misalnya, pertimbangkan kasus penggunaan membuka kunci mobil. Developer aplikasi mungkin ingin membuka kunci mobil saat perangkat berada dalam jarak 1 meter dari mobil. Developer memilih nilai minimum -60 dBm berdasarkan pengamatannya dengan ponsel yang dimilikinya, tetapi karena perbedaan kualitas antena dan penempatan antena, hal ini mungkin tidak berfungsi dengan baik pada perangkat Android lain meskipun kedua perangkat menggunakan chip yang sama.

Untuk interoperabilitas antara semua perangkat dalam ekosistem, Anda harus mengukur offset Rx untuk setiap perangkat dan menyesuaikan RSSI yang dilaporkan di perangkat untuk memastikan bahwa RSSI BLE memenuhi standar 1 m pada ADVERTISE_TX_POWER_HIGH.

Meskipun chip radio BLE dikalibrasi dengan sempurna, penerima yang ideal akan membaca RSSI yang berbeda bergantung pada kualitas antena dan penempatan antena pada perangkat iklan. Persyaratan Rx memastikan bahwa semua perangkat dapat memberitahukan dengan kekuatan yang sama, dengan semua hal lainnya sama.

Untuk memverifikasi kepatuhan terhadap persyaratan Rx dan Tx:

  1. Tempatkan DUT 1 m dari perangkat referensi, mengikuti penyiapan kalibrasi BLE. Sebaiknya perangkat diorientasikan sedemikian rupa sehingga sejajar satu sama lain dengan layar menghadap ke arah yang sama.

  2. Jalankan pengujian akurasi rentang dan periksa metrik yang dicatat dalam log oleh kasus pengujian test_ble_rx_tx_offset_precision.

    Kasus pengujian menjalankan pengujian Rx dan Tx secara bersamaan, dan mengumpulkan 1.000 pemindaian untuk setiap pengujian:

    • Rx: DUT memindai saat perangkat referensi memberitahukan di ADVERTISE_TX_POWER_HIGH.
    • Tx: Perangkat referensi memindai saat DUT memberitahukan di ADVERTISE_TX_POWER_HIGH.

    Untuk memenuhi persyaratan, median RSSI untuk pengujian Rx dan Tx harus antara -65 dBm dan -45 dBm.

  3. Kalibrasikan perangkat untuk mengimbangi offset Rx dan daya Tx guna memastikan RSSI median -55 dBm.

    • Rx: Sesuaikan RSSI dengan menetapkan properti sistem bluetooth.hardware.radio.le_rx_path_loss_comp_db ke nilai (dB) yang mengompensasi offset Rx untuk memastikan median BLE RSSI -55 dBm pada jarak 1 m. Stack Bluetooth menyesuaikan RSSI menjadi RSSI ditambah nilai bluetooth.hardware.radio.le_rx_path_loss_comp_db.

      Untuk mengetahui detailnya, lihat le_scanning_manager.cc.

    • Tx: Sesuaikan daya Tx dengan menetapkan properti sistem bluetooth.hardware.radio.le_tx_path_loss_comp_db ke nilai (dB) yang mengompensasi daya Tx untuk memastikan RSSI BLE median sebesar -55 dBm pada jarak 1 m. Stack Bluetooth menyesuaikan daya Tx menjadi daya Tx ditambah nilai bluetooth.hardware.radio.le_tx_path_loss_comp_db.

      Untuk detailnya, lihat le_advertising_manager.cc.

Persyaratan Pengukuran Jarak Saluran BLE

CDD pasal 7.4.3. Bluetooth mencakup persyaratan untuk akurasi BLE Channel Sounding (CS). Persyaratan [C-11-2] menentukan bahwa perangkat yang mendeklarasikan FEATURE_BLUETOOTH_LE_CHANNEL_SOUNDING harus melaporkan rentang secara akurat dalam ±0,5 m pada persentil ke-90, seperti yang dihitung dengan fungsi distribusi kumulatif (CDF), pada jarak 1 m.

Memverifikasi kepatuhan CDD 7.4.3 [C-11-2]

Untuk memverifikasi kepatuhan terhadap CDD 7.4.3 [C-11-2], jalankan pengujian akurasi pengukuran jarak dengan perangkat yang ditempatkan sesuai dengan penyiapan kalibrasi BLE, dan periksa metrik yang dicatat dalam log oleh kasus pengujian test_channel_sounding_ranging. DUT dan perangkat referensi harus mendukung BLE CS.

Kasus pengujian mengikat DUT dan perangkat referensi melalui BLE, memulai sesi pengukuran jarak BLE CS di antara keduanya, dan melakukan 100 pengukuran jarak. Kasus pengujian kemudian menghitung persentase pengukuran yang berada dalam ±0,5 m dari jarak sebenarnya 1 m. Untuk memenuhi persyaratan, setidaknya 90% pengukuran harus berada dalam rentang ±0,5 m.