ساختمان
درستی‌سنجی کنید تلفنتان سازگار باشد
همه دستگاه‌های Android O (8.1، سطح میانای برنامه‌سازی کاربردی ۲۷) و جدیدتر با Matter سازگار هستند. برای بررسی اینکه آیا تلفنتان واحدهای لازم را دارد یا نه، مراحل زیر را دنبال کنید.
راه‌اندازی Android Debug Bridge
«پل اشکال‌زدایی Android» (adb) باید قبل‌از عیب‌یابی راه‌اندازی شود.
برای راه‌اندازی آن:
- «adb» را روی رایانه‌تان نصب کنید.
- «گزینه‌های توسعه‌دهندگان» و «اشکال‌زدایی USB» را در تلفن Android روشن کنید.
واحدهای Matter «خدمات Google Play» (GPS) را تأیید کنید
برای بررسی اینکه آیا Google Play services Matter واحدها را دارید، مراحل زیر را انجام دهید:
- راه‌اندازی پل اشکال‌زدایی Android.
- تلفن Android را بااستفاده از کابل USB به رایانه متصل کنید.
- این فرمان را در پایانه اجرا کنید تا درستی‌سنجی کنید که
Matter واحدهای لازم نصب شده‌اند:
adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.home"com.google.android.gms.home [v222110900]
- این فرمان را در پایانه اجرا کنید تا درستی‌سنجی کنید که
Thread واحدهای لازم نصب شده‌اند:
adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.threadnetwork"com.google.android.gms.threadnetwork [v222106301]
اگر واحدها فهرست نشده باشند، یعنی:
- نسخه Android شما قدیمی است. مطمئن شوید Android O (8.1) یا بالاتر باشد.
- واحدهای Matter هنوز بارگیری نشده‌اند. حداقل ۲۴ ساعت صبر کنید تا بارگیری شوند. مطمئن شوید دستگاهتان در این مدت روشن و درحال شارژ باشد تا بارگیری به‌تأخیر نیفتد. اگر ظرف ۲۴ ساعت ماژول‌ها را دریافت نکردید، می‌توانید دستگاه را بازنشانی کارخانه‌ای کنید تا ماژول‌ها مجبور به بارگیری شوند.
VID/PID دستگاهتان را درستی‌سنجی کنید
اگر می‌خواهید توسعه یکپارچه‌سازی با Google را شروع کنید، باید در «کنسول Google Home» پروژه و یکپارچه‌سازی ایجاد کنید.
مقدار VID/PID که دستگاهتان پخش می‌کند باید با مقدار VID/PID واردشده در پروژه Google Home Developer Console شما مطابقت داشته باشد.
- VIDs
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 خواهد بود.
تأیید کنید که دستگاهتان بااستفاده از شاخه سازگار «کیت توسعه نرم‌افزار Matter» ساخته شده است
هاب‌های Google Matter با
Matter 1.0 سازگار هستند و با ساخت‌هایی که از
تغییرات شاخه پایدار v1.0-branch استفاده می‌کردند آزمایش شده‌اند. یادداشت‌های
انتشار عمومی را برای تعهدات خاصی که برای استفاده با
هر انتشار جدید هاب توصیه می‌شود بررسی کنید.
جفت‌سازی
اطلاعات اعتباری دستگاهتان را درستی‌سنجی کنید
وقتی از VID اختصاص‌داده‌شده Alliance خودتان استفاده می‌کنید، مطمئن شوید که اعتبارنامه‌های صحیح را در دستگاه دارید:
- اعلامیه گواهینامه (CD).
- «گواهینامه گواهی دستگاه» (DAC) و زنجیره گواهینامه آن.
برای اطلاعات بیشتر، ایجاد گواهینامه‌های آزمایش دستگاه Matter را ببینید.
درستی‌سنجی «مرکز سازگار با Matter»
مرکز کنترل Matter شما باید یکی از مراکز کنترل پشتیبانی‌شده توسط Google باشد. همچنین باید در ساخت سازگار با Matter باشد.
برخی‌از هاب‌ها نیز Thread Border Router (TBR)s هستند و بنابراین به شما امکان می‌دهند دستگاه‌های Thread را توسعه دهید و آزمایش کنید. هاب‌های دیگر فقط از دستگاه‌های Wi-Fi و اترنت Matter پشتیبانی می‌کنند، مگر اینکه border router دیگری در شبکه‌تان داشته باشید که اتصال Thread را فعال کند.
ساختمان مرکزی شما ممکن است ازطریق موارد زیر تأیید شود: کشیدن انگشت از لبه بالا به‌پایین > چرخ پیکربندی > اطلاعات دستگاه > اطلاعات فنی > نسخه سفت‌افزار Chromecast
راه‌اندازی با پیام خطای «نمی‌توان با Google تماس گرفت» ناموفق است
مطمئن شوید که یکپارچه‌سازی را با ترکیب VID/PID صحیح در Developer Console ایجاد کرده‌اید. برای اطلاعات بیشتر، ایجاد یک یکپارچه‌سازی Matter را ببینید.
راه‌اندازی با پیام خطای «نمی‌توان به دستگاه دسترسی داشت» ناموفق است
اگر هنگام آماده‌سازی دستگاه Thread همچنان پیام خطای «دسترسی به دستگاه امکان‌پذیر نیست» دریافت می‌کنید و همه گزینه‌های اشکال‌زدایی دردسترس را امتحان کرده‌اید، می‌توانید با رفتن به تنظیمات > برنامه‌ها > برنامه‌های > خدمات Google Play > فضای ذخیره‌سازی و حافظه نهان > مدیریت فضا > پاک کردن همه داده‌ها، اطلاعات اعتباری ترجیحی ذخیره‌شده Thread را در تلفن Android خود پاک کنید تا راه‌اندازی تمیزی داشته باشید.
آزمایش
دستگاه مأمور در «مجموعه آزمایش» نشان داده نمی‌شود
اگر دستگاهی را با «شناسه فروشنده» (VID) و «شناسه محصول» (PID) آزمایشی جفت کرده‌اید، اما وقتی سعی می‌کنید دستگاه را با «مجموعه آزمایش» در Developer Console آزمایش کنید، دستگاه نشان داده نمی‌شود، احتمالاً دلیل آن استفاده از ترکیب VID و PID آزمایشی یکسان در چندین یکپارچه‌سازی است.
برای عیب‌یابی، همه دستگاه‌های آزمایشی را از Developer Console بردارید و دستگاهی را که می‌خواهید دوباره آزمایش کنید جفت کنید.
برای تأیید اینکه دستگاه درست را جفت کرده‌اید، می‌توانید اطلاعات «سازنده» و «مدل» (CHIP_DEVICE_CONFIG_DEVICE_* مقدار) را برای دستگاه روی مقادیر یکتا در سفت‌افزار آزمایشی‌تان تنظیم کنید.
برای اطلاعات بیشتر، اطلاعات دستگاه را ببینید.
اگر همچنان مشکلی وجود دارد
اگر پس‌از دنبال کردن همه مراحل عیب‌یابی در اینجا، مشکلتان همچنان حل نشد، مشکلی نیست!
در مراحل عیب‌یابی، داده‌های مهمی درباره دستگاه، پروژه کنسول، و محیط خود جمع‌آوری کرده‌اید. با دردست داشتن این داده‌ها، برای اطلاع از بهترین روش هم‌رسانی مشکلتان با انجمن و تیم پشتیبانی Google Home، صفحه پشتیبانی را بررسی کنید.