Określanie odległości: specyfikacja poza pasmem w wersji 3

W Androidzie 16 wprowadzono moduł pomiaru odległości. Ten protokół i specyfikacja ładunku definiują sekwencję wiadomości i ładunek komunikacji poza pasmem (OOB) używanej do wymiany konfiguracji pomiaru odległości oraz do rozpoczynania i zatrzymywania pomiaru odległości między urządzeniem inicjującym a urządzeniem odpowiadającym, które biorą udział w pomiarze odległości. Android 17 wprowadza wersję 3 tej specyfikacji.

Ta strona umożliwia dostawcom urządzeń innych niż Android wdrożenie tej specyfikacji, aby ich urządzenia były zgodne z urządzeniami z Androidem.

Implementacja tej specyfikacji w języku opisu pakietów (PDL) Google jest dostępna w serwisie GitHub. Na podstawie tej implementacji kompilator PDL może wygenerować kod serializacji i deserializacji wiadomości zdefiniowanych w tej specyfikacji. Ta specyfikacja obsługuje różne języki docelowe, w tym C++, Rust i Java.

Nowości w wersji 3

Wersja 3 specyfikacji OOB wprowadza te zmiany:

• Powiadomienie o ruchu: wiadomość, której urządzenie reklamodawcy używa do powiadamiania urządzenia inicjującego o zmianie ruchu.
• Konfiguracja pomiaru odległości: zawiera nowe pole Motion support, które informuje inicjatora o konieczności powiadamiania odpowiadającego o wszelkich zmianach w ruchu urządzenia peryferyjnego.
• Dodano obsługę nowej technologii Wi-Fi PD w Ranging Capability i Ranging Configuration.
• Wycofaj pola Supported Bandwidth i Supported number of Receive chains w Wi-Fi NAN RTT Ranging Capability.

Kolejność bajtów

O ile nie określono inaczej, wszystkie wielobajtowe pola liczbowe w wiadomościach są zapisywane w formacie little-endian.

Wiadomości i sekwencja wiadomości

W tej sekcji opisano wiadomości i kolejność ich wymiany.

W tabeli poniżej znajdziesz wszystkie komunikaty, które występują w wymianie danych poza pasmem:

Wiadomość	Identyfikator wiadomości
Ranging Capability Request	0x0
Ranging Capability Response	0x1
Ranging Configuration	0x2
Ranging Configuration Response (opcjonalnie)	0x3
Stop Ranging	0x6
Stop Ranging Response (opcjonalnie)	0x7
Motion Notification	0x8

Rysunki 1 i 2 pokazują, jak wymiana wiadomości jest wywoływana w przypadku różnych kanałów komunikacji.

W przypadku kanałów komunikacji opartych na połączeniu, takich jak BLE GATT, wymiana wiadomości rozpoczyna się od wysłania przez urządzenie inicjujące sygnału Ranging Capability Request do urządzenia odpowiadającego. Urządzenie odpowiadające wysyła odpowiedź Ranging Capability Response, jak pokazano na rysunku 1:

Rysunek 1. Wymiana wiadomości OOB za pomocą kanału komunikacji opartego na połączeniu.

W przypadku kanałów komunikacji opartych na reklamach urządzenie odpowiadające rozpoczyna od rozgłaszania Ranging Capability Response. W takim przypadku urządzenie inicjujące nie wysyła Ranging Capability Request. Zamiast tego po wykryciu rozgłaszania, gdy urządzenie inicjujące (początkowy skaner) jest gotowe, odpowiada, rozgłaszając Ranging Configuration jako pierwszą wiadomość, jak pokazano na rysunku 2:

Rysunek 2. Wymiana wiadomości poza pasmem za pomocą komunikacji opartej na reklamach.

W obu przypadkach reszta wymiany wiadomości jest taka sama. Urządzenie odpowiadające rozpoczyna pomiar odległości natychmiast po otrzymaniu wiadomości Ranging Configuration. Urządzenie odpowiadające przestaje określać odległość po otrzymaniu lub wykryciu wiadomości Stop Ranging.

W przypadku procesu opartego na połączeniu urządzenie odpowiadające wypełnia możliwości tylko w zakresie technologii pomiaru odległości, o które poproszono w Ranging Capability Request, natomiast w przypadku procesu opartego na reklamie urządzenie odpowiadające musi podać wszystkie swoje możliwości, ponieważ nie ma wcześniejszej wiadomości z prośbą o możliwości.

Urządzenie inicjujące zakłada, że w odpowiedzi na wysłane żądanie otrzyma tylko 1 wiadomość. Urządzenie odpowiadające nie może przyjmować takich założeń, aby móc odpowiadać na dowolne żądanie w dowolnej kolejności. Sprawdza to, czy urządzenie odpowiadające może odpowiadać na wiele kolejnych wiadomości Ranging Capability Request lub inne wiadomości wysłane w nieprawidłowej kolejności z urządzenia inicjującego.

Przenoszenie technologii

Wersja OOB umożliwia urządzeniom dynamiczne przełączanie się między różnymi technologiami pomiaru odległości podczas sesji. Aby to ułatwić, inicjator może:

• Wysyłaj wiele wiadomości Ranging Configuration, aby wprowadzać nowe technologie.
• Wyślij kilka wiadomości Stop Ranging, aby zatrzymać aktywne technologie.

Kolejność tych wiadomości zależy od schematu przejścia obsługiwanego przez odpowiadającego:

• Break-before-make: inicjator może przejść na nową technologię tylko wtedy, gdy zatrzyma pierwszą za pomocą komunikatu Stop Ranging, a następnie uruchomi drugą za pomocą komunikatu Ranging Configuration.
• Make-before-break: inicjator może uruchomić nową technologię za pomocą wiadomości Ranging Configuration, zanim zatrzyma istniejące technologie za pomocą wiadomości Stop Ranging.

Odpowiadający musi zaimplementować obsługę jednego z tych schematów przejścia zgodnie z wartością pola supported technology transitioning w Ranging Capability Response.

Identyfikatory technologii pomiaru odległości

Identyfikatory technologii pomiaru odległości znajdziesz w tej tabeli:

Technologia pomiaru odległości	Identyfikator
UWB	0x0
CS	0x1
Wi-Fi NAN RTT	0x2
RSSI	0x3
DS Wi-Fi	0x4
RFU	0x5–0xFF

Te identyfikatory są używane w tabelach, w których wymagany jest identyfikator technologii pomiaru odległości. W przypadku pól zawierających pole bitowe technologii pomiaru odległości bit odpowiadający indeksowi identyfikatora technologii jest ustawiany, gdy ta technologia jest uwzględniona w polu bitowym.

Na przykład RSSI ma wartość identyfikatora 3, ale jeśli RSSI jest uwzględniony w polu bitowym technologii pomiaru odległości, bit o pozycji identyfikatora (3) musi być włączony (pierwszy bit znajduje się na pozycji 0), co powoduje, że wynikowa wartość pola bitowego wynosi 0x8. Jeśli uwzględnione są zarówno UWB, jak i RSSI, wartość pola bitowego to 0x0A (włączone są bity 0 i 3).

Format wiadomości

Każda wiadomość składa się z nagłówka i ładunku.

Rysunek 3. Format wiadomości.

Nagłówek

Rozmiar: 2 bajty

Opis: nagłówek jest wspólny dla wszystkich wiadomości i jest pierwszą częścią wiadomości. Nagłówek zawiera wersję i identyfikator typu wiadomości. Pole version określa wersję tej specyfikacji, z którą zgodna jest zawartość wiadomości. Więcej informacji o tym, jak wersjonowanie jest używane na urządzeniach z różnymi wersjami, znajdziesz w artykule Wersjonowanie. Nagłówek zachowuje zgodność wsteczną w różnych wersjach, co oznacza, że w każdym przypadku użycia można go przeanalizować, aby określić wersję i identyfikator wiadomości.

Nagłówek został podsumowany w tej tabeli:

Oktet	Typ danych	Opis	Wartość
0	uint8	Wersja	0x1 – V1 0x2 – V2 0x3 - V3
1	uint8	Identyfikator wiadomości	0x0 – Ranging Capability Request wiadomość 0x1 – Ranging Capability Response message 0x2 – Ranging Configuration wiadomość 0x3 – Ranging Configuration Response message (opcjonalny) 0x6 – Stop Ranging wiadomość 0x7 – Stop Ranging Response message (opcjonalny) 0x8 – Motion Notification wiadomość 0x4–0x5, 0x9 – 0xFF RFU

Ładunek

Rozmiar: różny (w zależności od typu wiadomości)

Opis: ładunek to ostatnia część wiadomości, po nagłówku. Ładunek zależy od typu wiadomości. Format ładunku każdego typu wiadomości jest zdefiniowany w sekcjach poniżej.

Ładunek wiadomości z prośbą o określenie zakresu

Rozmiar (bez rozmiaru nagłówka): 2 bajty

Opis: wysyłana przez urządzenie inicjujące w celu rozpoczęcia wymiany wiadomości. Ten komunikat jest opcjonalny, gdy kanał komunikacji jest oparty na rozgłaszaniu. W takim przypadku urządzenie odpowiadające musi w pierwszej kolejności rozgłaszać komunikat Ranging Capability Response. Urządzenie inicjujące (pierwszy skaner) odczytuje reklamę i bezpośrednio odpowiada komunikatem Ranging Capability Request, dzięki czemu nie jest on potrzebny.

Ładunek wiadomości Ranging Capability Request został podsumowany w tej tabeli:

Oktet	Typ danych	Opis	Wartość
0	uint8*2	Żądane technologie pomiaru odległości (pole bitowe)	0x01 – UWB 0x02 – BLE channel sounding 0x04 – Wi-Fi NAN RTT 0x08 – BLE RSSI 0x10 – Wi-Fi PD RFU

Ładunek wiadomości odpowiedzi dotyczącej możliwości pomiaru odległości

Rozmiar (bez rozmiaru nagłówka): zmienny (część wspólna 2 bajty plus rozmiar każdego bajtu uwzględnionej technologii pomiaru odległości)

Opis: wysłana przez osobę odpowiadającą w odpowiedzi na wiadomość Ranging Capability Request. Ładunek wiadomości składa się z części wspólnej i części specyficznych dla technologii pomiaru odległości (BLE CS, Wi-Fi NAN RTT, BLE RSSI), jak pokazano w tabelach poniżej. Każda część specyficzna dla danej technologii pomiaru odległości musi być dodana tylko wtedy, gdy ta technologia jest obsługiwana przez urządzenie odpowiadające i jest wymagana w wiadomości Ranging Capability Request. W przypadku kanału komunikacji reklamowej należy uwzględnić wszystkie obsługiwane technologie określania zakresu.

Typowy ładunek wiadomości Ranging Capability Response został podsumowany w tabeli poniżej:

Oktet	Typ danych	Opis	Wartość
0	uint8*2	Pole bitowe obsługiwanych technologii pomiaru odległości. Wskazuje zestaw możliwości technologii pomiaru odległości, które są zawarte w pozostałej części ładunku.	0x01 – UWB 0x02 – BLE channel sounding 0x04 – Wi-Fi NAN RTT 0x08 – BLE RSSI 0x10 – Wi-Fi PD RFU
2	tablica bajtów	Bajty możliwości technologii pomiaru odległości.	Powtórzone bloki struktur zdefiniowane dla każdej technologii.
W zależności od usługi	uint8	Wskazuje obsługę przejścia na inną technologię.	0x00 – obsługiwane jest rozłączanie przed załączeniem. 0x01 – przełączanie z przerwą jest obsługiwane. Urządzenie odpowiadające może jednocześnie określać odległość za pomocą wielu technologii.
W zależności od usługi	uint16	Wskazuje typ urządzenia odpowiadającego.	0x00 – nieznany 0x01 – telefon 0x02 – tablet 0x03 – tag 0x04 – urządzenie do noszenia 0x05 – urządzenie douszne lub nauszne RFU

Ładunek wiadomości UWB Ranging Capability Response został opisany w tabeli poniżej:

Oktet	Typ danych	Opis	Wartość
0	uint8	Identyfikator technologii pomiaru odległości	0x0 – UWB
1	uint8	Rozmiar	Rozmiar bajtów funkcji UWB (w tym pól Technology ID i Size) w bajtach.
2	uint8*2	Adres UWB	2-bajtowy adres UWB urządzenia.
4	uint8*4	Pole bitowe obsługiwanych kanałów	Pole bitowe obsługiwanych kanałów. Bit ustawiony na 0 oznacza, że funkcja nie jest obsługiwana, a 1, że jest obsługiwana. Bit 0 odpowiada kanałowi 0. LSB == channel 0 MSB == channel 31
8	uint8*4	Obsługiwane pole bitowe indeksu preambuły	Pole bitowe obsługiwanych indeksów preambuły. Bit ustawiony na 0 oznacza, że funkcja nie jest obsługiwana, a 1, że jest obsługiwana. Bit 0 odpowiada indeksowi preambuły 1. LSB == preamble index 1 MSB == preamble index 32
12	uint8*4	Pole bitowe obsługiwanych identyfikatorów konfiguracji	Pole bitowe obsługiwanych identyfikatorów konfiguracji UWB. Bit ustawiony na 0 oznacza, że funkcja nie jest obsługiwana, a 1 – że jest obsługiwana. LSB == config Id 0 MSB == config Id 31
16	uint8*2	Obsługiwany minimalny odstęp pomiaru odległości	Wskazuje najszybszy obsługiwany interwał pomiaru odległości w milisekundach. Dozwolone wartości (w milisekundach): 96 120 240 600
18	uint8	Obsługiwany minimalny czas trwania przedziału	Wskazuje najkrótszy obsługiwany czas trwania przedziału w milisekundach. Jeśli na przykład urządzenie zwróci wartość 1 ms, zakłada się, że obsługuje też czas trwania przedziału 2 ms lub dłuższy. Dozwolone wartości (w milisekundach): 1 2
19		Pole bitowe roli obsługiwanego urządzenia UWB	Pole bitowe obsługiwanych ról UWB. Jeśli na przykład oba obsługują ostateczną wartość pola, będzie ona wynosić 0x3. 0x1 – obsługiwana rola inicjatora 0x2 – rola odpowiadającego jest obsługiwana

Ładunek wiadomości BLE CS Ranging Capability Response został podsumowany w tabeli poniżej:

Oktet	Typ danych	Opis	Wartość
0	uint8	Identyfikator technologii pomiaru odległości	0x1 – BLE CS
1	uint8	Rozmiar	Rozmiar bajtów funkcji BLE CS (w tym pól Technology ID i Size) w bajtach.
2	uint8	Obsługiwane pole bitowe typu zabezpieczeń	Pole bitowe obsługiwanych typów zabezpieczeń dla 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	Adres urządzenia	Adres urządzenia używanego w BLE CS w kolejności big-endian.

Ładunek wiadomości Wi-Fi NAN RTT Ranging Capability Response został podsumowany w tabeli poniżej:

Oktet	Typ danych	Opis	Wartość
0	uint8	Identyfikator technologii pomiaru odległości	0x2 – Wi-Fi NAN RTT
1	uint8	Rozmiar	Rozmiar bajtów możliwości RSSI BLE (w tym pola Identyfikator technologii i Rozmiar) w bajtach.
2	uint8	Pole bitowe obsługiwanych funkcji	Pole bitowe obsługiwanych funkcji. 0x01 – obsługa 11mc 0x02 – obsługuje 11az
3	uint8	Obsługa okresowego pomiaru odległości	0x0 – okresowe określanie odległości nieobsługiwane 0x1 – obsługiwane okresowe pomiary odległości
4	uint8	Obsługiwana przepustowość	WYCOFANE Te informacje pomagają określić możliwą do osiągnięcia dokładność pomiaru odległości za pomocą Wi-Fi NAN i mogą pomóc aplikacjom w określeniu, czy do pomiaru odległości używać UWB, BLE CS, BLE RSSI czy Wi-Fi NAN. 0x00 - 20 MHz 0x01 - 40 MHz 0x02 - 80 MHz 0x03 – 160 MHz 0x04 - 80+80 MHz 0x05 – 320 MHz RFU
5	uint8	Obsługiwana liczba łańcuchów odbiorczych	WYCOFANE Te informacje pomagają określić możliwą do osiągnięcia dokładność pomiaru odległości za pomocą Wi-Fi NAN i mogą pomóc aplikacjom w określeniu, czy do pomiaru odległości używać UWB, BLE CS, BLE RSSI czy Wi-Fi NAN. 0x00 – nieokreślony 0x01 – 1 łańcuch RX 0x02 – 2 łańcuchy RX 0x03 – 3 łańcuchy RX 0x04 – 4 łańcuchy RX

Ładunek wiadomości BLE RSSI Ranging Capability Response został podsumowany w tabeli poniżej:

Oktet	Typ danych	Opis	Wartość
0	uint8	Identyfikator technologii pomiaru odległości	0x3 – BLE RSSI
1	uint8	Rozmiar	Rozmiar w bajtach możliwości BLE RSSI (w tym pola Identyfikator technologii i Rozmiar).
2	uint8*6	Adres urządzenia	Adres urządzenia używanego do BLE RSSI; w kolejności big-endian

Ładunek wiadomości Wi-Fi PD Ranging Capability Response został podsumowany w tabeli poniżej:

Oktet	Typ danych	Opis	Wartość
0	uint8	Identyfikator technologii pomiaru odległości	0x4 – Wi-Fi PD
1	uint8	Rozmiar	Rozmiar w bajtach możliwości Wi-Fi PD (w tym pola Technology ID i Size).
2	uint8	Obsługiwane funkcje	Bitmapa b0 – obsługuje 11mc b1 – obsługuje 11az
3	uint8	PansMode	Bitmapa b0 – tryb nieuwierzytelnionego PASN b1 – tryb uwierzytelnionego PASN
4	uint8*6	Adres urządzenia	Adres urządzenia używanego do Wi-Fi PD w kolejności big-endian.
10	uint8*2	Minimalny odstęp pomiaru odległości 802.11mc	Minimalny odstęp pomiaru odległości obsługiwany w formacie big-endian dla 11mc
12	uint8*2	Minimalny odstęp pomiaru odległości 802.11az	Minimalny odstęp pomiaru odległości obsługiwany w formacie big-endian dla 11az
14	uint8	Maksymalny typ preambuły	0 – PREAMBLE_LEGACY 1 - PREAMBLE_HT 2 - PREAMBLE_VHT 3 - PREAMBLE_HE 4 - PREAMBLE_EHT Zakładamy, że wszystkie niższe preambuły będą obsługiwane.
15	uint8	Maksymalna szerokość kanału	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 Zakładamy, że wszystkie mniejsze szerokości kanałów będą obsługiwane.
16	uint8*2	Częstotliwość obsługiwanego kanału	b0 – Kanał 1 b1 – kanał 11 b2 – kanał 36 b3 – kanał 40 b4 – kanał 44 b5 – kanał 48 b6 – kanał 153 b7 – kanał 157 b8 – kanał 161 b9 – kanał 165 b10-b15 - RFU

Ładunek wiadomości Ranging Configuration

Rozmiar (bez rozmiaru nagłówka): zmienny (część wspólna 4 bajty plus rozmiar każdego bajtu uwzględnionej technologii pomiaru odległości).

Opis: ten komunikat jest wysyłany przez inicjatora i zawiera konfiguracje, z którymi każda technologia pomiaru odległości może rozpocząć pomiar. Urządzenie odpowiadające musi po otrzymaniu tej wiadomości spróbować rozpocząć pomiar odległości za pomocą każdej wskazanej technologii pomiaru odległości. Ładunek wiadomości składa się z części wspólnej i części specyficznych dla technologii pomiaru odległości (UWB, BLE CS, Wi-Fi NAN RTT, BLE RSSI), jak pokazano w tabelach poniżej.

Typowy ładunek wiadomości Ranging Configuration został podsumowany w tabeli poniżej:

Oktet	Typ danych	Opis	Wartość
0	uint8*2	Konfiguracja technologii pomiaru odległości – pole bitowe	Pole bitowe technologii pomiaru odległości, dla których to pole zawiera dane konfiguracyjne i dla których muszą być ustawione parametry konfiguracji. 0x01 – UWB 0x02 – BLE channel sounding 0x04 – Wi-Fi NAN RTT 0x08 – BLE RSSI 0x10 – Wi-Fi PD RFU
2	uint8*2	Bitfield	RFU. Musi mieć taką samą wartość jak pole Ranging technologies configuration set bitfield.
4	tablica bajtów	Konfiguracje technologii pomiaru odległości (bajty)	Powtórzone bloki struktur zdefiniowane dla poszczególnych technologii
różni się	uint8	Obsługa ruchu	Motion Notification prosi o dostęp 0x0 – oznacza, że urządzenie inicjujące nie wymaga danych o ruchu. 0x1 – wskazuje, że urządzenie inicjujące wymaga danych o ruchu z urządzenia równorzędnego.

Ładunek wiadomości UWB Ranging Configuration został podsumowany w tej tabeli:

Oktet	Typ danych	Opis	Wartość
0	uint8	Identyfikator technologii pomiaru odległości	0x0 – UWB
1	uint8	Rozmiar	Rozmiar konfiguracji UWB (w tym pola Identyfikator technologii i Rozmiar) w bajtach.
2	uint8*2	Adres UWB	2-bajtowy adres UWB urządzenia
4	uint8*4	Identyfikator sesji	Wygenerowany identyfikator sesji. Identyfikator sesji to unikalny identyfikator sesji pomiaru odległości między telefonem a urządzeniem peryferyjnym.
8	uint8	Identyfikator wybranej konfiguracji	Wybrany numer identyfikatora konfiguracji w postaci liczby całkowitej. Identyfikator konfiguracji określa parametry czasowe i rodzaj zabezpieczeń, które muszą być używane w sesji pomiaru odległości UWB.
9	uint8	Wybrany kanał	Wybrany kanał sesji pomiaru odległości UWB
10	uint8	Wybrany indeks preambuły	Wybrany indeks preambuły dla sesji pomiaru odległości UWB
11	uint8*2	Wybrany przedział pomiaru odległości	Wybrana częstotliwość pomiaru odległości (w milisekundach). Dozwolone wartości (w milisekundach): 96 120 240 600
13	uint8	Wybrany czas trwania przedziału czasu	Czas trwania wybranego przedziału w milisekundach. Dozwolone wartości (w milisekundach): 1 2
14	uint8	Długość klucza sesji	Długość klucza sesji w bajtach
15	tablica bajtów	Klucz sesji	Klucz sesji. Jeśli używany jest S-STS, pierwsze 2 bajty to IDENTYFIKATOR DOSTAWCY, a kolejne 6 bajtów to STATYCZNY WEKTOR INICJALIZACYJNY STS. Jeśli używany jest P-STS, jest to 16- lub 32-bajtowy klucz sesji. Rodzaj użytego zabezpieczenia jest określany przez identyfikator konfiguracji.
różni się	uint8*2	Kod kraju	Kod kraju w formacie ISO 3166-1 alfa-2, reprezentowany przez 2 znaki ASCII.
różni się	uint8	Wybrana rola urządzenia	0x01 – inicjator 0x02 – Responder
różni się	uint8	Wybrany tryb urządzenia	0x01 – kontroler 0x02 – Controlee

Ładunek wiadomości BLE CS Ranging Configuration został podsumowany w tabeli poniżej:

Oktet	Typ danych	Opis	Wartość
0	uint8	Identyfikator technologii pomiaru odległości	0x1 – BLE CS
1	uint8	Rozmiar	Rozmiar konfiguracji BLE CS (w tym pola Identyfikator technologii i Rozmiar) w bajtach.
2	uint8	Wybrany typ zabezpieczeń	Wybrany typ zabezpieczeń. Dozwolone wartości: 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	Adres urządzenia	Adres urządzenia używanego do BLE CS w kolejności big-endian.

Ładunek wiadomości Wi-Fi NAN RTT Ranging Configuration został podsumowany w tabeli poniżej:

Oktet	Typ danych	Opis	Wartość
0	uint8	Identyfikator technologii pomiaru odległości	0x2 – Wi-Fi NAN RTT
1	uint8	Rozmiar	Rozmiar konfiguracji Wi-Fi NAN RTT (w tym pola Technology ID i Size) w bajtach.
2	uint8	Długość nazwy usługi	Długość pola Nazwa usługi w bajtach. Zapoznaj się z sekcją 1.3.3 tabeli 1 specyfikacji Wi-Fi Aware w wersji 4.0. Definicje.
3	tablica bajtów	Nazwa usługi	Nazwa usługi. Zapoznaj się z sekcją 1.3.3 tabeli 1 specyfikacji Wi-Fi Aware w wersji 4.0. Definicje.
różni się	uint8	Rola urządzenia	0x0 – Responder (wydawca usługi NAN) 0x1 – inicjator (subskrybent usługi NAN)
różni się	uint8	Korzystanie z okresowego pomiaru odległości	0x0 – okresowe określanie odległości wyłączone 0x1 – włączone pomiary okresowe

Ładunek wiadomości BLE RSSI Ranging Configuration został podsumowany w tabeli poniżej:

Oktet	Typ danych	Opis	Wartość
0	uint8	Identyfikator technologii pomiaru odległości	0x3 – BLE RSSI
1	uint8	Rozmiar	Rozmiar konfiguracji BLE RSSI (w tym pola Technology ID i Size) w bajtach.
2	uint8*6	Adres urządzenia	Adres urządzenia używanego do BLE RSSI; w kolejności big-endian

Ładunek wiadomości Wi-Fi PD Ranging Configuration został podsumowany w tabeli poniżej:

Oktet	Typ danych	Opis	Wartość
0	uint8	Identyfikator technologii pomiaru odległości	0x4 – Wi-Fi PD
1	uint8	Rozmiar	Rozmiar konfiguracji Wi-Fi NAN PD (w tym pola Technology ID i Size) w bajtach.
2	uint8	Funkcja	0x01 - 11mc 0x02 - 11az
3	uint8*6	Adres MAC	Adres MAC inicjatora
9	uint8*2	Przedział pomiaru odległości	Interwał pomiaru odległości w ms
11	uint8	Wybrany wstęp	0 – PREAMBLE_LEGACY 1 - PREAMBLE_HT 2 - PREAMBLE_VHT 3 - PREAMBLE_HE 4 - PREAMBLE_EHT
12	uint8	Wybrana szerokość kanału	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	Wybrany kanał	0 – Kanał 1 1 – kanał 11 2 – kanał 36 3 – kanał 40 4 – kanał 44 5 – kanał 48 6 – kanał 153 7 – kanał 157 8 – kanał 161 9 – kanał 165
14	uint8	Wybrany tryb PASN	0x01 – tryb nieuwierzytelnionego PASN 0x02 – tryb uwierzytelnionego PASN Uwaga: to pole oznacza koniec pakietu w przypadku nieuwierzytelnionego trybu PASN.
15	tablica bajtów	Klucz identyfikatora urządzenia	16-bajtowa tablica o stałej długości Uwaga: to pole jest prawidłowe tylko w przypadku uwierzytelnionego trybu PASN. Nie można go ustawić w przypadku nieuwierzytelnionego trybu PASN.
31	uint8	Długość hasła	długość hasła, Uwaga: to pole jest prawidłowe tylko w przypadku uwierzytelnionego trybu PASN. Nie można go ustawić w przypadku nieuwierzytelnionego trybu PASN.
różni się	tablica bajtów	Hasło	Hasło jako tablica bajtów. Uwaga: to pole jest prawidłowe tylko w przypadku uwierzytelnionego trybu PASN. Nie można go ustawić w przypadku nieuwierzytelnionego trybu PASN.

Ładunek wiadomości odpowiedzi konfiguracji pomiaru odległości

Rozmiar (bez rozmiaru nagłówka): 2 bajty

Opis: ta wiadomość jest wysyłana przez odpowiadającego w odpowiedzi na wiadomość Ranging Configuration. Ten komunikat jest opcjonalny. Jest wymagany tylko wtedy, gdy używany kanał komunikacji wymaga wyraźnej odpowiedzi na każde żądanie.

Ładunek wiadomości Ranging Configuration Response został podsumowany w tabeli poniżej:

Oktet	Typ danych	Opis	Wartość
0	uint8*2	Pole bitowe konfiguracji technologii pomiaru odległości	Pole bitowe technologii pomiaru odległości, które zostały skonfigurowane. Pole bitowe ustawia bit technologii pomiaru odległości na 1, jeśli technologia została zażądana i ustawiona, a w przeciwnym razie na 0. 0x01 – UWB 0x02 – BLE channel sounding 0x04 – Wi-Fi NAN RTT 0x08 – BLE RSSI 0x10 – Wi-Fi PD RFU

Ładunek wiadomości Stop Ranging

Rozmiar (bez rozmiaru nagłówka): 2 bajty

Opis: ten komunikat jest wysyłany przez urządzenie inicjujące, gdy nadszedł czas na zatrzymanie pomiaru odległości za pomocą określonej technologii pomiaru odległości.

Ładunek wiadomości Stop Ranging został podsumowany w tej tabeli:

Oktet	Typ danych	Opis	Wartość
0	uint8*2	Technologie pomiaru odległości do zatrzymania pola bitowego	Pole bitowe technologii pomiarowych, które muszą przestać dokonywać pomiarów. Bit ustawiony na 1 oznacza, że technologia pomiaru odległości musi przestać mierzyć odległość, a 0 oznacza, że technologia pomiaru odległości nie mierzyła odległości lub musi kontynuować pomiar, jeśli już go wykonywała. W przypadku niektórych technologii pomiaru odległości (np. CS) ta operacja nie ma wpływu na działanie, ponieważ pomiar odległości jest inicjowany i zatrzymywany tylko po stronie inicjatora. 0x01 – UWB 0x02 – BLE channel sounding 0x04 – Wi-Fi NAN RTT 0x08 – BLE RSSI 0x10 – Wi-Fi PD RFU

Ładunek wiadomości Stop Ranging Response

Rozmiar (bez rozmiaru nagłówka): 2 bajty

Opis: ta wiadomość jest wysyłana przez odpowiadającego w odpowiedzi na wiadomość Stop Ranging. Ten komunikat jest opcjonalny. Jest wymagany tylko wtedy, gdy używany kanał komunikacji wymaga wyraźnej odpowiedzi na każde żądanie.

Ładunek wiadomości Stop Ranging Response został podsumowany w tej tabeli:

Oktet	Typ danych	Opis	Wartość
0	uint8*2	Bitowe pole informujące o tym, że technologie pomiaru odległości zostały zatrzymane	Pole bitowe technologii pomiarowych, które zostały zatrzymane. Pole bitowe ustawia bit technologii pomiaru odległości na 1, jeśli zażądano zatrzymania tej technologii i zostało ono zrealizowane, a w przeciwnym razie na 0. 0x01 – UWB 0x02 – BLE channel sounding 0x04 – Wi-Fi NAN RTT 0x08 – BLE RSSI 0x10 – Wi-Fi PD RFU

Ładunek wiadomości powiadomienia o ruchu

Rozmiar (bez rozmiaru nagłówka): 1 bajt

Opis: urządzenie odpowiadające wysyła tę wiadomość, aby poinformować urządzenie inicjujące o wszelkich zmianach w swoim stanie ruchu.

Oktet	Typ danych	Opis	Wartość
0	uint8	Ruch	0x0 – nie wykryto 0x1 – niewielki ruch 0x2 – umiarkowany ruch 0x3 – duży ruch RFU Próg ruchu musi być skonfigurowany tak, aby wykrywać zmianę orientacji o ±X° wzdłuż dowolnych 2 osi akcesorium. Nie wykryto: < 5° Lekki ruch: 5–7° Umiarkowany ruch: 7–10° Duży ruch: > 10°

Obsługa wersji

Wersja specyfikacji jest zawarta w nagłówku każdej wiadomości. W tej sekcji opisano sposób komunikacji, gdy jedno z urządzeń (inicjator lub odpowiadający) ma starszą wersję niż drugie urządzenie.

Przypadek 1. Kanał komunikacji oparty na połączeniu

W tej sekcji opisano przypadki, w których używany jest kanał komunikacji oparty na połączeniu, a Ranging Capability Request to pierwsza wiadomość wysłana przez urządzenie inicjujące.

Przypadek 1a.Inicjator obsługuje nowszą wersję specyfikacji, a odpowiadający – starszą.

Urządzenie inicjujące wysyła wiadomość Ranging Capability Request z nowszą wersją. Urządzenie odpowiadające obsługuje tylko starszą wersję, więc odpowiada w jej ramach. Następnie starsza wersja urządzenia odpowiadającego jest używana w pozostałej części wymiany wiadomości. Oznacza to, że wiadomość Ranging Capability Request musi być wstecznie zgodna.

Przypadek 1.b: inicjator obsługuje starszą wersję specyfikacji, a odpowiadający – nowszą.

Urządzenie odpowiadające widzi, że urządzenie inicjujące nie obsługuje nowszej wersji, więc wysyła wiadomości tylko w starszej wersji, o którą początkowo poprosiło urządzenie inicjujące.

Przypadek 2. Kanał komunikacji oparty na reklamach

W tej sekcji opisujemy przypadki, w których używany jest kanał komunikacji oparty na reklamach, a urządzenie odpowiadające reklamuje się Ranging Capability Requestbezpośrednio, bez początkowego żądania.

Przypadek 2a.Inicjator obsługuje nowszą wersję specyfikacji, a odpowiadający – starszą.

W pozostałej części komunikacji używana jest starsza wersja ustawiona w Ranging Capability Responsereklamie.

Przypadek 2b.Nadawca obsługuje starszą wersję specyfikacji, a odbiorca nowszą.

Nowsza wersja reklamy Ranging Capability Response musi być wstecznie zgodna, aby urządzenie inicjujące mogło odczytać wiadomość, nawet jeśli używa nowszej wersji. Urządzenie inicjujące wysyła wtedy wiadomość Ranging Configuration przy użyciu starszej wersji, którą obsługuje. Jest to wersja, która jest używana w pozostałej części komunikacji.

Aby zapewnić wsteczną zgodność Ranging Capability Response, wszystkie nowe pola dodane do następnej wersji tej specyfikacji w ładunku wiadomości Ranging Capability Response muszą być dołączane na końcu ładunku, a żadne z istniejących pól nie może być modyfikowane. Podczas analizowania konfiguracji, jeśli wskazany rozmiar jest większy niż oczekiwany, dodatkowe pola muszą być ignorowane przez każde urządzenie, które rozumie tylko starszą wersję specyfikacji.

Fragmentacja

Ta specyfikacja jest niezależna od kanału komunikacji, więc nie określa, jak dzielić ładunek wiadomości na fragmenty w przypadku, gdy pojedyncza wiadomość jest zbyt duża, aby zmieścić się w pakiecie przesyłanym przez używany kanał komunikacji. Moduł pomiaru odległości oczekuje otrzymania każdej wiadomości w pełnej formie. Za fragmentację odpowiada osoba wdrażająca kanał komunikacji OOB.

Szczegóły dotyczące technologii pomiaru odległości

Ta sekcja zawiera szczegółowe informacje dotyczące technologii pomiaru odległości.

Szczegóły dotyczące łącza ultraszerokopasmowego (UWB)

W tej sekcji znajdziesz szczegółowe informacje dotyczące technologii UWB.

Identyfikatory konfiguracji

Dane konfiguracyjne OOB wymieniane w przypadku technologii UWB nie zawierają pełnego zestawu dostępnych parametrów konfiguracyjnych, których technologia UWB wymaga do rozpoczęcia sesji pomiaru odległości. Dzieje się tak, ponieważ niektóre parametry są niejawnie wybierane przez wybrany identyfikator konfiguracji.

Każdy identyfikator konfiguracji to zestaw wstępnie zdefiniowanych parametrów konfiguracji UWB, które są opisane w UwbRangingParams. Urządzenie odpowiadające wysyła listę wszystkich obsługiwanych identyfikatorów konfiguracji w ramach obsługiwanych identyfikatorów konfiguracji supports_technology_transitioning. Dzięki temu podczas konfiguracji OOB można wymieniać mniejszy zestaw parametrów konfiguracji. Ogranicza też liczbę możliwych kombinacji parametrów, które można wykorzystać do pomiaru odległości za pomocą technologii UWB, co umożliwia testowanie tylko dozwolonych kombinacji parametrów.

Prośba o możliwości po każdej sesji UWB

Po zatrzymaniu istniejącej sesji UWB i przed rozpoczęciem nowej sesji UWB urządzenie inicjujące musi poprosić o możliwości urządzenia odpowiadającego i ponownie ustawić parametry konfiguracji, ponieważ adres UWB może się zmienić natychmiast po zakończeniu bieżącej sesji pomiaru odległości.

Szczegóły dotyczące sondowania kanału BLE (CS)

W tej sekcji opisujemy szczegóły dotyczące sondowania kanału.

Wymagane połączenie między urządzeniami

Aby pomiar odległości za pomocą sondowania kanału działał, musi istnieć powiązanie między urządzeniem inicjującym a urządzeniem odpowiadającym. Ta specyfikacja nie umożliwia tworzenia powiązań między urządzeniami. Użytkownik interfejsów Ranging API musi nawiązać to połączenie między urządzeniami.

Działanie wymagane po stronie odpowiadającego w przypadku obsługi klienta

W przypadku UWB oba urządzenia muszą jawnie wywoływać interfejsy UWB API do rozpoczęcia i zakończenia pomiaru odległości. W przypadku CS tylko urządzenie inicjujące musi rozpocząć pomiar odległości CS, wywołując stos Bluetooth (BT). Pozostała część inicjowania po stronie urządzenia odpowiadającego odbywa się w pasmie za pomocą Bluetootha. Oznacza to, że po otrzymaniu wiadomości Ranging Configuration lub wiadomości Stop Ranging dla CS urządzenie odpowiadające nie musi nic robić, jeśli Bluetooth jest włączony. Urządzenie odpowiadające może używać tych wiadomości jako wyzwalacza do aktualizowania interfejsu lub np. migania diod LED.