تحديد مشاكل 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. راجِع ملاحظات الإصدار العلني للاطّلاع على عمليات الإرسال المحدّدة التي يُنصح باستخدامها مع كل إصدار جديد من المحور.

جارٍ الإقران

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

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

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

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

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

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

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

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

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

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

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

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

الاختبار

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

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

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

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

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

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

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

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