אימות וניפוי באגים

כדי לאמת את מקבץ ה-Bluetooth ולנפות באגים, צריך להשתמש בכלים שמפורטים AOSP והבדיקות של קבוצת תחומי העניין המיוחדים (SIG) של Bluetooth.

בדיקה ואימות

כדי לבדוק את מקבץ ה-Bluetooth, שירות AOSP מספק שילוב של בדיקות יחידה (unit testing), בדיקות CTS וכלים עבור חבילת הכוונון של פרופיל Bluetooth.

בדיקות יחידה ב-AOSP

AOSP כולל בדיקות פונקציונליות ובדיקות יחידה לברירת המחדל מקבץ Bluetooth. הבדיקות האלה ממוקמות ב /packages/modules/Bluetooth/system/test/. כדי להריץ את בדיקות ה-AOSP:

  1. הפסקת סביבת זמן הריצה של Android:
    adb shell stop
  2. מספריית הבדיקות, מריצים את קובץ ההפעלה של המעטפת כוללים אפשרויות אם רוצים להריץ בדיקה או מקבץ בדיקות ספציפיים:
    ./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), כלי בדיקה ליכולת פעולה הדדית של פרוטוקול ופרופיל. מידע נוסף זמין במאמר האתר של חבילת הכוונון של פרופיל Bluetooth.

בדיקות CTS

החבילה לבדיקת תאימות (CTS) כולל בדיקות של סטאק Bluetooth. השירותים האלה נמצאים ב cts/apps/CtsVerifier/src/com/android/cts/verifier/bluetooth.

אפשרויות לניפוי באגים

שירות AOSP מספק שיטות שונות לניפוי באגים במכשיר מקבץ Bluetooth, כולל יומנים ודוחות על באגים. ייתכן שהשיטות האלה לא יפעלו עבור בעיות שלא ניתן לשחזר או עבור בעיות אודיו, והם יכולים להיות מושפעים מהרבה חלקים של הפלטפורמה והמכשיר.

ניפוי באגים באמצעות דוחות איתור באגים

כדי לבדוק את הסטטוס של שירות Bluetooth באמצעות 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

ניפוי באגים ביומנים

ב-Android מגרסה 4.4 ואילך, אפשר לאסוף יומני BTSnoop באופן ידני שדומה לפורמט snoop ב-RFC 1761. היומנים האלה מתעדים את מנות ממשק בקר מארח (HCI). ברוב מכשירי Android, היומנים מאוחסנים ב- data/misc/bluetooth/logs

מטעמי פרטיות, ההגדרה פועלת כל הזמן, 'בזיכרון' יומנים של BTSnoop בלבד מידע ואירועים שאינם אישיים. כדי לרשום את כל הנתונים, המשתמש צריך כדי להפעיל snoop של Bluetooth HCI, יש לבצע את הפעולות הבאות:

  1. מפעילים את אפשרויות למפתחים במכשיר.
  2. בתפריט אפשרויות למפתחים, מפעילים את מתג להפעלה של הפעלת Snoop Log של Bluetooth HCI.
  3. כדי שהרישום ביומן ייכנס לתוקף, צריך להפעיל מחדש את ה-Bluetooth.