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

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

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

כתבי ויתור

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

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

איך בונים

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

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

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

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

הגדרות

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

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

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

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

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

  1. מרכז של Google עם תמיכה ב-Thread שישמש גם כנתב Border במכשירים שתומכים בפרוטוקול Thread וגם כנתיב למילוי הזמנות מקומי לניתוב אובייקטים מסוג Intent בבית חכם.
  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 EFR32MG24 ערכת פיתוח
EFR32MG Zigbee ו-Thread Starter Kit
טיקישור 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 קראו את המאמר מתגי תאורה להפעלה/כיבוי כדי להבין איך זה משפיע על מתגי תאורה שפועלים/כיבוי.

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