تحديد المدى: الإصدار 3 من المواصفات خارج النطاق

قدّم الإصدار Android 16 وحدة تحديد المسافة. يحدّد هذا البروتوكول ومواصفات الحمولة تسلسل الرسائل وحمولة الاتصال خارج النطاق (OOB) المستخدَم لتبادل إعدادات تحديد المدى وبدء عملية تحديد المدى وإيقافها بين الجهاز المبدئي والجهاز المستجيب اللذين يشاركان في عملية تحديد المدى. يقدّم نظام التشغيل Android 17 الإصدار 3 من هذه المواصفات.

تتيح هذه الصفحة لموفّري الأجهزة غير التابعة لنظام التشغيل Android تنفيذ هذا المواصفات لكي تكون أجهزتهم متوافقة مع أجهزة Android.

يتوفّر تنفيذ لهذه المواصفات في لغة وصف الحِزم (PDL) من Google على GitHub. من خلال عملية التنفيذ هذه، يمكن لمترجم لغة PDL إنشاء رمز تسلسل ورمز إلغاء تسلسل للرسائل المحدّدة في هذا المواصفات. تتيح هذه المواصفات مجموعة متنوعة من اللغات المستهدَفة، بما في ذلك C++‎ وRust وJava.

الميزات الجديدة في الإصدار 3

يتضمّن الإصدار 3 من مواصفات OOB التغييرات التالية:

• إشعار الحركة: رسالة يستخدمها جهاز المعلِن لإعلام الجهاز الذي بدأ عملية الإرسال بتغيير في الحركة.
• إعدادات تحديد المدى: تتضمّن حقل Motion support جديدًا لإعلام الجهاز المبادِر بأي تغييرات في حركة الجهاز الطرفي من الجهاز المستجيب.
• إضافة دعم تكنولوجيا PD الجديدة لشبكة Wi-Fi في إمكانية تحديد المدى وإعدادات تحديد المدى
• إيقاف الحقلَين Supported Bandwidth وSupported number of Receive chains نهائيًا في Wi-Fi NAN RTT Ranging Capability

Endianness

ما لم يُحدّد خلاف ذلك، تكون جميع الحقول الرقمية المتعددة البايتات في الرسائل بترتيب little-endian.

الرسائل وتسلسل الرسائل

يوضّح هذا القسم الرسائل وتسلسل تبادلها.

يعرض الجدول التالي جميع الرسائل المتوفّرة في عملية تبادل البيانات خارج النطاق:

رسالة	معرّف الرسالة
Ranging Capability Request	0x0
Ranging Capability Response	0x1
Ranging Configuration	0x2
Ranging Configuration Response (اختياري)	0x3
Stop Ranging	0x6
Stop Ranging Response (اختياري)	0x7
Motion Notification	0x8

يوضّح الشكلان 1 و2 كيف يتم بدء تبادل الرسائل لقنوات الاتصال المختلفة.

بالنسبة إلى قنوات الاتصال المستندة إلى الربط، مثل BLE GATT، يبدأ تبادل الرسائل عندما يرسل الجهاز المبدئي Ranging Capability Request إلى الجهاز المستجيب. يردّ جهاز المجيب بإرسال Ranging Capability Response، كما هو موضّح في الشكل 1:

الشكل 1: تبادل رسائل النطاق الخارجي باستخدام قناة اتصال مستندة إلى الاتصال

بالنسبة إلى قنوات التواصل المستندة إلى الإعلانات، يبدأ جهاز الردّ بالإعلان عن Ranging Capability Response. في هذه الحالة، لا يرسل الجهاز الذي بدأ عملية المشاركة Ranging Capability Request. بدلاً من ذلك، بعد رصد الإعلان، عندما يكون الجهاز الذي بدأ عملية البحث (الماسح الضوئي الأولي) جاهزًا، يستجيب من خلال الإعلان عن Ranging Configuration كرسالته الأولى، كما هو موضّح في الشكل 2:

الشكل 2: تبادل الرسائل خارج النطاق باستخدام اتصال مستند إلى الإعلانات

ويكون تبادل الرسائل المتبقية هو نفسه في كلتا الحالتين. يبدأ الجهاز المستجيب في تحديد المدى فور تلقّي الرسالة Ranging Configuration. يتوقف جهاز الردّ عن تحديد المدى بعد تلقّيه الرسالة Stop Ranging أو رصدها.

في مسار العمل المستند إلى الاتصال، يملأ جهاز الرد الإمكانات الخاصة بتقنيات تحديد المدى المطلوبة في الرسالة Ranging Capability Request فقط، بينما في مسار العمل المستند إلى الإعلان، يجب أن يدرج جهاز الرد جميع إمكاناته لأنه لا توجد رسالة طلب إمكانات سابقة.

يفترض الجهاز البادئ أنّه سيتلقّى ردًا واحدًا فقط على أي رسالة طلب يرسلها. يجب ألا يفترض الجهاز المستجيب أي شيء من هذا القبيل حتى يتمكّن من الاستجابة لأي طلب بأي ترتيب. يتحقّق هذا الاختبار من قدرة جهاز المستجيب على الردّ على عدة رسائل Ranging Capability Request متتالية أو أي رسائل أخرى غير مرتبة من جهاز المُرسِل.

الانتقال إلى تكنولوجيا جديدة

يتيح إصدار النطاق الفائق العرض للأجهزة الانتقال ديناميكيًا بين تقنيات تحديد المدى المختلفة أثناء الجلسة. لتسهيل ذلك، يمكن للمستخدم الذي بدأ البث المباشر إجراء ما يلي:

• إرسال عدة رسائل Ranging Configuration لبدء استخدام تكنولوجيات جديدة
• أرسِل عدة رسائل إلى Stop Ranging لإيقاف التقنيات النشطة.

يختلف ترتيب هذه الرسائل حسب نظام الانتقال الذي يتيحه المستجيب:

• التوقف قبل البدء: لا يمكن للمرسِل الانتقال إلى تكنولوجيا جديدة إلا من خلال إيقاف التكنولوجيا الأولى باستخدام الرسالة Stop Ranging قبل بدء التكنولوجيا الثانية باستخدام الرسالة Ranging Configuration.
• التنفيذ قبل الإيقاف: يمكن للمرسِل بدء استخدام تكنولوجيا جديدة باستخدام رسالة Ranging Configuration قبل إيقاف التكنولوجيات الحالية باستخدام رسالة Stop Ranging.

يجب أن يتيح المستجيب إمكانية استخدام أحد أنظمة الانتقال هذه وفقًا لقيمة الحقل supported technology transitioning في Ranging Capability Response.

معرّفات تكنولوجيا تحديد المدى

يتم إدراج معرّفات تقنيات تحديد المدى في الجدول التالي:

تكنولوجيا تحديد المدى	رقم التعريف
النطاق الفائق العرض (UWB)	0x0
CS	0x1
ميزة "مراسلة نصية في الوقت الفعلي" (RTT) في شبكة Wi-Fi NAN	0x2
RSSI	0x3
Wi-Fi PD	0x4
RFU	0x5 - 0xFF

يتم استخدام هذه المعرّفات في الجداول التالية التي يتطلّب فيها توفير معرّف تكنولوجيا تحديد المدى. بالنسبة إلى الحقول التي تحتوي على bitfield لتكنولوجيا تحديد المدى، يتم ضبط بت يتوافق مع فهرس رقم تعريف التكنولوجيا عندما يتم تضمين هذه التكنولوجيا في bitfield.

على سبيل المثال، يحتوي RSSI على قيمة المعرّف 3، ولكن إذا تم تضمين RSSI في حقل بتات تكنولوجيا تحديد المدى، يجب تفعيل البت الذي يحمل موضع المعرّف (3) (البت الأول في الموضع 0)، ما يجعل القيمة الناتجة لحقل البتات 0x8. في حال تضمين كلّ من UWB وRSSI، ستكون قيمة حقل البت هي 0x0A (يتم تفعيل كلّ من البت 0 والبت 3).

تنسيق الرسالة

تتألف كل رسالة من عنوان وحمولة.

الشكل 3 تنسيق الرسالة

العنوان

الحجم: بايتان

الوصف: هو جزء مشترك بين جميع الرسائل، وهو الجزء الأول الذي يتم إدراجه في الرسالة. يحتوي العنوان على إصدار ومعرّف لنوع الرسالة. يحدّد حقل الإصدار إصدار هذه المواصفات الذي يتوافق معه محتوى الرسالة. لمزيد من المعلومات حول كيفية استخدام تحديد الإصدارات بين الأجهزة التي تعمل بإصدارات مختلفة، يُرجى الاطّلاع على تحديد الإصدارات. يبقى العنوان متوافقًا مع الإصدارات السابقة على مستوى الإصدارات المختلفة، ما يعني أنّه يمكن لحالة الاستخدام دائمًا تحليل العنوان لتحديد إصدار الرسالة ومعرّفها.

يتم تلخيص العنوان في الجدول التالي:

Octet	نوع البيانات	الوصف	القيمة
0	uint8	الإصدار	0x1 - الإصدار 1 ‫0x2 - الإصدار 2 0x3 - V3
1	uint8	معرّف الرسالة	0x0 - رسالة Ranging Capability Request ‫0x1 - رسالة Ranging Capability Response ‫0x2 - رسالة Ranging Configuration ‫0x3 - رسالة Ranging Configuration Response (اختيارية) 0x6 - رسالة Stop Ranging ‫0x7 - رسالة Stop Ranging Response (اختيارية) 0x8 - رسالة Motion Notification ‫0x4-0x5 و0x9 - 0xFF RFU

المحتوى

الحجم: يختلف (حسب نوع الرسالة)

الوصف: الحمولة هي الجزء الأخير من الرسالة، بعد العنوان. يعتمد الحمولة على نوع الرسالة. يتم تحديد تنسيق حمولة كل نوع من أنواع الرسائل الفردية في الأقسام التالية.

حمولة رسالة طلب تحديد المدى

الحجم (لا يشمل حجم العنوان): بايتان

الوصف: يتم إرسالها من الجهاز المضيف لبدء تبادل الرسائل. هذه الرسالة اختيارية عندما تستند قناة الاتصال إلى الإعلانات، وفي هذه الحالة، يجب أن يعلن جهاز الرد عن رسالة Ranging Capability Response كخطوة أولى. يقرأ الجهاز البادئ (الماسح الضوئي الأولي) الإعلان ويردّ مباشرةً برسالة Ranging Capability Request، ما يغني عن الحاجة إلى هذه الرسالة.

يرد في الجدول التالي ملخّص Ranging Capability Request لحمولة الرسالة:

Octet	نوع البيانات	الوصف	القيمة
0	uint8*2	حقل بت لتكنولوجيات تحديد المدى المطلوبة	‫0x01 - النطاق الفائق العرض (UWB) ‫0x02 - إصدار صوت على قناة BLE 0x04 - Wi-Fi NAN RTT 0x08 - BLE RSSI ‫0x10 - شاحن Wi-Fi RFU

حمولة رسالة الردّ على إمكانية تحديد المدى

الحجم (لا يشمل حجم العنوان): يختلف (الجزء المشترك 2 بايت بالإضافة إلى حجم بايتات كل تقنية تحديد مدى مضمّنة)

الوصف: يتم إرسالها من المجيب ردًا على رسالة Ranging Capability Request. تتكوّن حمولة هذه الرسالة من الجزء المشترك والأجزاء الخاصة بتكنولوجيا تحديد المدى (BLE CS وWi-Fi NAN RTT وBLE RSSI)، كما هو موضّح في الجداول التالية. يجب عدم إضافة أي جزء خاص بتقنية تحديد المدى إلا إذا كان جهاز الرد متوافقًا مع تقنية تحديد المدى هذه وتم طلبها في رسالة Ranging Capability Request. في حالة قناة اتصال إعلانية، يجب تضمين جميع تقنيات تحديد المدى المتوافقة.

يرد في الجدول التالي ملخص لحمولة رسالة Ranging Capability Response الشائعة:

Octet	نوع البيانات	الوصف	القيمة
0	uint8*2	حقل بتات لتكنولوجيات تحديد المدى المتوافقة يشير إلى مجموعة إمكانات تكنولوجيات تحديد المدى التي تلي ذلك في بقية الحمولة.	‫0x01 - النطاق الفائق العرض (UWB) ‫0x02 - إصدار صوت على قناة BLE 0x04 - Wi-Fi NAN RTT 0x08 - BLE RSSI ‫0x10 - شاحن Wi-Fi RFU
2	مصفوفة بايت	وحدات بايت خاصة بإمكانية استخدام تكنولوجيا تحديد المدى	كتل متكرّرة من البُنى المحدّدة لكل تكنولوجيا
يختلف من جهاز إلى آخر	uint8	تشير إلى إمكانية نقل التكنولوجيا.	‫0x00: ميزة "قطع الاتصال قبل إجرائه" متاحة. ‫0x01 - ميزة "الوصل قبل الفصل" متاحة. يمكن لجهاز الردود إجراء قياس المسافة باستخدام تقنيات متعددة في الوقت نفسه.
يختلف من جهاز إلى آخر	uint16	تشير هذه السمة إلى نوع جهاز المستجيب.	0x00 - غير معروف ‫0x01 - الهاتف ‫0x02 - جهاز لوحي ‫0x03 - العلامة ‫0x04 - جهاز قابل للارتداء ‫0x05 - سماعة أذن RFU

يرد في الجدول التالي ملخّص لحمولة رسالة UWB Ranging Capability Response:

Octet	نوع البيانات	الوصف	القيمة
0	uint8	معرّف تكنولوجيا تحديد المدى	‫0x0 - النطاق الفائق العرض (UWB)
1	uint8	الحجم	حجم بايت إمكانات UWB (بما في ذلك الحقلان معرّف التكنولوجيا والحجم) بالبايت
2	uint8*2	عنوان UWB	عنوان UWB للجهاز يتألف من بايتَين
4	uint8*4	حقل بت لقنوات الدعم	حقل بت للقنوات المتوافقة يشير البت الذي تم ضبطه على 0 إلى أنّ الميزة غير متاحة، ويشير البت الذي تم ضبطه على 1 إلى أنّ الميزة متاحة. يتوافق البت 0 مع القناة 0. LSB == channel 0 MSB == channel 31
8	uint8*4	Supported preamble index bitfield	حقل بتات لفهارس المقدمة المتوافقة يشير البت الذي تم ضبطه على 0 إلى أنّ الميزة غير متاحة، ويشير البت الذي تم ضبطه على 1 إلى أنّ الميزة متاحة. يتوافق البت 0 مع فهرس الديباجة 1. LSB == preamble index 1 MSB == preamble index 32
12	uint8*4	حقل بت لأرقام تعريف الإعدادات المتوافقة	حقل بتات لمعرّفات الإعدادات المتوافقة مع النطاق الفائق العرض (UWB). يشير البت الذي تم ضبطه على 0 إلى أنّ الميزة غير متاحة، بينما يشير البت الذي تم ضبطه على 1 إلى أنّ الميزة متاحة. LSB == config Id 0 MSB == config Id 31
16	uint8*2	الحدّ الأدنى المتاح للفاصل الزمني لتحديد المدى	تشير إلى أسرع فاصل زمني متاح لتحديد المدى بالملّي ثانية. القيم المسموح بها (بالمللي ثانية): 96 120 240 600
18	uint8	الحدّ الأدنى لمدة الفترة الزمنية المتاحة	تشير إلى أصغر مدة زمنية متاحة للوحدة الإعلانية بالملّي ثانية. على سبيل المثال، إذا كان الجهاز يعرض 1 مللي ثانية، يُفترض أنّه يتيح أيضًا مدة الفاصل الزمني 2 مللي ثانية أو أكثر. القيم المسموح بها (بالمللي ثانية): 1 2
19		حقل بت لدور جهاز النطاق الفائق العرض (UWB) المتوافق	حقل بت للأدوار المتوافقة مع تقنية النطاق الفائق العرض (UWB). على سبيل المثال، إذا كان كلاهما متوافقًا، تكون قيمة الحقل النهائية 0x3. ‫0x1 - دور المبدئ متاح ‫0x2 - دور المستجيب متاح

يرد في الجدول التالي ملخص لحمولة رسالة BLE CS Ranging Capability Response:

Octet	نوع البيانات	الوصف	القيمة
0	uint8	معرّف تكنولوجيا تحديد المدى	0x1 - BLE CS
1	uint8	الحجم	حجم بايت إمكانات BLE CS (بما في ذلك الحقلان معرّف التكنولوجيا والحجم) بالبايت
2	uint8	حقل بت لأنواع الأمان المتوافقة	حقل بت لأنواع الأمان المتوافقة مع 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	عنوان الجهاز	عنوان الجهاز المستخدَم في خدمة BLE CS، بترتيب الأهمية الكبرى أولاً

يرد في الجدول التالي ملخّص لحِزمة بيانات رسالة Wi-Fi NAN RTT Ranging Capability Response:

Octet	نوع البيانات	الوصف	القيمة
0	uint8	معرّف تكنولوجيا تحديد المدى	‫0x2 - Wi-Fi NAN RTT
1	uint8	الحجم	حجم بايت إمكانات RSSI في البلوتوث المنخفض الطاقة (بما في ذلك الحقلان معرّف التكنولوجيا والحجم) بالبايت
2	uint8	حقل بت للميزات المتوافقة	حقل بت للميزات المتوافقة ‫0x01 - متوافق مع 11mc ‫0x02 - إمكانية استخدام 11az
3	uint8	يتيح قياس المسافة بشكل دوري	0x0 - قياس المسافة بشكل دوري غير متاح 0x1 - نطاق دوري متوافق
4	uint8	النطاق الترددي المتوافق	تم إيقاف هذه السمة نهائيًا تساعد هذه المعلومات في استنتاج دقة تحديد المدى التي يمكن تحقيقها باستخدام Wi-Fi NAN، ويمكن أن تساعد التطبيقات في تحديد ما إذا كان يجب استخدام UWB أو BLE CS أو BLE RSSI أو Wi-Fi NAN لتحديد المدى. ‫0x00 - 20 ميغاهرتز ‫0x01 - 40 ميغاهرتز ‫0x02 - 80 ميغاهرتز ‫0x03 - 160 ميغاهرتز ‫0x04 - 80+80 ميغاهرتز ‫0x05 - 320 ميغاهرتز RFU
5	uint8	عدد سلاسل الاستلام المتاحة	تم إيقاف هذه السمة نهائيًا تساعد هذه المعلومات في استنتاج دقة تحديد المدى التي يمكن تحقيقها باستخدام Wi-Fi NAN، ويمكن أن تساعد التطبيقات في تحديد ما إذا كان يجب استخدام UWB أو BLE CS أو BLE RSSI أو Wi-Fi NAN لتحديد المدى. 0x00 - غير محدّد ‫0x01 - سلسلة استقبال واحدة 0x02 - سلسلتا RX 0x03 - 3 سلاسل RX 0x04 - 4 سلاسل RX

يرد في الجدول التالي ملخّص لحمولة رسالة Ranging Capability Response الخاصة بإشارة RSSI عبر البلوتوث المنخفض الطاقة:

Octet	نوع البيانات	الوصف	القيمة
0	uint8	معرّف تكنولوجيا تحديد المدى	‫0x3 - قوة إشارة BLE المستلَمة
1	uint8	الحجم	حجم بايت إمكانات RSSI في البلوتوث المنخفض الطاقة (بما في ذلك الحقلان معرّف التكنولوجيا والحجم) بالبايت
2	uint8*6	عنوان الجهاز	عنوان الجهاز المستخدَم في BLE RSSI، بترتيب الأهمية الكبرى أولاً

يرد في الجدول التالي ملخّص لحمولة رسالة Wi-Fi PD Ranging Capability Response:

Octet	نوع البيانات	الوصف	القيمة
0	uint8	معرّف تكنولوجيا تحديد المدى	0x4 - Wi-Fi PD
1	uint8	الحجم	حجم بايت إمكانات Wi-Fi PD (بما في ذلك الحقلان معرّف التكنولوجيا والحجم)
2	uint8	الميزات المتاحة	صورة نقطية ‫b0 - إمكانية استخدام 11mc ‫b1 - متوافق مع 11az
3	uint8	PansMode	صورة نقطية ‫b0 - وضع PASN غير مصادَق عليه ‫b1 - وضع PASN المصادَق عليه
4	uint8*6	عنوان الجهاز	عنوان الجهاز المستخدَم في الشحن السريع عبر Wi-Fi، بترتيب الأهمية الكبرى أولاً
10	uint8*2	الحد الأدنى للفاصل الزمني لتحديد المدى 802.11mc	الحدّ الأدنى لفاصل تحديد المدى المسموح به بتنسيق big-endian لبروتوكول 11mc
12	uint8*2	الحد الأدنى لفاصل تحديد المدى 802.11az	الحدّ الأدنى لفاصل تحديد المدى المسموح به بتنسيق big-endian لبروتوكول 11az
14	uint8	نوع Max preamble	‫0 - PREAMBLE_LEGACY ‫1 - PREAMBLE_HT ‫2 - PREAMBLE_VHT ‫3 - PREAMBLE_HE ‫4 - PREAMBLE_EHT يُفترض أنّ جميع المقدمات الأدنى ستكون متوافقة.
15	uint8	الحد الأقصى لعرض القناة	‫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 يُفترض أنّ جميع عروض القنوات المنخفضة ستكون متاحة.
16	uint8*2	معدّل تكرار القنوات المتوافقة	‫b0 - القناة 1 ‫b1 - القناة 11 ‫b2 - القناة 36 ‫b3 - القناة 40 ‫b4 - القناة 44 ‫b5 - القناة 48 ‫b6 - القناة 153 ‫b7 - القناة 157 ‫b8 - القناة 161 ‫b9 - القناة 165 ‫b10-b15 - RFU

حمولة رسالة إعداد تحديد المدى

الحجم (لا يشمل حجم العنوان): يختلف (الجزء المشترك 4 بايت بالإضافة إلى حجم كل بايت من تكنولوجيات تحديد المدى المضمّنة).

الوصف: يتم إرسال هذه الرسالة من قِبل الجهة البادئة، وهي تحتوي على الإعدادات التي يمكن لكل تقنية تحديد مدى البدء في تحديد المدى بها. يجب أن يحاول جهاز الرد بدء تحديد المدى باستخدام كل تقنية تحديد مدى مُشار إليها عند تلقّي هذه الرسالة. تتألف حمولة الرسالة هذه من الجزء المشترك وأجزاء خاصة بتكنولوجيا تحديد المدى (النطاق الفائق العرض (UWB)، وBLE CS، وWi-Fi NAN RTT، وقوة الإشارة المستلَمة عبر البلوتوث)، كما هو موضّح في الجداول التالية.

يرد في الجدول التالي ملخص لحمولة رسالة Ranging Configuration الشائعة:

Octet	نوع البيانات	الوصف	القيمة
0	uint8*2	حقل بت لمجموعة إعدادات تكنولوجيات تحديد المدى	حقل بت لتكنولوجيات تحديد المدى التي تحتوي هذه الرسالة على بيانات إعداد لها والتي يجب ضبط مَعلمات الإعداد لها. ‫0x01 - النطاق الفائق العرض (UWB) ‫0x02 - إصدار صوت على قناة BLE 0x04 - Wi-Fi NAN RTT 0x08 - BLE RSSI ‫0x10 - شاحن Wi-Fi RFU
2	uint8*2	Bitfield	RFU. يجب ضبطها على القيمة نفسها التي تم ضبطها في الحقل Ranging technologies configuration set bitfield.
4	مصفوفة بايت	وحدات بايت إعدادات تكنولوجيات تحديد المدى	حِزم متكرّرة من البُنى المحدّدة لكل تكنولوجيا
يختلف	uint8	دعم الحركة	طلب Motion Notification ‫0x0: يشير إلى عدم حاجة الجهاز البادئ إلى بيانات الحركة. ‫0x1: يشير إلى أنّ الجهاز المصدِر يتطلّب بيانات الحركة من الجهاز الآخر.

يرد في الجدول التالي ملخّص لحمولة رسالة Ranging Configuration UWB:

Octet	نوع البيانات	الوصف	القيمة
0	uint8	معرّف تكنولوجيا تحديد المدى	‫0x0 - النطاق الفائق العرض (UWB)
1	uint8	الحجم	حجم إعدادات UWB (بما في ذلك الحقلان معرّف التكنولوجيا والحجم) بالبايت
2	uint8*2	عنوان UWB	عنوان UWB للجهاز المكوّن من بايتَين
4	uint8*4	معرّف الجلسة	معرّف الجلسة الذي تم إنشاؤه رقم تعريف الجلسة هو معرّف فريد لجلسة تحديد المسافة بين الهاتف والجهاز الطرفي.
8	uint8	رقم تعريف الإعدادات المحدَّدة	رقم معرّف الإعداد المحدّد كعدد صحيح يحدّد رقم تعريف الإعدادات مَعلمات التوقيت ونوع الأمان الذي يجب استخدامه لجلسة تحديد المدى باستخدام تقنية UWB.
9	uint8	القناة المحدّدة	القناة المحدّدة لجلسة تحديد المدى باستخدام النطاق الفائق العرض
10	uint8	فهرس الديباجة المحدّد	فهرس الديباجة المحدّد لجلسة تحديد المدى باستخدام النطاق الفائق العرض
11	uint8*2	الفاصل الزمني المحدّد	معدّل الفاصل الزمني المحدّد لتحديد المدى بالمللي ثانية القيم المسموح بها (بالمللي ثانية): 96 120 240 600
13	uint8	مدة الفترة الزمنية المحدّدة	مدة الفترة الزمنية المحدّدة بالمللي ثانية القيم المسموح بها (بالمللي ثانية): 1 2
14	uint8	طول مفتاح الجلسة	طول مفتاح الجلسة بالبايت
15	مصفوفة بايت	مفتاح الجلسة	مفتاح الجلسة في حال استخدام S-STS، يكون أول بايتَين هما VENDOR ID، وتكون البايتات الستة التالية هي STATIC STS IV. في حال استخدام P-STS، يكون هذا المفتاح إما مفتاح جلسة بحجم 16 بايت أو 32 بايت. يتم تحديد نوع الأمان المستخدَم من خلال رقم تعريف الإعدادات.
يختلف	uint8*2	رمز البلد	رمز البلد المكوّن من حرفَين وفقًا لمعيار ISO 3166-1 alpha-2، ويتم تمثيله بحرفَي ASCII
يختلف	uint8	دور الجهاز المحدّد	0x01 - بادئ التشغيل 0x02 - المستجيب
يختلف	uint8	وضع الجهاز الذي تم اختياره	‫0x01 - وحدة التحكّم ‫0x02 - Controlee

يرد في الجدول التالي ملخص لحمولة رسالة BLE CS Ranging Configuration:

Octet	نوع البيانات	الوصف	القيمة
0	uint8	معرّف تكنولوجيا تحديد المدى	0x1 - BLE CS
1	uint8	الحجم	حجم إعدادات BLE CS (بما في ذلك الحقلان معرّف التكنولوجيا والحجم) بالبايت
2	uint8	نوع الأمان المحدّد	نوع الأمان المحدّد القيم المسموح بها: ‫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	عنوان الجهاز	عنوان الجهاز المستخدَم في خدمة BLE CS، بترتيب الأهمية الكبرى أولاً

يرد في الجدول التالي ملخّص لحِزمة بيانات رسالة Wi-Fi NAN RTT Ranging Configuration:

Octet	نوع البيانات	الوصف	القيمة
0	uint8	معرّف تكنولوجيا تحديد المدى	‫0x2 - Wi-Fi NAN RTT
1	uint8	الحجم	حجم إعدادات Wi-Fi NAN RTT (بما في ذلك الحقلان معرّف التكنولوجيا والحجم) بالبايت
2	uint8	طول اسم الخدمة	طول حقل "اسم الخدمة" بالبايت. يُرجى الرجوع إلى مواصفات Wi-Fi Aware الإصدار 4.0 القسم 1.3.3 الجدول 1. التعريفات
3	مصفوفة بايت	اسم الخدمة	اسم الخدمة يُرجى الرجوع إلى مواصفات Wi-Fi Aware الإصدار 4.0 القسم 1.3.3 الجدول 1. التعريفات
يختلف	uint8	دور الجهاز	0x0 - المستجيب (ناشر خدمة NAN) ‫0x1 - الجهة المبادرة (مشترك في خدمة NAN)
يختلف	uint8	استخدام تحديد المدى الدوري	0x0 - إيقاف تحديد المدى بشكل دوري ‫0x1 - تفعيل تحديد المدى بشكل دوري

يرد في الجدول التالي ملخّص لحمولة رسالة Ranging Configuration الخاصة بإشارة RSSI عبر البلوتوث المنخفض الطاقة:

Octet	نوع البيانات	الوصف	القيمة
0	uint8	معرّف تكنولوجيا تحديد المدى	‫0x3 - قوة إشارة BLE المستلَمة
1	uint8	الحجم	حجم إعدادات RSSI الخاصة بتقنية البلوتوث المنخفض الطاقة (بما في ذلك الحقلان معرّف التكنولوجيا والحجم) بالبايت
2	uint8*6	عنوان الجهاز	عنوان الجهاز المستخدَم في BLE RSSI، بترتيب الأهمية الكبرى أولاً

يرد في الجدول التالي ملخّص لحمولة رسالة Wi-Fi PD Ranging Configuration:

Octet	نوع البيانات	الوصف	القيمة
0	uint8	معرّف تكنولوجيا تحديد المدى	‫0x4 - شحن Wi-Fi
1	uint8	الحجم	حجم إعدادات NAN PD لشبكة Wi-Fi (بما في ذلك الحقلان معرّف التكنولوجيا والحجم) بالبايت
2	uint8	الميزة	0x01 - 11mc ‫0x02 - 11az
3	uint8*6	عنوان Mac	عنوان MAC لأداة البدء
9	uint8*2	الفاصل الزمني لتحديد المدى	الفاصل الزمني لتحديد المدى بالمللي ثانية
11	uint8	المقدّمة المحدّدة	‫0 - PREAMBLE_LEGACY ‫1 - PREAMBLE_HT ‫2 - PREAMBLE_VHT ‫3 - PREAMBLE_HE ‫4 - PREAMBLE_EHT
12	uint8	عرض القناة المحدّدة	‫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	القناة المحدّدة	0 - القناة 1 ‫1 - القناة 11 2 - القناة 36 3 - القناة 40 ‫4 - القناة 44 ‫5 - القناة 48 ‫6 - القناة 153 ‫7 - القناة 157 ‫8 - القناة 161 ‫9 - القناة 165
14	uint8	وضع PASN المحدّد	‫0x01 - وضع PASN غير مصادق عليه ‫0x02 - وضع PASN المصادَق عليه ملاحظة: يمثّل هذا الحقل نهاية الحزمة في وضع PASN غير المصادَق عليه.
15	مصفوفة بايت	مفتاح معرّف الجهاز	صفيف ثابت من 16 بايت ملاحظة:هذا الحقل صالح فقط لوضع PASN المصادَق عليه، ويجب عدم ضبطه لوضع PASN غير المصادَق عليه
31	uint8	طول كلمة المرور	طول كلمة المرور ملاحظة: هذا الحقل صالح فقط لوضع PASN الذي تمت المصادقة عليه، ويجب عدم ضبطه لوضع PASN الذي لم تتم المصادقة عليه.
يختلف	مصفوفة بايت	كلمة المرور	كلمة المرور كمصفوفة بايت ملاحظة: هذا الحقل صالح فقط لوضع PASN الذي تمت المصادقة عليه، ويجب عدم ضبطه لوضع PASN الذي لم تتم المصادقة عليه.

البيانات الأساسية لرسالة الرد على إعدادات تحديد المدى

الحجم (لا يشمل حجم العنوان): بايتان

الوصف: يرسل المجيب هذه الرسالة ردًا على الرسالة Ranging Configuration. هذه الرسالة اختيارية، وهي مطلوبة فقط عندما تتطلّب قناة التواصل المستخدَمة ردًا صريحًا على كل طلب.

يتم تلخيص حمولة رسالة Ranging Configuration Response في الجدول التالي:

Octet	نوع البيانات	الوصف	القيمة
0	uint8*2	تم ضبط إعدادات تقنيات تحديد المدى بنجاح، حقل بت	حقل بت لتقنيات تحديد المدى التي تم ضبطها بنجاح. يضبط حقل البت بتكنولوجيا تحديد المدى على 1 إذا تم طلب التكنولوجيا وإعدادها بنجاح، وعلى 0 في الحالات الأخرى. ‫0x01 - النطاق الفائق العرض (UWB) ‫0x02 - إصدار صوت على قناة BLE 0x04 - Wi-Fi NAN RTT 0x08 - BLE RSSI ‫0x10 - شاحن Wi-Fi RFU

حمولة رسالة إيقاف تحديد المدى

الحجم (لا يشمل حجم العنوان): بايتان

الوصف: يتم إرسال هذه الرسالة من الجهاز البادئ عندما يحين وقت التوقف عن تحديد المدى باستخدام تكنولوجيا تحديد المدى المحدّدة.

يتم تلخيص حمولة رسالة Stop Ranging في الجدول التالي:

Octet	نوع البيانات	الوصف	القيمة
0	uint8*2	تقنيات تحديد المدى لإيقاف حقل البت	حقل بت لتقنيات تحديد المدى التي يجب إيقافها. يشير البت الذي تم ضبطه على 1 إلى أنّه يجب إيقاف تكنولوجيا تحديد المدى، ويشير البت الذي تم ضبطه على 0 إلى أنّ تكنولوجيا تحديد المدى لم تكن تحدّد المدى في المقام الأول، أو أنّه يجب مواصلة تحديد المدى إذا كانت تحدّده من قبل. بالنسبة إلى بعض تقنيات تحديد المدى (مثل CS)، لا يتم تنفيذ أي عملية لأنّ تحديد المدى يتم بدؤه وإيقافه فقط من جهة الجهاز الذي يبدأ العملية. ‫0x01 - النطاق الفائق العرض (UWB) ‫0x02 - إصدار صوت على قناة BLE 0x04 - Wi-Fi NAN RTT 0x08 - BLE RSSI ‫0x10 - شاحن Wi-Fi RFU

Stop Ranging Response message payload

الحجم (لا يشمل حجم العنوان): بايتان

الوصف: يرسل المجيب هذه الرسالة ردًا على الرسالة Stop Ranging. هذه الرسالة اختيارية، وهي مطلوبة فقط عندما تتطلب قناة التواصل المستخدمة ردًا صريحًا على كل طلب.

يرد في الجدول التالي ملخّص Stop Ranging Response لحمولة الرسالة:

Octet	نوع البيانات	الوصف	القيمة
0	uint8*2	حقل بتات يشير إلى إيقاف تقنيات تحديد المدى بنجاح	حقل بتات لتكنولوجيات تحديد المدى التي تم إيقاف تحديد المدى فيها بنجاح. يضبط حقل البت بت تكنولوجيا تحديد المدى على 1 إذا تم طلب إيقاف التكنولوجيا وإذا تم إيقافها بنجاح، وعلى 0 في الحالات الأخرى. ‫0x01 - النطاق الفائق العرض (UWB) ‫0x02 - إصدار صوت على قناة BLE 0x04 - Wi-Fi NAN RTT 0x08 - BLE RSSI ‫0x10 - شاحن Wi-Fi RFU

حمولة رسالة إشعار الحركة

الحجم (لا يشمل حجم العنوان): بايت واحد

الوصف: يرسل الجهاز المستجيب هذه الرسالة لإبلاغ الجهاز البادئ بأي تغييرات في حالة الحركة.

Octet	نوع البيانات	الوصف	القيمة
0	uint8	حركة	0x0 - لم يتم رصدها 0x1 - حركة طفيفة ‫0x2 - حركة معتدلة ‫0x3 - حركة كبيرة RFU يجب ضبط حد الحركة الأدنى لرصد تغيير في الاتجاه بمقدار ‎±X° على طول أي محورَين من محاور الجهاز الملحق. لم يتم رصد أي تغيير: < 5° حركة طفيفة: من 5 إلى 7 درجات حركة معتدلة: من 7 إلى 10 درجات حركة كبيرة: > 10 درجات

تحديد الإصدار

يتم تضمين إصدار المواصفات في رأس كل رسالة. يحدّد هذا القسم كيفية إجراء الاتصال عندما يكون أحد الجهازَين (إما الجهاز الذي يبدأ الاتصال أو الجهاز الذي يستجيب له) يعمل بإصدار أقدم من الجهاز الآخر.

الحالة 1: قناة التواصل المستندة إلى الاتصال

يصف هذا القسم الحالات التي تستخدم قناة اتصال مستندة إلى الاتصال، حيث Ranging Capability Request هي الرسالة الأولى التي يرسلها الجهاز البادئ.

الحالة 1.أ: يتوافق المُرسِل مع الإصدار الأحدث، ويتوافق المستلِم مع الإصدار الأقدم من المواصفات.

يرسل الجهاز البادئ الرسالة Ranging Capability Request مع الإصدار الأحدث. يتوافق الجهاز المستجيب مع الإصدار القديم فقط، لذا يستجيب به، ثم يتم استخدام الإصدار القديم من الجهاز المستجيب لبقية عملية تبادل الرسائل. وهذا يعني أنّ رسالة Ranging Capability Request يجب أن تكون متوافقة مع الإصدارات القديمة.

الحالة 1.ب: يتوافق الجهاز المُنشئ مع إصدار قديم، ويتوافق الجهاز المستجيب مع إصدار أحدث من المواصفات.

يلاحظ جهاز الردّ أنّ جهاز الطلب غير متوافق مع الإصدار الأحدث، لذا يرسل الرسائل باستخدام الإصدار القديم الذي طلبه جهاز الطلب في البداية.

الحالة 2: قناة التواصل المستندة إلى الإعلانات

يوضّح هذا القسم الحالات التي تستخدم قناة اتصال مستندة إلى الإعلانات، حيث يعلن جهاز الرد عن Ranging Capability Request مباشرةً بدون طلب أولي.

الحالة 2.أ: يتوافق الجهاز المضيف مع إصدار أحدث، ويتوافق الجهاز المستجيب مع إصدار أقدم من المواصفات.

يتم استخدام الإصدار الأقدم الذي تم ضبطه في إعلان Ranging Capability Response لبقية عمليات التواصل.

الحالة 2.ب: يتوافق الجهاز المُنشئ مع إصدار قديم، ويتوافق الجهاز المستجيب مع إصدار أحدث من المواصفات.

يجب أن يكون الإصدار الأحدث من إعلان Ranging Capability Response متوافقًا مع الإصدارات القديمة حتى يتمكّن الجهاز المبدئي من قراءة الرسالة حتى إذا كان يستخدم إصدارًا أحدث. بعد ذلك، يرسل الجهاز المبدئي الرسالة Ranging Configuration باستخدام الإصدار القديم المتوافق معه. وهي الإصدار الذي يتم استخدامه في بقية عمليات التواصل.

لضمان توافق Ranging Capability Response مع الأنظمة القديمة، يجب إلحاق أي حقول جديدة تتم إضافتها إلى الإصدار التالي من هذا المواصفات في حمولة الرسالة Ranging Capability Response بنهاية الحمولة، ولا يمكن تعديل أي من الحقول الحالية. عند تحليل الإعدادات، إذا كان الحجم المحدّد أكبر من المتوقّع، يجب أن تتجاهل أي أجهزة لا يمكنها فهم سوى الإصدار القديم من المواصفات الحقول الإضافية.

التجزئة

هذه المواصفات لا تعتمد على قناة التواصل، لذا لا تحدّد كيفية تقسيم حمولة الرسالة في الحالات التي تكون فيها الرسالة الواحدة كبيرة جدًا بحيث لا يمكن تضمينها في حزمة نقل قناة التواصل المستخدَمة. تتوقّع وحدة Ranging تلقّي كل رسالة بشكلها الكامل. وتقع مسؤولية التجزئة على عاتق الجهة التي تنفّذ قناة الاتصال خارج النطاق.

Ranging-technology-specifics

يحتوي هذا القسم على تفاصيل خاصة بتكنولوجيا تحديد المدى.

تفاصيل النطاق الفائق العرض (UWB)

يوضّح هذا القسم تفاصيل محدّدة حول النطاق الفائق العرض.

معرّفات الإعدادات

لا تحتوي بيانات إعدادات النطاق الفائق العرض التي يتم تبادلها عبر قناة الاتصال خارج النطاق على مجموعة كاملة من المَعلمات القابلة للإعداد التي يتطلّبها النطاق الفائق العرض لبدء جلسة تحديد المدى. ويرجع ذلك إلى أنّ بعض المَعلَمات يتم اختيارها ضمنيًا من خلال رقم تعريف الإعداد الذي تم اختياره.

رقم تعريف الإعداد هو مجموعة من مَعلمات إعدادات النطاق الفائق العرض (UWB) المحدّدة مسبقًا والموضّحة في UwbRangingParams. يرسل جهاز الاستجابة قائمة بجميع أرقام تعريف الإعدادات المتوافقة معه كجزء من أرقام تعريف الإعدادات المتوافقة مع supports_technology_transitioning التي يتم استخدامها. يتيح ذلك تبادل مجموعة أصغر من مَعلمات الإعدادات أثناء عملية الإعداد خارج النطاق. ويحدّ أيضًا من عدد المجموعات الممكنة من المَعلَمات التي يمكن استخدامها لتحديد المدى باستخدام تقنية النطاق الفائق العرض (UWB)، ما يتيح اختبار المجموعات المسموح بها فقط من المَعلَمات.

طلب إمكانات بعد كل جلسة UWB

بعد إيقاف جلسة حالية باستخدام تقنية النطاق الفائق العرض وقبل بدء جلسة جديدة، يجب أن يطلب الجهاز البادئ إمكانات الجهاز المستجيب وأن يضبط مَعلمات الإعداد مرة أخرى، لأنّه يمكن تغيير عنوان تقنية النطاق الفائق العرض بمجرد انتهاء جلسة تحديد المدى الحالية.

تفاصيل حول استشعار القناة (CS) في البلوتوث المنخفض الطاقة (BLE)

يوضّح هذا القسم تفاصيل محدّدة بشأن تحديد القنوات الصوتية.

الربط المطلوب بين الأجهزة

يجب أن يكون هناك ربط حالي بين الجهاز المبدئي والجهاز المستجيب لكي تعمل ميزة تحديد المدى باستخدام اختبار القناة. لا يوفّر هذا المواصفات طريقة لإنشاء ربط بين الأجهزة. يجب أن ينشئ مستخدم واجهات برمجة التطبيقات الخاصة بتحديد المسافة هذا الربط بين الأجهزة.

الإجراء المطلوب من جانب المستجيب في "خدمة العملاء"

في تقنية UWB، يجب أن يستدعي كلا الجهازين واجهة برمجة التطبيقات start ranging وstop ranging الخاصة بتقنية UWB بشكل صريح. في المقابل، لا يتطلّب استخدام ميزة "الاتصال القريب" سوى الجهاز الذي يبدأ عملية تحديد المدى من خلال استدعاء حزمة بروتوكول البلوتوث (BT). يتم تنفيذ بقية عملية الإعداد على جهاز الرد خارج النطاق من خلال البلوتوث، ما يعني أنّه عند تلقّي الرسالة Ranging Configuration أو الرسالة Stop Ranging الخاصة بالإعداد السريع، لن يحتاج جهاز الرد إلى تنفيذ أي إجراء إذا كان البلوتوث مفعّلاً. يمكن أن يستخدم جهاز الردّ هذه الرسائل كإشارة لتعديل واجهة المستخدم أو، على سبيل المثال، لإضاءة مصابيح LED في الجهاز.