תוכנית Google Home Developer מאפשרת ליצרני מכשירים לחבר את המכשירים שלהם לבית החכם לסביבה של 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. לאחר מכן, קראו את רשימת המשימות למפתחים כדי להבין את כל תהליך הפיתוח, מיצירת הפרויקט ועד להשקה.
מכשירים נתמכים רשימת משימות למפתחים
הגדרות
המונחים הבאים מופיעים לאורך המאמר:
- נתב גבולות
- רכזת שמטמיעה נתב גבולות (Border Router) לשימוש כללי ב-Thread למכשירים שתומכים ב-Thread.
- מרכז הפעילות
- מכשיר Google Nest נתמך, כמו Google Nest Hub (2nd gen). כדי לשלוט במכשירים שפועלים בתקן Matter באמצעות פלטפורמות אחרות כמו Assistant, GHA ומסכים חכמים, צריך רכזת ביתית.
- מכשיר עם Matter
- מכשיר או לוח פיתוח שצרובה עליהם גרסת build או אפליקציה לדוגמה עם תמיכה ב-Matter.
- בנייד
- טלפון הבדיקה שמשמש לסיוע בהתאמה. כרגע זה טלפון Android.
דרישות מוקדמות
כדי לשלב באופן מלא מכשיר שתומך ב-Matter עם המערכת של Google Home, המפתח צריך:
- רכזת של Google עם תמיכה בפרוטוקול Thread שתשמש גם כborder router למכשירים שתומכים בפרוטוקול Thread וגם כנתיב מקומי לשרשור פעולות (fulfillment) לניתוב כוונות (intents) של הבית החכם.
- מכשיר נייד (טלפון לבדיקה) שעומד בדרישות המינימליות:
- Android O (8.1, רמת API 27 ואילך)
- iOS (גרסה 16.5 ואילך)
- יכולת BLE
- מזהה ספק (VID) ומזהה מוצר (PID) של המכשיר עם תמיכה ב-Matter.
- מכשיר שתומך ב-Matter. המכשיר צריך להיות אחד מMatter סוגי המכשירים שנתמכים בסביבה של Google Home, ויכול להיות:
- מוצר משלכם עם קושחה שתומכת ב-Matter.
- אחד ממכשירי Matter הבאים כדי לבצע אימות מקצה לקצה:
| ספק | פלטפורמה | התמיכה של Thread | הדרכות |
|---|---|---|---|
| Bouffalo Lab | BL602 | ||
| BL702 | |||
| Espressif | ESP32 | בדיקות OTA | |
| Nordic Semiconductor | nRF52840 DK | בדיקות OTA | |
| NXP | ערכת הפיתוח IOTZTB-DK006 | ||
| Realtek | Ameba D Series | ||
| Silicon Labs | ערכת פיתוח EFR32MG24 | ||
| ערכת פיתוח EFR32MG Zigbee ו-Thread | |||
| Telink | TLSR9528 | מדריך למפתחים של Telink Matter | |
| Texas Instruments | ערכת פיתוח CC2652R7 LaunchPad |
מזהה הספק
כברירת מחדל, אתם יכולים להשתמש באחד ממזהי ה-VID שהוקצו על ידי Alliance למטרות בדיקה. בוחרים אחת מהאפשרויות הבאות: 0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.
כדי להשתמש ב-VID בסביבת ייצור, כך שתוכלו לאשר ולהשיק את השילוב, קודם כל Google צריכה לאמת אותו כדי לוודא שהוא הונפק לכם על ידי ה-Alliance.
צריך להטמיע את ה-VID הזה בקושחה של המכשיר.
אפשר להתאים מכשיר Matter בסביבה של Google Home רק בתרחישים מסוימים של מזהה ספק וסוג מכשיר.
- אי אפשר להשתמש ב-VID לבדיקה במכשיר של צרכן.
- מזהה ה-VID בסביבת הייצור צריך להיות מונפק על ידי Connectivity Standards Alliance (Alliance). Google תאמת שאתם הבעלים של ה-VID הזה לפני שתוכלו להשתמש בו ב-Google Home Developer Console. אחרי שהאימות יסתיים, תוכלו ליצור שילובים למזהה הזה.
- למטרות פיתוח וField Trial, צריך ליצור בDeveloper Console פרויקט ושילוב עם השילוב התואם של VID ו-PID. המשתמש שמפעיל את המכשיר צריך להיות חבר בפרויקט או להיכלל ברשימת המשתמשים של Field Trial.
- משתמשים פרטיים יכולים להשתמש במוצר רק אחרי שהוא קיבל אישור מ-Alliance.
אפשר להשתמש ב-VID וב-PID רק פעם אחת בשילוב אחד. אם אתם רוצים להשתמש באותו VID או PID בשילוב, אתם צריכים:
- עורכים את השילוב באמצעות ה-VID או ה-PID ל-VID או ל-PID אחר.
- מוחקים את השילוב באמצעות ה-VID או ה-PID.
| אילו סוגי משתמשים יכולים להפעיל את המכשיר בסביבה העסקית של Google Home? | |||
|---|---|---|---|
| סוג ה-VID | אישור VID וסטטוס השילוב של המסוף | ייצור
(משתמשים פרטיים) |
פיתוח
(מפתחים, Field Trial משתמשים) |
| בדיקה | אין שילוב ב-Developer Console (לא ניתן לאשר) | ||
| בדיקה | השילוב קיים ב-Developer Console (לא ניתן לאשר אותו) | ||
| ייצור | לא מאושר, השילוב לא קיים ב-Developer Console | ||
| ייצור | לא מאושר, השילוב קיים ב-Developer Console | ||
| ייצור | יש אישור ב-DCL של Alliance, אין שילוב ב-Developer Console | ||
| ייצור | יש אישור ב-DCL של Alliance והשילוב קיים ב-Developer Console | ||
מזהה מוצר
המידע על המכשיר נקרא מאשכול המידע הבסיסי של Matter. מזהה המוצר שמקודד בקושחה של המכשיר צריך להיות זהה למזהה המוצר של השילוב עם Matter ב-Developer Console.
תכונות שלא נתמכות
עם זאת, יכול להיות שהמערכת משתמשת באשכולות Matter מסוימים שעדיין לא חשופים למשתמשים. ברוב המקרים, המשמעות היא שמאפיינים שנחשפים דרך האשכולות האלה לא גלויים למשתמשי הקצה:
| Cluster Type | Clusters |
|---|---|
| Core |
|
| Application |
|
¹ במתגי תאורה להפעלה/כיבוי מוסבר איך זה משפיע על מתגי תאורה להפעלה/כיבוי.