Pengukuran jarak: Spesifikasi out-of-band versi 3

Android 16 memperkenalkan Modul pengukuran jarak. Spesifikasi protokol dan payload ini menentukan urutan pesan dan payload komunikasi di luar band (OOB) yang digunakan untuk menukar konfigurasi pengukuran jarak, serta untuk memulai dan menghentikan pengukuran jarak, antara perangkat inisiator dan perangkat responder yang terlibat dalam pengukuran jarak. Android 17 memperkenalkan versi 3 dari spesifikasi ini.

Halaman ini menjelaskan cara penyedia perangkat non-Android dapat menerapkan spesifikasi ini agar perangkat mereka kompatibel dengan perangkat Android.

Implementasi spesifikasi ini di Packet Description Language (PDL) Google tersedia di GitHub. Dari penerapan ini, compiler PDL dapat membuat kode serialisasi dan deserialisasi untuk pesan yang ditentukan dalam spesifikasi ini. Spesifikasi ini mendukung berbagai bahasa target termasuk C++, Rust, dan Java.

Yang baru di versi 3

Spesifikasi OOB versi 3 memperkenalkan perubahan berikut:

  • Notifikasi Gerakan: Pesan yang digunakan perangkat pengiklan untuk memberi tahu perangkat yang memulai tentang perubahan gerakan.
  • Konfigurasi Pengukuran Jarak: Mencakup kolom Motion support baru untuk memberi tahu pemrakarsa agar memberi tahu responden tentang perubahan gerakan periferal dari responden.
  • Menambahkan dukungan teknologi PD Wi-Fi baru di Ranging Capability dan Ranging Configuration.
  • Menghentikan penggunaan kolom Supported Bandwidth dan Supported number of Receive chains di Wi-Fi NAN RTT Ranging Capability.

Endianness

Kecuali jika ditentukan lain, semua kolom numerik multi-byte dalam pesan berada dalam urutan little-endian.

Pesan dan urutan pesan

Bagian ini menjelaskan pesan dan urutan pertukaran pesan.

Tabel berikut menampilkan semua pesan yang ada dalam pertukaran OOB:

Pesan ID Pesan
Ranging Capability Request 0x0
Ranging Capability Response 0x1
Ranging Configuration 0x2
Ranging Configuration Response (opsional) 0x3
Stop Ranging 0x6
Stop Ranging Response (opsional) 0x7
Motion Notification 0x8

Pertukaran pesan dimulai dengan perangkat inisiator yang mengirim Ranging Capability Request ke perangkat responder. Perangkat responder membalas dengan mengirim Ranging Capability Response, seperti yang ditunjukkan pada Gambar 1:

Alur saluran komunikasi

Gambar 1. Pertukaran pesan OOB menggunakan saluran komunikasi berbasis koneksi.

Perangkat responder akan segera memulai pengukuran jarak setelah menerima pesan Ranging Configuration. Perangkat responder berhenti melakukan pengukuran jarak setelah menerima atau mendeteksi pesan Stop Ranging.

Perangkat responder mengisi kemampuan hanya teknologi pengukuran jarak yang diminta dalam pesan Ranging Capability Request.

Perangkat pemrakarsa berharap hanya menerima satu respons untuk setiap pesan permintaan yang dikirimnya. Perangkat responder tidak boleh membuat asumsi semacam itu sehingga dapat merespons permintaan apa pun dalam urutan apa pun. Hal ini memverifikasi bahwa perangkat responder dapat merespons beberapa pesan Ranging Capability Request berturut-turut, atau pesan lain yang tidak berurutan, dari perangkat inisiator.

Transisi teknologi

Versi OOB memungkinkan perangkat bertransisi secara dinamis antara berbagai teknologi pengukuran jarak selama sesi. Untuk memfasilitasi hal ini, pemrakarsa dapat:

  • Kirim beberapa pesan Ranging Configuration untuk memulai teknologi baru.
  • Kirim beberapa pesan Stop Ranging untuk menghentikan teknologi aktif.

Urutan pesan ini bervariasi, bergantung pada skema transisi yang didukung oleh responder:

  • Break-before-make: Pemrakarsa dapat bertransisi ke teknologi baru hanya dengan menghentikan yang pertama menggunakan pesan Stop Ranging sebelum memulai yang kedua menggunakan pesan Ranging Configuration.
  • Make-before-break: Pemrakarsa dapat memulai teknologi baru menggunakan pesan Ranging Configuration sebelum menghentikan teknologi yang ada dengan pesan Stop Ranging.

Responder harus menerapkan dukungan untuk salah satu skema transisi ini sesuai dengan nilai kolom supported technology transitioning dalam Ranging Capability Response-nya.

ID teknologi pengukuran jarak

ID teknologi pengukuran jarak tercantum dalam tabel berikut:

Teknologi pengukuran jarak ID
UWB 0x0
CS 0x1
RTT NAN Wi-Fi 0x2
RSSI 0x3
PD Wi-Fi 0x4
RFU 0x5 - 0xFF

ID ini digunakan dalam tabel di halaman ini jika ID teknologi pengukuran jarak diperlukan. Untuk kolom yang berisi bitfield teknologi pengukuran jarak, bit yang sesuai dengan indeks ID teknologi akan ditetapkan saat teknologi tersebut disertakan dalam bitfield.

Misalnya, RSSI memiliki nilai ID 3, tetapi jika RSSI disertakan dalam bitfield teknologi pengukuran jarak, maka bit dengan posisi ID (3) harus diaktifkan (bit pertama berada di posisi 0), sehingga nilai bitfield yang dihasilkan adalah 0x8. Jika UWB dan RSSI disertakan, nilai bitfield adalah 0x0A (bit 0 dan 3 diaktifkan).

Format pesan

Setiap pesan terdiri dari header dan payload.

Format pesan

Gambar 3. Format pesan.

Ukuran: 2 byte

Deskripsi: Umum di semua pesan, header adalah bagian pertama yang masuk ke dalam pesan. Header berisi versi dan ID jenis pesan. Kolom versi menentukan versi spesifikasi yang dipatuhi oleh konten pesan. Untuk mengetahui informasi selengkapnya tentang cara penggunaan pembuatan versi di antara perangkat dengan versi yang berbeda, lihat Pembuatan versi. Header tetap kompatibel mundur di berbagai versi, yang berarti kasus penggunaan selalu dapat menguraikannya untuk menentukan versi dan ID pesan.

Header diringkas dalam tabel berikut:

Octet Jenis data Deskripsi Nilai
0 uint8 Versi
  • 0x1 - V1
  • 0x2 - V2
  • 0x3 - V3
1 uint8 ID Pesan
  • 0x0 - Ranging Capability Request pesan
  • 0x1 - Ranging Capability Response pesan
  • 0x2 - Ranging Configuration pesan
  • 0x3 - Pesan Ranging Configuration Response (opsional)
  • 0x6 - Stop Ranging pesan
  • 0x7 - Stop Ranging Response message (opsional)
  • 0x8 - Motion Notification pesan
  • 0x4-0x5, 0x9 - 0xFF RFU

Payload

Ukuran: Bervariasi (bergantung pada jenis pesan)

Deskripsi: Payload adalah bagian terakhir dari pesan, setelah header. Payload bergantung pada jenis pesan. Format payload setiap jenis pesan individual ditentukan di bagian berikut.

Payload pesan Permintaan Kemampuan Pengukuran Jarak

Ukuran (ukuran header tidak disertakan): 2 byte

Deskripsi: Dikirim oleh perangkat pemrakarsa untuk memulai pertukaran pesan.

Payload pesan Ranging Capability Request diringkas dalam tabel berikut:

Octet Jenis data Deskripsi Nilai
0 uint8*2 Bitfield teknologi ranging yang diminta
  • 0x01 - UWB
  • 0x02 - BLE channel sounding
  • 0x04 - Wi-Fi NAN RTT
  • 0x08 - BLE RSSI
  • 0x10 - Deteksi kedekatan (PD) Wi-Fi
  • RFU

Payload pesan Respons Kemampuan Pengukuran Jarak

Ukuran (ukuran header tidak disertakan): Bervariasi (bagian umum 2 byte ditambah ukuran setiap byte teknologi rentang yang disertakan)

Deskripsi: Dikirim oleh responden sebagai respons terhadap pesan Ranging Capability Request. Payload pesan ini terdiri dari bagian umum, dan bagian khusus teknologi pengukuran jarak (BLE CS, Wi-Fi NAN RTT, BLE RSSI), seperti yang ditunjukkan dalam tabel berikut. Setiap bagian khusus teknologi pengukuran jarak harus ditambahkan hanya jika teknologi pengukuran jarak tersebut didukung oleh perangkat responder dan diminta dalam pesan Ranging Capability Request.

Payload pesan Ranging Capability Response umum diringkas dalam tabel berikut:

Octet Jenis data Deskripsi Nilai
0 uint8*2 Bitfield teknologi pengukuran jarak yang didukung. Menunjukkan serangkaian kemampuan teknologi pengukuran jarak yang mengikuti di bagian payload lainnya.
  • 0x01 - UWB
  • 0x02 - BLE channel sounding
  • 0x04 - Wi-Fi NAN RTT
  • 0x08 - BLE RSSI
  • 0x10 - Wi-Fi PD
  • RFU
2 array byte Byte kemampuan teknologi pengukuran jarak. Blok struct berulang yang ditentukan per teknologi.
Bervariasi uint8 Menunjukkan dukungan untuk transisi teknologi.
  • 0x00 - Break-before-make didukung.
  • 0x01 - Make-before-break didukung. Responder dapat melakukan pengukuran jarak dengan beberapa teknologi secara bersamaan.
Bervariasi uint16 Menunjukkan jenis perangkat responden.
  • 0x00 - Tidak diketahui
  • 0x01 - Ponsel
  • 0x02 - Tablet
  • 0x03 - Tag
  • 0x04 - Perangkat wearable
  • 0x05 - Perangkat dengar
  • RFU

Payload pesan UWB Ranging Capability Response diringkas dalam tabel berikut:

Octet Jenis data Deskripsi Nilai
0 uint8 ID teknologi pengukuran jarak 0x0 - UWB
1 uint8 Ukuran Ukuran byte kemampuan UWB (termasuk kolom Technology ID dan Size) dalam byte.
2 uint8*2 Alamat UWB Alamat UWB perangkat 2 byte.
4 uint8*4 Bitfield saluran yang didukung Bitfield saluran yang didukung. Bit yang ditetapkan ke 0 menunjukkan tidak didukung, 1 menunjukkan didukung. Bit 0 sesuai dengan channel 0.
LSB == channel 0
MSB == channel 31
8 uint8*4 Bitfield indeks pembuka yang didukung Bitfield indeks preamble yang didukung. Bit yang ditetapkan ke 0 menunjukkan tidak didukung, 1 menunjukkan didukung. Bit 0 sesuai dengan indeks preamble 1.
LSB == preamble index 1
MSB == preamble index 32
12 uint8*4 Bitfield ID konfigurasi yang didukung Bitfield ID konfigurasi UWB yang didukung. Bit yang disetel ke 0 menunjukkan tidak didukung, 1 menunjukkan didukung.
LSB == config Id 0
MSB == config Id 31
16 uint8*2 Interval pengukuran jarak minimum yang didukung Menunjukkan interval pengukuran jarak tercepat yang didukung dalam milidetik. Nilai yang diizinkan (dalam ms):
  • 96
  • 120
  • 240
  • 600
18 uint8 Durasi slot minimum yang didukung Menunjukkan durasi slot terkecil yang didukung dalam milidetik. Misalnya, jika perangkat menampilkan 1 md, maka diasumsikan perangkat tersebut juga mendukung durasi slot 2 md atau yang lebih tinggi. Nilai yang diizinkan (dalam ms):
  • 1
  • 2
19 uint8 Bitfield peran perangkat UWB yang didukung Bitfield peran UWB yang didukung. Misalnya, jika keduanya mendukung, nilai kolom akhir adalah 0x3.
  • 0x1 - peran pemrakarsa didukung
  • 0x2 - peran responden didukung

Payload pesan Ranging Capability Response BLE CS diringkas dalam tabel berikut:

Octet Jenis data Deskripsi Nilai
0 uint8 ID teknologi pengukuran jarak 0x1 - BLE CS
1 uint8 Ukuran Ukuran byte kemampuan CS BLE (termasuk kolom Technology ID dan Size) dalam byte.
2 uint8 Bitfield jenis keamanan yang didukung Bitfield jenis keamanan yang didukung untuk BLE CS.
  • 0x01 - CS_SECURITY_LEVEL_UNKNOWN
  • 0x02 - CS_SECURITY_LEVEL_ONE
  • 0x04 - CS_SECURITY_LEVEL_TWO
  • 0x08 - CS_SECURITY_LEVEL_THREE
  • 0x10 - CS_SECURITY_LEVEL_FOUR
3 uint8*6 Alamat perangkat Alamat perangkat yang digunakan untuk CS BLE; dalam urutan big-endian.

Payload pesan RTT NAN Wi-Fi Ranging Capability Response diringkas dalam tabel berikut:

Octet Jenis data Deskripsi Nilai
0 uint8 ID teknologi pengukuran jarak 0x2 - Wi-Fi NAN RTT
1 uint8 Ukuran Ukuran byte kemampuan RTT NAN Wi-Fi (termasuk kolom Technology ID dan Size) dalam byte.
2 uint8 Bitfield fitur yang didukung Bitfield fitur yang didukung.
  • 0x01 - Kompatibel dengan 11mc
  • 0x02 - Mendukung 11az
3 uint8 Mendukung pengukuran jarak berkala
  • 0x0 - periodic ranging tidak didukung
  • 0x1 - didukung pengukuran jarak berkala
4 uint8 Bandwidth yang didukung TIDAK DIGUNAKAN LAGI: Informasi ini membantu mendapatkan akurasi pengukuran jarak yang dapat dicapai menggunakan Wi-Fi NAN dan dapat membantu aplikasi menentukan apakah akan menggunakan UWB, BLE CS, BLE RSSI, atau Wi-Fi NAN untuk pengukuran jarak.
  • 0x00 - 20 MHz
  • 0x01 - 40 MHz
  • 0x02 - 80 MHz
  • 0x03 - 160 MHz
  • 0x04 - 80+80 MHz
  • 0x05 - 320 MHz
  • RFU
5 uint8 Jumlah rantai penerimaan yang didukung TIDAK DIGUNAKAN LAGI: Informasi ini membantu mendapatkan akurasi pengukuran jarak yang dapat dicapai menggunakan Wi-Fi NAN dan dapat membantu aplikasi menentukan apakah akan menggunakan UWB, BLE CS, BLE RSSI, atau Wi-Fi NAN untuk pengukuran jarak.
  • 0x00 - Belum ditentukan
  • 0x01 - 1 RX chain
  • 0x02 - 2 RX chains
  • 0x03 - 3 rantai RX
  • 0x04 - 4 rantai RX

Payload pesan BLE RSSI Ranging Capability Response diringkas dalam tabel berikut:

Octet Jenis data Deskripsi Nilai
0 uint8 ID teknologi pengukuran jarak 0x3 - BLE RSSI
1 uint8 Ukuran Ukuran byte kemampuan RSSI BLE (termasuk kolom Technology ID dan Size) dalam byte
2 uint8*6 Alamat perangkat Alamat perangkat yang digunakan untuk BLE RSSI; dalam urutan big-endian

Payload pesan Ranging Capability Response PD Wi-Fi diringkas dalam tabel berikut:

Octet Jenis data Deskripsi Nilai
0 uint8 ID teknologi pengukuran jarak 0x4 - Wi-Fi PD
1 uint8 Ukuran Ukuran byte kemampuan PD Wi-Fi (termasuk kolom ID Teknologi dan Ukuran) dalam byte
2 uint8 Fitur yang didukung Bitmap
  • b0 - Kompatibel dengan 11mc
  • b1 - Kompatibel dengan 11az
3 uint8 Mode PASN Bitmap
  • b0 - Mode PASN yang tidak diautentikasi
  • b1 - Mode PASN yang diautentikasi
4 uint8*6 Alamat perangkat Alamat perangkat yang digunakan untuk Wi-Fi PD; dalam urutan big-endian.
10 uint8*2 Interval pengukuran jarak minimum 802.11mc Interval pengukuran jarak minimum yang didukung dalam format big-endian untuk 11mc
12 uint8*2 Interval pengukuran jarak minimum 802.11az Interval pengukuran jarak minimum yang didukung dalam format big-endian untuk 11az
14 uint8 Jenis preamble maks
  • 0 - PREAMBLE_LEGACY
  • 1 - PREAMBLE_HT
  • 2 - PREAMBLE_VHT
  • 3 - PREAMBLE_HE
  • 4 - PREAMBLE_EHT

Hal ini mengasumsikan bahwa semua jenis preamble yang lebih rendah didukung.
15 uint8 Lebar saluran maksimum
  • 0 - CHANNEL_WIDTH_20MHZ
  • 1 - CHANNEL_WIDTH_40MHZ
  • 2 - CHANNEL_WIDTH_80MHZ
  • 3 - CHANNEL_WIDTH_160MHZ
  • 4 - CHANNEL_WIDTH_80MHZ_PLUS_MHZ
  • 5 - CHANNEL_WIDTH_320MHZ

Hal ini mengasumsikan bahwa semua lebar channel yang lebih rendah didukung.
16 uint8*2 Frekuensi saluran yang didukung
  • b0 - Channel 1
  • b1 - Channel 11
  • b2 - Channel 36
  • b3 - Channel 40
  • b4 - Channel 44
  • b5 - Channel 48
  • b6 - Channel 153
  • b7 - Channel 157
  • b8 - Channel 161
  • b9 - Channel 165
  • b10-b15 - RFU

Payload pesan Konfigurasi Pengukuran Jarak

Ukuran (ukuran header tidak disertakan): Bervariasi (bagian umum 4 byte ditambah ukuran setiap byte teknologi rentang yang disertakan).

Deskripsi: Pesan ini dikirim oleh pemrakarsa dan berisi konfigurasi yang dapat digunakan setiap teknologi pengukuran jarak untuk memulai pengukuran jarak. Perangkat responder harus mencoba memulai pengukuran jarak dengan setiap teknologi pengukuran jarak yang ditunjukkan setelah menerima pesan ini. Payload pesan ini terdiri dari bagian umum, dan bagian khusus teknologi pengukuran jarak (UWB, BLE CS, Wi-Fi NAN RTT, BLE RSSI), seperti yang ditunjukkan dalam tabel berikut.

Payload pesan Ranging Configuration umum diringkas dalam tabel berikut:

Octet Jenis data Deskripsi Nilai
0 uint8*2 Bitfield set konfigurasi teknologi pengukuran jarak Bitfield teknologi pengukuran jarak yang berisi data konfigurasi untuk pesan ini dan parameter konfigurasi yang harus ditetapkan.
  • 0x01 - UWB
  • 0x02 - BLE channel sounding
  • 0x04 - Wi-Fi NAN RTT
  • 0x08 - BLE RSSI
  • 0x10 - Wi-Fi PD
  • RFU
2 uint8*2 Bitfield RFU. Harus ditetapkan ke nilai yang sama dengan kolom Bitfield set konfigurasi teknologi pengukuran jarak.
4 array byte Byte konfigurasi teknologi pengukuran jarak Blok struct berulang yang ditentukan per teknologi
Bervariasi uint8 Dukungan gerakan Motion Notification meminta
  • 0x0 - Menunjukkan tidak ada data gerakan yang diperlukan oleh perangkat inisiator.
  • 0x1 - Menunjukkan bahwa perangkat inisiator memerlukan data gerakan dari perangkat peer.

Payload pesan Ranging Configuration UWB diringkas dalam tabel berikut:

Octet Jenis data Deskripsi Nilai
0 uint8 ID teknologi pengukuran jarak 0x0 - UWB
1 uint8 Ukuran Ukuran konfigurasi UWB (termasuk kolom ID Teknologi dan Ukuran) dalam byte
2 uint8*2 Alamat UWB Alamat UWB perangkat 2 byte
4 uint8*4 ID Sesi ID sesi yang dibuat. ID sesi adalah ID unik untuk sesi pengukuran jarak antara ponsel dan perangkat periferal.
8 uint8 ID konfigurasi yang dipilih Nomor ID konfigurasi yang dipilih dalam bilangan bulat. ID konfigurasi menentukan parameter pengaturan waktu dan jenis keamanan yang harus digunakan untuk sesi pengukuran jarak UWB.
9 uint8 Channel yang dipilih Saluran yang dipilih untuk sesi pengukuran UWB
10 uint8 Indeks pembukaan yang dipilih Indeks pembukaan yang dipilih untuk sesi pengukuran jarak UWB
11 uint8*2 Interval pengukuran jarak yang dipilih Interval pengukuran jarak yang dipilih dalam milidetik. Nilai yang diizinkan (dalam ms):
  • 96
  • 120
  • 240
  • 600
13 uint8 Durasi slot yang dipilih Durasi slot yang dipilih dalam milidetik. Nilai yang diizinkan (dalam ms):
  • 1
  • 2
14 uint8 Panjang kunci sesi Panjang kunci sesi dalam byte
15 array byte Kunci sesi Kunci sesi. Jika S-STS digunakan, dua byte pertama adalah VENDOR ID dan enam byte berikutnya adalah STATIC STS IV. Jika P-STS digunakan, ini adalah kunci sesi 16 byte atau 32 byte. Jenis keamanan yang digunakan ditentukan oleh ID konfigurasi.
di waktu/bulan/tempat/tanggal tertentu uint8*2 Kode negara Kode negara ISO 3166-1 alpha-2, yang ditampilkan oleh dua karakter ASCII
di waktu/bulan/tempat/tanggal tertentu uint8 Peran perangkat yang dipilih
  • 0x01 - Inisiator
  • 0x02 - Responder
di waktu/bulan/tempat/tanggal tertentu uint8 Mode perangkat yang dipilih
  • 0x01 - Pengontrol
  • 0x02 - Controlee

Payload pesan Ranging Configuration BLE CS diringkas dalam tabel berikut:

Octet Jenis data Deskripsi Nilai
0 uint8 ID teknologi pengukuran jarak 0x1 - BLE CS
1 uint8 Ukuran Ukuran konfigurasi BLE CS (termasuk kolom Technology ID dan Size) dalam byte
2 uint8 Jenis keamanan yang dipilih Jenis keamanan yang dipilih. Nilai yang diizinkan:
  • 0x0 - CS_SECURITY_LEVEL_UNKNOWN
  • 0x1 - CS_SECURITY_LEVEL_ONE
  • 0x2 - CS_SECURITY_LEVEL_TWO
  • 0x3 - CS_SECURITY_LEVEL_THREE
  • 0x4 - CS_SECURITY_LEVEL_FOUR
3 uint8*6 Alamat perangkat Alamat perangkat yang digunakan untuk CS BLE; dalam urutan big-endian

Payload pesan RTT NAN Wi-Fi Ranging Configuration diringkas dalam tabel berikut:

Octet Jenis data Deskripsi Nilai
0 uint8 ID teknologi pengukuran jarak 0x2 - Wi-Fi NAN RTT
1 uint8 Ukuran Ukuran konfigurasi RTT NAN Wi-Fi (termasuk kolom Technology ID dan Size) dalam byte
2 uint8 Panjang nama layanan Panjang kolom Nama layanan dalam byte. Lihat Spesifikasi Wi-Fi Aware v4.0 bagian 1.3.3 Tabel 1. Definisi.
3 array byte Nama layanan Nama layanan. Lihat Spesifikasi Wi-Fi Aware v4.0 bagian 1.3.3 Tabel 1. Definisi.
di waktu/bulan/tempat/tanggal tertentu uint8 Peran perangkat
  • 0x0 - Responder (penerbit layanan NAN)
  • 0x1 - Inisiator (pelanggan layanan NAN)
di waktu/bulan/tempat/tanggal tertentu uint8 Menggunakan pengukuran jarak berkala
  • 0x0 - Pengukuran jarak berkala dinonaktifkan
  • 0x1 - Pengukuran jarak berkala diaktifkan

Payload pesan BLE RSSI Ranging Configuration diringkas dalam tabel berikut:

Octet Jenis data Deskripsi Nilai
0 uint8 ID teknologi pengukuran jarak 0x3 - BLE RSSI
1 uint8 Ukuran Ukuran konfigurasi RSSI BLE (termasuk kolom Technology ID dan Size) dalam byte
2 uint8*6 Alamat perangkat Alamat perangkat yang digunakan untuk BLE RSSI; dalam urutan big-endian

Payload pesan Ranging Configuration PD Wi-Fi diringkas dalam tabel berikut:

Octet Jenis data Deskripsi Nilai
0 uint8 ID teknologi pengukuran jarak 0x4 - Wi-Fi PD
1 uint8 Ukuran Ukuran konfigurasi PD Wi-Fi (termasuk kolom ID Teknologi dan Ukuran) dalam byte
2 uint8 Fitur
  • 0x01 - 11mc
  • 0x02 - 11az
3 uint8*6 Alamat MAC Alamat MAC inisiator
9 uint8*2 Interval pengukuran Interval pengukuran jarak dalam md
11 uint8 Kata pengantar yang dipilih
  • 0 - PREAMBLE_LEGACY
  • 1 - PREAMBLE_HT
  • 2 - PREAMBLE_VHT
  • 3 - PREAMBLE_HE
  • 4 - PREAMBLE_EHT
12 uint8 Lebar saluran yang dipilih
  • 0 - CHANNEL_WIDTH_20MHZ
  • 1 - CHANNEL_WIDTH_40MHZ
  • 2 - CHANNEL_WIDTH_80MHZ
  • 3 - CHANNEL_WIDTH_160MHZ
  • 4 - CHANNEL_WIDTH_80MHZ_PLUS_MHZ
  • 5 - CHANNEL_WIDTH_320MHZ
13 uint8 Channel yang dipilih
  • 0 - Channel 1
  • 1 - Channel 11
  • 2 - Channel 36
  • 3 - Channel 40
  • 4 - Channel 44
  • 5 - Channel 48
  • 6 - Channel 153
  • 7 - Channel 157
  • 8 - Channel 161
  • 9 - Channel 165
14 uint8 Mode PASN dipilih
  • 0x01 - Mode PASN yang tidak diautentikasi
  • 0x02 - Mode PASN yang diautentikasi
Catatan: Kolom ini adalah akhir paket untuk mode PASN yang tidak diautentikasi.
15 array byte Kunci identitas perangkat Array tetap 16 byte
Catatan: Kolom ini hanya valid untuk mode PASN yang diautentikasi, tidak boleh ditetapkan untuk mode PASN yang tidak diautentikasi
31 uint8 Panjang sandi Panjang kata sandi.
Catatan: Kolom ini hanya valid untuk mode PASN yang diautentikasi, tidak boleh ditetapkan untuk mode PASN yang tidak diautentikasi.
di waktu/bulan/tempat/tanggal tertentu array byte Sandi Sandi sebagai array byte.
Catatan: Kolom ini hanya valid untuk mode PASN yang diautentikasi, tidak boleh ditetapkan untuk mode PASN yang tidak diautentikasi.

Payload pesan Respons Konfigurasi Pengukuran Jarak

Ukuran (ukuran header tidak disertakan): 2 byte

Deskripsi: Pesan ini dikirim oleh responden sebagai respons terhadap pesan Ranging Configuration. Pesan ini bersifat opsional; hanya diperlukan jika saluran komunikasi yang digunakan memerlukan respons eksplisit untuk setiap permintaan.

Payload pesan Ranging Configuration Response diringkas dalam tabel berikut:

Octet Jenis data Deskripsi Nilai
0 uint8*2 Bitfield konfigurasi teknologi pengukuran jarak berhasil ditetapkan Bitfield teknologi pengukuran jarak yang berhasil ditetapkan. Bitfield menetapkan bit teknologi pengukuran jarak ke 1 jika teknologi diminta dan ditetapkan dengan berhasil, dan 0 jika tidak.
  • 0x01 - UWB
  • 0x02 - BLE channel sounding
  • 0x04 - Wi-Fi NAN RTT
  • 0x08 - BLE RSSI
  • 0x10 - Wi-Fi PD
  • RFU

Payload pesan Stop Ranging

Ukuran (ukuran header tidak disertakan): 2 byte

Deskripsi: Pesan ini dikirim oleh perangkat pemrakarsa saat waktunya menghentikan pengukuran jarak dengan teknologi pengukuran jarak yang ditentukan.

Payload pesan Stop Ranging diringkas dalam tabel berikut:

Octet Jenis data Deskripsi Nilai
0 uint8*2 Teknologi pengukuran jarak untuk menghentikan bitfield Bitfield teknologi pengukuran jarak yang harus menghentikan pengukuran jarak. Bit yang disetel ke 1 menunjukkan bahwa teknologi pengukuran jarak harus menghentikan pengukuran jarak, dan 0 menunjukkan bahwa teknologi pengukuran jarak tidak melakukan pengukuran jarak sejak awal, atau harus melanjutkan pengukuran jarak jika sudah melakukan pengukuran jarak. Untuk beberapa teknologi pengukuran jarak (seperti CS), ini adalah no-op karena pengukuran jarak dimulai dan dihentikan hanya di sisi pemrakarsa.
  • 0x01 - UWB
  • 0x02 - BLE channel sounding
  • 0x04 - Wi-Fi NAN RTT
  • 0x08 - BLE RSSI
  • 0x10 - Wi-Fi PD
  • RFU

Payload pesan Stop Ranging Response

Ukuran (ukuran header tidak disertakan): 2 byte

Deskripsi: Pesan ini dikirim oleh responden sebagai respons terhadap pesan Stop Ranging. Pesan ini bersifat opsional, hanya diperlukan jika saluran komunikasi yang digunakan memerlukan respons eksplisit untuk setiap permintaan.

Payload pesan Stop Ranging Response diringkas dalam tabel berikut:

Octet Jenis data Deskripsi Nilai
0 uint8*2 Bitfield teknologi pengukuran jarak berhasil dihentikan Bitfield teknologi pengukuran jarak yang berhasil menghentikan pengukuran jarak. Bitfield menyetel bit teknologi pengukuran jarak ke 1 jika teknologi diminta untuk dihentikan dan jika berhasil dihentikan, dan 0 jika tidak.
  • 0x01 - UWB
  • 0x02 - BLE channel sounding
  • 0x04 - Wi-Fi NAN RTT
  • 0x08 - BLE RSSI
  • 0x10 - Wi-Fi PD
  • RFU

Payload pesan Notifikasi Gerakan

Ukuran (ukuran header tidak disertakan): 1 byte

Deskripsi: Perangkat responder mengirim pesan ini untuk memberi tahu perangkat yang memulai tentang perubahan status gerakan.

Octet Jenis data Deskripsi Nilai
0 uint8 Gerakan
  • 0x0 - Tidak terdeteksi
  • 0x1 - Gerakan kecil
  • 0x2 - Gerakan sedang
  • 0x3 - Gerakan besar
  • RFU
Ambang batas gerakan harus dikonfigurasi untuk mendeteksi perubahan orientasi ±X° di sepanjang dua sumbu aksesori.
  • Tidak terdeteksi: < 5°
  • Gerakan kecil: 5° - 7°
  • Pergerakan sedang: 7° - 10°
  • Gerakan besar: > 10°

Pembuatan Versi

Versi spesifikasi terdapat di header setiap pesan. Bagian ini menentukan cara komunikasi dilakukan saat salah satu perangkat (baik inisiator maupun responder) menggunakan versi yang lebih lama daripada perangkat lainnya. Ranging Capability Request adalah pesan pertama yang dikirim oleh perangkat pemulai.

Inisiator mendukung versi spesifikasi yang lebih baru, responder mendukung versi spesifikasi yang lebih lama

Perangkat inisiasi mengirim pesan Ranging Capability Request dengan versi yang lebih baru. Perangkat yang merespons hanya mendukung versi yang lebih lama, sehingga merespons dengan versi tersebut, lalu versi yang lebih lama dari perangkat yang merespons digunakan untuk pertukaran pesan selanjutnya. Artinya, pesan Ranging Capability Request harus kompatibel dengan versi sebelumnya.

Inisiator mendukung versi spesifikasi yang lebih lama, responder mendukung versi spesifikasi yang lebih baru

Perangkat yang merespons melihat bahwa perangkat pemrakarsa tidak dapat menggunakan versi yang lebih baru, sehingga perangkat tersebut hanya mengirim pesan menggunakan versi lama yang awalnya diminta oleh perangkat pemrakarsa.

Untuk memastikan pesan kompatibel dengan versi sebelumnya, kolom baru yang ditambahkan ke spesifikasi versi berikutnya harus ditambahkan ke akhir payload, dan tidak ada kolom yang ada yang dapat diubah. Saat mengurai konfigurasi, jika ukuran yang ditunjukkan lebih besar dari yang diharapkan, kolom tambahan harus diabaikan oleh perangkat apa pun yang hanya dapat memahami versi spesifikasi yang lebih lama.

Fragmentasi

Spesifikasi ini tidak bergantung pada saluran komunikasi, sehingga tidak menentukan cara memecah payload pesan jika satu pesan terlalu besar untuk dimuat dalam paket transfer saluran komunikasi yang digunakan. Modul Ranging diharapkan menerima setiap pesan dalam bentuk lengkapnya. Tanggung jawab fragmentasi terletak pada penerapan saluran komunikasi OOB.

Spesifikasi teknologi pengukuran jarak

Bagian ini berisi detail khusus untuk teknologi pengukuran jarak.

Spesifikasi ultra-wideband (UWB)

Bagian ini menjelaskan detail khusus ultra-wideband.

ID Konfigurasi

Data konfigurasi OOB yang dipertukarkan untuk UWB tidak berisi kumpulan lengkap parameter yang dapat dikonfigurasi yang diperlukan UWB untuk memulai sesi pengukuran jarak UWB. Hal ini karena beberapa parameter dipilih secara implisit oleh ID konfigurasi yang dipilih.

Setiap ID konfigurasi adalah serangkaian parameter konfigurasi UWB yang telah ditentukan sebelumnya dan didokumentasikan di UwbRangingParams. Perangkat responder mengirimkan daftar semua ID konfigurasi yang didukungnya sebagai bagian dari pesan respons kemampuan, dan inisiator memilih salah satu ID konfigurasi yang didukung yang digunakan. Hal ini memungkinkan pertukaran set parameter konfigurasi yang lebih kecil selama OOB. Hal ini juga membatasi jumlah kemungkinan kombinasi parameter yang dapat digunakan untuk pengukuran jarak dengan UWB, sehingga hanya memungkinkan pengujian kombinasi parameter yang diizinkan.

Meminta kemampuan setelah setiap sesi UWB

Setelah menghentikan sesi UWB yang ada dan sebelum memulai sesi UWB baru, perangkat inisiator harus meminta kemampuan perangkat responder dan menetapkan parameter konfigurasi lagi, karena alamat UWB dapat berubah segera setelah sesi pengukuran jarak saat ini berakhir.

Spesifikasi BLE channel sounding (CS)

Bagian ini menjelaskan detail spesifik channel sounding.

Enkripsi link yang diperlukan antarperangkat

Bonding yang ada antara perangkat inisiator dan perangkat responder diperlukan agar pengukuran jarak menggunakan channel sounding dapat berfungsi. Spesifikasi ini tidak menyediakan cara untuk membuat koneksi antar-perangkat. Anda harus membuat hubungan ini antara perangkat saat menggunakan Ranging API.

Tindakan yang diperlukan oleh pihak responden untuk CS

Di UWB, kedua perangkat harus memanggil API mulai pengukuran jarak dan berhenti pengukuran jarak UWB secara eksplisit. Sebaliknya, untuk CS, hanya perangkat pemrakarsa yang diperlukan untuk memulai pengukuran jarak CS dengan memanggil stack BT. Inisialisasi lainnya di sisi responder terjadi dalam band melalui BT. Artinya, setelah menerima pesan Ranging Configuration atau pesan Stop Ranging untuk CS, sisi responder tidak perlu melakukan apa pun jika BT diaktifkan. Perangkat responder dapat menggunakan pesan tersebut sebagai pemicu untuk memperbarui UI atau, misalnya, mengedipkan LED perangkat.