תחילת העבודה עם Matter

תוכנית המפתחים של Google Home מאפשרת ליצרני מכשירים לחבר את המכשירים החכמים לבית שלהם למערכת האקולוגית של Google Home. אנחנו מרחיבים את נתיב ההשלמה המקומי של פעולות לבית חכם, ומוסיפים לו את האפשרות להגדיר מכשירים עם תמיכה ב-Matter באמצעות Google Home app (GHA) ולשלוט בהם באמצעות Google Assistant, ‏ GHA או מסכים חכמים כמו Google Nest Hub (2nd gen).

במאמר הזה נסביר איך מתחילים לפתח ולשלב פלטפורמה שתומכת ב-Matter במערכת האקולוגית של Google Home.

כתבי ויתור

לגבי ההליכים שמתוארים במסמכי התיעוד של Matter Google Workspace, חשוב לשים לב לנקודות הבאות:

  • מומלץ שבחשבון שמשמש לפיתוח יהיה רק מרכז בקרה אחד עם Matterשמופעל לצורך בדיקה. חיבור של כמה רכזות עם Matterבדיקות בו-זמנית או חיבור שלהן לאותו בית במהלך הבדיקה עלול לגרום להתנהגות בלתי צפויה.
  • כל הפרוצדורות מניחות שימוש במחשב Linux עם Ubuntu 20.04 לצורך בנייה והפעלה של דוגמאות Matter שנבדקו על ידי Google. מכשירי macOS נתמכים, אבל מומלץ להשתמש ב-Linux. ההוראות הספציפיות ל-Mac מופיעות בתהליכים לפי הצורך.

איך יוצרים

כדי ליצור מכשיר עם תמיכה ב-Matter שמשתלב עם המערכת האקולוגית של Google Home, תצטרכו לעבוד עם לוח פיתוח שתואם ל-Matter ועם Matter SDK.

הדרך הקלה ביותר להתחיל היא לעבור על ה-codelabs שלנו. מומלץ לבצע לפחות אחד מה-codelabs הבאים:

לאחר מכן, כדאי לעיין ברשימת המכשירים הנתמכים כדי לוודא שהמכשיר שאתם מתכננים לשלב נתמך במערכת האקולוגית של Google Home. לאחר מכן, כדאי לעיין ברשימת המשימות לפיתוח כדי להבין את כל תהליך הפיתוח, מיצירת הפרויקט ועד להשקה.

מכשירים נתמכים רשימת משימות למפתחים

הגדרות

במסמכי התיעוד האלה נעשה שימוש במונחים הבאים:

נתב גבולות
רכזת שמטמיעה נתב גבולות Threadלמטרות כלליות Threadעבור מכשירים עם פרוטוקול Thread.
קהילה
מכשיר Google Nest נתמך, כמו Google Nest Hub (2nd gen). כדי לשלוט במכשירים שתומכים ב-Matter באמצעות פלטפורמות אחרות כמו Assistant, GHA ומסכים חכמים, צריך רכזת.
מכשיר שתואם לתקן MatterMatter
מכשיר או לוח פיתוח שהותקן בהם build או אפליקציה לדוגמה עם תמיכה ב-Matter.
בנייד
הטלפון שמשמש לבדיקה כדי לסייע בהתאמה. כרגע זה טלפון Android.

דרישות מוקדמות

תוספים מומלצים ל-IDE לפיתוח Matter

כדי לשלב באופן מלא מכשיר שתואם ל-Matter עם המערכת האקולוגית של Google Home, המפתח צריך:

  1. רכזת Google עם תמיכה בפרוטוקול Thread שתשמש כנתב גבולות למכשירים עם פרוטוקול Thread וכמסלול מקומי לשרשור פעולות (fullfillment) לניתוב כוונות (intents) של הבית החכם.
  2. מכשיר נייד (טלפון לבדיקה) שעומד בדרישות המינימליות:
    • ‫Android O (8.1, ‏ API ברמה 27 ומעלה)
    • ‫iOS (גרסה 16.5 ואילך)
    • יכולת BLE
  3. מזהה ספק (VID) ומזהה מוצר (PID) למכשיר עם תמיכה ב-Matter.
  4. מכשיר שתואם לתקן Matter. המכשיר צריך להיות אחד מMatterסוגי המכשירים שנתמכים במערכת האקולוגית של Google Home, והוא יכול להיות:
    • מוצר משלכם עם קושחה שמופעלת באמצעות Matter.
    • אחד מהמכשירים הבאים 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 and Thread Starter Kit
Telink TLSR9518
Texas Instruments ערכת פיתוח CC2652R7 LaunchPad

מזהה הספק

כברירת מחדל, אפשר להשתמש באחד ממזהי הספק שהוקצו על ידי ה-CSA למטרות בדיקה. בוחרים באחת מהאפשרויות הבאות: 0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.

כדי להשתמש ב-VID של סביבת הייצור כדי שהשילוב שלכם יוכל לעבור אישור ולהיות מושק, קודם צריך לוודא ש-Google אימתה אותו כדי לוודא שהוא הונפק לכם על ידי ה-CSA.

צריך להטמיע את ה-VID הזה בקושחה של המכשיר.

אפשר לשייך מכשיר Matter למערכת האקולוגית של Google Home רק בתרחישים מסוימים של מזהה ספק וסוג מכשיר.

  • אי אפשר להשתמש ב-VID לבדיקה במכשיר לצרכן.
  • מספר הספק (VID) שלכם בסביבת הייצור צריך להיות מונפק על ידי Connectivity Standards Alliance (Alliance). ‫Google תאמת שאתם הבעלים של ה-VID הזה לפני שתוכלו להשתמש בו ב-Google Home Developer Console. אחרי שזה יקרה, תוכלו ליצור שילובים עבור מזהה ה-VID הזה.
  • למטרות פיתוח וField Trial, צריך ליצור פרויקט ושילוב עם שילוב ה-VID וה-PID המתאים ב-Developer Console. המשתמש שמפעיל את המכשיר צריך להיות חבר בפרויקט או להיכלל ברשימת המשתמשים Field Trial.
  • משתמשים פרטיים יכולים להשתמש במוצר שלכם רק אחרי שהוא מקבל אישור מ-Alliance.

אפשר להשתמש ב-VID וב-PID רק פעם אחת לשילוב אחד. אם רוצים להשתמש באותו VID או PID בשילוב, צריך:

  • עורכים את השילוב באמצעות ה-VID או ה-PID כדי להשתמש ב-VID או ב-PID אחרים.
  • מוחקים את השילוב באמצעות ה-VID או ה-PID.
‫
טבלה: תרחישי שיוך של מזהה ספק (VID) וסוג מכשיר
אילו סוגי משתמשים יכולים להפעיל את המכשיר במערכת Google Home?
סוג ה-VID סטטוס האישור של VID והשילוב במסוף ייצור
(משתמשים במוצרים לצרכנים)		 פיתוח
(מפתחים, משתמשי Field Trial)
בדיקה אין שילוב ב-Developer Console (לא ניתן לאשר)
בדיקה השילוב קיים ב-Developer Console (לא ניתן לאשר אותו)
ייצור לא אושר, השילוב לא קיים ב-Developer Console
ייצור לא קיבל אישור, השילוב קיים בDeveloper Console
ייצור השילוב מאושר ב-Alliance DCL, אבל הוא לא קיים ב-Developer Console
ייצור יש אישור ל-Alliance DCL והשילוב קיים ב-Developer Console

מזהה מוצר

המידע על המכשיר נקרא מתוך Matter Basic Information Cluster. מזהה המוצר שמוצפן בקושחה של המכשיר צריך להיות זהה למזהה המוצר של השילוב 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.

‫¹ במאמר מתגי אור עם הפעלה/כיבוי מוסבר איך זה משפיע על מתגי אור עם הפעלה/כיבוי.

הבא
רשימת משימות למפתחים