Mit Android 16 wurde das Ranging-Modul eingeführt. Dieses Protokoll und diese Nutzlastspezifikation definieren die Nachrichtenfolge und die Nutzlast der Out-of-Band-Kommunikation (OOB), die zum Austausch von Entfernungs-Konfigurationen sowie zum Starten und Beenden der Entfernungsmessung zwischen dem Initiator- und dem Responder-Gerät verwendet wird. Mit Android 17 wird Version 3 dieser Spezifikation eingeführt.
Auf dieser Seite wird beschrieben, wie Anbieter von Nicht-Android-Geräten diese Spezifikation implementieren können, damit ihre Geräte mit Android-Geräten kompatibel sind.
Eine Implementierung dieser Spezifikation in der Paketbeschreibungssprache (Packet Description Language, PDL) von Google ist auf GitHub verfügbar. Aus dieser Implementierung kann der PDL-Compiler Serialisierungs- und Deserialisierungscode für die in dieser Spezifikation definierten Nachrichten generieren. Diese Spezifikation unterstützt eine Vielzahl von Zielsprachen, darunter C++, Rust und Java.
Neu in Version 3
In Version 3 der OOB-Spezifikation werden die folgenden Änderungen eingeführt:
- Bewegungsbenachrichtigung:Eine Nachricht, mit der das Gerät des Werbetreibenden das initiierende Gerät über eine Änderung der Bewegung informiert.
- Konfiguration für die Entfernungsmessung:Enthält das neue Feld
Motion support, mit dem der Initiator den Responder über Änderungen in der Bewegung des Peripheriegeräts vom Responder benachrichtigen kann. - Unterstützung für die neue Wi-Fi PD-Technologie in Ranging Capability (Entfernungsmessungsfunktion) und Ranging Configuration (Entfernungsmessungskonfiguration) hinzugefügt.
- Die Felder
Supported BandwidthundSupported number of Receive chainsinWi-Fi NAN RTT Ranging Capabilitywerden eingestellt.
Byte-Reihenfolge
Sofern nicht anders angegeben, sind alle numerischen Mehrbytefelder in den Nachrichten in Little-Endian-Reihenfolge.
Nachrichten und Nachrichtenfolge
In diesem Abschnitt werden die Nachrichten und die Reihenfolge des Nachrichtenaustauschs beschrieben.
In der folgenden Tabelle sind alle Nachrichten aufgeführt, die im OOB-Austausch enthalten sind:
| Nachricht | Nachrichten-ID |
|---|---|
Ranging Capability Request |
0x0 |
Ranging Capability Response |
0x1 |
Ranging Configuration |
0x2 |
Ranging Configuration Response (optional) |
0x3 |
Stop Ranging |
0x6 |
Stop Ranging Response (optional) |
0x7 |
Motion Notification |
0x8 |
Der Nachrichtenaustausch beginnt damit, dass das Initiatorgerät Ranging
Capability Request an das Respondergerät sendet. Das Responder-Gerät antwortet mit Ranging Capability Response, wie in Abbildung 1 dargestellt:
Abbildung 1. OOB-Nachrichtenaustausch über einen verbindungsbasierten Kommunikationskanal.
Das Responder-Gerät beginnt sofort nach dem Empfang der Ranging
Configuration-Nachricht mit der Entfernungsmessung. Das Antwortgerät beendet die Entfernungsmessung, nachdem es die Stop Ranging-Nachricht empfangen oder erkannt hat.
Das Antwortgerät füllt die Funktionen nur der in der Ranging Capability Request-Nachricht angeforderten Ortungstechnologien aus.
Das Initiatorgerät erwartet nur eine Antwort auf jede von ihm gesendete Anfragenachricht. Das Antwortgerät darf keine solchen Annahmen treffen, damit es auf jede Anfrage in beliebiger Reihenfolge reagieren kann. Damit wird überprüft, ob das Responder-Gerät auf mehrere aufeinanderfolgende Ranging Capability Request-Nachrichten oder andere Nachrichten in falscher Reihenfolge vom Initiator-Gerät reagieren kann.
Technologieumstellung
Mit der OOB-Version können die Geräte während einer Sitzung dynamisch zwischen verschiedenen Ranging-Technologien wechseln. Dazu kann der Initiator Folgendes tun:
- Senden Sie mehrere
Ranging Configuration-Nachrichten, um neue Technologien zu starten. - Senden Sie mehrere
Stop Ranging-Nachrichten, um aktive Technologien zu beenden.
Die Reihenfolge dieser Nachrichten hängt vom Übergangsschema ab, das vom Responder unterstützt wird:
- Break-before-make:Der Initiator kann nur dann zu einer neuen Technologie wechseln, wenn er die erste mit einer
Stop Ranging-Nachricht beendet, bevor er die zweite mit einerRanging Configuration-Nachricht startet. - Make-before-break:Der Initiator kann eine neue Technologie mit einer
Ranging Configuration-Nachricht starten, bevor er vorhandene Technologien mit einerStop Ranging-Nachricht beendet.
Der Responder muss die Unterstützung für eines dieser Übergangsschemas gemäß dem Wert des Felds supported technology transitioning in seinem Ranging Capability Response implementieren.
IDs der Entfernungsmessungstechnologie
Die IDs der Ortungstechnologien sind in der folgenden Tabelle aufgeführt:
| Entfernungsmessung | ID |
|---|---|
| UWB | 0x0 |
| CS | 0x1 |
| WLAN-NAN-RTT | 0x2 |
| RSSI | 0x3 |
| WLAN‑PD | 0x4 |
| Für zukünftige Verwendung reserviert | 0x5 – 0xFF |
Diese IDs werden in den Tabellen auf dieser Seite verwendet, wenn die ID der Technologie zur Entfernungsmessung erforderlich ist. Bei Feldern, die ein Bitfeld für die Entfernungsmessungstechnologie enthalten, wird ein Bit, das dem Index der ID der Technologie entspricht, gesetzt, wenn diese Technologie im Bitfeld enthalten ist.
RSSI hat beispielsweise den ID-Wert 3. Wenn RSSI jedoch im Bitfeld der Ortungstechnologie enthalten ist, muss das Bit mit der Position der ID (3) aktiviert werden (das erste Bit hat die Position 0). Der resultierende Wert des Bitfelds ist dann 0x8. Wenn sowohl UWB als auch RSSI enthalten sind, ist der Wert des Bitfelds 0x0A (sowohl Bit 0 als auch Bit 3 sind aktiviert).
Nachrichtenformat
Jede Nachricht besteht aus einem Header und einer Nutzlast.
Abbildung 3. Nachrichtenformat
Header
Größe:2 Byte
Beschreibung:Der Header ist der erste Teil einer Nachricht und ist für alle Nachrichten gleich. Der Header enthält eine Version und die ID des Nachrichtentyps. Das Feld „version“ gibt die Version dieser Spezifikation an, der der Inhalt der Nachricht entspricht. Weitere Informationen zur Verwendung der Versionsverwaltung zwischen Geräten mit unterschiedlichen Versionen finden Sie unter Versionsverwaltung. Der Header ist über verschiedene Versionen hinweg abwärtskompatibel. Das bedeutet, dass der Anwendungsfall ihn immer parsen kann, um die Version und die ID der Nachricht zu ermitteln.
Der Header ist in der folgenden Tabelle zusammengefasst:
| Oktett | Datentyp | Beschreibung | Wert |
|---|---|---|---|
| 0 | uint8 | Version |
|
| 1 | uint8 | Nachrichten-ID |
|
Nutzlast
Größe:Variiert (abhängig von der Art der Nachricht)
Beschreibung:Die Nutzlast ist der letzte Teil der Nachricht nach dem Header. Die Nutzlast hängt vom Typ der Nachricht ab. Das Format für die Nutzlast der einzelnen Nachrichtentypen wird in den folgenden Abschnitten definiert.
Nutzlast der Anfrage für die Entfernungsbestimmung
Größe (Headergröße nicht enthalten): 2 Byte
Beschreibung:Wird vom Initiatorgerät gesendet, um den Nachrichtenaustausch zu starten.
Die Ranging Capability Request-Nachrichtennutzlast wird in der folgenden Tabelle zusammengefasst:
| Oktett | Datentyp | Beschreibung | Wert |
|---|---|---|---|
| 0 | uint8*2 | Bitfeld der angeforderten Technologien für die Entfernungsmessung |
|
Nutzlast der Antwortnachricht zur Reichweitenbestimmung
Größe (Headergröße nicht enthalten): Variiert (gemeinsamer Teil 2 Byte plus die Größe der Byte für jede enthaltene Ranging-Technologie)
Beschreibung:Wird vom Empfänger als Antwort auf eine Ranging Capability
Request-Nachricht gesendet. Die Nutzlast dieser Nachricht besteht aus dem gemeinsamen Teil und den technologiebezogenen Teilen (BLE CS, Wi-Fi NAN RTT, BLE RSSI), wie in den folgenden Tabellen dargestellt. Jeder technologiebezogene Teil muss nur hinzugefügt werden, wenn die entsprechende Technologie vom Responder-Gerät unterstützt wird und in der Ranging Capability Request-Nachricht angefordert wird.
Die allgemeine Ranging Capability Response-Nachrichtennutzlast wird in der folgenden Tabelle zusammengefasst:
| Oktett | Datentyp | Beschreibung | Wert |
|---|---|---|---|
| 0 | uint8*2 | Bitfeld der unterstützten Ranging-Technologien. Gibt die Menge der Funktionen von Ortungstechnologien an, die im Rest der Nutzlast folgen. |
|
| 2 | Byte-Array | Bytes für die Technologie zur Entfernungsmessung. | Wiederholte Blöcke von Strukturen, die pro Technologie definiert sind. |
| Variabel | uint8 | Gibt an, dass Technologieübergänge unterstützt werden. |
|
| Variabel | uint16 | Gibt den Typ des Antwortgeräts an. |
|
Die Nutzlast der UWB-Ranging Capability Response-Nachricht wird in der folgenden Tabelle zusammengefasst:
| Oktett | Datentyp | Beschreibung | Wert |
|---|---|---|---|
| 0 | uint8 | ID der Technologie zur Entfernungsmessung | 0x0 – UWB |
| 1 | uint8 | Größe | Größe der UWB-Funktionen in Byte (einschließlich der Felder Technology ID und Size). |
| 2 | uint8*2 | UWB-Adresse | 2 Byte lange UWB-Adresse des Geräts. |
| 4 | uint8*4 | Bitfeld für unterstützte Kanäle | Bitfeld der unterstützten Kanäle. Wenn das Bit auf 0 gesetzt ist, wird die Funktion nicht unterstützt. Wenn es auf 1 gesetzt ist, wird sie unterstützt. Bit 0 entspricht Kanal 0.LSB == channel 0MSB == channel 31 |
| 8 | uint8*4 | Unterstütztes Bitfeld für den Preamble-Index | Bitfeld der unterstützten Präambelindexe. Wenn das Bit auf 0 gesetzt ist, wird die Funktion nicht unterstützt. Wenn es auf 1 gesetzt ist, wird sie unterstützt. Bit 0 entspricht dem Präambelindex 1.LSB == preamble index 1MSB == preamble index 32 |
| 12 | uint8*4 | Bitfeld der unterstützten Konfigurations-IDs | Bitfeld der unterstützten UWB-Konfigurations-IDs. Wenn das Bit auf 0 gesetzt ist, wird die Funktion nicht unterstützt. Wenn es auf 1 gesetzt ist, wird sie unterstützt.LSB == config Id 0MSB == config Id 31 |
| 16 | uint8*2 | Unterstütztes minimales Intervall für die Entfernungsmessung | Gibt das schnellste unterstützte Entfernungsintervall in Millisekunden an. Zulässige Werte (in Millisekunden):
|
| 18 | uint8 | Unterstützte Mindestdauer von Slots | Gibt die kleinste unterstützte Slotdauer in Millisekunden an. Wenn das Gerät beispielsweise 1 ms zurückgibt, wird davon ausgegangen, dass es auch Slot-Dauern von 2 ms oder höher unterstützt. Zulässige Werte (in Millisekunden):
|
| 19 | uint8 | Unterstütztes Bitfeld für die UWB-Geräterolle | Bitfeld der unterstützten UWB-Rollen. Wenn beide unterstützt werden, ist der endgültige Feldwert beispielsweise 0x3.
|
Die Nutzlast der BLE CS-Nachricht Ranging Capability Response ist in der folgenden Tabelle zusammengefasst:
| Oktett | Datentyp | Beschreibung | Wert |
|---|---|---|---|
| 0 | uint8 | ID der Technologie zur Entfernungsmessung | 0x1 – BLE CS |
| 1 | uint8 | Größe | Größe der BLE CS-Funktionen in Byte (einschließlich der Felder Technology ID und Size). |
| 2 | uint8 | Bitfeld für unterstützte Sicherheitstypen | Bitfeld der unterstützten Sicherheitstypen für BLE CS.
|
| 3 | uint8*6 | Geräteadresse | Die Adresse des für BLE CS verwendeten Geräts in Big-Endian-Reihenfolge. |
Die Nutzlast der Ranging Capability Response-Nachricht für Wi-Fi NAN RTT ist in der folgenden Tabelle zusammengefasst:
| Oktett | Datentyp | Beschreibung | Wert |
|---|---|---|---|
| 0 | uint8 | ID der Technologie zur Entfernungsmessung | 0x2 – Wi-Fi NAN RTT |
| 1 | uint8 | Größe | Größe der Wi-Fi NAN RTT-Funktionen in Byte (einschließlich der Felder Technology ID und Size). |
| 2 | uint8 | Bitfeld für unterstützte Funktionen | Bitfeld der unterstützten Funktionen.
|
| 3 | uint8 | Unterstützt regelmäßige Entfernungsbestimmung |
|
| 4 | uint8 | Unterstützte Bandbreite | VERALTET:Diese Informationen helfen dabei, die erreichbare Entfernungsgenauigkeit mit Wi-Fi NAN abzuleiten. Außerdem kann so in Apps bestimmt werden, ob für die Entfernungsmessung UWB, BLE CS, BLE RSSI oder Wi-Fi NAN verwendet werden soll.
|
| 5 | uint8 | Unterstützte Anzahl von Empfangsketten | VERALTET:Diese Informationen helfen dabei, die erreichbare Entfernungsgenauigkeit mit Wi-Fi NAN abzuleiten. Apps können so besser entscheiden, ob sie UWB, BLE CS, BLE RSSI oder Wi-Fi NAN für die Entfernungsmessung verwenden sollen.
|
Die Nutzlast der BLE RSSI-Nachricht Ranging Capability Response ist in der folgenden Tabelle zusammengefasst:
| Oktett | Datentyp | Beschreibung | Wert |
|---|---|---|---|
| 0 | uint8 | ID der Technologie zur Entfernungsmessung | 0x3 – BLE RSSI |
| 1 | uint8 | Größe | Die Größe der BLE RSSI-Funktionen in Byte (einschließlich der Felder Technology ID und Size) |
| 2 | uint8*6 | Geräteadresse | Die Adresse des Geräts, das für BLE RSSI verwendet wird, in Big-Endian-Reihenfolge |
Die Nutzlast der Ranging Capability Response-Mitteilung für Wi-Fi PD ist in der folgenden Tabelle zusammengefasst:
| Oktett | Datentyp | Beschreibung | Wert |
|---|---|---|---|
| 0 | uint8 | ID der Technologie zur Entfernungsmessung | 0x4 – WLAN-PD |
| 1 | uint8 | Größe | Die Größe der WLAN-PD-Funktionen in Byte (einschließlich der Felder Technology ID und Size) |
| 2 | uint8 | Unterstützte Funktionen | Bitmap
|
| 3 | uint8 | PASN-Modus | Bitmap
|
| 4 | uint8*6 | Geräteadresse | Die Adresse des für Wi‑Fi PD verwendeten Geräts in Big-Endian-Reihenfolge. |
| 10 | uint8*2 | Minimales Intervall für die Entfernungsmessung (802.11mc) | Unterstütztes Mindestintervall für die Entfernungsmessung im Big-Endian-Format für 11mc |
| 12 | uint8*2 | Minimales Ranging-Intervall 802.11az | Minimales Entfernungsintervall, das im Big-Endian-Format für 11az unterstützt wird |
| 14 | uint8 | Maximaler Präambeltyp |
Dabei wird davon ausgegangen, dass alle niedrigeren Präambeltypen unterstützt werden. |
| 15 | uint8 | Maximale Kanalbreite |
Dabei wird davon ausgegangen, dass alle niedrigeren Kanalbreiten unterstützt werden. |
| 16 | uint8*2 | Unterstützte Kanalfrequenz |
|
Nutzlast der Nachricht zur Konfiguration der Entfernungsmessung
Größe (Headergröße nicht enthalten): Variiert (gemeinsamer Teil 4 Byte plus die Größe der Byte für jede enthaltene Technologie zur Entfernungsmessung).
Beschreibung:Diese Nachricht wird vom Initiator gesendet und enthält die Konfigurationen, mit denen die einzelnen Ortungstechnologien die Ortung starten können. Das Antwortgerät muss versuchen, die Entfernung mit jeder angegebenen Entfernungstechnologie zu bestimmen, sobald es diese Nachricht empfängt. Die Nutzlast dieser Nachricht besteht aus dem gemeinsamen Teil und den technologiebezogenen Teilen (UWB, BLE CS, Wi-Fi NAN RTT, BLE RSSI), wie in den folgenden Tabellen dargestellt.
Die allgemeine Ranging Configuration-Nachrichtennutzlast wird in der folgenden Tabelle zusammengefasst:
| Oktett | Datentyp | Beschreibung | Wert |
|---|---|---|---|
| 0 | uint8*2 | Bitfeld für die Konfiguration von Ranging-Technologien | Bitfeld der Ortungstechnologien, für die diese Nachricht Konfigurationsdaten enthält und für die Konfigurationsparameter festgelegt werden müssen.
|
| 2 | uint8*2 | Bitfeld | RFU. Muss auf denselben Wert wie das Feld Ranging technologies configuration set bitfield gesetzt werden. |
| 4 | Byte-Array | Konfigurationsbytes für Ranging-Technologien | Wiederholte Blöcke von Strukturen, die pro Technologie definiert sind |
| Variabel | uint8 | Unterstützung für Bewegungsmodus | Motion Notification angefordert
|
Die Nutzlast der UWB-Ranging Configuration-Nachricht ist in der folgenden Tabelle zusammengefasst:
| Oktett | Datentyp | Beschreibung | Wert |
|---|---|---|---|
| 0 | uint8 | ID der Technologie zur Entfernungsmessung | 0x0 – UWB |
| 1 | uint8 | Größe | Größe der UWB-Konfiguration (einschließlich der Felder Technology ID und Size) in Byte |
| 2 | uint8*2 | UWB-Adresse | 2‑Byte-UWB-Adresse des Geräts |
| 4 | uint8*4 | Sitzungs-ID | Generierte Sitzungs-ID. Die Sitzungs-ID ist eine eindeutige Kennung für die Entfernungsmessung zwischen dem Smartphone und dem Peripheriegerät. |
| 8 | uint8 | Ausgewählte Konfigurations-ID | Ausgewählte Konfigurations-ID als Ganzzahl. Die Konfigurations-ID gibt die Timing-Parameter und den Sicherheitstyp an, die für die UWB-Entfernungsmessungssitzung verwendet werden müssen. |
| 9 | uint8 | Ausgewählter Kanal | Ausgewählter Kanal für die UWB-Entfernungsmessung |
| 10 | uint8 | Ausgewählter Präambelindex | Ausgewählter Präambelindex für die UWB-Entfernungsmessungssitzung |
| 11 | uint8*2 | Ausgewähltes Intervall für die Reichweite | Ausgewählte Rate für die Entfernungsmessung in Millisekunden. Zulässige Werte (in Millisekunden):
|
| 13 | uint8 | Ausgewählte Zeitblockdauer | Ausgewählte Slot-Dauer in Millisekunden. Zulässige Werte (in Millisekunden):
|
| 14 | uint8 | Länge des Sitzungsschlüssels | Länge des Sitzungsschlüssels in Byte |
| 15 | Byte-Array | Sitzungsschlüssel | Sitzungsschlüssel Wenn S-STS verwendet wird, sind die ersten beiden Byte die VENDOR ID und die folgenden sechs Byte die STATIC STS IV. Wenn P-STS verwendet wird, ist dies entweder ein 16-Byte- oder ein 32-Byte-Sitzungsschlüssel. Der verwendete Sicherheitstyp wird durch die Konfigurations-ID bestimmt. |
| variiert | uint8*2 | Ländercode | Ländercode nach ISO 3166-1 Alpha-2, dargestellt durch zwei ASCII-Zeichen |
| variiert | uint8 | Ausgewählte Geräterolle |
|
| variiert | uint8 | Ausgewählter Gerätemodus |
|
Die Nutzlast der BLE CS-Nachricht Ranging Configuration ist in der folgenden Tabelle zusammengefasst:
| Oktett | Datentyp | Beschreibung | Wert |
|---|---|---|---|
| 0 | uint8 | ID der Technologie zur Entfernungsmessung | 0x1 – BLE CS |
| 1 | uint8 | Größe | Größe der BLE-CS-Konfiguration (einschließlich der Felder Technology ID und Size) in Byte |
| 2 | uint8 | Ausgewählter Sicherheitstyp | Ausgewählter Sicherheitstyp. Zulässige Werte:
|
| 3 | uint8*6 | Geräteadresse | Die Adresse des für BLE CS verwendeten Geräts in Big-Endian-Reihenfolge |
Die Nutzlast der Ranging Configuration-Nachricht für Wi-Fi NAN RTT ist in der folgenden Tabelle zusammengefasst:
| Oktett | Datentyp | Beschreibung | Wert |
|---|---|---|---|
| 0 | uint8 | ID der Technologie zur Entfernungsmessung | 0x2 – Wi-Fi NAN RTT |
| 1 | uint8 | Größe | Größe der WLAN-NAN-RTT-Konfiguration (einschließlich der Felder Technology ID und Size) in Byte |
| 2 | uint8 | Länge des Dienstnamens | Länge des Felds „Name des Dienstkontos“ in Byte. Weitere Informationen finden Sie in der Wi-Fi Aware-Spezifikation v4.0, Abschnitt 1.3.3, Tabelle 1. Definitionen. |
| 3 | Byte-Array | Dienstname | Dienstname. Weitere Informationen finden Sie in der Wi-Fi Aware-Spezifikation v4.0, Abschnitt 1.3.3, Tabelle 1. Definitionen. |
| variiert | uint8 | Geräterolle |
|
| variiert | uint8 | Periodische Reichweitenmessung verwenden |
|
Die Nutzlast der BLE RSSI-Nachricht Ranging Configuration ist in der folgenden Tabelle zusammengefasst:
| Oktett | Datentyp | Beschreibung | Wert |
|---|---|---|---|
| 0 | uint8 | ID der Technologie zur Entfernungsmessung | 0x3 – BLE RSSI |
| 1 | uint8 | Größe | Größe der BLE RSSI-Konfiguration (einschließlich der Felder Technology ID und Size) in Byte |
| 2 | uint8*6 | Geräteadresse | Die Adresse des Geräts, das für BLE RSSI verwendet wird, in Big-Endian-Reihenfolge |
Die Nutzlast der Ranging Configuration-Mitteilung für Wi-Fi PD ist in der folgenden Tabelle zusammengefasst:
| Oktett | Datentyp | Beschreibung | Wert |
|---|---|---|---|
| 0 | uint8 | ID der Technologie zur Entfernungsmessung | 0x4 – WLAN-PD |
| 1 | uint8 | Größe | Größe der WLAN-PD-Konfiguration (einschließlich der Felder Technology ID und Size) in Byte |
| 2 | uint8 | Funktion |
|
| 3 | uint8*6 | MAC-Adresse | MAC-Adresse des Initiators |
| 9 | uint8*2 | Entfernungsmessungsintervall | Entfernungsmessungsintervall in ms |
| 11 | uint8 | Ausgewählte Präambel |
|
| 12 | uint8 | Ausgewählte Kanalbreite |
|
| 13 | uint8 | Ausgewählter Kanal |
|
| 14 | uint8 | Ausgewählter PASN-Modus |
|
| 15 | Byte-Array | Geräte-Identitätsschlüssel | Festes Array mit 16 Byte Hinweis:Dieses Feld ist nur für den authentifizierten PASN-Modus gültig und darf für den nicht authentifizierten PASN-Modus nicht festgelegt werden. |
| 31 | uint8 | Passwortlänge | Länge des Passworts. Hinweis:Dieses Feld ist nur für den authentifizierten PASN-Modus gültig und darf für den nicht authentifizierten PASN-Modus nicht festgelegt werden. |
| variiert | Byte-Array | Passwort | Passwort als Byte-Array.
Hinweis:Dieses Feld ist nur für den authentifizierten PASN-Modus gültig und darf für den nicht authentifizierten PASN-Modus nicht festgelegt werden. |
Nutzlast der Antwortnachricht für die Bereichskonfiguration
Größe (Headergröße nicht enthalten): 2 Byte
Beschreibung:Diese Nachricht wird vom Antwortenden als Antwort auf die Nachricht Ranging Configuration gesendet. Diese Nachricht ist optional und nur erforderlich, wenn der verwendete Kommunikationskanal eine explizite Antwort auf jede Anfrage erfordert.
Die Ranging Configuration Response-Nachrichtennutzlast wird in der folgenden Tabelle zusammengefasst:
| Oktett | Datentyp | Beschreibung | Wert |
|---|---|---|---|
| 0 | uint8*2 | Bitfeld für die Konfiguration der Ranging-Technologien wurde festgelegt | Bitfeld der erfolgreich festgelegten Technologien für die Entfernungsmessung. Das Bitfeld setzt das Bit für die Entfernungsmessungstechnologie auf 1, wenn die Technologie angefordert und erfolgreich festgelegt wurde, andernfalls auf 0.
|
Nutzlast der Nachricht zum Beenden der Entfernungsmessung
Größe (Headergröße nicht enthalten): 2 Byte
Beschreibung:Diese Nachricht wird vom Initiatorgerät gesendet, wenn es an der Zeit ist, die Entfernungsmessung mit der angegebenen Entfernungsmessungstechnologie zu beenden.
Die Stop Ranging-Nachrichtennutzlast wird in der folgenden Tabelle zusammengefasst:
| Oktett | Datentyp | Beschreibung | Wert |
|---|---|---|---|
| 0 | uint8*2 | Entfernungsmessungstechnologien zum Beenden des Bitfelds | Bitfeld der Ortungstechnologien, die die Ortung beenden müssen. Wenn das Bit auf 1 gesetzt ist, muss die Entfernungsmessung beendet werden. Wenn es auf 0 gesetzt ist, wurde die Entfernungsmessung entweder noch nicht gestartet oder muss fortgesetzt werden, falls sie bereits läuft. Bei einigen Technologien zur Entfernungsmessung (z. B. CS) ist dies ein No-Op, da die Entfernungsmessung nur auf der Initiatorseite gestartet und beendet wird.
|
Nutzlast der Nachricht „Stop Ranging Response“
Größe (Headergröße nicht enthalten): 2 Byte
Beschreibung:Diese Nachricht wird vom Antwortenden als Antwort auf die Nachricht Stop Ranging gesendet. Diese Nachricht ist optional und nur erforderlich, wenn der verwendete Kommunikationskanal eine explizite Antwort auf jede Anfrage erfordert.
Die Stop Ranging Response-Nachrichtennutzlast wird in der folgenden Tabelle zusammengefasst:
| Oktett | Datentyp | Beschreibung | Wert |
|---|---|---|---|
| 0 | uint8*2 | Bitfeld für erfolgreich beendete Technologien für die Entfernungsmessung | Bitfeld der Technologien, die die Entfernungsmessung erfolgreich beendet haben. Das Bitfeld setzt das Bit für die Entfernungsmessungstechnologie auf 1, wenn das Beenden der Technologie angefordert wurde und erfolgreich war, andernfalls auf 0.
|
Nutzlast der Bewegungsbenachrichtigung
Größe (Headergröße nicht enthalten): 1 Byte
Beschreibung:Das Antwortgerät sendet diese Nachricht, um das initiierende Gerät über Änderungen des Bewegungsstatus zu informieren.
| Oktett | Datentyp | Beschreibung | Wert |
|---|---|---|---|
| 0 | uint8 | Bewegung |
|
Versionsverwaltung
Die Version der Spezifikation ist in der Kopfzeile jeder Nachricht enthalten.
In diesem Abschnitt wird definiert, wie die Kommunikation erfolgt, wenn eines der Geräte (entweder das Initiator- oder das Antwortgerät) eine ältere Version als das andere Gerät verwendet. Ranging Capability Request ist die erste Nachricht, die vom Gerät des Initiators gesendet wird.
Initiator unterstützt neuere Version, Responder unterstützt ältere Version der Spezifikation
Das Initiatorgerät sendet die Ranging Capability Request-Nachricht mit der neueren Version. Das Responder-Gerät unterstützt nur die ältere Version. Es antwortet mit dieser und die ältere Version des Responders wird für den Rest des Nachrichtenaustauschs verwendet. Das bedeutet, dass die Ranging Capability Request-Mitteilung abwärtskompatibel sein muss.
Initiator unterstützt ältere Version, Responder unterstützt neuere Version der Spezifikation
Das Responder-Gerät erkennt, dass das Initiator-Gerät die neuere Version nicht verwenden kann, und sendet Nachrichten nur mit der älteren Version, die ursprünglich vom Initiator-Gerät angefordert wurde.
Damit Nachrichten abwärtskompatibel sind, müssen alle neuen Felder, die der nächsten Version dieser Spezifikation hinzugefügt werden, an das Ende der Nutzlast angehängt werden. Keine der vorhandenen Felder darf geändert werden. Wenn beim Parsen der Konfiguration die angegebene Größe größer als erwartet ist, müssen zusätzliche Felder von allen Geräten ignoriert werden, die nur die ältere Version der Spezifikation verstehen.
Fragmentierung
Diese Spezifikation ist unabhängig vom Kommunikationskanal. Sie definiert also nicht, wie die Nachrichtennutzlast fragmentiert werden soll, wenn eine einzelne Nachricht zu groß ist, um in ein Übertragungspaket des verwendeten Kommunikationskanals zu passen. Das Ranging-Modul erwartet, dass jede Nachricht in ihrer vollständigen Form empfangen wird. Die Verantwortung für die Fragmentierung liegt beim Implementierer des OOB-Kommunikationskanals.
Spezifische Informationen zur Technologie für die Entfernungsmessung
Dieser Abschnitt enthält Details zur Ranging-Technologie.
Besonderheiten von Ultrabreitband (UWB)
In diesem Abschnitt werden spezifische Details zu Ultrabreitband beschrieben.
Konfigurations-IDs
Die für UWB ausgetauschten OOB-Konfigurationsdaten enthalten nicht alle verfügbaren konfigurierbaren Parameter, die UWB zum Starten einer UWB-Entfernungsmessungssitzung benötigt. Das liegt daran, dass einige Parameter durch die ausgewählte Konfigurations-ID implizit ausgewählt werden.
Jede Konfigurations-ID ist eine Reihe vordefinierter UWB-Konfigurationsparameter, die in UwbRangingParams dokumentiert sind. Das Antwortgerät sendet eine Liste aller von ihm unterstützten Konfigurations-IDs als Teil der Antwortnachricht für die Funktion. Der Initiator wählt eine der unterstützten Konfigurations-IDs aus, die verwendet wird. Dadurch kann während der Out-of-Band-Kommunikation eine kleinere Gruppe von Konfigurationsparametern ausgetauscht werden. Außerdem wird die Anzahl der möglichen Kombinationen von Parametern, die für die Entfernungsmessung mit UWB verwendet werden können, begrenzt. So können nur zulässige Kombinationen von Parametern getestet werden.
Funktionen nach jeder UWB-Sitzung anfordern
Nach dem Beenden einer bestehenden UWB-Sitzung und vor dem Start einer neuen UWB-Sitzung muss das Initiatorgerät die Funktionen des Respondergeräts anfordern und die Konfigurationsparameter neu festlegen, da sich die UWB-Adresse ändern kann, sobald die aktuelle Ranging-Sitzung beendet wird.
Besonderheiten bei der BLE-Kanalmessung (Channel Sounding, CS)
In diesem Abschnitt werden spezifische Details zur Kanalsondierung beschrieben.
Verschlüsselung der Verbindung zwischen Geräten erforderlich
Für die Entfernungsmessung mit Channel Sounding ist eine bestehende Verbindung zwischen dem Initiator- und dem Antwortgerät erforderlich. Diese Spezifikation bietet keine Möglichkeit, eine Verbindung zwischen Geräten herzustellen. Sie müssen diese Verbindung zwischen den Geräten herstellen, wenn Sie Ranging APIs verwenden.
Erforderliche Maßnahmen für den Kundenservice
Bei UWB müssen beide Geräte die APIs zum Starten und Beenden der Bereichsermittlung explizit aufrufen. Bei CS ist dagegen nur das Initiatorgerät erforderlich, um die CS-Entfernungsmessung durch Aufrufen des BT-Stacks zu starten. Die restliche Initialisierung auf der Responder-Seite erfolgt inband über Bluetooth. Das bedeutet, dass die Responder-Seite nach dem Empfang der Ranging Configuration-Nachricht oder der Stop Ranging-Nachricht für CS nichts tun muss, wenn Bluetooth aktiviert ist. Das Antwortgerät könnte diese Nachrichten als Trigger verwenden, um die Benutzeroberfläche zu aktualisieren oder beispielsweise die Geräte-LEDs blinken zu lassen.