شبكة Wi-Fi RTT (IEEE 802.11mc)

تتيح ميزة Wi-Fi Round Trip Time (RTT) في Android 9 للأجهزة الداعمة قياس المسافة إلى الأجهزة الداعمة الأخرى: سواء كانت نقاط وصول (APs) أو نظائر Wi-Fi Aware (إذا كان Wi-Fi Aware مدعومًا على جهاز). هذه الميزة ، المبنية على بروتوكول IEEE 802.11mc ، تمكن التطبيقات من استخدام دقة ووعي محسنين للموقع.

الأمثلة والمصدر

لاستخدام هذه الميزة ، قم بتنفيذ لغة تصميم واجهة أجهزة Wi-Fi (HIDL) المتوفرة في مشروع Android مفتوح المصدر (AOSP). في Android 8.0 ، يستبدل HIDL بنية طبقة تجريد الأجهزة (HAL) السابقة المستخدمة لتبسيط عمليات التنفيذ من خلال تحديد الأنواع واستدعاءات الطريقة التي يتم جمعها في الواجهات والحزم.

اتبع Wi-Fi HIDL لاستخدام ميزة Wi-Fi RTT: hardware/interfaces/wifi/1.0 أو أحدث.

يمكنك الرجوع إلى Wi-Fi HAL القديم لمعرفة كيفية ارتباطه بواجهة HIDL الجديدة: Hardware / libhardware_legacy / + / main / include / hardware_legacy / rtt.h.

تطبيق

لتنفيذ Wi-Fi RTT ، يجب توفير دعم إطار العمل و HAL / البرامج الثابتة:

  • نطاق:

    • كود AOSP
    • تمكين Wi-Fi RTT: يتطلب علامة ميزة

  • دعم Wi-Fi RTT (IEEE 802.11mc) HAL (الذي يتضمن دعم البرامج الثابتة)

لتنفيذ هذه الميزة ، قم بتنفيذ Wi-Fi HIDL وقم بتمكين علامة الميزة:

  • في device.mk الموجود في device/<oem>/<device> ، قم بتعديل متغير البيئة PRODUCT_COPY_FILES لتضمين دعم ميزة Wi-Fi RTT:

    PRODUCT_COPY_FILES += frameworks/native/data/etc/android.hardware.wifi.rtt.xml:$(TARGET_COPY_OUT_VENDOR)/etc/permissions/android.hardware.wifi.rtt.xml

وبخلاف ذلك ، يتم تضمين كل ما هو مطلوب لهذه الميزة في AOSP.

عشوائية MAC

لتعزيز الخصوصية ، يجب أن يكون عنوان MAC المستخدم أثناء معاملات Wi-Fi RTT عشوائيًا ، أي يجب ألا يتطابق مع عنوان MAC الأصلي لواجهة Wi-Fi. ومع ذلك ، كاستثناء ، عندما يكون الجهاز مرتبطًا بنقطة وصول ، يجوز له استخدام عنوان MAC المرتبط به لأي معاملات RTT مع نقطة الوصول هذه أو مع نقاط الوصول الأخرى.

تصديق

توجد اختبارات مجموعة اختبار توافق Android (CTS) لهذه الميزة. تكتشف CTS متى يتم تمكين الميزة وتتضمن الاختبارات المرتبطة تلقائيًا. يمكن أيضًا اختبار هذه الميزة باستخدام Vendor Test Suite (VTS) و act / sl4a ، وهي مجموعة اختبار تجري اختبارات تكامل شاملة.

اختبارات الوحدة

يتم تنفيذ اختبارات حزمة Wi-Fi RTT باستخدام:

اختبارات الخدمة:

atest com.android.server.wifi.rtt

اختبارات المدير:

atest android.net.wifi.rtt

اختبارات التكامل (ACTS)

توفر مجموعة اختبارات act / sl4a ، الموضحة في /tools/test/connectivity/acts_tests/tests/google/wifi/rtt/README.md ، اختبارات وظيفية وأداء واختبارات إجهاد.

CTS

توجد اختبارات مجموعة اختبار توافق Android (CTS) لهذه الميزة. تكتشف CTS متى يتم تمكين الميزة وتتضمن الاختبارات المرتبطة تلقائيًا. يجب أن تكون نقطة الوصول التي تدعم Wi-Fi RTT (IEEE 802.11mc) ضمن نطاق الجهاز قيد الاختبار.

يمكن بدء اختبارات CTS باستخدام:

atest WifiRttTest

معايرة

لكي تعمل Wi-Fi RTT بشكل جيد ، تكون النطاقات التي تم إرجاعها في بروتوكول 802.11mc دقيقة بشكل مثالي ضمن مؤشر الأداء الرئيسي (KPI). بالنسبة لخطأ 90٪ CDF ، عند عرض النطاق الترددي المذكور ، من المتوقع أن يكون لمؤشر الأداء الرئيسي الموصى به لتقدير النطاق التفاوتات التالية:

  • 80 ميجا هرتز: 2 متر
  • 40 ميجا هرتز: 4 أمتار
  • 20 ميجا هرتز: 8 أمتار

للتأكد من أن تنفيذ الميزة يعمل بشكل صحيح ، فإن اختبار المعايرة ضروري.

يمكن تحقيق ذلك من خلال مقارنة نطاق الحقيقة الأساسية مع النطاق المقدر لـ RTT على مسافات متزايدة. للتوافق الأساسي ، يجب عليك التحقق من صحة الحل الخاص بك مقابل جهاز معروف بمعايرة RTT. يجب اختبار معايرة الميدان في ظل الظروف التالية:

  1. معمل كبير مفتوح ، أو ممر لا يحتوي على الكثير من الأجسام المعدنية التي قد تؤدي إلى حدوث ارتفاع غير معتاد في المسارات المتعددة.
  2. ما لا يقل عن مسار / مسار خط البصر (LOS) يمتد لمسافة 25 مترًا.
  3. علامات بزيادات 0.5 متر من أحد طرفي المسار إلى الطرف الآخر.
  4. مكان لتأمين نقطة وصول قادرة على RTT في أحد طرفي المسار مثبتة على ارتفاع 20 سم فوق الأرض ، وحامل متحرك لهاتف Android (أو أي جهاز محمول يعمل بنظام Android قيد الاختبار) يمكن تحريكه على طول المسار ، ومحاذاة مع علامات 0.5 متر ، أيضًا على ارتفاع 20 سم فوق الأرض. ملاحظة: يمكن تنفيذ هذه المهمة المتكررة بواسطة روبوت صغير ، ولكن المشغل البشري جيد أيضًا.
  5. يجب تسجيل 50 نتيجة نطاق عند كل علامة ، جنبًا إلى جنب مع المسافة من نقطة الوصول. يجب حساب الإحصائيات ، مثل متوسط ​​النطاق والتباين ، لكل موضع علامة.

من النتائج الواردة في الخطوة 5 ، يمكن رسم مخطط للحقيقة الأساسية (المحور السيني) مقابل النطاق المقدر (المحور الصادي) وتقدير خط الانحدار الأنسب. ستؤدي معايرة الجهاز المثالية إلى خط من التدرج 1.0 ، مع إزاحة 0.0 متر على المحور ص. تكون الانحرافات عن هذه القيم مقبولة إذا كانت ضمن مؤشر الأداء الرئيسي لعرض النطاق الترددي المقابل. إذا كانت النتائج خارج KPI ، فيجب إعادة معايرة ميزة الجهاز لإحضار النتائج ضمن مواصفات KPI.

و

تتيح ميزة Wi-Fi Round Trip Time (RTT) في Android 9 للأجهزة الداعمة قياس المسافة إلى الأجهزة الداعمة الأخرى: سواء كانت نقاط وصول (APs) أو نظائر Wi-Fi Aware (إذا كان Wi-Fi Aware مدعومًا على جهاز). هذه الميزة ، المبنية على بروتوكول IEEE 802.11mc ، تمكن التطبيقات من استخدام دقة ووعي محسنين للموقع.

الأمثلة والمصدر

لاستخدام هذه الميزة ، قم بتنفيذ لغة تصميم واجهة أجهزة Wi-Fi (HIDL) المتوفرة في مشروع Android مفتوح المصدر (AOSP). في Android 8.0 ، يستبدل HIDL بنية طبقة تجريد الأجهزة (HAL) السابقة المستخدمة لتبسيط عمليات التنفيذ من خلال تحديد الأنواع واستدعاءات الطريقة التي يتم جمعها في الواجهات والحزم.

اتبع Wi-Fi HIDL لاستخدام ميزة Wi-Fi RTT: hardware/interfaces/wifi/1.0 أو أحدث.

يمكنك الرجوع إلى Wi-Fi HAL القديم لمعرفة كيفية ارتباطه بواجهة HIDL الجديدة: Hardware / libhardware_legacy / + / main / include / hardware_legacy / rtt.h.

تطبيق

لتنفيذ Wi-Fi RTT ، يجب توفير دعم إطار العمل و HAL / البرامج الثابتة:

  • نطاق:

    • كود AOSP
    • تمكين Wi-Fi RTT: يتطلب علامة ميزة

  • دعم Wi-Fi RTT (IEEE 802.11mc) HAL (الذي يتضمن دعم البرامج الثابتة)

لتنفيذ هذه الميزة ، قم بتنفيذ Wi-Fi HIDL وقم بتمكين علامة الميزة:

  • في device.mk الموجود في device/<oem>/<device> ، قم بتعديل متغير البيئة PRODUCT_COPY_FILES لتضمين دعم ميزة Wi-Fi RTT:

    PRODUCT_COPY_FILES += frameworks/native/data/etc/android.hardware.wifi.rtt.xml:$(TARGET_COPY_OUT_VENDOR)/etc/permissions/android.hardware.wifi.rtt.xml

وبخلاف ذلك ، يتم تضمين كل ما هو مطلوب لهذه الميزة في AOSP.

عشوائية MAC

لتعزيز الخصوصية ، يجب أن يكون عنوان MAC المستخدم أثناء معاملات Wi-Fi RTT عشوائيًا ، أي يجب ألا يتطابق مع عنوان MAC الأصلي لواجهة Wi-Fi. ومع ذلك ، كاستثناء ، عندما يكون الجهاز مرتبطًا بنقطة وصول ، يجوز له استخدام عنوان MAC المرتبط به لأي معاملات RTT مع نقطة الوصول هذه أو مع نقاط الوصول الأخرى.

تصديق

توجد اختبارات مجموعة اختبار توافق Android (CTS) لهذه الميزة. تكتشف CTS متى يتم تمكين الميزة وتتضمن الاختبارات المرتبطة تلقائيًا. يمكن أيضًا اختبار هذه الميزة باستخدام Vendor Test Suite (VTS) و act / sl4a ، وهي مجموعة اختبار تجري اختبارات تكامل شاملة.

اختبارات الوحدة

يتم تنفيذ اختبارات حزمة Wi-Fi RTT باستخدام:

اختبارات الخدمة:

atest com.android.server.wifi.rtt

اختبارات المدير:

atest android.net.wifi.rtt

اختبارات التكامل (ACTS)

توفر مجموعة اختبارات act / sl4a ، الموضحة في /tools/test/connectivity/acts_tests/tests/google/wifi/rtt/README.md ، اختبارات وظيفية وأداء واختبارات إجهاد.

CTS

توجد اختبارات مجموعة اختبار توافق Android (CTS) لهذه الميزة. تكتشف CTS متى يتم تمكين الميزة وتتضمن الاختبارات المرتبطة تلقائيًا. يجب أن تكون نقطة الوصول التي تدعم Wi-Fi RTT (IEEE 802.11mc) ضمن نطاق الجهاز قيد الاختبار.

يمكن بدء اختبارات CTS باستخدام:

atest WifiRttTest

معايرة

لكي تعمل Wi-Fi RTT بشكل جيد ، تكون النطاقات التي تم إرجاعها في بروتوكول 802.11mc دقيقة بشكل مثالي ضمن مؤشر الأداء الرئيسي (KPI). بالنسبة لخطأ 90٪ CDF ، عند عرض النطاق الترددي المذكور ، من المتوقع أن يكون لمؤشر الأداء الرئيسي الموصى به لتقدير النطاق التفاوتات التالية:

  • 80 ميجا هرتز: 2 متر
  • 40 ميجا هرتز: 4 أمتار
  • 20 ميجا هرتز: 8 أمتار

للتأكد من أن تنفيذ الميزة يعمل بشكل صحيح ، فإن اختبار المعايرة ضروري.

يمكن تحقيق ذلك من خلال مقارنة نطاق الحقيقة الأساسية مع النطاق المقدر لـ RTT على مسافات متزايدة. للتوافق الأساسي ، يجب عليك التحقق من صحة الحل الخاص بك مقابل جهاز معروف بمعايرة RTT. يجب اختبار معايرة الميدان في ظل الظروف التالية:

  1. معمل كبير مفتوح ، أو ممر لا يحتوي على الكثير من الأجسام المعدنية التي قد تؤدي إلى حدوث ارتفاع غير معتاد في المسارات المتعددة.
  2. ما لا يقل عن مسار / مسار خط البصر (LOS) يمتد لمسافة 25 مترًا.
  3. علامات بزيادات 0.5 متر من أحد طرفي المسار إلى الطرف الآخر.
  4. مكان لتأمين نقطة وصول قادرة على RTT في أحد طرفي المسار مثبتة على ارتفاع 20 سم فوق الأرض ، وحامل متحرك لهاتف Android (أو أي جهاز محمول يعمل بنظام Android قيد الاختبار) يمكن تحريكه على طول المسار ، ومحاذاة مع علامات 0.5 متر ، أيضًا على ارتفاع 20 سم فوق الأرض. ملاحظة: يمكن تنفيذ هذه المهمة المتكررة بواسطة روبوت صغير ، ولكن المشغل البشري جيد أيضًا.
  5. يجب تسجيل 50 نتيجة نطاق عند كل علامة ، جنبًا إلى جنب مع المسافة من نقطة الوصول. يجب حساب الإحصائيات ، مثل متوسط ​​النطاق والتباين ، لكل موضع علامة.

من النتائج الواردة في الخطوة 5 ، يمكن رسم مخطط للحقيقة الأساسية (المحور السيني) مقابل النطاق المقدر (المحور الصادي) وتقدير خط الانحدار الأنسب. ستؤدي معايرة الجهاز المثالية إلى خط من التدرج 1.0 ، مع إزاحة 0.0 متر على المحور ص. تكون الانحرافات عن هذه القيم مقبولة إذا كانت ضمن مؤشر الأداء الرئيسي لعرض النطاق الترددي المقابل. إذا كانت النتائج خارج KPI ، فيجب إعادة معايرة ميزة الجهاز لإحضار النتائج ضمن مواصفات KPI.