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

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

تشمل حزمة ITS-in-a-box المزايا التالية:

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

البدء

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

Rig المسافة في الرسم البياني نطاق مجال رؤية كاميرا 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. شراء أو إنشاء منظومة ITS جاهزة للاستخدام من نوع الوحدات المُدمجة أو WFoV أو RFoV
    2. إعداد جهاز لوحي باستخدام برنامج ITS للكاميرا
    3. إجراء الاختبارات
    4. الحصول على النتائج من جهاز DUT

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

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

    ملاحظة: تضبط نصوص Python البرمجية لنظام ITS للكاميرا تلقائيًا الخيارات التالية على الجهاز اللوحي نيابةً عنك:
    الإعدادات > الشاشة > وضع السكون > بعد 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، تأكَّد من أنّ إعداد الاختبار يتضمّن الأجهزة والبرامج التالية:

    • وحدة ITS-in-a-box واحدة (1)
    • جهاز لوحي واحد (1) بدقة عالية مقاس 10 بوصة لعرض المشاهد، الرقم التسلسلي: 5811000011
    • جهاز اختبار واحد (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 و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، والتي يمكنك تنزيلها من عمليات تنزيل مجموعة أدوات اختبار التوافق). يجب تشغيل المشهد 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.
        تقارير أنظمة النقل الذكية بالكاميرا
        الشكل 4. تقارير تكنولوجيا المعلومات والاتصالات (ITS) بالكاميرا

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

    بالنسبة إلى الإصدار 15 من Android والإصدارات الأحدث، يجب أن تكون الأجهزة اللوحية المستخدَمة لعرض الرسم البياني 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 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 x ‏6.03 x ‏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 x 6.64 x 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 x ‏6.22 x ‏0.28 192 yunluo الإصدار 14 من نظام التشغيل Android والإصدارات الأحدث
    Xiaomi
    Redmi
    Pad SE    		 11 2560 × 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 والإصدارات الأحدث

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

    يجب أن يكون حجم شاشة الجهاز اللوحي 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
    Pad 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 x ‏6.03 x ‏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 أو إصدار أحدث
    Chuwi
    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 x 6.44 x 0.28 192 8 الإصدار 7 من نظام التشغيل Android أو الإصدارات الأحدث الإصدار 6 من نظام التشغيل Android أو الإصدارات الأحدث
    ‫Huawei
    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 x 6.57 x 0.24 192 8 الإصدار 7 من نظام التشغيل Android أو الإصدارات الأحدث الإصدار 5 من نظام التشغيل Android والإصدارات الأحدث

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

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

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

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

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

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

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

    في الجدول أدناه، يمكنك الاطّلاع على مجموعة من أمثلة الإعدادات.

    مثال زوايا رؤية الكاميرا REALTIME? الأجهزة المقترَحة الملاحظات
    1 75° لا قاعدة وحدات أو الإصدار 1 أو الإصدار 2 الإصدار 7.0 من Android أو إصدار أحدث
    2 75° نعم قاعدة وحدات أو الإصدار 1 أو الإصدار 2 ودمج البيانات من أجهزة الاستشعار الإصدار 9 من Android أو إصدار أحدث
    3 ‫75° + 95° نعم قاعدة وحدات أو الإصدار 2 ودمج البيانات من أجهزة الاستشعار الإصدار 9 من Android أو إصدار أحدث
    4 75° + 95° + 20° نعم قاعدة وحدات ووحدة تمديد مقروءة عن بُعد ودمج المستشعرات الإصدار 9 من Android أو إصدار أحدث
    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.

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

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

    على سبيل المثال، لنفترض أنّ هناك 10 اختبارات في مشهد يحمل كلّ منها احتمالية% 50 لعرض القيمة PASS. من خلال إجراء كل اختبار بشكلٍ فردي، من المرجّح أن يتمكّن المشغّل من مساعدة الكاميرا على اجتياز اختبار 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 متصلة بمنفذ 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 سم. يتم تحديد نسبة قياس الرسم البياني على الجهاز اللوحي من خلال ملفtered FoV للكاميرا كما هو موضّح في الجدول التالي:

    مجال رؤية الكاميرا عامل تحجيم الرسم البياني
    ‫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.