برنامه «توسعه‌دهنده خانه هوشمند» Google به تولیدکنندگان دستگاه امکان می‌دهد دستگاه‌های خانه هوشمند خود را به بوم‌سازگان Google Home متصل کنند. درحال گسترش مسیر اجرای محلی «کنش‌های خانه هوشمند» با قابلیت افزودن دستگاه‌های فعال‌شده با Matter برای راه‌اندازی بااستفاده از Google Home app (GHA) و کنترل آن‌ها بااستفاده از Google Assistant، GHA، یا نمایشگرهای هوشمند مثل Google Nest Hub (2nd gen) هستیم.
این سند نحوه شروع به کار با ساختن و ادغام کردن پلاتفرم پشتیبانی‌شده با Matter در بوم‌سازگان Google Home را شرح می‌دهد.
سلب مسئولیت‌ها
درباره رویه‌های شرح‌داده‌شده در مستندات Matter، به موارد زیر توجه کنید:
- توصیه می‌کنیم حسابی که برای توسعه استفاده می‌شود فقط یک مرکز Matterفعال‌شده متصل برای آزمایش داشته باشد. چندین هاب فعال‌شده با Matter که به‌طور هم‌زمان متصل شده‌اند یا درطول آزمایش به ساختار یکسانی متصل شده‌اند می‌توانند منجر به عملکرد غیرقابل پیش‌بینی شوند.
- همه رویه‌ها استفاده از ماشین Linux با سیستم‌عامل Ubuntu 20.04 را برای ساختن و فلش کردن نمونه‌های Matter که توسط Google آزمایش شده‌اند، فرض می‌کنند. اگرچه از ماشین‌های macOS پشتیبانی می‌شود، اما Linux توصیه می‌شود. دستورالعمل‌های ویژه Mac درصورت نیاز در رویه‌ها ذکر می‌شوند.
نحوه ساختن
برای ساختن دستگاه سازگار با Matter که با بوم‌سازگان Google Home یکپارچه می‌شود، باید با برد توسعه سازگار با Matter و Matter SDK کار کنید.
آسان‌ترین راه برای شروع کار، گذراندن دوره‌های کدنویسی ما است. توصیه می‌کنیم حداقل یکی از codelabهای زیر را انجام دهید:
پس‌از آن، فهرست دستگاه‌های پشتیبانی‌شده ما را بررسی کنید تا مطمئن شوید آنچه را که قصد دارید ادغام کنید در بوم‌سازگان Google Home پشتیبانی می‌شود. سپس فهرست وارسی توسعه‌دهنده را بخوانید تا کل جریان توسعه از ایجاد پروژه تا راه‌اندازی را درک کنید.
دستگاه‌های پشتیبانی‌شده فهرست وارسی توسعه‌دهنده
تعاریف
اصطلاحات زیر در سراسر این مستندات استفاده می‌شود:
- رهیاب مرزی
- مرکزی که Thread رهیاب مرزی همه‌منظوره را برای دستگاه‌های سازگار با Thread پیاده‌سازی می‌کند.
- مرکز
- دستگاه Google Nest پشتیبانی‌شده، مانند Google Nest Hub (2nd gen). برای کنترل دستگاه‌های سازگار با Matter ازطریق سطوح دیگر مثل Assistant، GHA، و نمایشگرهای هوشمند، به هاب نیاز است.
- دستگاه سازگار با Matter
- دستگاه یا برد توسعه‌ای که با ساخت یا برنامه نمونه Matterفعال‌شده فلش شده است.
- دستگاه همراه
- تلفن آزمایشی برای کمک به جفت‌سازی استفاده می‌شود. درحال‌حاضر این تلفن Android است.
پیش‌نیازها
برای ادغام کامل دستگاه سازگار با Matter با اکوسیستم Google Home، توسعه‌دهنده باید موارد زیر را داشته باشد:
- مرکز کنترل Google با پشتیبانی از Thread که هم به‌عنوان border router برای دستگاه‌های سازگار با Thread و هم به‌عنوان مسیر اجرای محلی برای مسیریابی اهداف «خانه هوشمند» عمل می‌کند.
- دستگاه همراه (تلفن آزمایش) که حداقل الزامات را برآورده کند:
- Android O (نسخه ۸.۱، سطح API ۲۷ یا جدیدتر)
- iOS (نسخه ۱۶.۵ یا جدیدتر)
- قابلیت بلوتوث کم‌مصرف
- شناسه فروشنده (VID) و شناسه محصول (PID) برای دستگاه دارای Matter.
- دستگاهی سازگار با Matter. این دستگاه باید یکی از
انواع دستگاه Matter پشتیبانی‌شده در
اکوسیستم Google Home باشد و می‌تواند موارد زیر باشد:
- محصول خودتان با سفت‌افزار فعال‌شده Matter.
- یکی از دستگاه‌های Matter زیر برای استفاده در درستی‌سنجی سرتاسری:
| فروشنده | پلاتفرم | پشتیبانی Thread | راهنما |
|---|---|---|---|
| Bouffalo Lab | BL602 | ||
| BL702 | |||
| Espressif | ESP32 | آزمایش OTA | |
| Nordic Semiconductor | nRF52840 DK | آزمایش OTA | |
| NXP | کیت توسعه IOTZTB-DK006 | ||
| Realtek | Ameba D Series | ||
| Silicon Labs | EFR32MG24 Dev Kit | ||
| کیت شروع به کار EFR32MG Zigbee و Thread | |||
| Telink | TLSR9528 | راهنمای توسعه‌دهنده Telink Matter | |
| Texas Instruments | کیت توسعه LaunchPad مدل CC2652R7 |
شناسه ارائه‌دهنده
به‌طور پیش‌فرض، می‌توانید از یکی از VIDs اختصاص‌داده‌شده توسط «اتحاد» برای
اهداف آزمایشی استفاده کنید. یکی از موارد زیر را انتخاب کنید:
0xFFF1، 0xFFF2، 0xFFF3، 0xFFF4.
برای استفاده از VID «تولید» به‌طوری که یکپارچه‌سازی شما بتواند گواهی و راه‌اندازی شود، ابتدا باید آن را در Google درستی‌سنجی کنید تا مطمئن شوید که «ائتلاف» آن را برای شما صادر کرده است.
این VID باید در میان‌افزار دستگاهتان پیاده‌سازی شود.
دستگاه Matter فقط در برخی‌از سناریوهای «شناسه فروشنده» و نوع دستگاه در بوم‌سازگان Google Home جفت می‌شود.
- نمی‌توان از VID آزمایشی در دستگاه مصرف‌کننده استفاده کرد.
- «شماره شناسایی تولیدکننده» شما باید توسط Connectivity Standards Alliance (Alliance) صادر شده باشد. قبل‌از اینکه بتوانید از آن VID در Google Home Developer Console استفاده کنید، Google مالکیت شما را بر آن VID تأیید خواهد کرد. پس‌از آن می‌توانید برای آن VID ادغام ایجاد کنید.
- برای اهداف توسعه و Field Trial، باید پروژه و ادغام با ترکیب VID و PID مربوطه در Developer Console ایجاد شود. کاربری که دستگاه را راه‌اندازی می‌کند باید یا عضو پروژه باشد یا در فهرست کاربران Field Trial قرار داشته باشد.
- کاربران مصرف‌کننده فقط پس‌از اینکه محصولتان توسط Alliance گواهی شد می‌توانند از آن استفاده کنند.
از VID و PID فقط یک‌بار برای یک یکپارچه‌سازی می‌توان استفاده کرد. اگر می‌خواهید از همان VID یا PID در یکپارچه‌سازی‌تان استفاده کنید، باید:
- یکپارچه‌سازی را بااستفاده از VID یا PID به VID یا PID دیگری ویرایش کنید.
- یکپارچه‌سازی را بااستفاده از VID یا PID حذف کنید.
| کدام نوع کاربران می‌توانند دستگاه را در اکوسیستم Google Home راه‌اندازی کنند؟ | |||
|---|---|---|---|
| نوع VID | وضعیت گواهینامه VID و یکپارچه‌سازی کنسول | تولید
(کاربران مصرف‌کننده) |
توسعه
(توسعه‌دهندگان، Field Trial کاربر) |
| آزمایش | یکپارچه‌سازی در Developer Console وجود ندارد (نمی‌تواند گواهینامه دریافت کند) | ||
| آزمایش | یکپارچه‌سازی در Developer Console وجود دارد (نمی‌تواند گواهینامه دریافت کند) | ||
| تولید | گواهی ندارد، یکپارچه‌سازی در Developer Console وجود ندارد | ||
| تولید | گواهی ندارد، ادغام در Developer Console وجود دارد | ||
| تولید | در Alliance DCL گواهینامه دارد، ادغام در Developer Console وجود ندارد | ||
| تولید | در Alliance DCL گواهینامه دارد و یکپارچه‌سازی در Developer Console وجود دارد | ||
شناسه محصول
اطلاعات مربوط به دستگاه از «خوشه اطلاعات پایه» Matter خوانده می‌شود. «شناسه محصول» کدبندی‌شده در سخت‌افزار دستگاهتان باید با «شناسه محصول» ادغام Matter در «کنسول توسعه‌دهندگان» مطابقت داشته باشد.
ویژگی‌های پشتیبانی‌نشده
برخی‌از خوشه‌های Matter هنوز برای کاربران نمایش داده نمی‌شوند، هرچند ممکن است سیستم از آن‌ها استفاده کند. در بیشتر موارد، این یعنی مشخصه‌هایی که ازطریق این خوشه‌ها نمایان می‌شوند برای کاربران نهایی قابل‌مشاهده نیستند:
| Cluster Type | Clusters |
|---|---|
| Core |
|
| Application |
|
¹ برای اطلاع از اینکه این موضوع چگونه بر «کلیدهای روشن/خاموش چراغ» تأثیر می‌گذارد، کلیدهای روشن/خاموش چراغ را ببینید.