מצלמת ITS בקופסה

הכלי לבדיקת התמונה של מצלמת Android (ITS) הוא חלק מבדיקת התאימות של Android כלי אימות מסוג Suite (CTS) וכולל בדיקות שמאמתות את תוכן התמונה. מאמת CTS תומכת באוטומציה של בדיקות ITS באמצעות מצלמת ITS-in-a-box. תמיכה בבדיקות ידניות חלה על כל מכשירי Android גורמי צורה.

ITS-in-a-box כולל את היתרונות הבאים:

  • אוטומציה. אין צורך בהתערבות אנושית במהלך לבדיקה.
  • פתרון בעיות בקלות. עקביות של סביבת הבדיקה היא מובילה לפחות שגיאות בהגדרה ומגבירה את יכולת השחזור.
  • יעילות. אפשרות לנסות שוב במצלמה או בסצנה מסוימת משפרת את יעילות הביצוע של הבדיקה.

שנתחיל?

מארז ITS כולל קופסת פלסטיק שנגזרת מלייזר (CAD) שרטוטים, טאבלט תרשים ומכשיר בבדיקה (DUT). הטבלה הבאה מתאר את התכונות והמפרטים של ציוד ה-ITS באריזה השונים שזמינים.

מתקן מרחק בתרשים טווח מיקוד של מצלמת DUT (בערך) תכונות
מתקן בסיס מודולרי 22 ס"מ 120-60°
  • טביעת רגל קטנה יותר
  • מגרעת צמצם גדול בחזית מאפשרת בדיקה של מערכת מרובת מצלמות ללא מגרעת חוסמות מצלמות משניות
  • ניתן לסובב את המתקן ב-90°
    		•
    מתקן בסיסי למתקן תלייה ומתקן טלאים מודולריים 22 ס"מ עד 100 ס"מ* 10° עד 120°
  • מגרעת צמצם גדול בחזית
  • תומכת בבדיקה של מצלמות עם מרחק מיקוד מינימלי ארוך יותר (רוב מצלמות הטלקומוניקציה)
    		•
    WFoV ITS בקופסה 22 ס"מ 120-60°
  • טביעת רגל גדולה שמאפשרת מיקומי טעינה רבים של DUT
  • תמיכה ביעדי DUT גדולים, כמו טאבלטים
    		•
    RFoV ITS בקופסה 31 ס"מ 15° עד 90°
  • לוח תרשים
  • מערכת תאורה פנימית
    		•
    *ניתן לכוונן את אורך המתקן של תוספת הטלקומוניקציה למרחקים שונים בתרשים.
    (CAD) שרטוטים, טאבלט תרשים ומכשיר בבדיקה (DUT). הטבלה הבאה מתאר את התכונות והמפרטים של ציוד ה-ITS באריזה השונים שזמינים.

    מתקן מרחק בתרשים טווח מיקוד של מצלמת DUT (בערך) תכונות
    מתקן בסיס מודולרי 22 ס"מ 120-60°
  • טביעת רגל קטנה יותר
  • מגרעת צמצם גדול בחזית מאפשרת בדיקה של מערכת מרובת מצלמות ללא מגרעת חוסמות מצלמות משניות
  • ניתן לסובב את המתקן ב-90°
    		•
    מתקן בסיסי למתקן תלייה ומתקן טלאים מודולריים 22 ס"מ עד 100 ס"מ* 10° עד 120°
  • מגרעת צמצם גדול בחזית
  • תומכת בבדיקה של מצלמות עם מרחק מיקוד מינימלי ארוך יותר (רוב מצלמות הטלקומוניקציה)
    		•
    WFoV ITS בקופסה 22 ס"מ 120-60°
  • טביעת רגל גדולה שמאפשרת מיקומי טעינה רבים של DUT
  • תמיכה ביעדי DUT גדולים, כמו טאבלטים
    		•
    RFoV ITS בקופסה 31 ס"מ 15° עד 90°
  • לוח תרשים
  • מערכת תאורה פנימית
    		•
    *ניתן לכוונן את אורך המתקן של תוספת הטלקומוניקציה למרחקים שונים בתרשים.

    כדי להתחיל להשתמש במצלמה עם מארז ITS:

    1. רוכשים או בונים מודולרי WFoV, או href="/docs/compatibility/cts/camera-modular-rig-system">מודולרי, WFoV, או RFoV ITS בקופסה.
    2. הגדרת טאבלט עם אפליקציית Camera ITS תוכנה.
    3. הרצת בדיקות.
    4. קבלת תוצאות מה-DUT.

    הגדרת הטאבלט

    בקטע הזה מפורטות הוראות מפורטות להגדרת לשימוש עם בדיקות ITS של המצלמה שנמצאות ב: CameraITS בהוראות האלה נעשה שימוש ב-Pixel C בתור טאבלט לדוגמה. למידע על טאבלט דרישות והמלצות. ניתן לעיין בטאבלט הדרישות.

    הערה: הסקריפטים של המצלמה ל-Python ITS תגדיר באופן אוטומטי את האפשרויות הבאות בטאבלט:
    הגדרות > רשת המדיה > שינה > לאחר 30 דקות של חוסר פעילות
    בהירות אוטומטית > השבתה

    1. טוענים את הטאבלט ומפעילים אותו מחדש. אם מוצגת בקשה להגדיר חשבון, דלגו על השלב הזה (למצלמה הזו לא נדרש חשבון שמותאם לטאבלט).
    2. לעדכן את הטאבלט ל-Android מגרסה 7.0 ואילך. Android 6.x וגרסאות קודמות לא תומכים במצלמה ITS.
    3. מפעילים את מצב הפיתוח.
    4. חוזרים אל הגדרות ובוחרים באפשרות אפשרויות למפתחים.
      הפעלת האפשרויות
      • מצב פעיל
      • הישאר ער
      • ניפוי באגים ב-USB (הפעולה הזו מאפשרת למארח להפעיל את הטאבלט במצב ניפוי באגים. אחרי ש לחבר את הטאבלט למארח בפעם הראשונה, תופיע הודעה מהטאבלט לאפשר ניפוי באגים ב-USB? אם לא מוצגת בטאבלט את בקשת ניפוי הבאגים, מנתקים את הטאבלט ומחברים אותו מחדש.)
      השבתת האפשרויות
      • עדכוני מערכת אוטומטיים
      • אימות אפליקציות באמצעות USB
    5. קובעים מזהי DUT ומזהי תרשימים על ידי הרצת הפקודה $ adb devices כדי להציג את הרשימה מכשירים זמינים. כדי לזהות את device_id וגם chart_id, מחברים ונתקו מכשירים ובדקו את המכשירים להתחבר ולהתנתק.
    6. מבצעים שלוש הרצת בדיקה כדי להסתיר רמזים והנחיות למשתמש שעלולות לטשטש תרשימים במסך הטאבלט.
      1. צריך להניח את הטאבלט עם הפנים כלפי מעלה על שולחן (אין לחבר את הטאבלט לחלק האחורי של הקופסה).
      2. מריצים את הפקודה הבאה: 
        python tools/run_all_tests.py device=$device_id camera=0 chart=$chart_id scenes=2,3
        סצנות 2 ו-3 מחייבות את הטאבלט להציג תמונה, לכן מוצגת בקשה בטאבלט לתת ל-Drive הרשאת גישה לתמונות, למדיה ולקבצים במכשיר שלך?. ניקוי הבחירה את ההנחיה הזו (ומונעת הצעות עתידיות) על ידי לחיצה על אישור.
      3. מריצים את הפקודה שוב. בטאבלט מופיעה ההודעה רוצה לשמור עותק של הקובץ הזה? ומציע את Google Drive. מחיקת ההנחיה הזו (ומניעת בקשות עתידיות) עד לוחצים על סמל Drive ואז על ביטול כדי להעלות ל-Drive.
      4. בסיום, מריצים את tools/run_all_tests.py ומאשרים את הסצנות ישתנו אוטומטית כשהסקריפט עובר בין סצנות שונות. אומנם רוב הבדיקות נכשלות (מכיוון שהמצלמה לא מופנית לתרשים), אפשר לוודא הטאבלט עובר בצורה תקינה בין הסצנות מבלי להציג הנחיות או חלונות קופצים אחרים במסך.

    הרצת בדיקות

    לפני הפעלת ה-ITS-in-a-box, יש לוודא שהגדרת הבדיקה כוללת את החומרה והתוכנה הבאות:

    • מכשיר ITS אחד (1) בקופסה
    • אחד (1) רזולוציה גבוהה בגודל 10 אינץ' טאבלט להצגת סצנות, S/N: 5811000011
    • מסמך DUT אחד (1) שיש לו מאמת CTS מותקנת אפליקציה בגרסה 7.0_8 ומעלה. DUT לדוגמה:
      • Pixel אחד (1) NOF26W לבדיקה של המצלמה האחורית(0), S/N: FA6BM0305016. שפת תרגום מתקינים את האפליקציה CTS Verifier, מחלצים את הקובץ android-cts-verifier.zip ואז להציג 
        adb -s FA6BM0305016 install -r -g android-cts-verifier/CtsVerifier.apk

    הפעלת סצנות מבוססות טאבלט

    כדי להריץ את סצנות 0 עד 4, 6 ו-scene_change במצלמה האחורית:

    cd android-cts-verifier/CameraITS
. build/envsetup.sh
python tools/run_all_tests.py camera=0

    דוגמה:

    מצלמה 0 S/N: FA6BM0305016
    איור 1. מצלמה 0 S/N: FA6BM0305016

    ניסיון נוסף לסצנות

    אתם יכולים לנסות ליצור שוב סצנות למצלמה אחת:

    • כדי לנסות מחדש סצנות במצלמה אחת: 
      python tools/run_all_tests.py device=FA6BM0305016 camera=0 scenes=3,4

    הפעלת סצנה 5

    לסצנה 5 נדרשת הגדרה מיוחדת עם תאורה ספציפית (לפרטים, אפשר לעיין ב CameraITS.pdf ב-CTS Verifier, שניתן להוריד בכתובת הורדות של החבילה לבדיקת תאימות). צריך להריץ את סצנה 5 בנפרד (מחוץ לקופסה).

    סצנה 5 במצלמה
    איור 2. סצנת מצלמה 5

    כדי להפעיל את סצנה 5 במצלמה הקדמית והאחורית במכשיר יחיד:

    python tools/run_all_tests.py device=FA6BM0305016 camera=0 scenes=5
python tools/run_all_tests.py device=FA6BM0305016 camera=1 scenes=5

    משיגים תוצאות

    אפשר להציג את התוצאות במהלך הבדיקה ולשמור את התוצאות שהושלמו שלנו.

    • מציגים את התוצאות. כדי לשמור את תוצאות ה-ITS של המצלמה כדוח:
      1. מקישים על Pass (עובר) ושומרים את הדוח.
        דוח ITS של המצלמה
        איור 3. דוח ITS של המצלמה
      2. שליפת דוחות מהמכשיר: 
        adb -s FA6BM0305016 pull /sdcard/verifierReports
      3. מחלצים את קובץ הדוח וצופים ב-test_result.xml.
        דוחות ITS של המצלמה
        איור 4. דוחות ITS של המצלמה

    דרישות לטאבלטים

    במכשירי Android מגרסה 15 ואילך, טאבלטים שמשמשים כתצוגת תרשים ה-ITS חייב להיות ברשימת ההיתרים הבאה לטאבלטים. לרשימת טאבלטים שתומכים בבדיקה של עם תאורה חלשה, טאבלטים נתמכים לסביבה עם תאורה חלשה עבור ב-Android מגרסה 14 ומטה: דרישות לטאבלט ב-Android מגרסה 14 ומטה.

    הטאבלטים ברשימת ההיתרים נבחרים לפי הקריטריונים הבאים:

    • גודל תצוגה של כ-10 אינץ' עם רזולוציית מסך גדולה מ- 1920 x 1200 פיקסלים.
    • אסור להציג הבהובים שנמדדים כתוצאה מאפנון רוחב דופק (PWM) במסך מבוקר מעומעם.
    • יכולת לבצע פקודות adb שנשלחות על ידי בדיקות ITS ולהציג תמונות תרשים עם בהירות המסך.

    צריך להגדיר את הערך של brightness בconfig.yml בהתאם לטאבלט מודל טרנספורמר. כדי לקבוע אם דגם הטאבלט תואם לשם המכשיר ברשימת ההיתרים, מדפיסים את הערך ro.product.device על ידי הרצת הפקודה פקודת adb adb shell getprop | grep 'ro.product.device'.

    מכשירים גודל תצוגה
    (אינצ'ים)    		 גודל התצוגה
    (בפיקסלים)    		 מידות הטאבלט
    (אינצ'ים)    		 בהירות
    התצוגה    		 שם המכשיר
    (ro.product
    .device)    		 גרסת מערכת הפעלה
    לטאבלט
    Google
    Pixel C    		 10.2 2,560 x 1,800 9.53 x 7.05 x 0.28 96 דרקון Android מגרסה 6 ואילך
    כבוד
    פד 8    		 11 2,000 x 1,200 10.18 x 6.76 x 0.29 192 HNHEY-Q 12 ‏Android
    Lenovo
    Tab M10 Plus    		 10.3 1,920 x 1,200 9.61 x 6.03 x 0.32 192 X606F Android מגרסה 9 ואילך
    Lenovo
    Tab P11    		 11 2,000 x 1,200 10.17 x 6.42 x 0.30 192 J606F Android מגרסה 11 ואילך
    Lenovo
    Tab P11 מדור2    		 11.5 2,000 x 1,200 10.59 x 6.67 x 0.29 192 TB350FU Android מגרסה 13 ואילך
    Nokia
    T21    		 10.4 2,000 x 1,200 9.74 x 6.19 x 0.30 192 AGTA Android מגרסה 12 ואילך
    Samsung
    Galaxy Tab A7    		 10.4 2,000 x 1,200 9.75 x 6.2 x 0.28 192 gta4lwifi Android מגרסה 10 ואילך
    Samsung
    Galaxy Tab A8    		 10.5 1,920 x 1,200 9.72 x 6.73 x 0.27 192 gta8wifi Android מגרסה 11 ואילך
    Samsung
    Galaxy Tab A9+    		 11 1,920 x 1,200 10.12 x 6.64 x 0.27 192 gta9pwifi Android מגרסה 13 ואילך
    Vivo
    Pad2    		 12.1 2,800 x 1,968 10.47 x 7.54 x 0.26 192 DPD2221 Android מגרסה 13 ואילך
    Xiaomi
    Pad 5    		 11 2,560 x 1,600 10.18 x 6.76 x 0.29 192 נבו Android מגרסה 13 ואילך
    Xiaomi
    Redmi
    Pad    		 10.61 2,000 x 1,200 9.86 x 6.22 x 0.28 192 Yunluo Android מגרסה 14 ואילך
    Xiaomi
    Redmi
    Pad SE    		 11 2,560 x 1,600 10.06 x 6.58 x 0.29 192 שון Android מגרסה 13 ואילך

    טאבלטים נתמכים לסצנות עם תאורה חלשה

    הטבלה הבאה מפרטת טאבלטים שתומכים בבדיקה של סצנות עם אור מועט. הטאבלטים האלה יכולים להגיע לרמת הבהירות הנדרשת לסצנות עם תאורה חלשה, וכך לאפשר ל-DUT לחשוף את התרשים בצורה נכונה.
    מכשירים שם המכשיר (ro.product.device) גרסת מערכת הפעלה לטאבלט
    Samsung Galaxy Tab A8 gta8wifi Android מגרסה 11 ואילך
    Samsung Galaxy Tab A9+ gta9pwifi Android מגרסה 13 ואילך

    דרישות לטאבלטים ל-Android מגרסה 14 ומטה

    טאבלטים צריכים להיות בגודל מסך של כ-10 אינץ' עם רזולוציית מסך גדול מ- 1,920 x 1,200 פיקסלים. אסור לטאבלט להשתמש באפנון רוחב דופק (PWM) כדי להגדיר רמת הבהירות. צריך להגדיר את הערך של brightness בפורמט config.yml, בהתאם לדגם הטאבלט. הטבלה הבאה מפרטת את הטאבלטים המומלצים לבדיקת ITS יחד עם גרסת Android של ה-DUT שאיתם הטאבלטים פועלים.

    מכשירים גודל תצוגה
    (אינצ'ים)    		 גודל התצוגה
    (בפיקסלים)    		 מידות הטאבלט
    (אינצ'ים)    		 בהירות
    התצוגה    		 ביטים
    תצוגה    		 נתמכת
    DUT OS    		 מערכת הפעלה
    נתמכת לטאבלט
    Samsung
    Galaxy Tab A8    		 10.5 1,920 x 1,200 9.72 x 6.37 x 0.27 192 8 Android מגרסה 13 ואילך Android מגרסה 11 ואילך
    Xiaomi
    Pad 5    		 11 2,560 x 1,600 10.03 x 6.55 x 0.27 1024 11 Android מגרסה 12 ואילך רק Android 11
    Lenovo
    Tab M10 Plus    		 10.3 1,920 x 1,200 9.61 x 6.03 x 0.32 192 8 Android מגרסה 12 ואילך Android מגרסה 9 ואילך
    Samsung
    Galaxy Tab A7    		 10.4 2,000 x 1,200 9.75 x 6.2 x 0.28 192 8 Android מגרסה 12 ואילך Android מגרסה 10 ואילך
    Chewi
    Hi9 Air 10.1    		 10.1 2,560 x 1,600 9.52 x 6.77 x 0.31 192 8 Android מגרסה 7 ואילך Android מגרסה 8 ואילך
    Asus
    ZenPad 3    		 9.7 2,048 x 1,536 9.47 x 6.44 x 0.28 192 8 Android מגרסה 7 ואילך Android מגרסה 6 ואילך
    Huawei
    MediaPad m5    		 10.8 2,560 x 1,600 10.18 x 6.76 x 0.29 192 8 Android מגרסה 7 ואילך Android מגרסה 8 ואילך
    Google
    Pixel C    		 10.2 2,560 x 1,800 9.53 x 7.05 x 0.28 96 8 Android מגרסה 7 ואילך Android מגרסה 6 ואילך
    Sony
    Xperia Z4    		 10.1 2,560 x 1,600 10 x 6.57 x 0.24 192 8 Android מגרסה 7 ואילך Android מגרסה 5 ואילך

    שאלות נפוצות

    שאלה 1: איך אפשר לקבוע אילו מתקני בדיקה צריך להפעיל במכשיר?

    גרסה 1 של RFoV ITS-באריזהבודקת מצלמות RFoV לבדיקות סצנות של טאבלט ספריית CameraITS/tests. RFoV מוגדר כך 60° < FoV < 90°. במצלמות FoV גדולות יותר, יכול להיות שהאורות יופיעו בתמונות או בתרשימים עלול לכסות שטח קטן מדי ב-FV, מה שישפיע על תוצאות הבדיקה.

    מכשיר WFoV ITS בקופסה גרסה 2 בודקת מצלמות WFoV עבור בדיקות סצנות של טאבלט ספריית CameraITS/tests. WFoV מוגדר כך: FoV >= 90°. מערך הבדיקה של גרסה 2 זהה מבחינה פונקציונלית לגרסה 1, אבל גדול יותר. מכשיר הבדיקה של גרסה 2 יכול לבדוק מצלמת RFoV ומצלמת WFoV ב-Android 9 ואילך. בהינתן טביעת הרגל הגדולה יותר, גרסה 2 הוא אידיאלי אם DUT הוא טאבלט

    מתקן הבסיס המודולרי מתבצעת בדיקה של מצלמות WFoV בבדיקות סצנות של טאבלטים ספריית CameraITS/tests. WFoV מוגדר כך: FoV >= 90°. מתקן הבסיס המודולרי יכול לבדוק מצלמות RFoV ו-WFoV במכשירים עם Android מגרסה 9 ומעלה. הוא גם תומך במתקן תוסף לטלקומוניקציה שניתן לחבר כדי לבדוק מצלמות טלקומוניקציה מרחק מיקוד מינימלי. הבסיס המודולרי זהה מבחינה פונקציונלית ל-WFoV ITS-בקופסה אבל הוא קטן יותר.

    תיבת היתוך חיישן נבדקת תזמון המצלמה/ג'ירוסקופ סנכרון פריימים ומערכות מרובות מצלמות עם בדיקות scenes=sensor_fusion. הבדלי התזמון של המצלמה או הג'ירוסקופ: פחות נדרש מ-1 אלפיות שנייה לצורך הפעלת התכונה REALTIME.

    ניתן לבדוק מכשירים עם מספר מצלמות במתקן יחיד לבדיקות ITS סטטיות ומתקן היתוך חיישן, אם המצלמה כוללת את התכונה REALTIME לסמן.

    הטבלה הבאה מציגה קבוצה של הגדרות לדוגמה.

    דוגמה אמצעי זיהוי למצלמות תמיד? מתקנים מומלצים הערות
    1 20° לא גרסה 1 או 2 Android מגרסה 7.0 ואילך
    2 20° כן בסיס מודולרי או Rev 1 או 2 והיתוך חיישן Android מגרסה 9 ואילך
    3 20° + 95° כן Rev 2 + מיזוג חיישן Android מגרסה 9 ואילך
    4 20° + 95° + 20° כן בסיס מודולרי והרחבת טלקומוניקציה ושילוב חיישן Android מגרסה 9 ואילך
    5 טאבלט 75° + 95° לא גרסה 2 Android מגרסה 9 ואילך

    שאלה 2: איך אפשר לסווג את מכשיר הבדיקה שנמצא בשימוש?

    כדי לקבוע את מכשיר הבדיקה הנכון, צריך לוודא שפרמטר המרחק בתרשים נכון. יש תרשים של מכשיר הבדיקה rev1 (RFoV) המרחק בתרשים הוא 31 ס"מ, והמרחק בתרשים (WFoV) הוא 22 ס"מ. כברירת מחדל המרחק בתרשים מוגדר ל-31 ס"מ.

    Android 10 עד Android 11

    כדי לזהות את מכשיר הבדיקה הנכון ב-Android 10 עד 11 מוסיפים את הדגל dist בשורת הפקודה. ברירת המחדל הערך של dist הוא 31. מריצים את הפקודה הבאה כדי לשנות את הפרמטר chart_distance. 
    python tools/run_all_tests.py ... chart=# dist=22

    Android מגרסה 12 ואילך

    כדי לזהות את מכשיר הבדיקה הנכון ב-Android 12 ואילך, אפשר לערוך את config.yml כדי לשנות את הפרמטר chart_distance. 
    edit config.yml
chart_distance: 31.0 → chart_distance: 22.0

    שאלה 3: איך אפשר לשלוט בבהירות של הטאבלט?

    כברירת מחדל, הבהירות של הטאבלט מוגדרת ל-96.

    כדי לשנות את הבהירות בטאבלטים עם Android מגרסה 7.0 עד 9. לרוץ:

    edit tools/wake_up_screen.py
DISPLAY_LEVEL=96 → DISPLAY_LEVEL=192

    כדי לשנות את הבהירות בטאבלטים עם Android מגרסה 10 עד 11, אפשר לשנות את הערך הזה בשורת הפקודה על ידי הוספת הדגל brightness:

    python tools/run_all_tests.py device=# camera=# chart=# brightness=192

    כדי לשנות את הבהירות בטאבלטים עם Android מגרסה 12 ואילך: לרוץ:

    edit config.yml
brightness: 96 → brightness: 192

    שאלה 4: איך אפשר לנפות באגים בבדיקה בודדת?

    אפשר להריץ בדיקות בנפרד למטרות ניפוי באגים, אבל התוצאות לא דווחו ל-CtsVerifier.apk, אלא אם כל הסצנה רצה.

    כדי להריץ סצנה ספציפית ב-Android 11 ומטה:

    1. כדי לטעון סצנה, מוסיפים את הדגל scenes tools/run_all_tests.py: 
      python tools/run_all_tests.py device=# camera=# chart=# scenes=#

    2. כדי להפסיק את הבדיקות אחרי הסצנה, לוחצים על Control+C. נרשם כ- נטען אל stdout.

      אם הסצנה הנכונה כבר מוצגת הוצאת המסך ממצב שינה:

      python tools/wake_up_screen.py screen=#

    3. מריצים בדיקה ספציפית.

      python tests/scene#/test_*.py device=# camera=#

      חלקות נוצרות בספרייה המקומית stdout ו-stderr מודפסים במסך.

      כדי לקבל מידע נוסף על ניפוי באגים, צריך להוסיף את print לסקריפט. כדי להגדיל את פלט הבדיקה לניפוי באגים, מוסיפים הדגל debug=True.

      python tests/scene#/test_*.py device=# camera=# debug=True

    התוצאות מודפסות במסך המקומי והתמונות נשמרות בספרייה המקומית במקום ספריית /tmp/tmp### שנוצרה כאשר עם tools/run_all_tests.py.

    כדי להריץ סצנה ספציפית ב-Android 12 ואילך:

    1. עורכים את הקובץ config.yml.

      edit config.yml
camera: <camera-id> → camera:  0
scene: <scene-name> → scene: scene1_1

    2. מריצים את הבדיקה הספציפית.

      python tools/run_all_tests.py -c config.yml --test_bed TEST_BED_TABLET_SCENES

    התוצאות מודפסות בספרייה /tmp/logs/mobly/TEST_BED_TABLET_SCENES/ שממוינת לפי זמן ריצה.

    שאלה 5: למה צריך להריץ במקום זאת בדיקות שנכשלות בסצנה שלמה להריץ בדיקות חוזרות בנפרד?

    אפשר להריץ בדיקות בנפרד למטרות ניפוי באגים, אבל אין תוצאות דווחו ל-CtsVerifier.apk, אלא אם כל הסצנה רצה.

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

    דוגמה קיצונית: נבחן מקרה שבו יש 10 בדיקות בסצנה שלכל אחת מהן יש סבירות של 50% להחזיר PASS. על ידי הרצה של לבדוק בנפרד, יש סיכוי גבוה שמפעיל יוכל לגרום למצלמה להעביר את המצלמה ITS. עם זאת, אם הבדיקות ירוצו במצטבר כסצנה, יש סיכוי של 0.1% בלבד שהסצנה תעבור.

    שאלה 6: איך מפעילים סצנה אחת או משנים את הסדר של סצנות הריצה?

    כברירת מחדל, הסקריפט tools/run_all_tests.py מריץ את כל הסצנות לפי הסדר. עם זאת, אפשר להריץ סצנות בנפרד או בסדר מסוים, וגם ידווחו ל-CtsVerifier.apk.

    כדי להריץ סצנה אחת (לדוגמה, סצנה 2) או להריץ יותר מסצנה אחת בסצנה ספציפית הזמנה ב-Android 11 או Low:

    python tools/run_all_tests.py device=# camera=# chart=# scenes=2

    python tools/run_all_tests.py device=# camera=# chart=# scenes=3,2

    כדי להריץ סצנה אחת או להפעיל יותר מסצנה אחת בסצנה ספציפית ההזמנה ב-Android מגרסה 12 ואילך:

    python tools/run_all_tests.py scenes=2

    python tools/run_all_tests.py scenes=3,2

    הפרמטרים הנוספים מוגדרים בקובץ config.yml.

    שאלה 7: מספר בדיקות בסצנה 1 נכשלות בהגדרת הטאבלט אבל עברו את הבדיקות בהצלחה באמצעות תרשים מנייר. מה הבעיה?

    צריך לוודא שהטאבלט וסביבת הבדיקה עומדים בדרישות הבאות: מפרט.

    מפרטי טאבלטים

    צריך לוודא שהטאבלט עומד במפרטים הבאים:

    • גודל התצוגה (אינצ'ים): 10 אינץ'
    • גודל המסך (בפיקסלים): גדול מ- 1,920 x 1,200 פיקסלים

    פרטים נוספים זמינים במאמר הדרישות לטאבלטים.

    בהירות של טאבלט

    ייתכן שהבדיקות לא יניבו תוצאות נכונות אם הבהירות של מסך הטאבלט גבוהה מדי נמוכה.

    פרטים נוספים זמינים במאמר איך אפשר לשלוט בבהירות של הטאבלט?

    עוצמת תאורה בתיבה (נדרש מד לוקס)

    צריך לוודא שערך היעד לוקס בפתיחת הטאבלט הוא בין 100 ל- השגיאה:

    אם רמת ה-lux גבוהה מדי, scene1/test_param_flash_mode.py מחזירה FAIL. אם רמת ה-lux נמוכה מדי, כמה בדיקות ייכשלו.

    שאלה 8: איך אפשר לנפות באגים בבדיקות היתוך של החיישן?

    1. עליך לוודא שאתם שייכים לקבוצה dialout.

      groups | egrep ‘dialout'

    2. יש לוודא שבקר היתוך של החיישן מחובר באמצעות בדיקה אם טכנולוגיית המיקרו-שבב מחוברת ליציאת ה-USB.

      lsusb
…
Bus 003 Device 004: ID 04d8:fc73 Microchip Technology, Inc.
…

    3. מריצים את הבדיקה מספר פעמים כדי לקבל התפלגות של ניסיונות הבדיקה עם את הפקודות הבאות.

      ב-Android מגרסה 11 ומטה:

      python tools/run_sensor_fusion_box.py device=A camera=0 num_runs=10 rotator=default

      ב-Android מגרסה 12 ואילך:

      python tools/run_sensor_fusion_box.py num_runs=10

      הפרמטרים הנוספים מוגדרים בקובץ config.yml.

      הפלט של הרצת הפלט נמצא בתיקייה /tmp/tmp### שנוצרה במסגרת את sensor_fusion_# התיקיות, שבהן ההרצה של # מתבצעת מספר. הסיבות הנפוצות לכשל:

      1. הטלפון לא במרכז בצורה תקינה.
      2. לא נמצאו מספיק תכונות בתמונה (בדרך כלל יש בעיה ב-FV או בתאורה).
      3. הערך של FAIL שהוחזר תקף, והפרש התזמון בין צריך לתקן את המצלמה ואת הג'ירוסקופ.

    שאלה 9: איזה מידע עלי לכלול בדיווח על לבדוק באג?

    כשמדווחים על באג לבדיקה, צריך לכלול את הקבצים והתמונות שנוצרו לצורך הבדיקה.

    1. אם הפעלת את הבדיקה דרך tools/run_all_tests.py, עליך לצרף בוצעה דחיסה של ספריית /tmp/ לבאג.
    2. אם הרצת את הבדיקה לבד, עליך לחבר את כל פלטי המסך יצירת תמונות לבאג.

    אפשר לכלול גם דוח איתור באגים. אחרי שהבדיקה הרלוונטית נכשלת, משתמשים את הפקודה הבאה כדי ליצור דוח על באג ולצרף את קובץ ה-ZIP שנוצר אל הבאג. 

    adb -s device_id bugreport

    שאלה 10: איך מריצים סצנה של בדיקת Sens_fusion עם מצלמה עם מיקוד מינימלי מרחק שיוצר תמונות מטושטשות במרחק של 25 ס"מ בתרשים?

    אם המצלמה לא יכולה להתמקד במרחק של 25 ס"מ, מסירים את חלונית הטעינה לתרשימים של תיבת היתוך של החיישן. יש למקם את התרשים במרחק שבו ה-DUT יכול להתמקד ולשנות chart_distance ב-config.yml למרחק שנמדד בין ה-DUT ו- את התרשים. איור 5 מציג דוגמה לאופן שבו ניתן למדוד את המרחק בתרשים במצב הזה.

    דוגמה לבדיקת TELE של חיישן_fusion6
    איור 5. מדידת המרחק של התרשים לסצנה של בדיקת היתוך של החיישן
      edit config.yml
chart_distance: 25 → chart_distance: DISTANCE_BETWEEN_DUT_AND_CHART

    שאלה 11: איך מפעילים סצנות בדיקה בטאבלט במצלמה עם מיקוד מינימלי מרחק שיוצר תמונות מטושטשות במרחק של 31 ס"מ בתרשים?

    אם המצלמה לא יכולה להפיק תמונות חדות מספיק במרחק 31 ס"מ את העומק של מתקן הבדיקה ל-RFoV), צריך להתקין את המצלמה מול המכשיר במרחק כדי לאפשר כדי למלא כ-60% משדה הראייה של המצלמה (FoV) תמונות חדות יותר. המרחק הזה יכול להיות קטן מהמיקוד המינימלי מרחק המצלמה. יציאה מchart_distance בconfig.yml בשעה 31 ס"מ. גודל התרשים בטאבלט נקבע על ידי המצלמה FoV כפי שמוצג בטבלה הבאה:

    חיישן המצלמה גורם לשינוי קנה מידה בתרשים
    60 > FoV > 40 0.67x
    40 > FoV > 25 0.5x
    FoV < 25 0.33x

    שאלה 12: באילו מצלמות מתבצעות בדיקות באמצעות ממשק ה-API הלוגי מרובה מצלמות?

    אם המצלמה משתמשת REQUEST_AVAILABLE_CAPABILITIES_LOGICAL_MULTI_CAMERA, כל בדיקות ה-ITS הנתמכות פועלות במצלמה הלוגית שברמה העליונה. חלק מהבדיקות ה-ITS מתבצעות מצלמות משנה, והבדיקות האלה רשומות בtools/run_all_tests.py מתחת הקבוע SUB_CAMERA_TESTS.