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

ساختمان

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

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

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

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

  1. یک ایمیل با شماره سریال و مدل دستگاه‌های خود به Technical Account Manager (TAM) خود ارسال کنید. آنها را می توان با حروف کوچک در زیر دستگاه پیدا کرد.
  2. پس از لیست مجاز، باید این ویژگی را با دنبال کردن مراحل زیر فعال کنید:
    • از مرکز:
      1. انگشت خود را از بالای صفحه به پایین بکشید
      2. روی نماد تنظیمات ضربه بزنید
      3. نسخه فوشیا را پیدا کنید: در Google Nest Hub (2nd gen) به اطلاعات دستگاه > اطلاعات فنی > نسخه فوشیا بروید
      4. روی "نسخه فوشیا" 7 بار ضربه بزنید. این گزینه های توسعه دهنده را فعال می کند
      5. به منوی سطح بالا برگردید
      6. روی «گزینه‌های برنامه‌نویس» ضربه بزنید
      7. روی «Logging Partner» ضربه بزنید
    • این ویژگی به مدت 24 ساعت فعال خواهد شد. پس از آن، از مرحله 5 به بعد قابلیت ثبت را دوباره فعال کنید.
  3. آدرس IP مرکز خود را دریافت کنید:
    • از هاب، اگر صفحه نمایش دارد:
      1. انگشت خود را از بالای صفحه به پایین بکشید
      2. روی نماد تنظیمات ضربه بزنید
      3. آدرس IP دستگاه را پیدا کنید: در Nest Hub (2nd gen) به اطلاعات دستگاه > اطلاعات فنی > آدرس IP بروید
    • از Google Home app (GHA) در تلفن شما:
      1. روی دستگاه ضربه بزنید تا صفحه جزئیات دستگاه ظاهر شود
      2. روی نماد تنظیمات ضربه بزنید تا صفحه تنظیمات ظاهر شود
      3. آدرس IP دستگاه را پیدا کنید: به اطلاعات دستگاه > اطلاعات فنی > آدرس IP بروید
  4. برای بازیابی گزارش‌ها از هاب، از رایانه‌ای در همان شبکه 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 خواهند بود.

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