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

مبنى

التأكّد من توافق هاتفك

تتوافق جميع أجهزة Android O (8.1، المستوى 27 من واجهة برمجة التطبيقات) والإصدارات الأحدث مع Matter. يُرجى اتّباع الخطوات التالية لمعرفة ما إذا كان هاتفك يتضمّن الوحدات اللازمة.

إعداد Android Debug Bridge

يجب إعداد Android Debug Bridge‏ (adb) قبل تحديد المشاكل وحلّها. للتحضير للجلسة:

  1. ثبِّت "adb" على جهاز الكمبيوتر.
  2. فعِّل خيارات المطوّرين وتصحيح أخطاء USB على هاتفك Android.

التحقّق من وحدات Matter في "خدمات Google Play"

لمعرفة ما إذا كانت لديك Google Play services Matter modules، اتّبِع الخطوات التالية:

  1. إعداد Android Debug Bridge.
  2. استخدِم كابل USB لتوصيل هاتف Android بالكمبيوتر.
  3. شغِّل الأمر التالي في الوحدة الطرفية للتأكّد من تثبيت الوحدات اللازمة Matter: 
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.home"
    إذا ظهرت لك نتيجة مشابهة للنتيجة أدناه، يعني ذلك أنّ لديك وحدات Matter مثبَّتة: 
    com.google.android.gms.home [v222110900]
     يُرجى العِلم أنّ رقم الإصدار أعلاه قد يختلف عن رقم الإصدار على جهازك.
  4. شغِّل الأمر التالي في الوحدة الطرفية للتأكّد من تثبيت الوحدات اللازمة Thread 
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.threadnetwork"
    إذا ظهرت لك نتيجة مشابهة للنتيجة في المثال التالي، يعني ذلك أنّ لديك وحدات Thread مثبَّتة: 
    com.google.android.gms.threadnetwork [v222106301]
     يُرجى العِلم أنّ رقم الإصدار على جهازك قد يختلف.

إذا لم تكن الوحدات مُدرَجة، يعني ذلك أحد الأمرين التاليين:

  1. لديك إصدار قديم من Android. تأكَّد من أنّه Android O (8.1) أو إصدار أحدث.
  2. لم يتم تنزيل وحدات Matter بعد. انتظِر 24 ساعة على الأقل لتنزيلها. تأكَّد من تشغيل جهازك وشحنه خلال هذه الفترة، حتى لا يتأخر التنزيل. إذا لم تتلقَّ الوحدات خلال 24 ساعة، يمكنك محاولة إعادة ضبط الجهاز على الإعدادات الأصلية لإجبار الوحدات على التنزيل.

التحقّق من معرّف المورّد (VID) ومعرّف المنتج (PID) لجهازك

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

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

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

  • معرّفات المورّد (VID) 0xFFF1 — 0xFFF4 محجوزة للاختبار. يمكن استخدامها لإجراء اختبارات أساسية للإعداد والتحكّم، ولكن لا يمكن استخدامها خلال مراحل التطوير التالية:

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

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

يعرض تطبيق BLE القيم بتنسيق little endian، ولكن قيم معرّف المورّد (VID) ومعرّف المنتج (PID) التي تُدخلها في مشروعك Developer Console تكون بتنسيق big endian.

تأكَّد من إدخال القيم والتنسيق الصحيحَين في مشروع Actions Console استنادًا إلى ما يعرضه جهاز تتبُّع البلوتوث.

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

التأكّد من أنّ جهازك تم إنشاؤه باستخدام فرع متوافق من حزمة تطوير البرامج (SDK) الخاصة بـ Matter

تتوافق مراكز Google Matter مع Matter 1.0 وتم اختبارها باستخدام إصدارات استخدَمت عمليات تثبيت من الفرع الثابت v1.0-branch. راجِع ملاحظات الإصدار العلني للاطّلاع على عمليات التثبيت المحدّدة التي يُنصح باستخدامها مع كل إصدار جديد من المركز.

جارٍ الإقران

التأكّد من بيانات اعتماد جهازك

عند استخدام Alliance-معرّف المورّد (VID) الذي خصّصه التحالف، تأكَّد من أنّ لديك بيانات الاعتماد الصحيحة على الجهاز:

  • إعلان الاعتماد (CD)
  • شهادة إثبات ملكية الجهاز (DAC) وسلسلة الشهادات الخاصة بها

لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إنشاء شهادات اختبار لجهاز Matter.

التأكّد من أنّ المركز متوافق مع Matter

يجب أن يكون مركز Matter أحد المراكز التي تتيحها Google. يجب أيضًا أن يكون على إصدار متوافق مع Matter.

تعمل بعض المراكز أيضًا كـ **أجهزة توجيه لحدود شبكة Thread**، ما يتيح لك تطوير أجهزة Thread واختبارها. لا تتيح المراكز الأخرى سوى أجهزة Wi-Fi وEthernet Matter، ما لم يكن لديك جهاز توجيه آخر لحدود الشبكة في شبكتك لتفعيل إمكانية الاتصال بشبكة Thread.

يمكنك التحقّق من إصدار المركز من خلال: التمرير سريعًا بإصبعك لأسفل من الحافة العلوية > رمز "عجلة الإعدادات" > معلومات الجهاز > المعلومات الفنية > إصدار البرامج الثابتة لجهاز Chromecast

فشل عملية الإعداد وظهور رسالة الخطأ "تعذّر التواصل مع Google"

تأكَّد من إنشاء عملية دمج تتضمّن مجموعة معرّف المورّد (VID) ومعرّف المنتج (PID) الصحيحة في Developer Console. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إنشاء عملية دمج Matter.

فشل عملية الإعداد وظهور رسالة الخطأ "لا يمكن الوصول إلى الجهاز"

إذا استمر ظهور رسالة الخطأ "لا يمكن الوصول إلى الجهاز" عند إعداد جهاز Thread، وسبق لك تجربة جميع خيارات تصحيح الأخطاء المتاحة، قد تحتاج إلى محو بيانات اعتماد Thread المفضّلة المخزّنة على هاتف Android لإجراء عملية إعداد نظيفة من خلال الإعدادات > التطبيقات > جميع التطبيقات > خدمات Google Play > مساحة التخزين المؤقت والذاكرة > إدارة المساحة > محو جميع البيانات.Thread

الاختبار

لا يظهر الجهاز الذي تم إعداده في Test Suite

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

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

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

لمزيد من المعلومات، يُرجى الاطّلاع على مقالة معلومات الجهاز.

إذا استمرت المشاكل

إذا لم يتم حلّ مشكلتك بعد اتّباع جميع خطوات تحديد المشاكل وحلّها هنا، لا بأس في ذلك.

في خطوات تحديد المشاكل وحلّها، جمعت بيانات مهمة عن جهازك ومشروعك في Console وبيئتك. باستخدام هذه البيانات، راجِع صفحة الدعم لمعرفة أفضل طريقة لمشاركة مشكلتك مع المنتدى وفريق دعم Google Home.