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

مدّ

التحقق من توافق هاتفك

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

إعداد Android Debug Bridge

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

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

التحقّق من وحدات نظام تحديد المواقع العالمي (GPS) في خدمات Google Play

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

  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. انقر 7 مرّات على "إصدار Fuchsia". سيؤدي هذا إلى تفعيل خيارات المطوّرين
      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.

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

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

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

يعرض تطبيق BLE القيم بعلامة النهاية الصغيرة، غير أنّ قيم VID/PID التي تدخلها في مشروع Developer Console هي قيمة كبيرة.

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

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

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

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

الإقران

التحقق من بيانات الاعتماد الخاصة بجهازك

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

  • بيان شهادة الاعتماد (CD).
  • شهادة مصادقة الجهاز (DAC) وسلسلة شهاداتها

لمزيد من المعلومات، راجِع إنشاء شهادات اختبار أجهزة Matter.

إثبات ملكية الموزع المتوافق مع معيار Matter

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

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

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

تعذُّر إجراء عمليات التحقّق مع ظهور رسالة الخطأ "تعذّر التواصل مع Google"

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

تعذُّر التشغيل مع ظهور رسالة الخطأ "يتعذّر الوصول إلى الجهاز"

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

الاختبار

لا يظهر الجهاز الذي تم التحقّق من ملكيته في "مجموعة الاختبار".

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

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

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

راجِع معلومات الجهاز للحصول على مزيد من المعلومات.

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

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

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