اختبار عملية دمج لمعيار Matter

توفّر Google Home Developer Console صفحة اختبارية يمكنك من خلالها ضبط وإجراء الاختبارات مقابل عملية دمج Matter باستخدام Google Home Test Suite. Test Suite هو تطبيق منفصل مُدمَج في Developer Console، ويعالج جميع اختبارات الدمج.

لكي يتم اختبار الأجهزة، يجب أن تكون الأجهزة الخاصة بمعرّف المورّد ومعرّف المنتج لعملية الدمج محدّدة وأن تكون متاحة في Google Home app (GHA) للحساب المستخدَم في Developer Console. راجِع إقران جهاز متوافق مع معيار Matter للحصول على مزيد من المعلومات.

يمكن تشغيل Test Suite على مجموعة من الأجهزة التي تنتمي إلى إعدادات مشروع Matter محدّد. من المهم جدًا تشغيل Test Suite في عمليات الدمج لضمان سير الأمور بشكل صحيح.

في صفحة الاختبار، يتم إدراج عمليات دمج Matter المكتملة والجاهزة للاختبار في جاهز للاختبار.

يتم سرد عمليات دمج Matter التي تم اختبارها في القسم الاختبار.

نوع خطط الاختبار

هناك نوعان من خطط الاختبار:

  • تُستخدم خطط الاختبار التطوير لاختبار التحكم في الأجهزة باستخدام Matter. إنها قابلة للتعديل، ولكن لا يمكن إرسالها للحصول على شهادة Matter.

  • خطط اختبار الشهادة مخصّصة للحصول على شهادة Matter، وغير قابلة للتعديل. سيؤدي تحديد هذا الخيار إلى إنشاء نسخة جديدة من عملية دمج خدمة Matter.

إصدارات الدمج

عند إنشاء خطة اختبار للحصول على الشهادة، يتم إنشاء نسخة جديدة من عملية الدمج. يتم إدراج هذه النسخة المرقّمة في جميع قوائم الدمج في Developer Console من علامة التبويب "اختبار" فصاعدًا.

لا يتم مطلقًا إنشاء نُسخ جديدة من نُسخ مُرقَّمة أخرى. على سبيل المثال، أول خطة الاختبار التي تنشئها لعملية الدمج ستنشئ الإصدار v.1 لعملية الدمج هذه. وسيؤدي إنشاء خطة اختبار أخرى إلى إنشاء الإصدار v.2 من عملية الدمج هذه، إلا أن هذا الإصدار لن يعتمد على v.2. بدلاً من ذلك، يستند هذا الإصدار إلى مثيل الدمج الذي لم يتم إصدار نسخة منه، كما هو الحال في v.1.

تمثل النسخة غير متوفرة من عملية الدمج النسخة غير المقيَّمة من عملية الدمج، والتي تتم إدارتها من خلال علامة التبويب تطوير.

بمعنى آخر، في Matter > اختبار في Developer Console:

  • إذا نقرت على اختبار للنسخة لا ينطبق من عملية الدمج، يتم إنشاء نسخة جديدة. سيكون رقم الإصدار أعلى من أي نُسخ مرقمة موجودة حاليًا.
    • في حالة عدم وجود نسخ مرقمة، يتم إنشاء الإصدار v.1.
    • في حالة وجود الإصدار v.1، يتم إنشاء الإصدار v.2. في حالة وجود الإصدار v.2، يتم إنشاء الإصدار v.3 وهكذا.
  • في حال النقر على اختبار للاطّلاع على نسخة مرقّمة من عملية الدمج (على سبيل المثال، v.1v.1 يتم إنشاء نسخة جديدة. بدلاً من ذلك، يتم اختبار الإصدار v.1 مرة أخرى.

لمزيد من المعلومات، يُرجى الاطّلاع على إصدارات الدمج.

إنشاء خطة اختبار

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

قبل إنشاء خطة اختبار للحصول على الشهادة، يجب الحرص على تنفيذ ما يلي:

  1. إنشاء ملف شخصي للشركة.
  2. إدخال معرّف مورّد الإنتاج (VID) لعملية الدمج.
  3. تم ضبط الإعداد والعلامة التجارية.

في حال عدم إكمال جميع هذه الخطوات في عملية الدمج، لا يمكن الحصول على شهادة نسخة دمج تم إنشاؤها لاختبار الشهادة. سيتعين عليك إنشاء نسخة جديدة، وهو ما يعني إعادة خطوات الاختبار والتجربة الميدانية والاعتماد.

سيكون عليك أيضًا إنشاء إصدار جديد والبدء من جديد إذا كنت تريد تعديل علامتك التجارية قبل اعتماد إصدار الدمج.

لإنشاء خطة اختبار:

الانتقال إلى Play Console

  1. من قائمة المشاريع، انقر على فتح بجانب المشروع المطلوب العمل عليه.

  2. في قائمة التنقّل على يمين الصفحة، انتقِل إلى Matter > اختبار.

  3. انقر على اختبار للاطّلاع على الإصدار غير متاح لعملية الدمج التي تريد اختبارها. يؤدي هذا الإجراء إلى إنشاء نسخة دمج جديدة.

  4. اختر نوع اختبار اختبار التطوير أو اختبار الشهادة. إنشاء خطة اختبار جديدة

    • اختَر اختبار الشهادة إذا كنت تستعد للحصول على شهادة في منظومة Google المتكاملة.
    • لا يمكن استخدام اختبار التطوير للحصول على الشهادة.
  5. انقر على اختبار. إذا ظهرت لك شاشة الخطأ لم يتم العثور على أي جهاز، يعني هذا أنّ الجهاز لإجراء عملية الدمج هذه لم يتم إدراجه في المنظومة المتكاملة إلى الآن. راجِع تحديد مشاكل الإقران وحلّها للحصول على مزيد من المعلومات.

  6. على شاشة إعداد الاختبار، أدخِل اسمًا للاختبار واختَر الأجهزة التي تريد اختبارها من قائمة الأجهزة.

  7. انقر على الزر التالي: الخطة التجريبية.

  8. في صفحة إنشاء خطة اختبار، وفي قسم مجموعات الاختبار، اختَر مجموعات الاختبار التي تريد تشغيلها.

إنشاء خطة اختبار

إذا كنت تريد الخروج من Test Suite، انقر على الرجوع إلى مركز مطوّري البرامج.

تنفيذ خطة الاختبار

في Test Suite، من صفحة إنشاء خطة اختبار، انقر على إجراء الاختبار. تظهر صفحة بيئة الاختبار مع حالة جميع الاختبارات وسجلاتها.

تظهر نتائج الاختبار بعد اكتماله. وتظهر حالة كل عملية تنفيذ لمجموعة اختبار بجانبها (تم بنجاح، فشل).

يعرض جزء السجلات حالة كل عملية تنفيذ اختبار فردية.

نتائج الاختبار

لإعادة اختبار خطة اختبار من صفحة بيئة الاختبار، انقر على إعادة الاختبار في الأعلى بعد اكتمال تنفيذ الاختبار.

بعد الانتهاء:

عرض نتائج الاختبار وتفسيرها

في صفحة سجلّ الاختبارات في Test Suite، يمكنك الاطّلاع على نتائج الاختبارات السابقة لخطة التطوير أو خطة اختبار الشهادة التي لم يتم إرسالها، وذلك بالنقر على إعادة الاختبار لخطة الاختبار المطلوبة ضمن قسم الخطط التجريبية. ينقلك ذلك إلى صفحة بيئة الاختبار التي تعرض نتائج ذلك الاختبار.

سجلّ الاختبار

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

يمكن أيضًا الوصول إلى نتائج الاختبار لإصدار مُدمَج من علامة التبويب اختبار في Developer Console. انقر على عرض للانتقال إلى سجلّ الاختبار لأي نسخة دمج مُدرَجة في تلك الصفحة ليتم نقلها إلى صفحة سجلّ الاختبار في Test Suite.

حالات وحدة التحكّم

يتم عرض حالات وحدة التحكّم التالية في مرحلة الاختبار:

Section الحالة الوصف المتطلبات الإجراءات التي يجب اتخاذها كخطوة تالية
جاهز للاختبار هيّا بنا هذا الإصدار من integration جاهز للاختبار. لا ينطبق اختبِر هذا الإصدار من integration.
تم الاختبار هيّا بنا تم اختبار هذا الإصدار من integration ويمكن إرساله للحصول على فترة تجريبية أو الحصول على شهادة.

تم اختبار الإصدار وحفظه.

وتشمل جميع حالات الاختبار التي تعذّر إجراؤها مبررًا لتراجعه Google.

يمكنك إعادة الاختبار إذا أردت ذلك.

تحديد المشاكل وحلّها

لا يظهر الجهاز الذي تم التحقّق منه في مجموعة الاختبار

في حال إقران جهاز مع معرِّف مورّد اختبار (VID) ومعرّف منتج (PID)، ولكنه لا يظهر عند محاولة اختبار الجهاز مع مجموعة الاختبار في Developer Console، من المحتمل أن يرجع ذلك إلى استخدام تركيبة VID وPID نفسَيهما في عمليات دمج متعدّدة.

لتحديد المشاكل وحلّها، يجب إزالة جميع أجهزة الاختبار من Developer Console وإقران الجهاز الذي تريد اختباره مرة أخرى.

للتحقّق من إقران الجهاز الصحيح، يمكنك ضبط معلومات الشركة المصنّعة والطراز (قيم CHIP_DEVICE_CONFIG_DEVICE_*) للجهاز على قيم فريدة في البرامج الثابتة للاختبار.

راجع معلومات الجهاز للحصول على مزيد من المعلومات.

التحقّق من معرِّف VID/PID لجهازك

إذا أردت بدء تطوير عملية الدمج مع Google، عليك إنشاء مشروع وعملية دمج على Google Home Console.

تحديد المشاكل وحلّها في أداة Bluetooth Sniffer

يجب أن تتطابق قيمة VID/PID التي يشير إليها جهازك مع قيمة VID/PID التي تم إدخالها في مشروع Developer Console.

باستخدام تطبيق هندسة بلوتوث، مثل nRF Connect for Mobile، يمكنك الاطّلاع على معرِّف VID/PID لجهاز الإشارة في حقل بيانات الخدمة.

في لقطة الشاشة هذه من إصدار Android من nRF Connect، سيظهر معرِّف VID/PID على أنّه 5A23FFFE بدءًا من البايت الرابع من حقل بيانات الخدمة. يشير هذا إلى معرّف VID لـ 5A23 ومعرّف PID لـ FFFE، وكلاهما بتنسيق داخلي صغير.

يعرض تطبيق BLE القيم باستخدام النهاية الصغيرة، غير أنّ قيم VID/PID التي تُدخلها في مشروع Developer Console تكون ثابتة بشكل كبير.

تحقَّق من أنه تم إدخال القيم والتنسيق الصحيحَين في مشروع وحدة تحكم المهام استنادًا إلى ما تعرضه أداة Bluetooth snifence.

بالنسبة إلى القيم في مثال لقطة الشاشة، سيظهر معرِّف VID وPID في Developer Console على 235A وFEFF على التوالي.