حزمة ITS-in-a-Box للكاميرا

تشكّل مجموعة اختبارات الصور في كاميرا Android (ITS) جزءًا من أداة التحقّق من مجموعة اختبار التوافق (CTS) لنظام التشغيل Android، وتتضمّن اختبارات للتحقّق من محتوى الصور. يتيح أداة التحقّق من التوافق (CTS Verifier) استخدام اختبارات ITS المبرمَجة باستخدام حزمة ITS المخصّصة للكاميرا، ويشمل التوافق مع الاختبارات اليدوية جميع أشكال أجهزة Android.

وتشمل علبته المزايا التالية:

  • التشغيل الآلي: لا حاجة إلى تدخل بشري أثناء الاختبار.
  • سهولة تحديد المشاكل وحلّها: يؤدي اتساق بيئة الاختبار إلى تقليل أخطاء الإعداد وزيادة إمكانية إعادة الإجراء.
  • الكفاءة: تؤدي إمكانية إعادة المحاولة لكاميرا أو مشهد فردي إلى تحسين كفاءة تنفيذ الاختبار.

البدء

يتكوّن نظام ITS-in-a-box من علبة بلاستيكية يتم قطعها بالليزر من رسومات التصميم بمساعدة الكمبيوتر (CAD) ولوحة رسم بياني وجهاز قيد الاختبار (DUT). يوضِّح الجدول التالي الميزات والمواصفات لأجهزة ITS-in-a-box المختلفة المتوفّرة.

أداة المسافة في الرسم البياني نطاق عرض الكاميرا DUT (تقريبًا) الميزات
قاعدة تركيب متنقلة 22 سم من 60 إلى 120 درجة
  • مساحة أصغر
  • فتحة عدسة كبيرة في الأمام تتيح اختبار نظام الكاميرات المتعدّدة بدون أن تؤدي الفتحة إلى حجب الكاميرات الثانوية
  • يمكن تدوير الإطار بزاوية 90 درجة
  • منصّة أساسية معيارية وأداة تمديد عن بُعد ‫22 سم - 100 سم* ‫10° - 120°
  • فتحة عدسة كبيرة في الأمام
  • يتيح اختبار الكاميرات التي تتطلّب مسافة أطول للتركيز (معظم كاميرات الزووم)
  • WFoV ITS-in-a-box 22 سم من 60 إلى 120 درجة
  • مساحة كبيرة تتيح العديد من مواضع تثبيت DUT
  • إتاحة استخدام أجهزة DUT كبيرة، مثل الأجهزة اللوحية
  • RFoV ITS-in-a-box 31 سم من 60 درجة إلى 90 درجة
  • لوحة الرسم البياني
  • نظام إضاءة داخلي
  • *يمكن تعديل طول قاعدة التثبيت لجهاز التمديد عن بُعد حسب المسافات المختلفة للرسم البياني.

    لبدء استخدام حزمة ITS-in-a-box للكاميرا، يُرجى اتّباع الخطوات التالية:

    1. يمكنك شراء أو إنشاء وحدات أو WFoV أو RFoV في علبة.
    2. إعداد جهاز لوحي باستخدام برنامج الكاميرا ITS.
    3. إجراء الاختبارات
    4. الحصول على النتائج من جهاز DUT

    ضبط الجهاز اللوحي

    يوفّر هذا القسم تعليمات تفصيلية لإعداد جهاز كمبيوتر لوحي لاستخدامه مع اختبارات ITS للكاميرا في الدليل CameraITS. تستخدِم هذه التعليمات جهاز Pixel C كأحد مثاليّات الأجهزة اللوحية. للحصول على معلومات عن متطلبات الجهاز اللوحي والاقتراحات المتعلّقة به، يُرجى الاطّلاع على متطلبات الجهاز اللوحي.

    ملاحظة: تعمل النصوص البرمجية من Python على الكاميرا تضبط الخيارات التالية تلقائيًا على الجهاز اللوحي:
    الإعدادات > الشاشة > السكون > بعد 30 دقيقة من عدم النشاط
    السطوع التكيُّفي > إيقاف

    1. اشحن الجهاز اللوحي وشغِّله. إذا طُلب منك إعداد حساب، تخطّاه (لا تتطلّب ميزة ITS للكاميرا أي حساب مقترن بالجهاز اللوحي).
    2. يجب تحديث الجهاز اللوحي إلى الإصدار 7.0 من Android أو إصدار أحدث. لا يتوافق الإصدار 6.x من نظام التشغيل Android والإصدارات الأقدم مع واجهة برمجة التطبيقات Camera 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، تأكَّد من أنّ إعداد الاختبار يتضمّن الأجهزة والبرامج التالية:

    • واحد (1) صندوق تكنولوجيا المعلومات
    • جهاز لوحي واحد (1) بدقة عالية مقاس 10 بوصة لعرض المشاهد، الرقم التسلسلي: 5811000011
    • وحدة DUT واحدة (1) مثبَّت عليها تطبيق CTS Verifier 7.0_8 أو الإصدارات الأحدث. مثال على جهاز DUT:
      • كاميرا Pixel NOF26W واحدة (1) لاختبار الكاميرا الخلفية(0)، الرقم التسلسلي: FA6BM0305016 لتثبيت تطبيق CTS Verifier، عليك فك ضغط android-cts-verifier.zip ثم تشغيل
        adb -s FA6BM0305016 install -r -g android-cts-verifier/CtsVerifier.apk
        

    تشغيل مشاهد مستندة إلى الجهاز اللوحي

    لعرض المشاهد من 0 إلى 4 و6 وWature_change على الكاميرا الخلفية:

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

    مثال:

    رقم التعريف التسلسلي للكاميرا 0: FA6BM0305016
    الشكل 1. رقم التعريف الخاص بالكاميرا 0: 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
    

    الحصول على النتائج

    يمكنك عرض النتائج أثناء الاختبار وحفظ النتائج المكتملة كملف تقرير.

    • عرض النتائج: لحفظ نتائج تكنولوجيا المعلومات والاتصالات في الكاميرا كتقرير:
      1. اضغط على اجتياز واحفظ التقرير.
        تقرير ITS للكاميرا
        الشكل 3. تقرير أنظمة النقل الذكية بالكاميرا
      2. سحب التقارير من الجهاز:
        adb -s FA6BM0305016 pull /sdcard/verifierReports
        
      3. فكِّ ضغط ملف التقرير واطّلِع على test_result.xml.
        تقارير ITS من الكاميرا
        الشكل 4. تقارير ITS للكاميرا

    متطلبات الجهاز اللوحي

    بالنسبة إلى الإصدار 15 من Android والإصدارات الأحدث، يجب أن تكون الأجهزة اللوحية المستخدَمة لعرض الرسم البياني ITS مُدرَجة في القائمة المسموح بها للأجهزة اللوحية التالية. للحصول على قائمة بالأجهزة اللوحية التي تتيح اختبار المشاهد ذات الإضاءة المنخفضة، يُرجى الاطّلاع على الأجهزة اللوحية المتوافقة مع ميزة اختبار المشاهد ذات الإضاءة المنخفضة. بالنسبة إلى Android 14 أو الإصدارات الأقدم، يُرجى الاطّلاع على متطلبات الأجهزة اللوحية لنظام التشغيل Android 14 والإصدارات الأقدم.

    يتم اختيار الأجهزة اللوحية المدرَجة في القائمة المسموح بها استنادًا إلى المعايير التالية:

    • حجم شاشة يبلغ 25.4 سم تقريبًا بدقة شاشة تزيد عن 1920 × 1200 بكسل
    • يجب ألا يكون هناك أي وميض تم قياسه ناتج عن خفض سطوع الشاشة باستخدام تقنية تعديل عرض النبضة (PWM).
    • أن يكون قادرًا على تنفيذ أوامر adb التي ترسلها اختبارات ITS وعرض صور الرسوم البيانية مع مستوى سطوع الشاشة المحدَّد

    يجب ضبط قيمة brightness في config.yml وفقًا لطراز الجهاز اللوحي. لتحديد ما إذا كان طراز جهازك اللوحي يتطابق مع اسم جهاز في ملف ملف قائمة المسموح به، اطبع قيمة ro.product.device من خلال تشغيل adb shell getprop | grep 'ro.product.device' adb.

    الجهاز حجم الشاشة
    (بالبوصة)
    حجم الشاشة
    (بالبكسل)
    أبعاد الجهاز اللوحي
    (بالبوصة)
    سطوع
    الشاشة
    اسم الجهاز
    (ro.product
    .device)
    نظام التشغيل
    الإصدار
    Google
    Pixel C
    10.2 2560 × 1800 ‎9.53 x ‏7.05 x ‏0.28 96 تنين الإصدار 6 من نظام التشغيل Android أو الإصدارات الأحدث
    Honor
    Pad 8
    11 ‎2000 x 1200 10.18 × 6.76 × 0.29 192 HNHEY-Q Android 12
    ‫Huawei
    MediaPad m5
    10.8 2560 × 1600 10.18 × 6.76 × 0.29 192 HWCMR09 الإصدار 8 من نظام التشغيل Android والإصدارات الأحدث
    Lenovo
    Tab M10 Plus
    10.3 ‫‎1920 x 1200 9.61 × 6.03 × 0.32 192 X606F الإصدار 9 من نظام التشغيل Android والإصدارات الأحدث
    Lenovo
    Tab P11
    11 ‎2000 x 1200 10.17 × 6.42 × 0.30 192 J606F الإصدار 11 من نظام التشغيل Android والإصدارات الأحدث
    Lenovo
    Tab P11 Gen2
    11.5 ‎2000 x 1200 10.59 × 6.67 × 0.29 192 TB350FU الإصدار 13 من نظام التشغيل Android والإصدارات الأحدث
    Nokia
    T21
    10.4 2000 x 1200 ‎9.74 x 6.19 x 0.30 192 AGTA الإصدار 12 من نظام التشغيل Android والإصدارات الأحدث
    Samsung
    Galaxy Tab A7
    10.4 ‎2000 x 1200 ‫9.75 x ‏6.2 x ‏0.28 192 gta4lwifi الإصدار 10 من نظام التشغيل Android أو إصدار أحدث
    ‫Samsung
    Galaxy Tab A8
    10.5 ‫‎1920 x 1200 9.72 × 6.73 × 0.27 192 gta8wifi الإصدار 11 من نظام التشغيل Android والإصدارات الأحدث
    Samsung
    Galaxy Tab A9+
    11 ‫‎1920 x 1200 10.12 × 6.64 × 0.27 192 gta9pwifi الإصدار 13 من نظام التشغيل Android والإصدارات الأحدث
    Vivo
    Pad2
    12.1 2800 x 1968 ‫10.47 × 7.54 × 0.26 192 DPD2221 الإصدار 13 من نظام التشغيل Android والإصدارات الأحدث
    Xiaomi
    Pad 5
    11 2560 × 1600 10.18 × 6.76 × 0.29 192 nabu الإصدار 13 من نظام التشغيل Android والإصدارات الأحدث
    Xiaomi
    Redmi
    Pad
    10.61 2000 x 1200 9.86 × 6.22 × 0.28 192 yunluo الإصدار 14 من نظام التشغيل Android والإصدارات الأحدث
    Xiaomi
    Redmi
    Pad SE
    11 2560 x 1600 ‎10.06 x 6.58 x 0.29 192 زين الإصدار 13 من نظام التشغيل Android والإصدارات الأحدث

    الأجهزة اللوحية المتوافقة مع ميزة "تحسين جودة الصور في الإضاءة المنخفضة"

    يسرد الجدول التالي الأجهزة اللوحية التي تتيح اختبار المَشاهد ذات الإضاءة المنخفضة. يمكن أن تصل هذه الأجهزة اللوحية إلى مستوى السطوع المطلوب لمشاهد الإضاءة المنخفضة، ما يسمح لوحدة التحكّم في العينة (DUT) بعرض الرسم البياني بشكل صحيح.
    الجهاز اسم الجهاز (ro.product.device) إصدار نظام التشغيل على الجهاز اللوحي
    ‫Huawei
    MediaPad m5
    HWCMR09 الإصدار 8 من نظام التشغيل Android والإصدارات الأحدث
    Samsung Galaxy Tab A8 gta8wifi الإصدار 11 من نظام التشغيل Android والإصدارات الأحدث
    Samsung Galaxy Tab A9+ gta9pwifi الإصدار 13 من نظام التشغيل Android والإصدارات الأحدث
    Xiaomi Pad 5 nabu الإصدار 13 من نظام التشغيل Android والإصدارات الأحدث
    Xiaomi
    Redmi
    Pad SE
    زين الإصدار 13 من نظام التشغيل Android والإصدارات الأحدث

    متطلبات الأجهزة اللوحية التي تعمل بالإصدار 14 من نظام التشغيل Android والإصدارات الأقدم

    يجب أن يكون حجم شاشة الجهاز اللوحي 10 بوصات تقريبًا وأن تكون دقة الشاشة أكبر من 1920 × 1200 بكسل. يجب ألا يستخدم الجهاز اللوحي تعديل عرض النبض (PWM) لضبط مستوى السطوع. يجب ضبط القيمة brightness في config.yml وفقًا لطراز الجهاز اللوحي. يسرد الجدول التالي الأجهزة اللوحية المقترَحة لاختبار ITS بالإضافة إلى إصدارات Android لجهاز DUT الذي تعمل عليه الأجهزة اللوحية.

    الجهاز حجم الشاشة
    (بالبوصة)
    حجم الشاشة
    (بالبكسل)
    أبعاد الجهاز اللوحي
    (بالبوصة)
    سطوع
    الشاشة
    عرض
    بت
    متوافق
    نظام التشغيل DUT
    نظام التشغيل المتوافق مع
    الأجهزة اللوحية
    ‫Samsung
    Galaxy Tab A8
    10.5 ‫‎1920 x 1200 9.72 × 6.37 × 0.27 192 8 الإصدار 13 من نظام التشغيل Android والإصدارات الأحدث الإصدار 11 من نظام التشغيل Android والإصدارات الأحدث
    Xiaomi
    اللوحة 5
    11 2560 × 1600 ‎10.03 x 6.55 x 0.27 1024 11 الإصدار 12 من نظام التشغيل Android والإصدارات الأحدث Android 11 فقط
    Lenovo
    Tab M10 Plus
    10.3 ‫‎1920 x 1200 9.61 × 6.03 × 0.32 192 8 الإصدار 12 من نظام التشغيل Android والإصدارات الأحدث الإصدار 9 من نظام التشغيل Android والإصدارات الأحدث
    ‫Samsung
    Galaxy Tab A7
    10.4 ‎2000 x 1200 ‫9.75 x ‏6.2 x ‏0.28 192 8 الإصدار 12 من نظام التشغيل Android والإصدارات الأحدث الإصدار 10 من نظام التشغيل Android أو إصدار أحدث
    تشووي
    Hi9 Air 10.1
    10.1 2560 × 1600 9.52 × 6.77 × 0.31 192 8 الإصدار 7 من نظام التشغيل Android أو الإصدارات الأحدث الإصدار 8 من نظام التشغيل Android والإصدارات الأحدث
    Asus
    ZenPad 3
    9.7 2048 × 1536 9.47 × 6.44 × 0.28 192 8 الإصدار 7 من نظام التشغيل Android أو الإصدارات الأحدث الإصدار 6 من نظام التشغيل Android أو الإصدارات الأحدث
    هواوي
    MediaPad m5
    10.8 2560 × 1600 10.18 × 6.76 × 0.29 192 8 الإصدار 7 من نظام التشغيل Android أو الإصدارات الأحدث الإصدار 8 من نظام التشغيل Android والإصدارات الأحدث
    Google
    Pixel C
    10.2 2560 × 1800 ‎9.53 x ‏7.05 x ‏0.28 96 8 الإصدار 7 من نظام التشغيل Android أو الإصدارات الأحدث الإصدار 6 من نظام التشغيل Android أو الإصدارات الأحدث
    Sony
    Xperia Z4
    10.1 2560 × 1600 10 × 6.57 × 0.24 192 8 الإصدار 7 من نظام التشغيل Android أو الإصدارات الأحدث الإصدار 5 من نظام التشغيل Android والإصدارات الأحدث

    الأسئلة الشائعة

    س 1: كيف يمكنني تحديد تجهيزات الاختبار التي أحتاج إليها لجهازي؟

    يختبر الإصدار 1 من حزمة اختبارات كاميرات الرؤية الفائقة الزاوية (RFoV) في علبة واحدة كاميرات الرؤية الفائقة الزاوية لاختبارات مَشاهد الأجهزة اللوحية في الدليل CameraITS/tests. يتم تعريف مجال الرؤية البعيد (RFoV) على النحو التالي: 60° < مجال الرؤية < 90°. بالنسبة إلى الكاميرات التي تتمتع بمجال رؤية أكبر، قد تظهر الأضواء في الصور أو المخططات البيانية وقد تغطي مساحة صغيرة جدًا في مجال الرؤية، ما يؤثر في نتائج الاختبار.

    يختبر WFoV ITS-in-a-box الإصدار 2 كاميرات WFoV لاختبارات مَشاهد الأجهزة اللوحية في دليل CameraITS/tests. يتم تعريف مجال الرؤية الفائق على النحو التالي: مجال الرؤية >= 90°. إنّ جهاز الاختبار من الإصدار 2 مطابق من الناحية الوظيفية لجهاز الإصدار 1، ولكنه أكبر حجمًا. يمكن لجهاز الاختبار من المراجعة 2 اختبار كل من كاميرات RFoV وWFoV في نظام التشغيل Android 9 والإصدارات الأحدث. نظرًا للمساحة الأكبر التي يشغلها الجهاز، فإنّ النسخة 2 هي مثالية إذا كان جهاز DUT جهازًا لوحيًا.

    يختبر هيكل القاعدة المُركّب كاميرات مجال الرؤية الواسع (WFoV) لاختبارات مَشاهد الأجهزة اللوحية في الدليل CameraITS/tests. يشير مصطلح WFoV إلى أنّه FoV >= 90°. يمكن للجهاز الأساسي النموذجي اختبار كلّ من كاميرات RFoV وWFoV على الأجهزة التي تعمل بالإصدار 9 من نظام التشغيل Android والإصدارات الأحدث. وهو متوافق أيضًا مع قاعدة تمديد الكاميرات المقرّبة التي يمكن تركيبها على كاميرات مقرّبة لاختبارها مع مزيد من الحد الأدنى لمسافة التركيز. إنّ القاعدة المُجمّعة متطابقة وظيفيًا مع نظام ITS-in-a-box المخصّص لتصوير الفيديو بزاوية عريضة جدًا، ولكنها أصغر حجمًا.

    يختبر مربّع دمج المستشعرات وقت بدء تسجيل الكاميرا/الاستشعار المغناطيسي ووقت الانتهاء ووقت مزامنة اللقطات في أنظمة الكاميرات المتعدّدة باستخدام الاختبارات في scenes=sensor_fusion. يجب أن يكون توقيت الكاميرا/الاستشعار الدوراني أقل من 1 ملي ثانية لعلامة ميزة REALTIME.

    يمكن اختبار الأجهزة المزوّدة بعدة كاميرات باستخدام جهاز واحد لاختبارات ITS الثابتة وجهاز تركيب أدوات استشعار إذا كانت الكاميرا تتضمّن علامة REALTIME الميزة.

    وتتوفر مجموعة من أمثلة عمليات الضبط في الجدول أدناه.

    مثال فيديوهات الكاميرا REALTIME? التجهيزات المقترَحة ملاحظات
    1 75° لا المراجعة 1 أو 2 الإصدار 7.0 من Android أو إصدار أحدث
    2 75° نعم القاعدة المعيارية أو Rev 1 أو Rev 1 أو اندماج أداة الاستشعار إصدار Android 9 أو أحدث
    3 ‫75° + 95° نعم الإصدار 2 والإصدارات الأحدث من ميزة "دمج أدوات الاستشعار" الإصدار 9 من Android أو إصدار أحدث
    4 75° + 95° + 20° نعم قاعدة معيارية ودمج طرف معي ومع جهاز استشعار إصدار Android 9 أو أحدث
    5 75° + 95° Tablet لا الإصدار 2 الإصدار 9 من Android أو إصدار أحدث

    السؤال 2: كيف يمكنني تحديد منصة الاختبار المستخدَمة؟

    لتحديد جهاز الاختبار الصحيح، تأكد من صحة معلمة المسافة في الرسم البياني. يبلغ سمك الرسم البياني في الإصدار 1 من جهاز الاختبار (RFoV) 31 سم، بينما يبلغ سمك الرسم البياني في الإصدار 2 من جهاز الاختبار (WFoV) 22 سم. يتم تلقائيًا ضبط مسافة الرسم البياني على 31 سم.

    الترقية من Android 10 إلى Android 11

    لتحديد جهاز الاختبار الصحيح في الإصدارات من Android 10 إلى 11، أضِف علامة dist في سطر الأوامر. القيمة التلقائية للعنصر dist هي 31. شغِّل الأمر التالي لتغيير المَعلمة chart_distance.
    python tools/run_all_tests.py ... chart=# dist=22
    

    الإصدار 12 من نظام التشغيل Android والإصدارات الأحدث

    لتحديد منصة الاختبار الصحيحة في Android 12 والإصدارات الأحدث، يمكنك تعديل ملف config.yml لتغيير المَعلمة chart_distance.
    edit config.yml
    chart_distance: 31.0 → chart_distance: 22.0
    

    س3: كيف يمكنني التحكّم في سطوع الشاشة على الجهاز اللوحي؟

    يتم ضبط سطوع الجهاز اللوحي تلقائيًا على 96.

    لتغيير مستوى السطوع على الأجهزة اللوحية التي تعمل بالإصدار 7.0 من Android إلى 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
    

    لتغيير مستوى السطوع على الأجهزة اللوحية التي تعمل بالإصدار 12 من نظام التشغيل Android والإصدارات الأحدث، يمكنك تشغيل:

    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

    عند تشغيل tools/run_all_tests.py، تتم طباعة النتائج على الشاشة المحلية ويتم حفظ الصور في الدليل المحلي بدلاً من دليل /tmp/tmp### الذي تم إنشاؤه.

    لتشغيل مشهد فردي في 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 ما لم يتم تشغيل المشهد بأكمله.

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

    على سبيل المثال، لنفترض أنّ هناك 10 اختبارات في مشهد يُحتمَل أن يعرض كلّ منها PASS بنسبة% 50. من خلال إجراء كل اختبار على حدة، تكون هناك فرصة كبيرة أن يتمكن العامل من جعل الكاميرا تجتاز الكاميرا تكنولوجيا تكنولوجيا المعلومات. ومع ذلك، إذا تم إجراء الاختبارات بشكل مجمّع كأحد المشاهد، تبلغ احتمالية اجتياز المشهد ‎0.1% فقط.

    س6: كيف يمكنني تشغيل مشهد واحد أو إعادة ترتيب مشاهد التشغيل؟

    يشغِّل النص البرمجي tools/run_all_tests.py تلقائيًا جميع المشاهد بالترتيب. ومع ذلك، يمكن تشغيل المشاهد بشكل فردي أو بترتيب محدّد، ويمكن إبلاغ CtsVerifier.apk بها.

    لتشغيل مشهد فردي (على سبيل المثال، المشهد 2) أو تشغيل أكثر من مشهد واحد بترتيب معيّن في Android 11 أو إصدار هُو أدنى:

    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 بوصة
    • حجم الشاشة (بالبكسل): أكبر من 1920 × 1200 بكسل

    لمزيد من التفاصيل، يُرجى الاطّلاع على متطلبات الأجهزة اللوحية.

    سطوع الجهاز اللوحي

    قد لا تُظهر الاختبارات نتائج صحيحة إذا كان مستوى سطوع شاشة الجهاز اللوحي منخفضًا جدًا.

    لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة: كيف يمكنني التحكّم في سطوع الشاشة على الجهاز اللوحي؟

    مستوى الإضاءة في العلبة (يتطلب مقياس لكس)

    تأكَّد من أنّ قيمة الإضاءة المستهدفة عند فتح الجهاز اللوحي تتراوح بين 100 و 300.

    إذا كان مستوى اللوكس مرتفعًا جدًا، ستعرض scene1/test_param_flash_mode.py القيمة FAIL. إذا كان مستوى الإضاءة منخفضًا جدًا، ستتعذّر إجراء عدة اختبارات.

    س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
      

      في الإصدار 12 من نظام التشغيل Android والإصدارات الأحدث:

      python tools/run_sensor_fusion_box.py num_runs=10
      

      يتم ضبط المَعلمات الإضافية في ملف config.yml.

      تتوفّر النتائج التي يتم تنفيذها في مجلد "/tmp/tmp###" الذي تم إنشاؤه ضمن مجلدات sensor_fusion_#، حيث يشير # إلى رقم التشغيل. في ما يلي الأسباب الشائعة لعدم نجاح عملية الربط:

      1. الهاتف غير في منتصف الشاشة بشكل صحيح.
      2. لا تتوفّر ميزات كافية في الصورة (غالبًا ما تكون مشكلة في مجال الرؤية أو الإضاءة).
      3. قيمة FAIL المعروضة صالحة، ويجب تصحيح التوقيت بين الكاميرا والجيروسكوب.

    س9: ما هي المعلومات التي يجب تضمينها عند الإبلاغ عن خطأ في الاختبار؟

    عند الإبلاغ عن خطأ في الاختبار، يُرجى تضمين الملفات والصور التي تم إنشاؤها للاختبار.

    1. إذا أجريت الاختبار من خلال tools/run_all_tests.py، يُرجى إرفاق دليل /tmp/ مضغوط بالخطأ.
    2. إذا أجريت الاختبار بنفسك، يُرجى إرفاق جميع نتائج الشاشة والصور التي تم إنشاؤها بالخطأ.

    يجب أيضًا تضمين تقرير خطأ. بعد تعذُّر الاختبار المعنيّ، استخدِم الأمر التالي لإنشاء تقرير خطأ وإرفاق ملف ZIP الذي تم إنشاؤه بالخطأ.

    adb -s device_id bugreport
    

    السؤال 10: كيف يمكنني تشغيل مشهد اختبار sensor_fusion باستخدام كاميرا ذات حد أدنى لشدّة التركيز ينتج عنه صور مموّهة على مسافة الرسم البياني 25 سم؟

    إذا لم تتمكّن الكاميرا من التركيز على مسافة 25 سم، عليك إزالة لوحة تركيب الرسم البياني من صندوق دمج إشارة المستشعر. ضَع الرسم البياني على مسافة يمكن للوحدة تحت الاختبار التركيز عليها وتغيير chart_distance في config.yml إلى المسافة المقاسة بين الوحدة تحت الاختبار والرسم البياني. يعرض الشكل 5 مثالاً على كيفية قياس المسافة في الرسم البياني في هذه الحالة.

    مثال على اختبار sensor_fusion TELE6
    الشكل 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 سم. يتم تحديد نسبة قياس الرسم البياني على الجهاز اللوحي من خلال كاميرا مجال الرؤية كما هو موضّح في الجدول التالي:

    صورة الكاميرا عامل تحجيم الرسم البياني
    ‫60 > مجال الرؤية > 40 0.67x
    ‫40 > مجال الرؤية > 25 0.5x
    مجال الرؤية أقل من 25 0.33x

    س 12: باستخدام واجهة برمجة التطبيقات المنطقية متعددة الكاميرات، ما هي الاختبارات التي يتم إجراؤها على أي كاميرات؟

    إذا كانت الكاميرا تستخدم REQUEST_AVAILABLE_CAPABILITIES_LOGICAL_MULTI_CAMERA، يتم تنفيذ جميع اختبارات ITS المتوافقة على الكاميرا المنطقية ذات المستوى الأعلى. يتم تنفيذ مجموعة فرعية من اختبارات ITS على الكاميرات الفرعية المادّية، ويتم إدراج هذه الاختبارات في tools/run_all_tests.py ضمن ثابت SUB_CAMERA_TESTS.