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

تشكّل "مجموعة اختبار صور الكاميرا" (ITS) في نظام التشغيل Android جزءًا من أداة التحقّق من مجموعة اختبار التوافق (CTS) في نظام التشغيل Android، وتتضمّن اختبارات تتحقّق من محتوى الصور. تتيح أداة CTS Verifier إمكانية التشغيل الآلي لاختبارات ITS باستخدام Camera ITS-in-a-box، وتغطي إمكانية إجراء الاختبارات اليدوية جميع أشكال أجهزة Android.

تتضمّن حزمة "نظام النقل الذكي المتكامل" المزايا التالية:

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

اختيار منصة الحفر

تتألف ITS-in-a-box من صندوق بلاستيكي مقطوع بالليزر من رسومات التصميم بمساعدة الكمبيوتر (CAD)، وجهاز لوحي للرسومات البيانية، وجهاز قيد الاختبار (DUT). يوضّح الجدول التالي الميزات والمواصفات الخاصة بمنصات ITS-in-a-box المختلفة المتوفّرة. لاختيار جهاز الاختبار المناسب، يجب مراعاة مجال الرؤية المحدّد وأدنى مسافة تركيز لجهاز الاختبار. بالنسبة إلى أنظمة الكاميرات التي تتراوح زاوية مجال رؤيتها بين 60 و110 درجات وتبلغ مسافة التركيز الدنيا فيها بين 22 و31 سم، ننصح باستخدام حامل ثلاثي القوائم معياري بسبب قابليته للتكيّف. إذا كان نظام الكاميرا يتضمّن عدسة مقرّبة بمسافة تركيز دنيا تتراوح بين 31 سم و110 سم، ننصح باستخدام حامل أساسي معياري مع وصلة مقرّبة تتطابق بشكل كبير مع مسافة تركيز العدسة. تتوفّر وصلات التلسكوب بأطوال تتراوح بين 50 سم و90 سم.

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

    لبدء استخدام Camera ITS-in-a-box، اتّبِع الخطوات التالية:

    1. شراء أو إنشاء وحدة أو WFoV أو RFoV و Sensor Fusion ITS-in-a-box
    2. ضبط جهاز لوحي باستخدام برنامج Camera ITS
    3. إجراء الاختبارات
    4. الحصول على النتائج من الجهاز الخاضع للاختبار

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

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

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

    1. اشحن الجهاز اللوحي وشغِّله. إذا طُلب منك إعداد حساب، يمكنك تخطّي هذه الخطوة (لا تتطلّب أداة Camera ITS أي حساب مقترن بالجهاز اللوحي).
    2. يجب تحديث الجهاز اللوحي إلى الإصدار 7.0 أو إصدار أحدث من Android. لا تتوافق الإصدارات 6.x من نظام التشغيل Android والإصدارات الأقدم مع Camera ITS.
    3. فعِّل وضع مطوّر البرامج.
    4. ارجع إلى الإعدادات وانقر على خيارات المطوّرين.
      تفعيل الخيارات
      • تشغيل
      • البقاء في الوضع النشط
      • تصحيح أخطاء الجهاز عبر USB (يسمح هذا الخيار للجهاز المضيف بتشغيل الجهاز اللوحي في وضع تصحيح الأخطاء. عند توصيل الجهاز اللوحي بالمضيف للمرة الأولى، سيطلب الجهاز اللوحي منك الإذن بالسماح بتصحيح أخطاء USB. إذا لم تعرض الجهاز اللوحي رسالة تصحيح الأخطاء، افصل الجهاز اللوحي ثم أعِد توصيله.)
      إيقاف الخيارات
      • تحديثات النظام التلقائية
      • التحقق من التطبيقات عبر USB
    5. حدِّد معرّفات الجهاز قيد الاختبار ومعرّفات الرسم البياني من خلال تنفيذ $ 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) عالي الدقة مقاس 10 بوصة لعرض المشاهد، الرقم التسلسلي: 5811000011
    • جهاز واحد (1) قيد الاختبار مثبَّت عليه تطبيق CTS Verifier 7.0_8+. مثال على الجهاز الخاضع للاختبار:
      • هاتف Pixel واحد (1) برقم الطراز NOF26W لاختبار الكاميرا الخلفية(0)، والرقم التسلسلي: 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: FA6BM0305016
    الشكل 1. رقم تسلسلي للكاميرا 0: FA6BM0305016

    إعادة محاولة إنشاء المَشاهد

    يمكنك إعادة محاولة التقاط المشاهد لكاميرا واحدة باتّباع الخطوات التالية:

    • لإعادة محاولة التقاط المشاهد على كاميرا واحدة، اتّبِع الخطوات التالية:
      python tools/run_all_tests.py device=FA6BM0305016 camera=0 scenes=3,4
      

    تشغيل المشهد 5

    يتطلّب المشهد 5 إعدادًا خاصًا مع إضاءة محدّدة (للحصول على التفاصيل، يُرجى الرجوع إلى CameraITS.pdf في CTS Verifier، والذي يمكنك تنزيله من عمليات تنزيل "مجموعة أدوات اختبار التوافق"). يجب تشغيل المشهد 5 بشكل منفصل (خارج المربع) وباستخدام منصة الاختبار TEST_BED_MANUAL.

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

    الأجهزة اللوحية المتوافقة مع المشاهد ذات الإضاءة المنخفضة

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

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

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

    جهاز حجم شاشة العرض
    (بالبوصة)
    حجم شاشة العرض
    (بالبكسل)
    أبعاد الجهاز اللوحي
    (بالبوصة)

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

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

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

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

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

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

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

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

    يتم تقديم مجموعة من أمثلة الإعدادات في الجدول أدناه.

    أدنى مسافة للتركيز مجالات رؤية الكاميرا REALTIME? أجهزة محاكاة مقترَحة الملاحظات
    ‫31 سم - 22 سم 75°‎ لا قاعدة معيارية أو مجال رؤية واسع أو مجال رؤية محدود الإصدار 7.0 من نظام التشغيل Android أو إصدار أحدث
    ‫31 سم - 22 سم 75°‎ نعم قاعدة معيارية أو مجال رؤية واسع أو مجال رؤية محدود ودمج البيانات الحسية الإصدار 9 من Android أو الإصدارات الأحدث
    ‫22 سم أو أقل ‫75 درجة مئوية + 95 درجة مئوية نعم قاعدة معيارية أو مجال رؤية واسع ودمج بيانات المستشعرات الإصدار 9 من Android أو الإصدارات الأحدث
    ‫110 سم - 22 سم 75° + 95° + 20° نعم قاعدة معيارية وعدسة مقربة وإمكانية دمج البيانات من المستشعرات الإصدار 9 من Android أو الإصدارات الأحدث
    ‫110 سم - 22 سم 75° + 95° + 20° نعم قاعدة معيارية ووصلة تمديد عن بُعد ودمج بيانات المستشعرات وجهاز الجيل الثاني
    ‫22 سم أو أقل 75° + 95° Tablet لا WFoV الإصدار 9 من Android أو الإصدارات الأحدث

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

    لتحديد جهاز الاختبار الصحيح، تأكَّد من صحة مَعلمة مسافة الرسم البياني. تبلغ مسافة المخطط في جهاز الاختبار rev1 (مجال الرؤية المحدود) 31 سم، وتبلغ مسافة المخطط في جهاز الاختبار rev2 (مجال الرؤية الواسع) 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 والإصدارات الأحدث

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

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

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

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

    لتغيير مستوى السطوع على الأجهزة اللوحية التي تعمل بنظام التشغيل 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. من خلال إجراء كل اختبار على حدة، تزداد فرص نجاح الكاميرا في اجتياز اختبار Camera ITS. في المقابل، إذا تم إجراء الاختبارات بشكل مجمّع كمشهد، لن تتجاوز نسبة نجاح المشهد% 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. تأكَّد من توصيل وحدة التحكّم في دمج البيانات الحسية من خلال تحديد ما إذا كانت شركة Microchip Technology متصلة بمنفذ USB.

      lsusb
      …
      Bus 003 Device 004: ID 04d8:fc73 Microchip Technology, Inc.
      …
      
    3. نفِّذ الاختبار عدة مرات للحصول على توزيع لمحاولات الاختبار باستخدام الأوامر التالية.

      في الإصدار 11 من نظام التشغيل Android أو الإصدارات الأقدم:

      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 TELE testing example6
    الشكل 5. قياس مسافة لوحة الاختبار لمشهد اختبار دمج المستشعرات
      edit config.yml
    chart_distance: 25 → chart_distance: DISTANCE_BETWEEN_DUT_AND_CHART
    

    السؤال 11: كيف يمكنني تشغيل مشاهد اختبار الأجهزة اللوحية لكاميرا بمسافة تركيز دنيا تؤدي إلى إنشاء صور غير واضحة على مسافة 31 سم من لوحة الاختبار؟

    إذا كانت الكاميرا لا تنتج صورًا حادة بما يكفي عند اختبارها على مسافة 31 سم (عمق جهاز اختبار مجال الرؤية المحدود)، ثبِّت الكاميرا أمام جهاز الاختبار على مسافة تسمح لمشهد المخطط بملء% 60 تقريبًا من مجال رؤية الكاميرا بصور أكثر حدة. ويمكن أن تكون هذه المسافة أقل من الحد الأدنى لمسافة التركيز في الكاميرا. اترك 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.