תחילת העבודה עם 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 ועם Matter SDK.

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

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

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

הגדרות

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

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

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

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

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

  1. מרכז מידע של Google עם תמיכה בפרוטוקול Thread לשמש גם כנתב גבול עבור מכשירים שתומכים בפרוטוקולי 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 הדרכות
מעבדה Bouffalo BL602
BL702
אספרסיף ESP32 בדיקת OTA
מוליך למחצה נורדי nRF52840 DK בדיקת OTA
NXP פיתוח IOTZTB-DK006 ערכה
Realtek סדרת Ameba D
מעבדות סיליקון 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 הזה.
  • למטרות פיתוח וניסויים בשטח, יצירת פרויקט ושילוב עם את השילוב המתאים של VID ו-PID צריך ליצור ב-Developer Console. הזמנת המשתמש שהמכשיר חייב להיות חבר בפרויקט או להיכלל ברשימה מהמשתמשים בניסויי השטח.
  • צרכנים פרטיים יוכלו להשתמש במוצר רק לאחר שהוא אושר על ידי Alliance
טבלה: מזהה ספק (VID) וסוג מכשיר תרחישי התאמה
אילו סוגי משתמשים יכולים להזמין של המכשיר לסביבה העסקית של Google Home?
סוג VID הסטטוס של אישור VID והשילוב של המסוף ייצור
(משתמשים צרכנים)
פיתוח
(מפתחים, משתמשים בתקופת ניסיון)
בדיקה אין שילוב עם Developer Console (לא ניתן לאשר)
בדיקה השילוב קיים בקובץ Developer Console (לא יכול להיות מוסמך)
ייצור לא אושר, אבל לא קיים שילוב בDeveloper Console
ייצור לא אושר, השילוב קיים בDeveloper Console
ייצור אושר ב-DCLAlliance, השילוב לא קיימות בDeveloper Console
ייצור יש אישור ב-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 למידע נוסף על מתגי תאורה להפעלה/כיבוי ההשפעה על מתגי האור/הכיבוי.