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

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

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

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

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

הגדרות

בתיעוד הזה נעשה שימוש במונחים הבאים:

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

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

תוספי IDE מומלצים לפיתוח בתקן Matter

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

  1. מרכז של Google עם תמיכה ב-Thread שישמש גם כנתב Border Router למכשירים שתומכים בפרוטוקול Thread וגם כנתיב מילוי בקשה מקומי לניתוב 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
מעבדת בופאלו BL602 התחלה מהירה
BL702 התחלה מהירה
אספרסיף ESP32 התחלה מהירה
בדיקת OTA
מוליכים למחצה נורדיים nRF52840 DK התחלה מהירה
בדיקת OTA
NXP ערכת פיתוח IOTZTB-DK006 התחלה מהירה
ריאלטק סדרת Ameba D התחלה מהירה
Silicon Labs EFR32MG24 ערכת פיתוח התחלה מהירה
EFR32MG Zigbee ו-Thread למתחילים התחלה מהירה
טקישור TLSR9518 התחלה מהירה
כלי נגינה של טקסס ערכת פיתוח CC2652R7 LaunchPad התחלה מהירה

מזהה הספק

כברירת מחדל, אפשר להשתמש באחד ממזהי ה-VID שהוקצו על ידי ה-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.
  • למטרות פיתוח וניסויי שטח, יש ליצור בDeveloper Console פרויקט ושילוב עם השילוב המתאים של VID ו-PID. המשתמש שמזמין את המכשיר חייב להיות חבר בפרויקט או להיכלל ברשימת המשתמשים בניסוי שטח.
  • צרכנים יכולים להשתמש במוצר רק אחרי שהוא קיבל אישור מAlliance.
טבלה: תרחישים של התאמה בין מזהה ספק (VID) לבין סוג מכשיר
אילו סוגי משתמשים יכולים להזמין את המכשיר לסביבה העסקית של Google Home?
סוג VID סטטוס אישור VID וסטטוס השילוב של המסוף ייצור
(משתמשים לצרכנים)
פיתוח
(מפתחים, משתמשים בתקופת ניסיון שטח)
בדיקה אין שילוב בDeveloper Console (לא ניתן לקבל אישור)
בדיקה השילוב קיים ב-Developer Console (לא ניתן לאשר אותו)
Production לא אושר, השילוב לא קיים בDeveloper Console
Production לא אושר, השילוב קיים בDeveloper Console
Production אושר ב-DCL של Alliance, השילוב לא קיים בDeveloper Console
Production אושר ב-DCL של Alliance והשילוב קיים בDeveloper Console

מזהה מוצר

הנתונים לגבי המכשיר נקראים מאשכול המידע הבסיסי של Matter. מזהה המוצר שקודד בקושחה של המכשיר חייב להתאים למזהה המוצר של השילוב של Matter ב-Play 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.

1 קראו את המאמר מתגי תאורה להפעלה/כיבוי כדי להבין איך זה משפיע על מתגי תאורה שפועלים/כיבוי.