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

مبنى

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

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

إعداد Android Debug Bridge

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

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

إثبات ملكية وحدات Matter في "خدمات Google Play" (GPS)

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

  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

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

  • ‫0xFFF1 و0xFFF4 من VID محجوزان للاختبار. يمكن استخدامها لإجراء اختبارات أساسية بشأن التشغيل والتحكّم، ولكن لا يمكن استخدامها خلال مراحل التطوير التالية:

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

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

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

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

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

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

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

جارٍ الإقران

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

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

  • إقرار الشهادة (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 > مساحة التخزين وذاكرة التخزين المؤقت > إدارة المساحة > محو جميع البيانات.

الاختبار

لا يظهر الجهاز الذي تم إعداده في "مجموعة الاختبار"

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

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

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

يمكنك الاطّلاع على معلومات الجهاز لمزيد من المعلومات.

في حال استمرار المشاكل

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

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