תחילת העבודה עם 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תמיכה ב-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). נדרש Hub כדי לשלוט במכשירים עם Matter באמצעות משטחים אחרים כמו Assistant,‏ GHA ומסכים חכמים.

מכשיר שתואם לתקן MatterMatter

מכשיר או לוח פיתוח שהותקן בהם build או אפליקציה לדוגמה עם תמיכה ב-Matter.

בנייד

הטלפון שמשמש לבדיקה כדי לסייע בהתאמה. כרגע זה טלפון Android.

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

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

1. רכזת Google עם תמיכה ב-Thread שתשמש כנתב גבולות למכשירים עם Thread וכמסלול מקומי לשרשור פעולות (fulfillment) לניתוב כוונות (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	TLSR9528		מדריך למפתחים בנושא Telink Matter
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. אחרי שזה יקרה, תוכלו ליצור שילובים עבור מזהה הספק הזה.
• למטרות פיתוח ו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 עדיין לא מוצגים למשתמשים, אבל יכול להיות שהמערכת משתמשת בהם. ברוב המקרים, המשמעות היא שהמאפיינים שנחשפים דרך האשכולות האלה לא גלויים למשתמשי קצה:

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