عیب‌یابی Matter

ساختمان

مطمئن شوید تلفنتان سازگار است

همه دستگاه‌های دارای Android O (نسخه ۸.۱، سطح میانای برنامه‌سازی کاربردی ۲۷) و جدیدتر با Matter سازگار هستند. مراحل زیر را دنبال کنید تا ببینید تلفنتان ماژول‌های لازم را دارد یا نه.

راه‌اندازی Android Debug Bridge

پیش‌از عیب‌یابی باید «پل اشکال‌زدایی Android» (adb) راه‌اندازی شود. برای راه‌اندازی:

  1. «adb» را در رایانه‌تان نصب کنید.
  2. «گزینه‌های توسعه‌دهنده» و «اشکال‌زدایی USB» را در تلفن Android روشن کنید.

درستی‌سنجی کردن واحدهای Matter «خدمات Google Play» (GPS)

برای بررسی اینکه آیا ماژول‌های Google Play services Matter را دارید، کارهای زیر را انجام دهید:

  1. راه‌اندازی کردن «پل اشکال‌زدایی Android».
  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 هنوز بارگیری نشده‌اند. حداقل ۲۴ ساعت صبر کنید تا بارگیری شوند. مطمئن شوید دستگاهتان در این مدت روشن و درحال شارژ باشد تا بارگیری به‌تأخیر نیفتد. اگر مدول‌ها را ظرف ۲۴ ساعت دریافت نکردید، می‌توانید دستگاه را بازنشانی داده‌های کارخانه کنید تا مدول‌ها به‌اجبار بارگیری شوند.

درستی‌سنجی کردن VID/PID دستگاه

اگر می‌خواهید توسعه ادغام با Google را شروع کنید، باید پروژه و ادغامی در Google Home Console ایجاد کنید.

عیب‌یابی «شنودگر بلوتوث»

مقدار 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 وارد می‌کنید به‌صورت «بایت باارزش در ابتدا» است.

براساس آنچه ردیاب بلوتوث نشان می‌دهد، بررسی کنید که مقادیر و قالب درست در پروژه «کنسول Actions» شما وارد شده باشد.

برای مقادیر موجود در نماگرفت نمونه، VID و PID در Developer Console به‌ترتیب 235A و FEFF خواهد بود.

تأیید کنید که دستگاهتان بااستفاده از شاخه سازگار Matter SDK ساخته شده است

هاب‌های Google Matter با Matter 1.0 سازگارند و با ساخت‌هایی که از ثبت‌های شاخه پایدار v1.0-branch استفاده می‌کنند آزمایش شده‌اند. برای اطلاع از commitهای خاصی که برای استفاده با هر نسخه جدید کانون توصیه می‌شود، یادداشت‌های انتشار عمومی را بررسی کنید.

جفت‌سازی

درستی‌سنجی کردن اطلاعات کاربری دستگاه

وقتی از Allianceشناسه فروشنده اختصاص‌داده‌شده خودتان استفاده می‌کنید، مطمئن شوید که اعتبارنامه صحیح را در دستگاه داشته باشید:

  • اظهارنامه گواهینامه (CD).
  • گواهی تصدیق دستگاه (DAC) و زنجیره گواهی آن.

برای اطلاعات بیشتر، ایجاد گواهی‌های آزمایشی دستگاه Matter را ببینید.

درستی‌سنجی کردن «کانون» سازگار با Matter

کانون Matter شما باید یکی از کانون‌های پشتیبانی‌شده توسط Google باشد. همچنین باید روی ساخت سازگار با Matter باشد.

برخی‌از هاب‌ها همچنین Thread Border Router (TBR) هستند و بنابراین به شما امکان می‌دهند دستگاه‌های Thread را توسعه دهید و آزمایش کنید. سایر هاب‌ها فقط از دستگاه‌های Wi-Fi و اترنت Matter پشتیبانی می‌کنند، مگراینکه border router دیگری در شبکه‌تان داشته باشید تا اتصال Thread را فعال کند.

ساخت کانون شما ممکن است با این روش تأیید شود: لغزاندن انگشت از لبه بالا به پایین > چرخ پیکربندی > اطلاعات دستگاه > اطلاعات فنی > نسخه سفت‌افزار Chromecast

راه‌اندازی با پیام خطای «امکان تماس با Google وجود ندارد» ناموفق می‌شود

مطمئن شوید که ادغامی با ترکیب VID/PID صحیح در Developer Console ایجاد کرده‌اید. برای اطلاعات بیشتر، به ایجاد ادغام Matter مراجعه کنید.

راه‌اندازی با پیام خطای «نمی‌توان به دستگاه دسترسی داشت» ناموفق می‌شود

اگر هنگام راه‌اندازی دستگاه Thread همچنان پیام خطای «دستگاه دردسترس نیست» را دریافت می‌کنید و همه گزینه‌های اشکال‌زدایی موجود را امتحان کرده‌اید، شاید بهتر باشد اعتبارنامه‌های ترجیحی ذخیره‌شده Thread را در تلفن Android خود پاک کنید تا راه‌اندازی تمیزی ازطریق تنظیمات > برنامه‌ها > برنامه‌های برنامه > خدمات Google Play > فضای ذخیره‌سازی و حافظه نهان > مدیریت فضا > پاک کردن همه داده‌ها داشته باشید.

آزمایش

دستگاه راه‌اندازی‌شده در «مجموعه آزمایشی» نشان داده نمی‌شود

اگر دستگاهی را با «شناسه فروشنده» (VID) و «شناسه محصول» (PID) آزمایشی مرتبط کرده‌اید، اما وقتی می‌خواهید دستگاه را با «مجموعه آزمون» آزمایش کنید در Developer Console نشان داده نمی‌شود، احتمالاً دلیل آن استفاده از ترکیب VID و PID آزمایشی یکسان در چندین ادغام است.

برای عیب‌یابی، همه دستگاه‌های آزمایشی را از Developer Console بردارید و دستگاهی را که می‌خواهید آزمایش کنید دوباره جفت کنید.

برای تأیید اینکه دستگاه درست را جفت کرده‌اید، می‌توانید اطلاعات «سازنده» و «مدل» (مقادیر CHIP_DEVICE_CONFIG_DEVICE_*) را برای دستگاه روی مقادیر منحصربه‌فرد در سفت‌افزار آزمایشی تنظیم کنید.

برای اطلاعات بیشتر، به اطلاعات دستگاه مراجعه کنید.

اگر مشکل برطرف نشد

اگر پس‌از دنبال کردن همه مراحل عیب‌یابی در اینجا مشکلتان هنوز برطرف نشده است، مشکلی نیست!

در مراحل عیب‌یابی، داده‌های مهمی درباره دستگاه، پروژه کنسول، و محیط خود جمع‌آوری کرده‌اید. با داشتن این داده‌ها، صفحه پشتیبانی را بررسی کنید تا ببینید چگونه می‌توانید مشکلتان را به بهترین شکل با انجمن و تیم پشتیبانی Google Home هم‌رسانی کنید.