با ماده شروع کنید

برنامه 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 است.

پیش نیازها

پسوندهای IDE توصیه شده برای توسعه Matter

برای ادغام کامل یک دستگاه دارای Matter با اکوسیستم Google Home، یک برنامه‌نویس باید:

  1. یک مرکز Google با پشتیبانی Thread که هم به عنوان یک مسیریاب مرزی برای دستگاه‌های دارای Thread و هم به عنوان یک مسیر تکمیل محلی برای مسیریابی اهداف خانه هوشمند عمل می‌کند.
  2. یک دستگاه تلفن همراه (تلفن آزمایشی) که حداقل شرایط را برآورده می کند:
    • Android O (8.1، API سطح 27 یا جدیدتر)
    • iOS (نسخه 16.5 یا جدیدتر)
    • قابلیت BLE
  3. شناسه فروشنده (VID) و شناسه محصول (PID) برای دستگاه دارای Matter -enabled.
  4. دستگاهی با قابلیت Matter . این دستگاه باید یکی از انواع دستگاه Matter باشد که در اکوسیستم Google Home پشتیبانی می‌شود و می‌تواند:
    • محصول خودتان با سیستم عامل Matter -enabled.
    • یکی از دستگاه‌های Matter زیر که برای تأیید سرتاسر استفاده می‌شود:
جدول: نمونه های 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) و سناریوهای جفت شدن نوع دستگاه
کدام نوع از کاربران می توانند دستگاه را وارد اکوسیستم 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 هنوز در معرض کاربران قرار نگرفته اند، اگرچه ممکن است توسط سیستم استفاده شوند. در بیشتر موارد، این بدان معنی است که ویژگی هایی که از طریق این خوشه ها در معرض دید قرار می گیرند برای کاربران نهایی قابل مشاهده نیستند:

Table: Matter clusters not exposed to users in the Google Home ecosystem
Cluster Type Clusters
Core
  • Binding ¹
  • Label
  • Fixed Label
  • User Label
  • Actions
  • Group Key
  • Localization Configuration
  • Time Format Localization
  • Unit Localization
  • Power Source Configuration
  • Power Source
  • Diagnostics clusters (Diagnostic Logs, General Diagnostics, Software Diagnostics, Thread Network Diagnostics, Wi-Fi Network Diagnostics, Ethernet Network Diagnostics)
  • Time Synchronization
  • Mode Select
Application
  • Groups and Scenes are not directly supported. Equivalent functionality is available via Routines .
  • All Media clusters. Equivalent functionality is available via Google Cast .

¹ برای چگونگی تأثیر این موضوع بر کلیدهای روشن/خاموش نور، به کلیدهای روشن/خاموش نور مراجعه کنید.