عیب یابی موضوع

ساختمان

بررسی کنید که گوشی شما سازگار است

همه دستگاه‌های Android O (8.1، API سطح 27) و جدیدتر با Matter سازگار هستند. مراحل زیر را دنبال کنید تا بررسی کنید که آیا گوشی شما ماژول های لازم را دارد یا خیر.

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

Android Debug Bridge ( adb ) باید قبل از عیب‌یابی راه‌اندازی شود. برای تنظیم آن:

  1. "adb" را روی رایانه خود نصب کنید .
  2. Developer Options و USB Debugging را در گوشی Android خود روشن کنید .

ماژول‌های Google Play Services (GPS) Matter خود را تأیید کنید

برای بررسی اینکه آیا ماژول های 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 ساعت دریافت نکرده‌اید، می‌توانید بازنشانی کارخانه‌ای دستگاه را امتحان کنید تا ماژول‌ها را مجبور به دانلود کنید.

VID/PID دستگاه خود را تأیید کنید

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

عیب یابی بلوتوث اسنیفر

مقدار VID/PID دستگاه شما باید با VID/PID وارد شده در پروژه Google Home Developer Console مطابقت داشته باشد.

  • VID 0xFFF1 — 0xFFF4 برای آزمایش رزرو شده است. آنها ممکن است برای تست های اولیه راه اندازی و کنترل استفاده شوند، اما نمی توان آنها را در مراحل زیر توسعه استفاده کرد:

با استفاده از یک برنامه مهندسی بلوتوث مانند nRF Connect for Mobile ، می توانید VID/PID دستگاه beaconing را در قسمت Service Data مشاهده کنید.

در این اسکرین شات از نسخه Android nRF Connect، مشاهده می کنید که VID/PID به صورت 5A23FFFE فهرست شده است که از بایت چهارم قسمت Service Data شروع می شود. این نشان‌دهنده یک VID 5A23 و یک PID از FFFE است - هر دو در قالب اندیان کوچک .

برنامه BLE مقادیر را در اندیان کوچک نمایش می دهد، اما مقادیر VID/PID که در پروژه Developer Console خود وارد می کنید در اندیان بزرگ هستند.

تأیید کنید که مقادیر و قالب مناسب بر اساس آنچه که sniffer بلوتوث نشان می دهد در پروژه Actions Console شما وارد شده است.

برای مقادیر در تصویر مثال، VID و PID در Developer Console به ترتیب 235A و FEFF خواهند بود.

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

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

جفت شدن

اعتبار دستگاه خود را تأیید کنید

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

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

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

هاب سازگار با Matter خود را تأیید کنید

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

برخی از هاب ها نیز Thread Border Router هستند و بنابراین شما را قادر می سازند تا دستگاه های Thread را توسعه و آزمایش کنید. هاب های دیگر فقط از دستگاه های Wi-Fi و Ethernet Matter پشتیبانی می کنند، مگر اینکه روتر مرزی دیگری در شبکه خود داشته باشید تا اتصال 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 به اشتراک بگذارید.