برنامه Google Home Developer به سازندگان دستگاه اجازه می دهد تا دستگاه های خانه هوشمند خود را به اکوسیستم Google Home متصل کنند. ما در حال گسترش مسیر تحقق محلی Smart Home Actions با قابلیت افزودن دستگاه‌های دارای Matter برای راه‌اندازی با استفاده از Google Home app (GHA) و کنترل آنها با استفاده از Google Assistant ، GHA یا نمایشگرهای هوشمند مانند Google Nest Hub (2nd gen) هستیم. .
این مستندات نحوه شروع ساخت و ادغام یک پلت فرم با پشتیبانی Matter در اکوسیستم Google Home را شرح می دهد.
سلب مسئولیت
با توجه به رویه های شرح داده شده در مستندات Matter ، به موارد زیر توجه داشته باشید:
- توصیه می‌کنیم حسابی که برای توسعه استفاده می‌شود، فقط یک مرکز فعال Matter برای آزمایش متصل باشد. هاب های فعال چندگانه که به طور Matter و یا در طول آزمایش به یک ساختار متصل می شوند، می تواند منجر به رفتار غیرقابل پیش بینی شود.
- همه رویه‌ها استفاده از یک ماشین لینوکس با Ubuntu 20.04 را برای ساختن و فلش کردن نمونه‌های Matter که توسط Google آزمایش شده‌اند، فرض می‌کنند. در حالی که ماشین‌های macOS پشتیبانی می‌شوند، لینوکس توصیه می‌شود. دستورالعمل‌های مخصوص Mac در صورت لزوم در رویه‌ها فراخوانی می‌شوند.
نحوه ساخت
برای ساختن یک دستگاه دارای Matter که با اکوسیستم Google Home ادغام می شود، با یک برد توسعه سازگار با Matter و Matter SDK کار خواهید کرد.
ساده ترین راه برای شروع، مرور کدهای ما است. توصیه می کنیم حداقل یکی از کدهای زیر را انجام دهید:
پس از آن، فهرست دستگاه‌های پشتیبانی‌شده ما را بررسی کنید تا مطمئن شوید که آنچه می‌خواهید ادغام کنید در اکوسیستم Google Home پشتیبانی می‌شود. سپس چک لیست توسعه دهندگان را بخوانید تا کل جریان توسعه را از ایجاد پروژه تا راه اندازی درک کنید.
چک لیست برنامه نویس دستگاه های پشتیبانی شده
تعاریف
عبارات زیر در سراسر این مستندات استفاده می شود:
- روتر مرزی
- هابی که یک مسیریاب مرزی Thread منظوره برای دستگاه های دارای Thread را پیاده سازی می کند.
- هاب
- یک دستگاه Google Nest پشتیبانی شده، مانند Google Nest Hub (2nd gen) . یک هاب برای کنترل دستگاه‌های دارای Matter از طریق سطوح دیگر مانند Assistant ، GHA و نمایشگرهای هوشمند مورد نیاز است.
- دستگاه دارای Matter فعال
- دستگاه یا برد توسعه که با ساخت یا برنامه نمونه دارای Matter فلش شده است.
- دستگاه موبایل
- تلفن آزمایشی برای کمک به جفت شدن استفاده می شود. در حال حاضر این یک گوشی Android است.
پیش نیازها
برای ادغام کامل یک دستگاه دارای Matter با اکوسیستم Google Home، یک برنامه‌نویس باید:
- یک مرکز Google با پشتیبانی Thread که هم به عنوان یک مسیریاب مرزی برای دستگاه‌های دارای Thread و هم به عنوان یک مسیر تکمیل محلی برای مسیریابی اهداف خانه هوشمند عمل می‌کند.
- یک دستگاه تلفن همراه (تلفن آزمایشی) که حداقل شرایط را برآورده می کند:
- Android O (8.1، API سطح 27 یا جدیدتر)
- iOS (نسخه 16.5 یا جدیدتر)
- قابلیت BLE
- شناسه فروشنده (VID) و شناسه محصول (PID) برای دستگاه دارای Matter -enabled.
- دستگاهی با قابلیت Matter . این دستگاه باید یکی از انواع دستگاه Matter باشد که در اکوسیستم Google Home پشتیبانی می‌شود و می‌تواند:
- محصول خودتان با سیستم عامل Matter -enabled.
- یکی از دستگاه‌های Matter زیر که برای تأیید سرتاسر استفاده می‌شود:
| فروشنده | پلت فرم | پشتیبانی Thread | راهنما |
|---|---|---|---|
| آزمایشگاه بوفالو | BL602 | ||
| BL702 | |||
| اسپرسف | ESP32 | تست OTA | |
| نیمه هادی نوردیک | nRF52840 DK | تست OTA | |
| NXP | کیت توسعه IOTZTB-DK006 | ||
| Realtek | Ameba سری D | ||
| آزمایشگاه سیلیکون | کیت توسعه دهنده EFR32MG24 | ||
| EFR32MG Zigbee and Thread Starter Kit | |||
| Telink | TLSR9518 | ||
| تگزاس اینسترومنتز | کیت توسعه لانچ پد CC2652R7 |
شناسه فروشنده
به طور پیش فرض، می توانید از یکی از VID های اختصاص داده شده توسط CSA برای اهداف آزمایشی استفاده کنید. یکی از موارد زیر را انتخاب کنید: 0xFFF1 ، 0xFFF2 ، 0xFFF3 ، 0xFFF4 .
برای استفاده از یک تولید VID به‌منظور تأیید و راه‌اندازی یکپارچه‌سازی شما، ابتدا باید آن را توسط Google تأیید کنید تا مطمئن شوید که توسط CSA برای شما صادر شده است.
این VID باید در سیستم عامل دستگاه شما پیاده سازی شود.
دستگاه Matter را فقط می‌توان در اکوسیستم Google Home در سناریوهای خاص فروشنده شناسه و نوع دستگاه جفت کرد.
- یک VID آزمایشی را نمی توان در دستگاه مصرف کننده استفاده کرد.
- VID تولید شما باید توسط Connectivity Standards Alliance (Alliance) صادر شود. قبل از اینکه بتوانید از آن در Google Home Developer Console استفاده کنید، Google تأیید می کند که شما مالک آن VID هستید. وقتی این اتفاق افتاد، می‌توانید برای آن VID یکپارچه‌سازی ایجاد کنید.
- برای اهداف توسعه و آزمایش میدانی، یک پروژه و ادغام با ترکیب VID و PID مربوطه باید در Developer Console ایجاد شود. کاربری که دستگاه را راه اندازی می کند یا باید عضو پروژه باشد یا در لیست کاربران آزمایشی میدانی قرار گیرد.
- کاربران مصرف کننده تنها زمانی می توانند از محصول شما استفاده کنند که توسط Alliance تایید شده باشد.
VID و PID فقط یک بار برای یک ادغام قابل استفاده هستند. اگر می خواهید از همان VID یا PID در ادغام خود استفاده کنید، باید یکی از موارد زیر را انجام دهید:
- ادغام را با استفاده از VID یا PID به یک VID یا PID دیگر ویرایش کنید.
- ادغام را با استفاده از VID یا PID حذف کنید.
| کدام نوع از کاربران می توانند دستگاه را وارد اکوسیستم Google Home کنند؟ | |||
|---|---|---|---|
| نوع VID | گواهی VID و وضعیت یکپارچه سازی کنسول | تولید (کاربران مصرف کننده) | توسعه (توسعه دهندگان، کاربران آزمایشی میدانی) |
| تست کنید | عدم ادغام در Developer Console (نمی توان تایید کرد) | ||
| تست کنید | ادغام در Developer Console وجود دارد (نمی توان تایید کرد) | ||
| تولید | تایید نشده است، ادغام در Developer Console وجود ندارد | ||
| تولید | تایید نشده است، یکپارچه سازی در Developer Console وجود دارد | ||
| تولید | دارای گواهینامه Alliance DCL، ادغام در Developer Console وجود ندارد | ||
| تولید | دارای گواهینامه Alliance DCL و ادغام در Developer Console وجود دارد | ||
شناسه محصول
اطلاعات مربوط به دستگاه از خوشه اطلاعات اساسی Matter خوانده می شود. شناسه محصول کدگذاری شده در سیستم عامل دستگاه شما باید با شناسه محصول ادغام Matter در Developer Console مطابقت داشته باشد.
ویژگی های پشتیبانی نشده
برخی از خوشه های Matter هنوز در معرض کاربران قرار نگرفته اند، اگرچه ممکن است توسط سیستم استفاده شوند. در بیشتر موارد، این بدان معنی است که ویژگی هایی که از طریق این خوشه ها در معرض دید قرار می گیرند برای کاربران نهایی قابل مشاهده نیستند:
| Cluster Type | Clusters |
|---|---|
| Core |
|
| Application |
|
¹ برای چگونگی تأثیر این موضوع بر کلیدهای روشن/خاموش نور، به کلیدهای روشن/خاموش نور مراجعه کنید.