تحديد مشاكل 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 ، اتّبِع الخطوات التالية:

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

سجلات أجهزة Fuchsia Hub

لتفعيل مركز لاسترداد السجلات المحلية:

  1. أرسِل رسالة إلكترونية تحتوي على الرقم التسلسلي وطراز أجهزتك إلى جهاز "Technical Account Manager (TAM)" في Google. ويمكن العثور عليها بأحرف صغيرة أسفل الجهاز.
  2. بعد إدراج الميزة في القائمة المسموح بها، عليك تفعيل الميزة باتّباع الخطوات التالية:
    • من المركز:
      1. التمرير سريعًا لأسفل الشاشة من أعلاها
      2. انقر على رمز "الإعدادات" .
      3. البحث عن إصدار Fuchsia: على جهاز Google Nest Hub (2nd gen)، انتقِل إلى معلومات الجهاز > المعلومات الفنية > إصدار Fuchsia.
      4. انقر على "إصدار Fuchsia" 7 مرات. سيؤدي ذلك إلى تفعيل خيارات المطوّرين.
      5. الرجوع إلى قائمة المستوى الأعلى
      6. انقر على "خيارات المطوّرين".
      7. انقر على "تسجيل بيانات الشركاء".
    • سيتم تفعيل الميزة لمدة 24 ساعة. بعد ذلك، عليك إعادة تفعيل ميزة التسجيل من الخطوة 5 فصاعدًا.
  3. الحصول على عنوان IP الخاص بالمركز:
    • من المحور، إذا كان يحتوي على شاشة:
      1. التمرير سريعًا لأسفل الشاشة من أعلاها
      2. انقر على رمز الإعدادات .
      3. العثور على عنوان IP للجهاز: على Nest Hub (2nd gen)، انتقِل إلى معلومات الجهاز > المعلومات الفنية > عنوان IP.
    • من Google Home app (GHA) على هاتفك:
      1. انقر على الجهاز لعرض صفحة تفاصيله.
      2. انقر على رمز الإعدادات لعرض صفحة الإعدادات.
      3. العثور على عنوان IP للجهاز: انتقِل إلى معلومات الجهاز > المعلومات الفنية > عنوان IP.
  4. لاسترداد السجلات من الموزّع، ستُجري طلب GET HTTP إلى الموزع من جهاز كمبيوتر متصل بشبكة Wi-Fi نفسها.
    • يُرجى تدوين المنفذ ومسار نقطة النهاية: 
      curl -k -X GET https://ip-address:8443/setup/get_logs --output output-file
    • يمكن إبقاء الاتصال مفتوحًا لمدة دقيقة واحدة فقط، ولكن البيانات التي يتم استرجاعها من المخزن المؤقت عادةً ما تتضمّن أحداثًا سابقة تتراوح مدتها بين 20 و30 دقيقة.
      • من المفترَض أن يتم استخراج السجلّات باستخدام هذه الطريقة فور إكمال إجراء الاختبار للتأكّد من احتواء المخزن المؤقت على محتوى ذي صلة بالاختبار (على غرار تقارير الأخطاء في Android).

إيقاف ميزة إخفاء محتوى سجلّات Android

  • من أجل الخصوصية والأمان، يجب عدم استخدام هذه الميزة إلا لأغراض الاختبار الهندسي.
  • لا تستخدم هذا الخيار مع أجهزة الإنتاج أو المستخدمين.
  • الخطوات:
    1. يمكنك إرسال حسابات Google للمستخدمين الذين سيكون لديهم سجلات غير مخفيّة إلى TAM في Google.
    2. بعد تأكيد إضافة حسابك إلى القائمة المسموح بها، يُرجى إعادة تشغيل الهاتف.

التحقّق من رقمَي VID/PID لجهازك

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

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

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

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

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

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

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

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

بالنسبة إلى القيم الواردة في مثال لقطة الشاشة، ستكون قيم 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، ونفدت كل خيارات debugging المتاحة، ننصحك بمحو بيانات اعتماد Thread المفضّلة المخزّنة على هاتف Android لإجراء عملية إعداد جديدة من خلال الإعدادات > التطبيقات > تطبيقات التطبيقات > خدمات Google Play > مساحة التخزين وذاكرة التخزين المؤقت > إدارة المساحة > محو كل البيانات.

الاختبار

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

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

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

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

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

في حال استمرار حدوث أخطاء

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

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