تحديد مشاكل 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.

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

يجب أن تتطابق قيمة 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، وكلاهما بتنسيق little endian.

يعرض تطبيق 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 على أفضل نحو.