Mesafe belirleme: Bant dışı spesifikasyon sürümü 3

Android 16'da Ranging modülü kullanıma sunuldu. Bu protokol ve yük spesifikasyonu, mesafeyi ölçme yapılandırmalarını değiştirmek ve mesafeyi ölçme işlemine başlamak ve durdurmak için kullanılan bant dışı (OOB) iletişimin mesaj sırasını ve yükünü tanımlar. Bu işlemler, mesafeyi ölçme işlemine katılan başlatıcı ve yanıtlayıcı cihaz arasında gerçekleştirilir. Android 17, bu spesifikasyonun 3. sürümünü kullanıma sunar.

Bu sayfada, Android olmayan cihaz sağlayıcıların bu spesifikasyonu nasıl uygulayarak cihazlarını Android cihazlarla uyumlu hale getirebileceği açıklanmaktadır.

Bu spesifikasyonun Google'ın Paket Açıklama Dili (PDL) ile uygulanmış hâlini GitHub'da bulabilirsiniz. Bu uygulamadan, PDL derleyicisi bu spesifikasyonda tanımlanan iletiler için serileştirme ve seri durumdan çıkarma kodu oluşturabilir. Bu spesifikasyon, C++, Rust ve Java dahil olmak üzere çeşitli hedef dilleri destekler.

3. sürümdeki yenilikler

OOB spesifikasyonunun 3. sürümünde aşağıdaki değişiklikler yapılmıştır:

  • Hareket Bildirimi: Reklamveren cihazının, başlatıcı cihaza hareket değişikliğini bildirmek için kullandığı mesaj.
  • Aralık Yapılandırması: Başlatıcıya, yanıtlayanın çevre birim hareketindeki değişiklikleri yanıtlayana bildirmesini söylemek için yeni bir Motion support alanı içerir.
  • Mesafe Belirleme Yeteneği ve Mesafe Belirleme Yapılandırması'na yeni Wi-Fi PD teknolojisi desteği eklendi.
  • Wi-Fi NAN RTT Ranging Capability içinde Supported Bandwidth ve Supported number of Receive chains alanlarının desteği sonlandırıldı.

Endianness

Aksi belirtilmedikçe, mesajlardaki tüm çok baytlı sayısal alanlar little-endian sırasındadır.

İletiler ve ileti sırası

Bu bölümde, iletiler ve ileti alışverişinin sırası açıklanmaktadır.

Aşağıdaki tabloda, OOB değişiminde bulunan tüm mesajlar gösterilmektedir:

Mesaj Mesaj kimliği
Ranging Capability Request 0x0
Ranging Capability Response 0x1
Ranging Configuration 0x2
Ranging Configuration Response (isteğe bağlı) 0x3
Stop Ranging 0x6
Stop Ranging Response (isteğe bağlı) 0x7
Motion Notification 0x8

İleti değişimi, başlatıcı cihazın yanıtlayıcı cihaza Ranging Capability Request göndermesiyle başlar. Yanıt veren cihaz, Şekil 1'de gösterildiği gibi Ranging Capability Response göndererek yanıt verir:

İletişim kanalı akışı

Şekil 1. Bağlantıya dayalı bir iletişim kanalı kullanılarak OOB mesajı değişimi.

Yanıt veren cihaz, Ranging Configuration mesajını aldıktan hemen sonra mesafe ölçümüne başlar. Yanıt veren cihaz, Stop Ranging mesajını aldıktan veya algıladıktan sonra aralık ölçümünü durdurur.

Yanıt veren cihaz, yalnızca Ranging Capability Request mesajında istenen mesafe ölçme teknolojilerinin özelliklerini doldurur.

Başlatan cihaz, gönderdiği tüm istek mesajlarına yalnızca bir yanıt almayı bekler. Yanıt veren cihaz, herhangi bir isteğe herhangi bir sırada yanıt verebilmek için bu tür varsayımlarda bulunmamalıdır. Bu, yanıtlayıcı cihazın, başlatıcı cihazdan gelen birden fazla ardışık Ranging Capability Request mesaja veya sırası bozulmuş diğer mesajlara yanıt verebildiğini doğrular.

Teknoloji geçişi

OOB sürümü, cihazların bir oturum sırasında farklı aralık teknolojileri arasında dinamik olarak geçiş yapmasına olanak tanır. Bu süreci kolaylaştırmak için başlatıcı şunları yapabilir:

  • Yeni teknolojileri başlatmak için birden fazla Ranging Configuration mesajı gönderin.
  • Etkin teknolojileri durdurmak için birden fazla Stop Ranging mesajı gönderin.

Bu mesajların sırası, yanıtlayanın desteklediği geçiş şemasına göre değişir:

  • Önce durdur sonra başlat: Başlatıcı, ikinciyi Ranging Configuration mesajıyla başlatmadan önce Stop Ranging mesajıyla ilkini durdurarak yeni bir teknolojiye geçebilir.
  • Önce yap sonra boz: Başlatıcı, Ranging Configuration mesajıyla yeni bir teknolojiyi başlatabilir ve Stop Ranging mesajıyla mevcut teknolojileri durdurabilir.

Yanıtlayıcı, Ranging Capability Response öğesindeki supported technology transitioning alanının değerine uygun olarak bu geçiş şemalarından birinin desteğini uygulamalıdır.

Mesafe ölçme teknolojisi kimlikleri

Mesafe ölçme teknolojilerinin kimlikleri aşağıdaki tabloda listelenmiştir:

Mesafe ölçme teknolojisi Kimlik
ultra geniş bant 0x0
CS 0x1
Kablosuz NAN RTT 0x2
RSSI 0x3
Wi-Fi PD 0x4
RFU 0x5 - 0xFF

Bu kimlikler, bu sayfadaki tabloların aralık teknolojisi kimliğinin gerekli olduğu yerlerde kullanılır. Aralık teknolojisi bit alanı içeren alanlarda, bu teknoloji bit alanına dahil edildiğinde teknolojinin kimliğinin dizinine karşılık gelen bir bit ayarlanır.

Örneğin, RSSI'nin kimlik değeri 3'tür. Ancak RSSI, aralık teknolojisi bit alanına dahil edilirse kimliğin (3) konumundaki bitin açılması gerekir (ilk bit 0 konumundadır). Bu durumda, bit alanının sonuç değeri 0x8 olur. Hem UWB hem de RSSI dahil edilmişse bit alanı değeri 0x0A olur (hem 0 hem de 3 bitleri açık).

İleti biçimi

Her mesaj bir başlık ve bir yükten oluşur.

İleti biçimi

Şekil 3. İleti biçimi.

Boyut: 2 bayt

Açıklama: Tüm iletilerde ortak olan üstbilgi, iletiye eklenen ilk kısımdır. Üstbilgi, ileti türünün sürümünü ve kimliğini içerir. Sürüm alanı, mesajın içeriğinin uygun olduğu bu spesifikasyonun sürümünü belirtir. Farklı sürümlerdeki cihazlar arasında sürüm oluşturmanın nasıl kullanıldığı hakkında daha fazla bilgi için Sürüm Oluşturma başlıklı makaleyi inceleyin. Başlık, farklı sürümler arasında geriye dönük olarak uyumlu kalır. Bu nedenle, kullanım alanı her zaman sürümü ve mesajın kimliğini belirlemek için başlığı ayrıştırabilir.

Üstbilgi aşağıdaki tabloda özetlenmiştir:

Octet Veri türü Açıklama Değer
0 uint8 Sürüm
  • 0x1 - V1
  • 0x2 - V2
  • 0x3 - V3
1 uint8 Mesaj kimliği
  • 0x0 - Ranging Capability Request mesajı
  • 0x1 - Ranging Capability Response mesajı
  • 0x2 - Ranging Configuration ileti
  • 0x3 - Ranging Configuration Response mesajı (isteğe bağlı)
  • 0x6 - Stop Ranging mesajı
  • 0x7 - Stop Ranging Response mesajı (isteğe bağlı)
  • 0x8 - Motion Notification mesajı
  • 0x4-0x5, 0x9 - 0xFF RFU

Yük

Boyut: Değişir (mesajın türüne bağlıdır)

Açıklama: Yük, iletinin başlığından sonraki son bölümüdür. Yük, mesajın türüne bağlıdır. Her bir mesaj türünün yük biçimi aşağıdaki bölümlerde tanımlanmıştır.

Mesafe belirleme özelliği isteği mesaj yükü

Boyut (başlık boyutu dahil değildir): 2 bayt

Açıklama: İleti alışverişini başlatmak için başlatıcı cihaz tarafından gönderilir.

Ranging Capability Request mesaj yükü aşağıdaki tabloda özetlenmiştir:

Octet Veri türü Açıklama Değer
0 uint8*2 İstenen mesafe ölçme teknolojileri bit alanı
  • 0x01 - UWB
  • 0x02 - BLE kanal seslendirmesi
  • 0x04 - Wi-Fi NAN RTT
  • 0x08 - BLE RSSI
  • 0x10: Kablosuz yakınlık algılama (PD)
  • RFU

Mesafe ölçme özelliği yanıt mesajı yükü

Boyut (üstbilgi boyutu dahil değildir): Değişir (ortak kısım 2 bayt artı dahil edilen her bir mesafe ölçme teknolojisi baytının boyutu)

Açıklama: Yanıtlayan tarafından Ranging Capability Request iletisine yanıt olarak gönderilir. Bu mesaj yükü, aşağıdaki tablolarda gösterildiği gibi ortak bölümden ve teknolojiye özel bölümlerden (BLE CS, Wi-Fi NAN RTT, BLE RSSI) oluşur. Her bir mesafe ölçme teknolojisine özgü bölüm yalnızca bu mesafe ölçme teknolojisi yanıtlayıcı cihaz tarafından destekleniyorsa ve Ranging Capability Request mesajında isteniyorsa eklenmelidir.

Yaygın Ranging Capability Response ileti yükü aşağıdaki tabloda özetlenmiştir:

Octet Veri türü Açıklama Değer
0 uint8*2 Desteklenen mesafe ölçme teknolojileri bit alanı. Yükün geri kalanında yer alan mesafe ölçme teknolojilerinin özellikler grubunu gösterir.
  • 0x01 - UWB
  • 0x02 - BLE kanal seslendirmesi
  • 0x04 - Wi-Fi NAN RTT
  • 0x08 - BLE RSSI
  • 0x10 - Wi-Fi PD
  • RFU
2 bayt dizisi Çeşitli teknoloji özelliği baytları. Teknoloji başına tanımlanan tekrarlanan yapı blokları.
Değişkenlik gösterir uint8 Teknoloji geçişi için destek olduğunu gösterir.
  • 0x00: Break-before-make desteklenir.
  • 0x01: Make-before-break desteklenir. Yanıtlayıcı, aynı anda birden fazla teknolojiyle aralık belirleyebilir.
Değişkenlik gösterir uint16 Yanıt veren cihazın türünü belirtir.
  • 0x00: Bilinmiyor
  • 0x01 - Telefon
  • 0x02 - Tablet
  • 0x03 - Etiket
  • 0x04 - Giyilebilir Cihaz
  • 0x05 - Akıllı kulaklık
  • RFU

UWB Ranging Capability Response mesaj yükü aşağıdaki tabloda özetlenmiştir:

Octet Veri türü Açıklama Değer
0 uint8 Mesafe ölçme teknolojisi kimliği 0x0 - UWB
1 uint8 Boyut Bayt cinsinden UWB özellikleri baytlarının boyutu (Teknoloji Kimliği ve Boyut alanları dahil).
2 uint8*2 Ultra geniş bant adresi 2 baytlık cihaz ultra geniş bant adresi.
4 uint8*4 Desteklenen kanallar bit alanı Desteklenen kanalların bit alanı. 0 olarak ayarlanan bit, desteklenmediğini, 1 olarak ayarlanan bit ise desteklendiğini gösterir. Bit 0, kanal 0'a karşılık gelir.
LSB == channel 0
MSB == channel 31
8 uint8*4 Desteklenen önsöz dizini bit alanı Desteklenen önsöz dizinlerinin bit alanı. 0 olarak ayarlanan bit, desteklenmediğini, 1 olarak ayarlanan bit ise desteklendiğini gösterir. Bit 0, önsöz dizini 1'e karşılık gelir.
LSB == preamble index 1
MSB == preamble index 32
12 uint8*4 Desteklenen yapılandırma kimlikleri bit alanı Desteklenen UWB yapılandırma kimliklerinin bit alanı. 0 olarak ayarlanan bit, desteklenmediğini, 1 olarak ayarlanan bit ise desteklendiğini gösterir.
LSB == config Id 0
MSB == config Id 31
16 uint8*2 Desteklenen minimum mesafe ölçme aralığı Milisaniye cinsinden desteklenen en hızlı mesafe ölçme aralığını gösterir. İzin verilen değerler (ms cinsinden):
  • 96
  • 120
  • 240
  • 600
18 uint8 Desteklenen minimum yer süresi Desteklenen en kısa yuva süresini milisaniye cinsinden gösterir. Örneğin, cihaz 1 ms döndürüyorsa 2 ms veya daha yüksek alan sürelerini de desteklediği varsayılır. İzin verilen değerler (ms cinsinden):
  • 1
  • 2
19 uint8 Desteklenen UWB cihaz rolü bit alanı Desteklenen UWB rollerinin bit alanı. Örneğin, her ikisi de destekliyorsa nihai alan değeri 0x3 olur.
  • 0x1: Başlatıcı rolü desteklenir.
  • 0x2: Yanıtlayıcı rolü destekleniyor.

BLE CS Ranging Capability Response mesaj yükü aşağıdaki tabloda özetlenmiştir:

Octet Veri türü Açıklama Değer
0 uint8 Mesafe ölçme teknolojisi kimliği 0x1 - BLE CS
1 uint8 Boyut Bayt cinsinden BLE CS özellikleri baytlarının boyutu (Technology ID ve Size alanları dahil).
2 uint8 Desteklenen güvenlik türü bit alanı BLE CS için desteklenen güvenlik türlerinin bit alanı.
  • 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 Cihaz adresi BLE CS için kullanılan cihazın adresi; big-endian sırasındadır.

Wi-Fi NAN RTT Ranging Capability Response mesaj yükü aşağıdaki tabloda özetlenmiştir:

Octet Veri türü Açıklama Değer
0 uint8 Mesafe ölçme teknolojisi kimliği 0x2: Wi-Fi NAN RTT
1 uint8 Boyut Bayt cinsinden Wi-Fi NAN RTT özellikleri baytlarının boyutu (Technology ID ve Size alanları dahil).
2 uint8 Desteklenen özellikler bit alanı Desteklenen özelliklerin bit alanı.
  • 0x01 - 11mc özellikli
  • 0x02 - 11az özellikli
3 uint8 Periyodik aralık belirlemeyi destekler
  • 0x0: Periyodik aralık ölçümü desteklenmiyor
  • 0x1: Periyodik mesafe ölçümü desteklenir.
4 uint8 Desteklenen bant genişliği DEPRECATED: Bu bilgiler, Wi-Fi NAN kullanılarak elde edilebilecek mesafeyi ölçme doğruluğunu belirlemeye yardımcı olur ve uygulamaların mesafeyi ölçmek için UWB, BLE CS, BLE RSSI veya Wi-Fi NAN kullanıp kullanmayacağına karar vermesine yardımcı olabilir.
  • 0x00 - 20 MHz
  • 0x01 - 40 MHz
  • 0x02 - 80 MHz
  • 0x03 - 160 MHz
  • 0x04 - 80+80 MHz
  • 0x05 - 320 MHz
  • RFU
5 uint8 Desteklenen alım zinciri sayısı DEPRECATED: Bu bilgiler, Wi-Fi NAN kullanılarak elde edilebilecek mesafeyi ölçme doğruluğunu belirlemeye yardımcı olur ve uygulamaların mesafeyi ölçmek için UWB, BLE CS, BLE RSSI veya Wi-Fi NAN kullanıp kullanmayacağına karar vermesine yardımcı olabilir.
  • 0x00: Tanımlanmamış
  • 0x01 - 1 RX zinciri
  • 0x02 - 2 RX zinciri
  • 0x03 - 3 RX zinciri
  • 0x04 - 4 RX zinciri

BLE RSSI Ranging Capability Response mesaj yükü aşağıdaki tabloda özetlenmiştir:

Octet Veri türü Açıklama Değer
0 uint8 Mesafe ölçme teknolojisi kimliği 0x3 - BLE RSSI
1 uint8 Boyut Bayt cinsinden BLE RSSI özellikleri baytlarının boyutu (Technology ID ve Size alanları dahil)
2 uint8*6 Cihaz adresi BLE RSSI için kullanılan cihazın adresi; big-endian sırasıyla

Wi-Fi PD Ranging Capability Response mesaj yükü aşağıdaki tabloda özetlenmiştir:

Octet Veri türü Açıklama Değer
0 uint8 Mesafe ölçme teknolojisi kimliği 0x4 - Wi-Fi PD
1 uint8 Boyut Bayt cinsinden Wi-Fi PD özellikleri boyutu (Teknoloji Kimliği ve Boyut alanları dahil)
2 uint8 Desteklenen özellikler Bit eşlem
  • b0 - 11mc özellikli
  • b1 - 11az özellikli
3 uint8 PASN modu Bit eşlem
  • b0: Kimliği doğrulanmamış PASN modu
  • b1: Kimliği doğrulanmış PASN modu
4 uint8*6 Cihaz adresi Wi-Fi PD için kullanılan cihazın adresi; big-endian sırasıyla.
10 uint8*2 Minimum mesafe ölçme aralığı 802.11mc 11mc için büyük endian biçiminde desteklenen minimum aralık ölçme aralığı
12 uint8*2 Minimum mesafe ölçme aralığı 802.11az 11az için büyük endian biçiminde desteklenen minimum aralık ölçümü aralığı
14 uint8 Maksimum ön talimat türü
  • 0 - PREAMBLE_LEGACY
  • 1 - PREAMBLE_HT
  • 2 - PREAMBLE_VHT
  • 3 - PREAMBLE_HE
  • 4 - PREAMBLE_EHT

Bu, tüm alt önsöz türlerinin desteklendiğini varsayar.
15 uint8 Maksimum kanal genişliği
  • 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

Bu, daha düşük tüm kanal genişliklerinin desteklendiği anlamına gelir.
16 uint8*2 Desteklenen kanal frekansı
  • b0 - Kanal 1
  • b1 - Channel 11
  • b2 - Kanal 36
  • b3 - Kanal 40
  • b4 - Channel 44
  • b5 - Kanal 48
  • b6 - Channel 153
  • b7 - Kanal 157
  • b8 - Kanal 161
  • b9 - Kanal 165
  • b10-b15 - RFU

Mesafe belirleme yapılandırması mesaj yükü

Boyut (üstbilgi boyutu dahil değildir): Değişir (ortak kısım 4 bayt artı dahil edilen her bir mesafe ölçme teknolojisi baytının boyutu).

Açıklama: Bu mesaj, başlatıcı tarafından gönderilir ve her bir mesafe ölçme teknolojisinin mesafe ölçmeye başlayabileceği yapılandırmaları içerir. Yanıt veren cihaz, bu mesajı aldıktan sonra belirtilen her mesafe ölçme teknolojisiyle mesafe ölçmeye çalışmalıdır. Bu mesaj yükü, aşağıdaki tablolarda gösterildiği gibi ortak bölüm ve mesafeyi ölçme teknolojisine özgü bölümlerden (UWB, BLE CS, Wi-Fi NAN RTT, BLE RSSI) oluşur.

Yaygın Ranging Configuration ileti yükü aşağıdaki tabloda özetlenmiştir:

Octet Veri türü Açıklama Değer
0 uint8*2 Mesafe ölçme teknolojileri yapılandırması, bit alanı ayarlandı Bu mesajın yapılandırma verilerini içerdiği ve yapılandırma parametrelerinin ayarlanması gereken mesafe ölçme teknolojilerinin bit alanı.
  • 0x01 - UWB
  • 0x02 - BLE kanal seslendirmesi
  • 0x04 - Wi-Fi NAN RTT
  • 0x08 - BLE RSSI
  • 0x10 - Wi-Fi PD
  • RFU
2 uint8*2 Bitfield RFU. Ranging technologies configuration set bitfield alanı ile aynı değere ayarlanmalıdır.
4 bayt dizisi Mesafe ölçme teknolojileri yapılandırma baytları Teknoloji başına tanımlanan tekrar eden yapı blokları
Değişkenlik gösterir uint8 Hareket desteği Motion Notification istendi
  • 0x0: Başlatıcı cihaz tarafından hareket verisi gerekmediğini gösterir.
  • 0x1: Başlatan cihazın, eş cihazdan hareket verileri alması gerektiğini gösterir.

UWB Ranging Configuration mesaj yükü aşağıdaki tabloda özetlenmiştir:

Octet Veri türü Açıklama Değer
0 uint8 Mesafe ölçme teknolojisi kimliği 0x0 - UWB
1 uint8 Boyut UWB yapılandırmasının (Teknoloji Kimliği ve Boyut alanları dahil) bayt cinsinden boyutu
2 uint8*2 Ultra geniş bant adresi 2 baytlık cihaz UWB adresi
4 uint8*4 Oturum kimliği Oluşturulan oturum kimliği. Oturum kimliği, telefon ile çevre birimi arasındaki mesafe ölçme oturumunun benzersiz tanımlayıcısıdır.
8 uint8 Seçilen yapılandırma kimliği Seçilen yapılandırma kimliği sayısı (tam sayı). Yapılandırma kimliği, UWB mesafe ölçme oturumu için kullanılması gereken zamanlama parametrelerini ve güvenlik türünü belirtir.
9 uint8 Seçilen kanal UWB mesafe ölçme oturumu için seçilen kanal
10 uint8 Seçilen önsöz dizini UWB mesafe ölçme oturumu için seçilen önsöz dizini
11 uint8*2 Seçilen aralık ölçme aralığı Milisaniye olarak seçilen aralık belirleme aralığı oranı. İzin verilen değerler (ms cinsinden):
  • 96
  • 120
  • 240
  • 600
13 uint8 Seçilen aralık süresi Seçilen aralığın milisaniye cinsinden süresi. İzin verilen değerler (ms cinsinden):
  • 1
  • 2
14 uint8 Oturum anahtarı uzunluğu Oturum anahtarının bayt cinsinden uzunluğu
15 bayt dizisi Oturum anahtarı Oturum anahtarı. S-STS kullanılıyorsa ilk iki bayt VENDOR ID, sonraki altı bayt ise STATIC STS IV'dir. P-STS kullanılıyorsa bu, 16 veya 32 baytlık bir oturum anahtarıdır. Kullanılan güvenlik türü, yapılandırma kimliğine göre belirlenir.
değişir uint8*2 Ülke kodu İki ASCII karakteriyle gösterilen ISO 3166-1 alfa-2 ülke kodu
değişir uint8 Seçilen cihaz rolü
  • 0x01 - Başlatan
  • 0x02 - Yanıtlayıcı
değişir uint8 Seçilen cihaz modu
  • 0x01 - Kumanda
  • 0x02 - Kontrol edilen

BLE CS Ranging Configuration mesaj yükü aşağıdaki tabloda özetlenmiştir:

Octet Veri türü Açıklama Değer
0 uint8 Mesafe ölçme teknolojisi kimliği 0x1 - BLE CS
1 uint8 Boyut Bayt cinsinden BLE CS yapılandırmasının boyutu (Technology ID ve Size alanları dahil)
2 uint8 Seçilen güvenlik türü Seçilen güvenlik türü. İzin verilen değerler:
  • 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 Cihaz adresi BLE CS için kullanılan cihazın adresi; big-endian sırasıyla

Wi-Fi NAN RTT Ranging Configuration mesaj yükü aşağıdaki tabloda özetlenmiştir:

Octet Veri türü Açıklama Değer
0 uint8 Mesafe ölçme teknolojisi kimliği 0x2: Wi-Fi NAN RTT
1 uint8 Boyut Bayt cinsinden Wi-Fi NAN RTT yapılandırmasının boyutu (Technology ID ve Size alanları dahil)
2 uint8 Hizmet adı uzunluğu Hizmet adı alanının bayt cinsinden uzunluğu. Wi-Fi Aware Specification v4.0 bölüm 1.3.3 Tablo 1'e bakın. Tanımlar.
3 bayt dizisi Hizmet adı Hizmet adı. Wi-Fi Aware Specification v4.0 bölüm 1.3.3 Tablo 1'e bakın. Tanımlar.
değişir uint8 Cihaz rolü
  • 0x0 - Yanıtlayıcı (NAN hizmeti yayıncısı)
  • 0x1: Başlatan (NAN hizmeti abonesi)
değişir uint8 Düzenli aralıklarla ölçüm özelliğini kullanma
  • 0x0: Periyodik aralık belirleme devre dışı
  • 0x1: Periyodik aralık ölçümü etkin

BLE RSSI Ranging Configuration mesaj yükü aşağıdaki tabloda özetlenmiştir:

Octet Veri türü Açıklama Değer
0 uint8 Mesafe ölçme teknolojisi kimliği 0x3 - BLE RSSI
1 uint8 Boyut Bayt cinsinden BLE RSSI yapılandırmasının boyutu (Technology ID ve Size alanları dahil)
2 uint8*6 Cihaz adresi BLE RSSI için kullanılan cihazın adresi; big-endian sırasıyla

Wi-Fi PD Ranging Configuration mesaj yükü aşağıdaki tabloda özetlenmiştir:

Octet Veri türü Açıklama Değer
0 uint8 Mesafe ölçme teknolojisi kimliği 0x4 - Wi-Fi PD
1 uint8 Boyut Bayt cinsinden Wi-Fi PD yapılandırmasının boyutu (Teknoloji Kimliği ve Boyut alanları dahil)
2 uint8 Özellik
  • 0x01 - 11mc
  • 0x02 - 11az
3 uint8*6 MAC adresi Başlatıcı MAC adresi
9 uint8*2 Mesafe ölçme aralığı Mesafe ölçme aralığı (ms)
11 uint8 Seçilen önsöz
  • 0 - PREAMBLE_LEGACY
  • 1 - PREAMBLE_HT
  • 2 - PREAMBLE_VHT
  • 3 - PREAMBLE_HE
  • 4 - PREAMBLE_EHT
12 uint8 Seçilen kanal genişliği
  • 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 Seçilen kanal
  • 0 - Kanal 1
  • 1 - Channel 11
  • 2 - Kanal 36
  • 3 - Channel 40
  • 4 - Channel 44
  • 5 - Channel 48
  • 6 - Channel 153
  • 7 - Kanal 157
  • 8 - Channel 161
  • 9 - Channel 165
14 uint8 Seçilen PASN modu
  • 0x01: Kimliği doğrulanmamış PASN modu
  • 0x02: Kimliği doğrulanmış PASN modu
Not: Bu alan, kimliği doğrulanmamış PASN modu için paketin sonudur.
15 bayt dizisi Cihaz kimliği anahtarı 16 baytlık sabit dizi
Not: Bu alan yalnızca kimliği doğrulanmış PASN modu için geçerlidir, kimliği doğrulanmamış PASN modu için ayarlanmamalıdır.
31 uint8 Şifre uzunluğu Şifrenin uzunluğu.
Not: Bu alan yalnızca kimliği doğrulanmış PASN modu için geçerlidir ve kimliği doğrulanmamış PASN modu için ayarlanmamalıdır.
değişir bayt dizisi Şifre Bayt dizisi olarak şifre.
Not: Bu alan yalnızca kimliği doğrulanmış PASN modu için geçerlidir ve kimliği doğrulanmamış PASN modu için ayarlanmamalıdır.

Ranging Configuration Response mesajı yükü

Boyut (başlık boyutu dahil değildir): 2 bayt

Açıklama: Bu ileti, yanıtlayıcı tarafından Ranging Configuration iletisine yanıt olarak gönderilir. Bu mesaj isteğe bağlıdır. Yalnızca kullanılan iletişim kanalının her istek için açık bir yanıt gerektirdiği durumlarda zorunludur.

Ranging Configuration Response ileti yükü aşağıdaki tabloda özetlenmiştir:

Octet Veri türü Açıklama Değer
0 uint8*2 Mesafe ölçme teknolojileri yapılandırması başarıyla ayarlandı bit alanı Başarıyla ayarlanan mesafe ölçme teknolojilerinin bit alanı. Bit alanı, teknoloji istenmişse ve başarıyla ayarlanmışsa menzil teknolojisi bitini 1'e, aksi takdirde 0'a ayarlar.
  • 0x01 - UWB
  • 0x02 - BLE kanal seslendirmesi
  • 0x04 - Wi-Fi NAN RTT
  • 0x08 - BLE RSSI
  • 0x10 - Wi-Fi PD
  • RFU

Stop Ranging mesajı yükü

Boyut (başlık boyutu dahil değildir): 2 bayt

Açıklama: Bu mesaj, belirtilen mesafe ölçme teknolojisiyle mesafe ölçme işleminin durdurulması gerektiğinde başlatıcı cihaz tarafından gönderilir.

Stop Ranging mesaj yükü aşağıdaki tabloda özetlenmiştir:

Octet Veri türü Açıklama Değer
0 uint8*2 Bit alanı durdurmak için aralık teknolojileri Mesafe ölçümünün durdurulması gereken mesafe ölçüm teknolojilerinin bit alanı. 1'e ayarlanmış bit, mesafe ölçme teknolojisinin mesafe ölçmeyi durdurması gerektiğini, 0 ise mesafe ölçme teknolojisinin ya en başından beri mesafe ölçmediğini ya da zaten mesafe ölçüyorsa mesafe ölçmeye devam etmesi gerektiğini gösterir. Bazı mesafe ölçme teknolojileri (ör. CS) için bu işlem, mesafe ölçme yalnızca başlatıcı tarafında başlatılıp durdurulduğu için etkisizdir.
  • 0x01 - UWB
  • 0x02 - BLE kanal seslendirmesi
  • 0x04 - Wi-Fi NAN RTT
  • 0x08 - BLE RSSI
  • 0x10 - Wi-Fi PD
  • RFU

Stop Ranging Response mesajı yükü

Boyut (başlık boyutu dahil değildir): 2 bayt

Açıklama: Bu ileti, yanıtlayıcı tarafından Stop Ranging iletisine yanıt olarak gönderilir. Bu mesaj isteğe bağlıdır. Yalnızca kullanılan iletişim kanalının her istek için açık bir yanıt gerektirdiği durumlarda zorunludur.

Stop Ranging Response mesaj yükü aşağıdaki tabloda özetlenmiştir:

Octet Veri türü Açıklama Değer
0 uint8*2 Ranging technologies stopped successfully bitfield Mesafe ölçme işlemini başarıyla durduran mesafe ölçme teknolojilerinin bit alanı. Bit alanı, teknolojinin durdurulması istendiyse ve başarıyla durdurulduysa aralık teknolojisi bitini 1, aksi takdirde 0 olarak ayarlar.
  • 0x01 - UWB
  • 0x02 - BLE kanal seslendirmesi
  • 0x04 - Wi-Fi NAN RTT
  • 0x08 - BLE RSSI
  • 0x10 - Wi-Fi PD
  • RFU

Hareket bildirimi mesajı yükü

Boyut (başlık boyutu dahil değildir): 1 bayt

Açıklama: Yanıt veren cihaz, hareket durumundaki değişiklikleri başlatan cihaza bildirmek için bu mesajı gönderir.

Octet Veri türü Açıklama Değer
0 uint8 Hareket
  • 0x0: Algılanmadı
  • 0x1: Hafif hareket
  • 0x2: Orta düzeyde hareket
  • 0x3: Büyük hareket
  • RFU
Hareket eşiği, aksesuarın herhangi iki ekseninde ±X° yön değişikliğini algılayacak şekilde yapılandırılmalıdır.
  • Algılanmadı: < 5°
  • Hafif hareket: 5° - 7°
  • Orta hareket: 7° - 10°
  • Büyük hareket: > 10°

Sürüm oluşturma

Spesifikasyonun sürümü, her iletinin üstbilgisinde yer alır. Bu bölümde, cihazlardan biri (başlatan veya yanıtlayan) diğer cihazdan daha eski bir sürümde olduğunda iletişimin nasıl yürütüleceği tanımlanır. Ranging Capability Request, başlatıcı cihaz tarafından gönderilen ilk mesajdır.

Başlatan taraf, spesifikasyonun daha yeni bir sürümünü destekliyor, yanıtlayan taraf ise daha eski bir sürümünü destekliyor.

Başlatıcı cihaz, daha yeni sürümle Ranging Capability Request mesajını gönderir. Yanıtlayanın cihazı yalnızca eski sürümü desteklediği için bu sürümle yanıt verir. Ardından, mesaj alışverişinin geri kalanında yanıtlayanın eski sürümü kullanılır. Bu nedenle Ranging Capability Request ileti geriye dönük uyumlu olmalıdır.

Başlatan taraf eski sürümü, yanıtlayan taraf ise spesifikasyonun daha yeni bir sürümünü destekliyor

Yanıtlayan cihaz, başlatan cihazın daha yeni sürümü kullanamadığını görür. Bu nedenle, mesajları yalnızca başlatan cihazın başlangıçta istediği eski sürümü kullanarak gönderir.

Mesajların geriye dönük uyumlu olmasını sağlamak için bu spesifikasyonun sonraki sürümüne eklenen tüm yeni alanlar yükün sonuna eklenmelidir ve mevcut alanların hiçbiri değiştirilemez. Yapılandırma ayrıştırılırken belirtilen boyut beklenenden büyükse yalnızca spesifikasyonun eski sürümünü anlayabilen cihazlar ek alanları yoksaymalıdır.

Parçalanma

Bu spesifikasyon, iletişim kanalından bağımsızdır. Bu nedenle, tek bir mesajın kullanılan iletişim kanalının aktarım paketine sığamayacak kadar büyük olduğu durumlarda mesaj yükünün nasıl parçalanacağını tanımlamaz. Mesafe ölçme modülü, her mesajı tam biçiminde almayı bekler. Parçalama sorumluluğu, bant dışı iletişim kanalını uygulayan tarafa aittir.

Mesafe ölçme teknolojisine özgü bilgiler

Bu bölümde, mesafe ölçme teknolojisine özgü ayrıntılar yer alır.

Ultra geniş bant (UWB) özellikleri

Bu bölümde, ultra geniş bant ile ilgili ayrıntılar açıklanmaktadır.

Yapılandırma kimlikleri

Ultra geniş bant için değiştirilen OOB yapılandırma verileri, ultra geniş bant mesafesi ölçme oturumu başlatmak için ultra geniş bantın ihtiyaç duyduğu, kullanılabilir yapılandırılabilir parametrelerin tam kümesini içermiyor. Bunun nedeni, seçilen yapılandırma kimliği tarafından bazı parametrelerin örtülü olarak seçilmesidir.

Her yapılandırma kimliği, UwbRangingParams içinde belgelenen, önceden tanımlanmış bir dizi ultra geniş bant yapılandırma parametresidir. Yanıtlayıcı cihaz, desteklediği tüm yapılandırma kimliklerinin listesini yetenek yanıtı mesajının bir parçası olarak gönderir ve başlatıcı, kullanılan desteklenen yapılandırma kimliklerinden birini seçer. Bu sayede OOB sırasında daha az sayıda yapılandırma parametresi değiştirilebilir. Ayrıca, UWB ile mesafeyi belirlemek için kullanılabilecek olası parametre kombinasyonlarının sayısını da sınırlar. Bu nedenle, yalnızca izin verilen parametre kombinasyonlarının test edilmesi mümkündür.

Her UWB oturumundan sonra özellik isteğinde bulunma

Mevcut bir UWB oturumu durdurulduktan sonra ve yeni bir UWB oturumu başlatılmadan önce, UWB adresi mevcut mesafe ölçme oturumu sona erer ermez değişebileceğinden başlatıcı cihaz, yanıtlayıcı cihazın özelliklerini istemeli ve yapılandırma parametrelerini tekrar ayarlamalıdır.

BLE kanal seslendirme (CS) özellikleri

Bu bölümde, kanal seslendirmeyle ilgili ayrıntılar açıklanmaktadır.

Cihazlar arasında bağlantı şifrelemesi zorunlu kılınır

Kanal seslendirme kullanılarak mesafe ölçümünün çalışması için başlatıcı ve yanıtlayıcı cihaz arasında mevcut bir bağ olması gerekir. Bu spesifikasyon, cihazlar arasında bağlantı oluşturma yöntemi sunmaz. Mesafe ölçme API'lerini kullanırken cihazlar arasında bu bağı oluşturmanız gerekir.

Müşteri hizmetleri için yanıtlayanın yapması gereken işlem

UWB'de, her iki cihazın da UWB başlangıç aralığı ve aralık durdurma API'sini açıkça çağırması gerekir. Buna karşılık, CS için BT yığınını çağırarak CS aralığını başlatmak üzere yalnızca başlatıcı cihazın bulunması gerekir. Yanıtlayıcı tarafındaki başlatma işleminin geri kalanı BT üzerinden bant içi olarak gerçekleşir. Bu, CS için Ranging Configuration mesajı veya Stop Ranging mesajı alındığında BT etkinse yanıtlayıcı tarafın herhangi bir işlem yapması gerekmediği anlamına gelir. Yanıt veren cihaz, bu mesajları kullanıcı arayüzünü güncellemek veya örneğin cihaz LED'lerini yanıp söndürmek için tetikleyici olarak kullanabilir.