التحقّق من الأخطاء وتصحيحها

للتحقّق من حزمة البلوتوث وتصحيح أخطائها، استخدِم الأدوات المتوفّرة في مشروع Android مفتوح المصدر (AOSP) واختبارات مجموعة الاهتمام الخاص (SIG) بتقنية البلوتوث.

الاختبار والتحقّق

لاختبار حزمة برامج البلوتوث، يوفّر مشروع AOSP مجموعة من اختبارات الوحدات واختبارات CTS وأدوات خاصة بمجموعة أدوات ضبط ملفات البلوتوث الشخصية (PTS).

اختبارات الوحدات في AOSP

يتضمّن AOSP اختبارات وظيفية واختبارات للوحدات لحزمة Bluetooth التلقائية. يمكنك العثور على هذه الاختبارات في /packages/modules/Bluetooth/system/test/. لتشغيل اختبارات AOSP، اتّبِع الخطوات التالية:

  1. إيقاف وقت تشغيل Android:

    adb shell stop
  2. من دليل الاختبار، شغِّل ملف shell القابل للتنفيذ وأدرِج الخيارات إذا كنت تريد تشغيل اختبار معيّن أو مجموعة اختبارات:

    ./run_unit_tests.sh TEST_GROUP_NAME TEST_NAME OPTIONS
  3. عند الانتهاء من الاختبارات، أعِد تفعيل وقت تشغيل Android باتّباع الخطوات التالية:

    adb shell start

يمكنك الاطّلاع على قائمة بأسماء الاختبارات في /packages/modules/Bluetooth/system/test/README.md.

مجموعة أدوات ضبط الملف الشخصي

توفّر مجموعة Bluetooth SIG أداة اختبار Bluetooth PTS للتحقّق من إمكانية التشغيل التفاعلي للبروتوكول والملف الشخصي. لمزيد من المعلومات، يُرجى الاطّلاع على موقع مجموعة أدوات ضبط ملفات البلوتوث.

اختبارات مجموعة أدوات اختبار التوافق (CTS)

تتضمّن مجموعة أدوات اختبار التوافق (CTS) اختبارات لحزمة Bluetooth. وتقع هذه المتاجر في cts/apps/CtsVerifier/src/com/android/cts/verifier/bluetooth.

خيارات تصحيح الأخطاء

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

تصحيح الأخطاء باستخدام تقارير الأخطاء

للتحقّق من حالة خدمة البلوتوث باستخدام dumpsys، استخدِم الأمر التالي:

adb shell dumpsys bluetooth_manager

تكون جميع رسائل السجلّ تلقائيًا بمستوى التتبُّع 2. لمزيد من المعلومات حول مستويات التسجيل وتغيير مستويات التسجيل لمختلف الملفات الشخصية، يُرجى الاطّلاع على system/bt/conf/bt_stack.conf.

لاستخراج سجلّات التتبُّع من تقرير الخطأ، استخدِم النص البرمجي btsnooz.

  1. تنزيل btsnooz.py

  2. استخرِج النسخة النصية من تقرير الخطأ.

  3. نفِّذ الأمر btsnooz.py على النسخة النصية من تقرير الخطأ:

    btsnooz.py BUG_REPORT.txt > BTSNOOP.log

تصحيح الأخطاء باستخدام السجلّات

في الإصدار 4.4 من نظام التشغيل Android والإصدارات الأحدث، يمكنك جمع سجلّات BTSnoop يدويًا، وهي تشبه تنسيق snoop في RFC 1761. تسجّل هذه السجلات حِزم واجهة Host Controller Interface (HCI). في معظم أجهزة Android، يتم تخزين السجلات في data/misc/bluetooth/logs.

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

  1. فعِّل خيارات المطوّرين على الجهاز.

  2. في قائمة خيارات المطوّرين، فعِّل خيار تفعيل سجلّ التطفل على واجهة وحدة تحكّم المضيف في بلوتوث.

  3. أعِد تشغيل البلوتوث لتفعيل التسجيل.