وضع الكمون المنخفض لشبكة Wi-Fi

يعمل نظام Android 10 على توسيع واجهة برمجة تطبيقات قفل Wi-Fi للسماح للتطبيقات الحساسة لزمن الاستجابة بتكوين شبكة Wi-Fi على وضع زمن الوصول المنخفض . يبدأ وضع زمن الوصول المنخفض عند استيفاء كافة الشروط التالية:

• تم تمكين شبكة Wi-Fi ويتمتع الجهاز بإمكانية الوصول إلى الإنترنت.
• قام التطبيق بإنشاء قفل Wi-Fi والحصول عليه، وهو قيد التشغيل في المقدمة.
• الشاشة قيد التشغيل.

لدعم وضع زمن الوصول المنخفض على الأجهزة، يجب على الشركات المصنعة للأجهزة تحديث برنامج تشغيل WLAN والمورد HAL. في وضع زمن الوصول المنخفض، يتم تعطيل توفير الطاقة (المعروف أيضًا باسم حالة الغفوة في معيار IEEE 802.11) بشكل صريح بواسطة إطار العمل. يمكن تحسين معلمات المسح والتجوال في طبقات برنامج التشغيل والبرامج الثابتة لتقليل زمن وصول Wi-Fi بشكل أكبر. التحسينات الدقيقة محددة بالتنفيذ.

يتمتع Android بوضع قفل Wi-Fi عالي الأداء (تم تقديمه في مستوى API 12) وهو منفصل عن وضع الكمون المنخفض.

تطبيق

لدعم ميزة وضع الكمون المنخفض لشبكة Wi-Fi، قم بتوفير تطبيقات لوظائف IWifiChip التالية.

في AIDL HAL:

• int getFeatureSet()
• void setLatencyMode(in LatencyMode mode)

في HIDL HAL (1.3 أو أحدث):

• getCapabilities_1_3() generates (WifiStatus status, bitfield<ChipCapabilityMask> capabilities)
• setLatencyMode(LatencyMode mode) generates (WifiStatus status)

يمكن العثور على تطبيق مرجعي في wifi_legacy_hal.cpp بالوظائف التالية:

• wifi_error wifi_get_supported_feature_set(wifi_interface_handle iface, feature_set *set)
• wifi_error wifi_set_latency_mode(wifi_interface_handle handle, wifi_latency_mode mode)

في وضع زمن الوصول المنخفض، يتم تعطيل توفير الطاقة بشكل صريح بواسطة WifiLockManager في إطار عمل Android. لدعم ذلك، يجب أن يدعم برنامج تشغيل WLAN الأمر NL80211، NL80211_CMD_SET_POWER_SAVE ، لتمكين توفير الطاقة وتعطيله. عند تعطيل توفير طاقة Wi-Fi، يجب أن يظل نظام Wi-Fi في حالة التنشيط ويكون جاهزًا لإرسال أو استقبال الحزم بأقل قدر من التأخير.

تعطيل الميزة

لإيقاف تشغيل ميزة وضع زمن الوصول المنخفض، قم بتحديث التعليمات البرمجية الأساسية لـ getFeatureSet() لـ AIDL HAL أو getCapabilities_1_3() لـ HIDL HAL، مثل تلك capabilities & SET_LATENCY_MODE = 0 ، حيث يتم تعريف SET_LATENCY_MODE في تعريف IWifiChip AIDL أو HIDL . عند تعطيل هذه الميزة، يقوم إطار العمل بتعطيل توفير الطاقة فقط عندما يكون وضع زمن الوصول المنخفض نشطًا.

تصديق

لاختبار عمل وضع زمن الاستجابة المنخفض عند تمكينه، قم بتشغيل الاختبارات التلقائية التالية واختبارات زمن انتقال اتصال ping اليدوية.

الاختبار الآلي

قم بإجراء اختبارات VTS وCTS التالية:

• VTS (AIDL): hardware/interfaces/wifi/aidl/vts/functional/wifi_chip_aidl_test.cpp
• VTS (HIDL): hardware/interfaces/wifi/1.3/vts/functional/wifi_chip_hidl_test.cpp
• CTS: cts/tests/tests/net/src/android/net/wifi/cts/WifiLockTest.java

الاختبار اليدوي

معدات الاختبار والبيئة المطلوبة

للاختبار اليدوي، يلزم الإعداد التالي:

• نقطة وصول واي فاي (AP)

• هاتف الجهاز قيد الاختبار (DUT) وكمبيوتر الاختبار

  • يجب أن يكون DUT متصلاً بنقطة الوصول عبر شبكة Wi-Fi.
  • يجب أن يكون كمبيوتر الاختبار متصلاً بنقطة الوصول عبر شبكة Wi-Fi أو Ethernet.
  • يجب أن يكون كمبيوتر الاختبار متصلاً بـ DUT عبر USB.

اختبار بينغ للوصلة الصاعدة

1. تمكين وضع الكمون المنخفض.

   adb root
   adb shell cmd wifi force-low-latency-mode enabled
   

2. تأكد من أن جهاز الكمبيوتر الخاص بك متصل بالهاتف من خلال ADB. من خلال ADB Shell، قم بإجراء اختبار الاتصال بالبوابة بشكل مستمر لمدة 3 ساعات بفواصل زمنية مدتها ثانية واحدة.

3. احفظ مخرجات الاختبار في ملف نصي واستخدم جدول بيانات أو برنامج Python النصي لإنشاء رسم بياني لنتائج اختبار زمن انتقال ping.

4. كرر الخطوات من 1 إلى 3 مع تعطيل وضع زمن الاستجابة.

   adb root
   adb shell cmd wifi force-low-latency-mode disabled
   

5. قارن نتائج الاختبار للتأكد من تقليل متوسط ​​قيمة زمن انتقال اختبار الاتصال (ping) عند تمكين وضع زمن الوصول المنخفض.

اختبار بينغ للوصلة الهابطة

1. تمكين وضع الكمون المنخفض.

   adb root
   adb shell cmd wifi force-low-latency-mode enabled
   

2. من سطر الأوامر لجهاز الكمبيوتر الاختباري، قم باختبار اتصال عنوان IP الخاص بالهاتف بشكل مستمر لمدة 3 ساعات بفواصل زمنية مدتها ثانية واحدة.

3. احفظ مخرجات الاختبار في ملف نصي واستخدم جدول بيانات أو برنامج Python النصي لإنشاء رسم بياني لنتائج اختبار زمن انتقال ping.

4. كرر الخطوات من 1 إلى 3 مع تعطيل وضع زمن الاستجابة.

   adb root
   adb shell cmd wifi force-low-latency-mode disabled
   

5. قارن نتائج الاختبار للتأكد من تقليل متوسط ​​قيمة زمن انتقال اختبار الاتصال (ping) عند تمكين وضع زمن الوصول المنخفض.

اختبارات أخرى

كرر الاختبارات المذكورة أعلاه في بيئات مختلفة. على سبيل المثال، في المنزل أو في المكتب.