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

תוכנית המפתחים של Google Home מאפשרת ליצרני מכשירים לחבר את המכשירים החכמים שלהם לבית לסביבת 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 ועם ערכת ה-SDK של Matter.

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

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

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

הגדרות

המונחים הבאים מופיעים במסמכי העזרה:

נתב גבולות

רכז שמטמיע נתב Thread Border למטרות כלליות למכשירים שתומכים ב-Thread.

קהילה

מכשיר Google Nest נתמך, כמו Google Nest Hub (2nd gen). רכזת נדרשת כדי לשלוט במכשירים שתומכים ב-Matter דרך משטחים אחרים, כמו Assistant, ‏ GHA ומסכים חכמים.

מכשיר אחד (Matter) שתומך ב-

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

בנייד

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

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

כדי לשלב באופן מלא מכשיר שתומך ב-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 לצורך אימות מקצה לקצה:

מזהה הספק

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

כדי להשתמש ב-VID בסביבת הייצור כדי לקבל אישור ולהשיק את השילוב, תחילה צריך לבצע אימות של ה-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.

מזהה מוצר

המידע על המכשיר נקרא מאשכול המידע הבסיסי Matter. מזהה המוצר המקודד בקושחת המכשיר צריך להתאים למזהה המוצר של השילוב של Matter במסוף הפיתוח.

תכונות שלא נתמכות

אשכולות Matter מסוימים עדיין לא חשופים למשתמשים, אבל יכול להיות שהמערכת תשתמש בהם. ברוב המקרים, המשמעות היא שהמאפיינים שנחשפים באמצעות האשכולות האלה לא גלויים למשתמשי הקצה:

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