W Androidzie 16 wprowadziliśmy 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.
Głównym celem tej strony jest umożliwienie dostawcom urządzeń innych niż Android wdrożenia tej specyfikacji, aby ich urządzenia były zgodne z urządzeniami z Androidem w zakresie pomiaru odległości.
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 |
Jak pokazano na rysunkach 1 i 2, sposób wywoływania wymiany wiadomości zależy od kanału 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 reklamowania Ranging Capability. W takim przypadku Ranging Capability Request
nie jest wysyłany z urządzenia inicjującego. Zamiast tego po wykryciu reklamy, gdy urządzenie inicjujące (skaner początkowy) jest gotowe, odpowiada, wysyłając jako pierwszą wiadomość reklamę Ranging Configuration, 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 pomiarowych, 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. Dzięki temu 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.
Identyfikatory technologii pomiaru odległości
Identyfikatory technologii pomiaru odległości znajdziesz w tej tabeli:
| Technologia pomiaru odległości | ID |
|---|---|
| UWB | 0x0 |
| CS | 0x1 |
| Wi-Fi NAN RTT | 0x2 |
| RSSI | 0x3 |
| RFU | 0x4–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 wynosi 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. Obecna wersja tej specyfikacji to 1. Więcej informacji o tym, jak działa zarządzanie wersjami na urządzeniach z różnymi wersjami, znajdziesz w sekcji Zarządzanie wersjami. Nagłówek zachowuje zgodność wsteczną w różnych wersjach, co oznacza, że w każdym przypadku można go przeanalizować, aby określić wersję i identyfikator wiadomości.
Nagłówek został podsumowany w tej tabeli:
| Octet | Typ danych | Opis | Wartość |
|---|---|---|---|
| 0 | uint8 | Wersja | 0x1 – bieżąca wersja |
| 1 | unit8 | Identyfikator wiadomości |
|
Ł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 możliwość określania odległości
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 reklamach. W takim przypadku urządzenie odpowiadające musi w pierwszej kolejności reklamować Ranging
Capability. Urządzenie inicjujące (pierwszy skaner) odczytuje reklamę i bezpośrednio odpowiada komunikatem Ranging Capability, dzięki czemu nie jest on potrzebny.
Ładunek wiadomości Ranging Capability Request został podsumowany w tej tabeli:
| Octet | Typ danych | Opis | Wartość |
|---|---|---|---|
| 0 | uint8*2 | Żądane technologie pomiaru odległości (pole bitowe) |
|
Ł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 urządzenie odpowiadające obsługuje tę technologię i jest ona wymagana w wiadomości Ranging Capability Request. W przypadku kanału komunikacji reklamowej należy uwzględnić wszystkie obsługiwane technologie określania zasięgu.
Typowy ładunek wiadomości Ranging Capability Response został podsumowany w tabeli poniżej:
| Octet | 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 znajdują się w pozostałej części ładunku. |
|
| 2 | tablica bajtów | Bajty możliwości technologii pomiaru odległości. | Powtórzone bloki struktur zdefiniowane dla każdej technologii. |
Ładunek wiadomości UWB Ranging Capability Response został podsumowany w tabeli poniżej:
| Octet | 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 0MSB == 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 1MSB == 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 – nieobsługiwane, 1 – obsługiwane.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):
|
| 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 zwraca 1 ms, zakłada się, że obsługuje też czas trwania boksu wynoszący 2 ms lub więcej. Dozwolone wartości (w milisekundach):
|
| 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, jest ona równa 0x3.
|
Ładunek wiadomości BLE CS Ranging Capability Response został podsumowany w tabeli poniżej:
| Octet | 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.
|
| 3 | uint8*6 | Adres urządzenia | Adres urządzenia używanego na potrzeby BLE CS w kolejności big-endian. |
Ładunek wiadomości Wi-Fi NAN RTT Ranging Capability Response został podsumowany w tej tabeli:
| Octet | 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.
|
| 3 | uint8 | Obsługa okresowego pomiaru odległości |
|
| 4 | uint8 | Obsługiwana przepustowość | 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.
|
| 5 | uint8 | Obsługiwana liczba łańcuchów odbiorczych | 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.
|
Ładunek wiadomości BLE RSSI Ranging Capability Response został podsumowany w tabeli poniżej:
| Octet | 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 Technology ID i Size). |
| 2 | uint8*6 | Adres urządzenia | Adres urządzenia używanego do BLE RSSI; w kolejności big-endian |
Ładunek wiadomości Ranging Configuration
Rozmiar (bez rozmiaru nagłówka): różny (część wspólna 4 bajty plus rozmiar każdego z uwzględnionych bajtów technologii pomiaru odległości).
Opis: ta wiadomość jest wysyłana 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 tej 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:
| Octet | 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 należy ustawić parametry konfiguracji.
|
| 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 (w bajtach) | Powtórzone bloki struktur zdefiniowane dla każdej technologii |
Ładunek wiadomości UWB Ranging Configuration został podsumowany w tej tabeli:
| Octet | 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 formacie 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 interwał pomiaru odległości | Wybrana częstotliwość pomiaru odległości w milisekundach. Dozwolone wartości (w milisekundach):
|
| 13 | uint8 | Wybrany czas trwania przedziału czasu | Czas trwania wybranego przedziału w milisekundach. Dozwolone wartości (w milisekundach):
|
| 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 inicjujący 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 alpha-2, reprezentowany przez 2 znaki ASCII. |
| różni się | uint8 | Wybrana rola urządzenia |
|
| różni się | uint8 | Wybrany tryb urządzenia |
|
Ładunek wiadomości BLE CS Ranging Configuration został podsumowany w tabeli poniżej:
| Octet | 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:
|
| 3 | uint8*6 | Adres urządzenia | Adres urządzenia używanego do BLE CS w kolejności big-endian. |
Ładunek wiadomości Ranging Configuration Wi-Fi NAN RTT został podsumowany w tabeli poniżej:
| Octet | 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 specyfikacją Wi-Fi Aware w wersji 4.0, sekcja 1.3.3, tabela 1. Definicje. |
| 3 | tablica bajtów | Nazwa usługi | Nazwa usługi. Zapoznaj się z specyfikacją Wi-Fi Aware w wersji 4.0, sekcja 1.3.3, tabela 1. Definicje. |
| różni się | uint8 | Rola urządzenia |
|
| różni się | uint8 | Używanie okresowego pomiaru odległości |
|
Ładunek wiadomości BLE RSSI Ranging Configuration został podsumowany w tabeli poniżej:
| Octet | Typ danych | Opis | Wartość |
|---|---|---|---|
| 0 | uint8 | Identyfikator technologii pomiaru odległości | 0x3 – BLE RSSI |
| 1 | uint8 | Rozmiar | Rozmiar konfiguracji RSSI BLE (w tym pola Identyfikator technologii i Rozmiar) w bajtach. |
| 2 | uint8*6 | Adres urządzenia | Adres urządzenia używanego do BLE RSSI; w kolejności big-endian |
Ładunek wiadomości odpowiedzi na konfigurację pomiaru odległości
Rozmiar (bez rozmiaru nagłówka): 2 bajty
Opis: ta wiadomość jest wysyłana przez osobę, która wypełniła formularz, 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:
| Octet | Typ danych | Opis | Wartość |
|---|---|---|---|
| 0 | uint8*2 | Bitowe pole 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.
|
Ładunek wiadomości Stop Ranging
Rozmiar (bez rozmiaru nagłówka): 2 bajty
Opis: ten komunikat jest wysyłany przez urządzenie inicjujące, gdy nadejdzie 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:
| Octet | 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, ponieważ pomiar odległości jest inicjowany i zatrzymywany tylko po stronie inicjatora.
|
Ładunek wiadomości Stop Ranging Response
Rozmiar (bez rozmiaru nagłówka): 2 bajty
Opis: ta wiadomość jest wysyłana przez osobę, która wypełniła formularz, 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:
| Octet | Typ danych | Opis | Wartość |
|---|---|---|---|
| 0 | uint8*2 | Pole bitowe wskazujące, że technologie pomiaru odległości zostały zatrzymane | Pole bitowe technologii pomiaru odległości, które zostały zatrzymane. Pole bitowe ustawia bit technologii pomiaru odległości na 1, jeśli zażądano zatrzymania tej technologii i jeśli zatrzymanie się powiodło, a w przeciwnym razie na 0.
|
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 opisujemy 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 przypadku, a następnie starsza wersja urządzenia odpowiadającego jest używana w pozostałej części wymiany wiadomości. Oznacza to, że komunikat Ranging Capability Request
musi być wstecznie zgodny.
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 prosiło urządzenie inicjujące.
Przypadek 2. Kanał komunikacji oparty na reklamach
W tej sekcji opisano 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.Nadawca obsługuje nowszą wersję specyfikacji, a odbiorca starszą.
W pozostałej części komunikacji używana jest starsza wersja ustawiona w Ranging Capability Responsereklamie.
Przypadek 2.b: inicjator obsługuje starszą wersję specyfikacji, a odpowiadający – 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ć zgodność wsteczną 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 w przypadkach, 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 wiadomości z odpowiedzią o możliwościach, a urządzenie inicjujące wybiera jeden z obsługiwanych identyfikatorów konfiguracji, który będzie używany. Umożliwia to wymianę mniejszego zestawu parametrów konfiguracji podczas komunikacji poza pasmem. Ogranicza też liczbę możliwych kombinacji parametrów, które można wykorzystać do pomiaru odległości za pomocą UWB, co umożliwia testowanie tylko dozwolonych kombinacji parametrów.
Żądanie funkcji 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.
Specyfika sondowania kanału BLE (CS)
W tej sekcji opisano 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 połączeń 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 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 po stronie odpowiadającego nie trzeba 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.