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

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

מזהה מוצר

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

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