این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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

ساختمان

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

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

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

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

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

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

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

Android Debug Bridge را راه اندازی کنید .
از کابل USB برای اتصال تلفن Android خود به رایانه خود استفاده کنید.
این دستور را در ترمینال اجرا کنید تا بررسی کنید که ماژول های ضروری 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]
```
توجه داشته باشید که شماره نسخه بالا ممکن است با دستگاه شما متفاوت باشد.
این دستور را در ترمینال اجرا کنید تا بررسی کنید که ماژول های 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]
```
توجه داشته باشید که شماره نسخه در دستگاه شما ممکن است متفاوت باشد.

اگر ماژول ها در لیست نیستند، به این معنی است که:

شما یک نسخه Android قدیمی دارید. مطمئن شوید که Android O (8.1) یا بالاتر باشد.
ماژول های Matter هنوز دانلود نشده اند. حداقل 24 ساعت صبر کنید تا دانلود شوند. مطمئن شوید که دستگاه شما در این مدت روشن و شارژ می شود، بنابراین دانلود به تاخیر نیفتد. اگر ماژول‌ها را ظرف 24 ساعت دریافت نکرده‌اید، می‌توانید بازنشانی کارخانه‌ای دستگاه را امتحان کنید تا ماژول‌ها را مجبور به دانلود کنید.

سیاهههای مربوط به دستگاه توپی فوشیا

برای فعال کردن یک هاب برای بازیابی گزارش‌های محلی:

یک ایمیل با شماره سریال و مدل دستگاه‌های خود به Technical Account Manager (TAM) خود ارسال کنید. آنها را می توان با حروف کوچک در زیر دستگاه پیدا کرد.
پس از لیست مجاز، باید این ویژگی را با دنبال کردن مراحل زیر فعال کنید:
- از مرکز:
  1. انگشت خود را از بالای صفحه به پایین بکشید
  2. روی نماد تنظیمات ضربه بزنید
  3. نسخه فوشیا را پیدا کنید: در Google Nest Hub (2nd gen) به اطلاعات دستگاه > اطلاعات فنی > نسخه فوشیا بروید
  4. روی "نسخه فوشیا" 7 بار ضربه بزنید. این گزینه های توسعه دهنده را فعال می کند
  5. به منوی سطح بالا برگردید
  6. روی «گزینه‌های برنامه‌نویس» ضربه بزنید
  7. روی "Partner Logging" ضربه بزنید
- این ویژگی به مدت 24 ساعت فعال خواهد شد. پس از آن، از مرحله 5 به بعد قابلیت ثبت را دوباره فعال کنید.
آدرس IP مرکز خود را دریافت کنید:
- از هاب، اگر صفحه نمایش دارد:
  1. انگشت خود را از بالای صفحه به پایین بکشید
  2. روی نماد تنظیمات ضربه بزنید
  3. آدرس IP دستگاه را پیدا کنید: در Nest Hub (2nd gen) به اطلاعات دستگاه > اطلاعات فنی > آدرس IP بروید
- از Google Home app (GHA) در تلفن شما:
  1. روی دستگاه ضربه بزنید تا صفحه جزئیات دستگاه ظاهر شود
  2. روی نماد تنظیمات ضربه بزنید تا صفحه تنظیمات ظاهر شود
  3. آدرس IP دستگاه را پیدا کنید: به اطلاعات دستگاه > اطلاعات فنی > آدرس IP بروید
برای بازیابی گزارش‌ها از هاب، از رایانه‌ای در همان شبکه Wi-Fi، درخواست GET HTTP را به هاب ارسال می‌کنید.
- به پورت و مسیر نقطه پایانی توجه کنید:
```
curl -k -X GET https://ip-address:8443/setup/get_logs --output output-file
```
- اتصال را می توان تنها برای یک دقیقه باز نگه داشت، اما داده های بازیابی شده از بافر معمولاً 20-30 دقیقه از رویدادهای گذشته دارند.
  - در حالت ایده‌آل، لاگ‌ها با استفاده از این روش بلافاصله پس از تکمیل یک روش آزمایشی استخراج می‌شوند تا اطمینان حاصل شود که بافر حاوی محتوای مرتبط با آزمایش است (مشابه گزارش‌های باگ اندروید).

غیرفعال کردن ویرایش گزارش‌های اندروید

برای حفظ حریم خصوصی و امنیت، این ویژگی فقط باید برای اهداف آزمایش مهندسی استفاده شود.
از این گزینه برای دستگاه های تولیدی یا کاربران استفاده نکنید.
مراحل:
1. حساب‌های Google کاربرانی که گزارش‌های ویرایش نشده دارند را به Google TAM خود ارسال کنید.
2. پس از تأیید اضافه شدن حساب شما به لیست مجاز، گوشی خود را مجددا راه اندازی کنید.

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 خواهند بود.

توجه: VID 235A دیگر نباید در پروژه شما استفاده شود و در اینجا برای اهداف توضیحی استفاده می شود. مطمئن شوید که از یک VID مطابق با مشخصات Matter یا یکی از VID های آزمایشی همانطور که در صفحه ادغام یک ماده ذکر شده است استفاده می کنید.

بررسی کنید که دستگاه شما با استفاده از یک شعبه 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 به اشتراک بگذارید.

ساختمان

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

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

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

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

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

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

Android Debug Bridge را راه اندازی کنید .
از کابل USB برای اتصال تلفن Android خود به رایانه خود استفاده کنید.
این دستور را در ترمینال اجرا کنید تا بررسی کنید که ماژول های ضروری 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]
```
توجه داشته باشید که شماره نسخه بالا ممکن است با دستگاه شما متفاوت باشد.
این دستور را در ترمینال اجرا کنید تا بررسی کنید که ماژول های 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]
```
توجه داشته باشید که شماره نسخه در دستگاه شما ممکن است متفاوت باشد.

اگر ماژول ها در لیست نیستند، به این معنی است که:

شما یک نسخه Android قدیمی دارید. مطمئن شوید که Android O (8.1) یا بالاتر باشد.
ماژول های Matter هنوز دانلود نشده اند. حداقل 24 ساعت صبر کنید تا دانلود شوند. مطمئن شوید که دستگاه شما در این مدت روشن و شارژ می شود، بنابراین دانلود به تاخیر نیفتد. اگر ماژول‌ها را ظرف 24 ساعت دریافت نکرده‌اید، می‌توانید بازنشانی کارخانه‌ای دستگاه را امتحان کنید تا ماژول‌ها را مجبور به دانلود کنید.

سیاهههای مربوط به دستگاه توپی فوشیا

برای فعال کردن یک هاب برای بازیابی گزارش‌های محلی:

یک ایمیل با شماره سریال و مدل دستگاه‌های خود به Technical Account Manager (TAM) خود ارسال کنید. آنها را می توان با حروف کوچک در زیر دستگاه پیدا کرد.
پس از لیست مجاز، باید این ویژگی را با دنبال کردن مراحل زیر فعال کنید:
- از مرکز:
  1. انگشت خود را از بالای صفحه به پایین بکشید
  2. روی نماد تنظیمات ضربه بزنید
  3. نسخه فوشیا را پیدا کنید: در Google Nest Hub (2nd gen) به اطلاعات دستگاه > اطلاعات فنی > نسخه فوشیا بروید
  4. روی "نسخه فوشیا" 7 بار ضربه بزنید. این گزینه های توسعه دهنده را فعال می کند
  5. به منوی سطح بالا برگردید
  6. روی «گزینه‌های برنامه‌نویس» ضربه بزنید
  7. روی "Partner Logging" ضربه بزنید
- این ویژگی به مدت 24 ساعت فعال خواهد شد. پس از آن، از مرحله 5 به بعد قابلیت ثبت را دوباره فعال کنید.
آدرس IP مرکز خود را دریافت کنید:
- از هاب، اگر صفحه نمایش دارد:
  1. انگشت خود را از بالای صفحه به پایین بکشید
  2. روی نماد تنظیمات ضربه بزنید
  3. آدرس IP دستگاه را پیدا کنید: در Nest Hub (2nd gen) به اطلاعات دستگاه > اطلاعات فنی > آدرس IP بروید
- از Google Home app (GHA) در تلفن شما:
  1. روی دستگاه ضربه بزنید تا صفحه جزئیات دستگاه ظاهر شود
  2. روی نماد تنظیمات ضربه بزنید تا صفحه تنظیمات ظاهر شود
  3. آدرس IP دستگاه را پیدا کنید: به اطلاعات دستگاه > اطلاعات فنی > آدرس IP بروید
برای بازیابی گزارش‌ها از هاب، از رایانه‌ای در همان شبکه Wi-Fi، درخواست GET HTTP را به هاب ارسال می‌کنید.
- به پورت و مسیر نقطه پایانی توجه کنید:
```
curl -k -X GET https://ip-address:8443/setup/get_logs --output output-file
```
- اتصال را می توان تنها برای یک دقیقه باز نگه داشت، اما داده های بازیابی شده از بافر معمولاً 20-30 دقیقه از رویدادهای گذشته دارند.
  - در حالت ایده‌آل، لاگ‌ها با استفاده از این روش بلافاصله پس از تکمیل یک روش آزمایشی استخراج می‌شوند تا اطمینان حاصل شود که بافر حاوی محتوای مرتبط با آزمایش است (مشابه گزارش‌های باگ اندروید).

غیرفعال کردن ویرایش گزارش‌های اندروید

برای حفظ حریم خصوصی و امنیت، این ویژگی فقط باید برای اهداف آزمایش مهندسی استفاده شود.
از این گزینه برای دستگاه های تولیدی یا کاربران استفاده نکنید.
مراحل:
1. حساب‌های Google کاربرانی که گزارش‌های ویرایش نشده دارند را به Google TAM خود ارسال کنید.
2. پس از تأیید اضافه شدن حساب شما به لیست مجاز، گوشی خود را مجددا راه اندازی کنید.

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

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

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

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

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

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

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

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

جفت شدن

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

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

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

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

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

راه اندازی با پیام خطای "نمی توان با Google تماس گرفت" ناموفق بود

راه اندازی با پیام خطای "دسترسی به دستگاه" انجام نمی شود

تست کردن

دستگاه سفارش داده شده در مجموعه آزمایشی ظاهر نمی شود

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

اگر باز هم همه چیز خراب باشد

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

ساختمان

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

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

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

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

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

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

Android Debug Bridge را راه اندازی کنید .
از کابل USB برای اتصال تلفن Android خود به رایانه خود استفاده کنید.
این دستور را در ترمینال اجرا کنید تا بررسی کنید که ماژول های ضروری 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]
```
توجه داشته باشید که شماره نسخه بالا ممکن است با دستگاه شما متفاوت باشد.
این دستور را در ترمینال اجرا کنید تا بررسی کنید که ماژول های 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]
```
توجه داشته باشید که شماره نسخه در دستگاه شما ممکن است متفاوت باشد.

اگر ماژول ها در لیست نیستند، به این معنی است که:

شما یک نسخه Android قدیمی دارید. مطمئن شوید که Android O (8.1) یا بالاتر باشد.
ماژول های Matter هنوز دانلود نشده اند. حداقل 24 ساعت صبر کنید تا دانلود شوند. مطمئن شوید که دستگاه شما در این مدت روشن و شارژ می شود، بنابراین دانلود به تاخیر نیفتد. اگر ماژول‌ها را ظرف 24 ساعت دریافت نکرده‌اید، می‌توانید بازنشانی کارخانه‌ای دستگاه را امتحان کنید تا ماژول‌ها را مجبور به دانلود کنید.

سیاهههای مربوط به دستگاه توپی فوشیا

برای فعال کردن یک هاب برای بازیابی گزارش‌های محلی:

یک ایمیل با شماره سریال و مدل دستگاه‌های خود به Technical Account Manager (TAM) خود ارسال کنید. آنها را می توان با حروف کوچک در زیر دستگاه پیدا کرد.
پس از لیست مجاز، باید این ویژگی را با دنبال کردن مراحل زیر فعال کنید:
- از مرکز:
  1. انگشت خود را از بالای صفحه به پایین بکشید
  2. روی نماد تنظیمات ضربه بزنید
  3. نسخه فوشیا را پیدا کنید: در Google Nest Hub (2nd gen) به اطلاعات دستگاه > اطلاعات فنی > نسخه فوشیا بروید
  4. روی "نسخه فوشیا" 7 بار ضربه بزنید. این گزینه های توسعه دهنده را فعال می کند
  5. به منوی سطح بالا برگردید
  6. روی «گزینه‌های برنامه‌نویس» ضربه بزنید
  7. روی "Partner Logging" ضربه بزنید
- این ویژگی به مدت 24 ساعت فعال خواهد شد. پس از آن، از مرحله 5 به بعد قابلیت ثبت را دوباره فعال کنید.
آدرس IP مرکز خود را دریافت کنید:
- از هاب، اگر صفحه نمایش دارد:
  1. انگشت خود را از بالای صفحه به پایین بکشید
  2. روی نماد تنظیمات ضربه بزنید
  3. آدرس IP دستگاه را پیدا کنید: در Nest Hub (2nd gen) به اطلاعات دستگاه > اطلاعات فنی > آدرس IP بروید
- از Google Home app (GHA) در تلفن شما:
  1. روی دستگاه ضربه بزنید تا صفحه جزئیات دستگاه ظاهر شود
  2. روی نماد تنظیمات ضربه بزنید تا صفحه تنظیمات ظاهر شود
  3. آدرس IP دستگاه را پیدا کنید: به اطلاعات دستگاه > اطلاعات فنی > آدرس IP بروید
برای بازیابی گزارش‌ها از هاب، از رایانه‌ای در همان شبکه Wi-Fi، درخواست GET HTTP را به هاب ارسال می‌کنید.
- به پورت و مسیر نقطه پایانی توجه کنید:
```
curl -k -X GET https://ip-address:8443/setup/get_logs --output output-file
```
- اتصال را می توان تنها برای یک دقیقه باز نگه داشت، اما داده های بازیابی شده از بافر معمولاً 20-30 دقیقه از رویدادهای گذشته دارند.
  - در حالت ایده‌آل، لاگ‌ها با استفاده از این روش بلافاصله پس از تکمیل یک روش آزمایشی استخراج می‌شوند تا اطمینان حاصل شود که بافر حاوی محتوای مرتبط با آزمایش است (مشابه گزارش‌های باگ اندروید).

ویرایش گزارش‌های اندروید را غیرفعال کنید

برای حفظ حریم خصوصی و امنیت، این ویژگی فقط باید برای اهداف آزمایش مهندسی استفاده شود.
از این گزینه برای دستگاه های تولیدی یا کاربران استفاده نکنید.
مراحل:
1. حساب‌های Google کاربرانی که گزارش‌های ویرایش نشده دارند را به Google TAM خود ارسال کنید.
2. پس از تأیید اضافه شدن حساب شما به لیست مجاز، گوشی خود را مجددا راه اندازی کنید.

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

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

عیب یابی بلوتوث Sniffer

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

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

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

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

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

جفت شدن

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

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

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

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

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

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

راه اندازی با پیام خطای "نمی توان با Google تماس گرفت" ناموفق بود

راه اندازی با پیام خطای "دسترسی به دستگاه" انجام نمی شود

تست کردن

دستگاه سفارش داده شده در مجموعه آزمایشی ظاهر نمی شود

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

اگر باز هم همه چیز خراب باشد

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

ساختمان

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

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

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

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

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

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

Android Debug Bridge را راه اندازی کنید .
از کابل USB برای اتصال تلفن Android خود به رایانه خود استفاده کنید.
این دستور را در ترمینال اجرا کنید تا بررسی کنید که ماژول های ضروری 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]
```
توجه داشته باشید که شماره نسخه بالا ممکن است با دستگاه شما متفاوت باشد.
این دستور را در ترمینال اجرا کنید تا بررسی کنید که ماژول های 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]
```
توجه داشته باشید که شماره نسخه در دستگاه شما ممکن است متفاوت باشد.

اگر ماژول ها در لیست نیستند، به این معنی است که:

شما یک نسخه Android قدیمی دارید. مطمئن شوید که Android O (8.1) یا بالاتر باشد.
ماژول های Matter هنوز دانلود نشده اند. حداقل 24 ساعت صبر کنید تا دانلود شوند. مطمئن شوید که دستگاه شما در این مدت روشن و شارژ می شود، بنابراین دانلود به تاخیر نیفتد. اگر ماژول‌ها را ظرف 24 ساعت دریافت نکرده‌اید، می‌توانید بازنشانی کارخانه‌ای دستگاه را امتحان کنید تا ماژول‌ها را مجبور به دانلود کنید.

سیاهههای مربوط به دستگاه توپی فوشیا

برای فعال کردن یک هاب برای بازیابی گزارش‌های محلی:

یک ایمیل با شماره سریال و مدل دستگاه‌های خود به Technical Account Manager (TAM) خود ارسال کنید. آنها را می توان با حروف کوچک در زیر دستگاه پیدا کرد.
پس از لیست مجاز، باید این ویژگی را با دنبال کردن مراحل زیر فعال کنید:
- از مرکز:
  1. انگشت خود را از بالای صفحه به پایین بکشید
  2. روی نماد تنظیمات ضربه بزنید
  3. نسخه فوشیا را پیدا کنید: در Google Nest Hub (2nd gen) به اطلاعات دستگاه > اطلاعات فنی > نسخه فوشیا بروید
  4. روی "نسخه فوشیا" 7 بار ضربه بزنید. این گزینه های توسعه دهنده را فعال می کند
  5. به منوی سطح بالا برگردید
  6. روی «گزینه‌های برنامه‌نویس» ضربه بزنید
  7. روی "Partner Logging" ضربه بزنید
- این ویژگی به مدت 24 ساعت فعال خواهد شد. پس از آن، از مرحله 5 به بعد قابلیت ثبت را دوباره فعال کنید.
آدرس IP مرکز خود را دریافت کنید:
- از هاب، اگر صفحه نمایش دارد:
  1. انگشت خود را از بالای صفحه به پایین بکشید
  2. روی نماد تنظیمات ضربه بزنید
  3. آدرس IP دستگاه را پیدا کنید: در Nest Hub (2nd gen) به اطلاعات دستگاه > اطلاعات فنی > آدرس IP بروید
- از Google Home app (GHA) در تلفن شما:
  1. روی دستگاه ضربه بزنید تا صفحه جزئیات دستگاه ظاهر شود
  2. روی نماد تنظیمات ضربه بزنید تا صفحه تنظیمات ظاهر شود
  3. آدرس IP دستگاه را پیدا کنید: به اطلاعات دستگاه > اطلاعات فنی > آدرس IP بروید
برای بازیابی سیاهههای مربوط از توپی ، درخواست دریافت HTTP را از طریق رایانه در همان شبکه Wi-Fi به هاب می دهید.
- به بندر و مسیر نقطه پایانی توجه داشته باشید:
```
curl -k -X GET https://ip-address:8443/setup/get_logs --output output-file
```
- این اتصال را می توان فقط برای یک دقیقه باز نگه داشت ، اما داده های برگرفته از بافر معمولاً 20-30 دقیقه از وقایع گذشته دارند.
  - در حالت ایده آل ، سیاههها با استفاده از این روش بلافاصله پس از انجام یک روش آزمایش استخراج می شوند تا اطمینان حاصل شود که بافر حاوی محتوای مربوط به تست است (مشابه گزارش های اشکال اندرویدی).

ردیابی سیاهههای مربوط به اندرویدی را غیرفعال کنید

برای حفظ حریم خصوصی و امنیت ، این ویژگی فقط باید برای اهداف تست مهندسی استفاده شود.
از این گزینه با دستگاه های تولید یا کاربران استفاده نکنید.
مراحل:
1. حساب های Google از کاربرانی را که دارای سیاهههای غیرقانونی به Google TAM شما هستند ، ارسال کنید.
2. پس از تأیید اینکه حساب شما به لیست اجازه اضافه شده است ، تلفن خود را راه اندازی مجدد کنید.

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

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

عیب یابی بلوتوث sniffer

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

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

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

در این تصویر از نسخه Android NRF Connect ، خواهید دید که VID/PID به عنوان 5A23FFFE از چهارم بایت قسمت داده های سرویس شروع می شود. این نشانگر VID از 5A23 و یک PID از FFFE است - هر دو با فرمت Endian Little .

برنامه BLE مقادیر را در Little Endian نشان می دهد ، اما مقادیر VID/PID که وارد پروژه Developer Console خود می شوید در Big Endian قرار دارند.

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

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

توجه: VID 235A دیگر نباید در پروژه شما استفاده شود و در اینجا برای اهداف مصور استفاده می شود. اطمینان حاصل کنید که طبق مشخصات Matter ، یا یکی از VID های آزمایشی که در صفحه ایجاد یک موضوع ذکر شده است ، از VID استفاده می کنید.

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

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

جفت شدن

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

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

اعلامیه صدور گواهینامه (CD).
گواهی تأیید دستگاه (DAC) و زنجیره گواهی آن.

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

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

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

برخی از مراکز نیز روترهای مرزی نخ هستند و بنابراین شما را قادر می سازد دستگاه های نخ را توسعه داده و آزمایش کنید. سایر مراکز دیگر فقط از دستگاه های Matter Wi-Fi و اترنت پشتیبانی می کنند ، مگر اینکه روتر مرزی دیگری در شبکه خود داشته باشید تا اتصال نخ را فعال کنید.

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

راه اندازی با پیام خطای "با Google" تماس نمی گیرد

اطمینان حاصل کنید که یکپارچه سازی با ترکیب صحیح VID/PID در Developer Console ایجاد کرده اید. برای اطلاعات بیشتر به ایجاد یکپارچه سازی موضوع مراجعه کنید.

راه اندازی با پیام خطایی "نمی توان به دستگاه نمی رسد" شکست بخورد

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

تست کردن

دستگاه راه اندازی شده در مجموعه تست ظاهر نمی شود

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

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

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

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

اگر هنوز همه چیز اشتباه پیش می رود

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

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