Google Home Developer Console صفحه آزمایش را ارائه می‌دهد که در آن می‌توانید آزمایش‌هایی را برای ادغام Matter بااستفاده از Google Home Test Suite پیکربندی و اجرا کنید. Test Suite برنامه جداگانه‌ای است که در Developer Console ساخته شده است و همه آزمایش‌های ادغام را مدیریت می‌کند.
دستگاه‌های مربوط به «شناسه فروشنده» و «شناسه محصول» ادغام باید راه‌اندازی شوند و در Google Home app (GHA) برای حسابی که با Developer Console استفاده می‌شود دردسترس باشند تا بتوان آن‌ها را آزمایش کرد. برای اطلاعات بیشتر، به جفت کردن دستگاه Matter بروید.
Test Suite را می‌توان در مجموعه‌ای از دستگاه‌ها اجرا کرد که به پیکربندی پروژه Matter خاصی تعلق دارند. بسیار مهم است که Test Suite را در ادغام(های) خود اجرا کنید تا مطمئن شوید که همه چیز به‌درستی کار می‌کند.
در صفحه آزمایش، Matter ادغام‌هایی که کامل و آماده آزمایش هستند در بخش آماده آزمایش فهرست شده‌اند.
Matter ادغام‌هایی که آزمایش شده‌اند در بخش آزمایش‌شده فهرست شده‌اند.
انواع طرح‌های آزمایشی
این انواع طرح‌های آزمایشی دردسترس هستند:
از طرح‌های آزمایشی توسعه برای آزمایش کردن دستگاه‌های کنترل‌کننده بااستفاده از Matter استفاده می‌شود. این موارد قابل‌ویرایش هستند، اما نمی‌توان آن‌ها را برای گواهینامه Matter ارسال کرد.
طرح‌های آزمایشی گواهی به‌طور خاص برای گواهی Matter هستند و قابل‌ویرایش نیستند. با انتخاب این گزینه، نسخه جدیدی از ادغام Matter شما ایجاد خواهد شد.
طرح‌های آزمایشی CSA Interop به شما امکان می‌دهد از مرحله آزمایش رد شوید و از نتایج Connectivity Standards Alliance (Alliance) Interop Test Lab خود استفاده کنید. این گزینه آزمایشی برای همه انواع دستگاه‌های پشتیبانی‌شده دردسترس است و تنها گزینه معتبر برای دریافت گواهینامه Aliro برای قفل‌های در سازگار با Aliro است.
از Test Suite در Developer Console برای ارسال نتایج آزمایش جهت دریافت گواهینامه استفاده کنید. اگر می‌خواهید Test Suite را برای اهداف آزمایشی درطول توسعه اجرا کنید، به صفحه مجموعه آزمایشی Google Home برای نسخه مستقل مراجعه کنید.
نسخه‌های یکپارچه‌سازی
وقتی طرح آزمایشی برای صدور گواهینامه ایجاد می‌کنید، نسخه جدیدی از ادغام ایجاد می‌شود. این نسخه شماره‌دار در همه فهرست‌های ادغام در Developer Console از برگه «آزمایش» به بعد فهرست شده است.
نسخه‌های جدید هرگز از نسخه‌های شماره‌دار دیگر ایجاد نمی‌شوند. برای مثال، اولین طرح آزمایشی که برای یکپارچه‌سازی ایجاد می‌کنید، نسخه v.1 را برای آن یکپارچه‌سازی ایجاد خواهد کرد. ایجاد طرح آزمایشی دیگر باعث ایجاد نسخه v.2 برای آن ادغام می‌شود، اما این نسخه براساس v.1 نخواهد بود. درعوض، این نسخه براساس نمونه بدون نسخه ادغام است، همان‌طور که v.1 بود.
نسخه N/A یکپارچه‌سازی نشان‌دهنده نمونه بدون نسخه یکپارچه‌سازی است که در برگه توسعه مدیریت می‌شود.
به‌عبارت دیگر، در Matter > آزمایش در Developer Console:
- اگر برای نسخه N/A ادغام روی آزمایش کلیک کنید، نسخه جدیدی
ایجاد می‌شود. شماره نسخه یک عدد بالاتر از هر نسخه شماره‌دار موجود خواهد بود.
- اگر نسخه شماره‌گذاری‌شده‌ای وجود نداشته باشد، نسخه v.1 ایجاد می‌شود.
- اگر نسخه v.1 وجود داشته باشد، نسخه v.2 ایجاد می‌شود. اگر نسخه v.2 وجود داشته باشد، نسخه v.3 ایجاد می‌شود و به همین ترتیب.
- اگر برای نسخه شماره‌دار ادغام (برای مثال، v.1) روی آزمایش کلیک کنید، نسخه جدیدی ایجاد نمی‌شود. درعوض، نسخه v.1 دوباره آزمایش می‌شود.
برای اطلاعات بیشتر، نسخه‌بندی ادغام را ببینید.
ساختن طرح آزمون
نسخه‌های یکپارچه‌سازی عکس آنی از یکپارچه‌سازی بدون نسخه هستند. این یعنی وقتی طرح آزمایشی برای گواهینامه و درنتیجه نسخه ادغام ایجاد می‌کنید، همه فراداده‌های مربوط به آن ادغام باید اطلاعاتی باشد که می‌خواهید برای ادغام راه‌اندازی‌شده استفاده کنید.
پیش‌از ایجاد طرح آزمایشی برای گواهینامه، مطمئن شوید که کارهای زیر را انجام داده‌اید:
- نمایه شرکت ایجاد کرد.
- «شناسه ارائه‌دهنده» (VID) تولید را برای ادغام وارد کرده باشید.
- راه‌اندازی و نمانام‌سازی پیکربندی‌شده.
اگر همه این موارد را برای ادغام خود تکمیل نکرده‌اید، نسخه ادغامی که برای آزمایش گواهینامه ایجاد شده است نمی‌تواند گواهینامه دریافت کند. باید نسخه جدیدی ایجاد کنید، یعنی مراحل «آزمایش»، «آزمایش میدانی»، و «صدور گواهی» را دوباره انجام دهید.
همچنین اگر بخواهید نمانام‌سازی‌تان را قبل‌از تأیید شدن نسخه یکپارچه‌سازی به‌روز کنید، باید نسخه جدیدی ایجاد کنید و از ابتدا شروع کنید.
برای ایجاد طرح آزمایشی:
از فهرست پروژه‌ها، روی باز کردن در کنار پروژه‌ای که می‌خواهید با آن کار کنید کلیک کنید.
در منو پیمایش سمت راست صفحه، به Matter > آزمایش بروید.
روی آزمایش برای نسخه N/A از ادغامی که می‌خواهید آزمایش کنید کلیک کنید. این کنش نسخه ادغام جدیدی ایجاد می‌کند.
نوع آزمایش را انتخاب کنید و روی آزمایش کلیک کنید.
- اگر برای دریافت گواهینامه در بوم‌سازگان Google آماده می‌شوید، آزمون گواهینامه را انتخاب کنید.
- از آزمایش توسعه نمی‌توان برای صدور گواهینامه استفاده کرد.
آزمایش CSA Interop را انتخاب کنید تا از نتایج Alliance «آزمایشگاه آزمایش Interop» برای رد شدن از مراحل «آزمایش» و «آزمایش میدانی» در جریان ادغام Matter استفاده کنید. پس‌از انتخاب آزمایش CSA Interop، نام ردیابی را به نمایه پیکربندی اختصاص دهید، «شناسه محصول» (PID) دستگاه را نگاشت کنید، و برای رفتن مستقیم به صدور گواهینامه، روی ارسال کلیک کنید.
برای قفل‌های در سازگار با Aliro، باید آزمون CSA Interop را انتخاب کنید تا گواهینامه Aliro را دریافت کنید. اگر گزینه آزمایشی دیگری را انتخاب کنید، باید نسخه ادغام جدیدی ایجاد کنید و دوباره ارسال کنید.
اگر آزمون گواهینامه یا آزمون توسعه را انتخاب کرده‌اید، در صفحه پیکربندی آزمون، نامی برای آزمونتان ارائه دهید و روی جفت کردن خودکار دستگاه کلیک کنید تا دستگاهی را برای جفت کردن انتخاب کنید.
برای دستگاه Android:
- مطمئن شوید GHA را در تلفنتان نصب کرده‌اید.
- تلفنتان را با کابل USB به دستگاه میزبان وصل کنید.
- باید
اشکال‌زدایی USB را در دستگاهتان فعال کنید
APKcom.chip.interop.moblysnippetبه‌طور خودکار بارگیری و نصب خواهد شد. - وقتی تلفنتان متصل شد، کد جفت‌سازی و نام دستگاه را وارد کنید تا دستگاهتان به‌طور خودکار جفت شود.
برای دستگاه iOS:
- باید دستگاهتان را به‌صورت دستی جفت کنید. برای دستورالعمل‌های مربوط به جفت‌سازی دستی، به بخش برنامه Google Home مراجعه کنید.
- اگر دستگاهی دارید، ممکن است از شما خواسته شود جفت‌سازی دستگاه را لغو کنید و دوباره جفت کنید یا دستگاه جدیدی را جفت کنید.
روی دکمه بعدی: طرح آزمایشی کلیک کنید.
در صفحه ایجاد طرح آزمایشی، در بخش مجموعه‌های آزمایشی، مجموعه‌های آزمایشی موردنظر را برای اجرا انتخاب کنید.
اگر می‌خواهید از Test Suite خارج شوید، روی
بازگشت به مرکز
توسعه‌دهندگان کلیک کنید.
اجرای طرح آزمایشی
در Test Suite، از صفحه ایجاد طرح آزمایشی، روی اجرای آزمایش کلیک کنید. صفحه محیط آزمایشی با وضعیت و گزارش‌های همه آزمایش‌ها نشان داده می‌شود.
نتایج آزمایش شما پس‌از تکمیل آزمایش‌ها نشان داده می‌شود. وضعیت اجرای هر مجموعه آزمون در کنار آن نشان داده می‌شود (موفق، ناموفق).
صفحه گزارش‌ها وضعیت هر اجرای آزمایشی را به‌صورت جداگانه نشان می‌دهد.
برای آزمایش مجدد طرح آزمایشی از صفحه محیط آزمایشی،
پس‌از تکمیل اجرای آزمایشی، روی
آزمایش مجدد در بالا کلیک کنید.
وقتی تمام شد:
- روی تمام کلیک کنید تا به صفحه سابقه آزمایش بروید، یا
- روی ارسال کلیک کنید تا نتایج آزمایش را برای صدور گواهینامه ارسال کنید.
مشاهده و تفسیر نتایج آزمایش
در صفحه سابقه آزمایش در Test Suite، می‌توانید نتایج آزمایش قبلی را برای طرح توسعه یا طرح آزمایش گواهینامه ارسال‌نشده با کلیک کردن روی آزمایش مجدد برای طرح آزمایش در بخش طرح‌های آزمایش مشاهده کنید. با این کار به صفحه محیط آزمایشی می‌روید که نتایج آن آزمایش را نمایش می‌دهد.
برای طرح گواهینامه ارسال‌شده، روی نتایج در بخش ذخیره‌شده برای گواهینامه کلیک کنید تا گزارش نتایج آزمایش را ببینید.
همچنین می‌توان از برگه آزمایش در Developer Console به نتایج آزمایش برای نسخه ادغام دسترسی پیدا کرد. روی مشاهده برای سابقه آزمایش هر نسخه ادغام فهرست‌شده در آن صفحه کلیک کنید تا به صفحه سابقه آزمایش در Test Suite هدایت شوید.
وضعیت‌های کنسول
وضعیت‌های «کنسول» زیر در مرحله «آزمایش» مشاهده می‌شود:
| بخش | وضعیت | شرح | الزام | بعد از آن چه اقدامی باید انجام دهم |
|---|---|---|---|---|
| آماده برای آزمایش | آماده | این نسخه از integration برای آزمایش آماده است. | موجود نیست | این نسخه از integrationرا آزمایش کنید. |
| آزمایش‌شده | آماده | این نسخه از integration آزمایش شده است و می‌توان آن را برای Field Trial یا گواهینامه ارسال کرد. |
نسخه آزمایش و ذخیره شد. همه چارچوب‌های تست ناموفق شامل توجیهاتی برای بازبینی Google است. |
درصورت تمایل، دوباره آزمایش کنید. |
آزمایش مجدد
گواهی
اگر لازم است برای دریافت گواهینامه دوباره آزمایش کنید، باید دستگاهتان را پس‌از شروع آزمایش مجدد جفت کنید.
توسعه
اگر لازم است برای توسعه دوباره آزمایش کنید، می‌توانید از دستگاه موجود بدون جفت‌سازی مجدد استفاده کنید.
عیب‌یابی
دستگاه راه‌اندازی‌شده در «مجموعه آزمایشی» نشان داده نمی‌شود
اگر دستگاهی را با «شناسه فروشنده» (VID) و «شناسه محصول» (PID) آزمایشی مرتبط کرده‌اید، اما وقتی می‌خواهید دستگاه را با «مجموعه آزمون» آزمایش کنید در Developer Console نشان داده نمی‌شود، احتمالاً دلیل آن استفاده از ترکیب VID و PID آزمایشی یکسان در چندین ادغام است.
برای عیب‌یابی، همه دستگاه‌های آزمایشی را از Developer Console بردارید و دستگاهی را که می‌خواهید آزمایش کنید دوباره جفت کنید.
برای تأیید اینکه دستگاه درست را جفت کرده‌اید، می‌توانید اطلاعات «سازنده» و «مدل» (مقادیر CHIP_DEVICE_CONFIG_DEVICE_*) را برای دستگاه روی مقادیر منحصربه‌فرد در سفت‌افزار آزمایشی تنظیم کنید.
برای اطلاعات بیشتر، به اطلاعات دستگاه مراجعه کنید.
درستی‌سنجی کردن VID/PID دستگاه
اگر می‌خواهید توسعه ادغام با Google را شروع کنید، باید پروژه و ادغامی در Google Home Console ایجاد کنید.
مقدار VID/PID که دستگاهتان ارسال می‌کند باید با VID/PID واردشده در پروژه 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 خواهد بود.