תוכנית המפתחים של 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 לצורך פיתוח ודיפדוף (flashing) של דוגמאות Matter, שנבדקו על ידי Google. יש תמיכה במכונות macOS, אבל מומלץ להשתמש ב-Linux. הוראות ספציפיות ל-Mac מפורטות בתהליכים לפי הצורך.
איך יוצרים אפליקציות
כדי ליצור מכשיר שתומך ב-Matter ומשתלבש בסביבה העסקית של Google Home, צריך להשתמש בלוח פיתוח תואם ל-Matter וב-Matter SDK.
הדרך הקלה ביותר להתחיל היא לעבור על הקודלאב שלנו. מומלץ לעבור לפחות אחד מהקורסים הבאים ב-Codelab:
לאחר מכן, כדאי לבדוק את רשימת המכשירים הנתמכים כדי לוודא שהמכשיר שאתם מתכננים לשלב נתמך בסביבה של Google Home. לאחר מכן, כדאי לקרוא את רשימת המשימות למפתחים כדי להבין את כל תהליך הפיתוח, החל מיצירת הפרויקט ועד להשקה.
מכשירים נתמכים רשימת משימות למפתחים
הגדרות
המונחים הבאים מופיעים במסמכי העזרה:
- נתב גבולות
- רכז שמטמיע נתב Thread Border למטרות כלליות למכשירים שתומכים ב-Thread.
- קהילה
- מכשיר Google Nest נתמך, כמו Google Nest Hub (2nd gen). רכזת נדרשת כדי לשלוט במכשירים שתומכים ב-Matter דרך מכשירים אחרים, כמו Assistant, GHA ומסכים חכמים.
- מכשיר שתומך ב-Matter
- מכשיר או לוח פיתוח שעבר פלאש עם build או אפליקציה לדוגמה שתומכים ב-Matter.
- בנייד
- טלפון הבדיקה שמשמש לסיוע בהתאמה. כרגע זהו טלפון Android.
דרישות מוקדמות
כדי לשלב באופן מלא מכשיר שתומך ב-Matter עם הסביבה העסקית של Google Home, למפתחים צריכים להיות:
- רכזת Google עם תמיכה ב-Thread שתשמש גם כנתב גבול למכשירים שתומכים ב-Thread וגם כנתיב מקומי לשרשור פעולות (fullfillment) לצורך ניתוב כוונות (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 | TLSR9518 | ||
| Texas Instruments | ערכת הפיתוח LaunchPad של CC2652R7 |
מזהה הספק
כברירת מחדל, אפשר להשתמש באחד מ-VIDs שהוקצו על ידי CSA למטרות בדיקה. בוחרים באחת מהאפשרויות הבאות:
0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.
כדי להשתמש ב-VID בסביבת הייצור כדי לקבל אישור ולהשיק את השילוב, תחילה צריך לבצע אימות של ה-VID ב-Google כדי לוודא שהוא הונפק לכם על ידי ה-CSA.
צריך להטמיע את ה-VID הזה בקושחה של המכשיר.
אפשר להתאים מכשיר Matter לסביבה של Google Home רק בתרחישים מסוימים של מזהה ספק וסוג מכשיר.
- אי אפשר להשתמש ב-VID לבדיקה במכשיר של צרכן.
- ה-VID בסביבת הייצור צריך להונפק על ידי Connectivity Standards Alliance (Alliance). Google תאמתו שאתם הבעלים של ה-VID הזה לפני שתוכלו להשתמש בו ב-Google Home Developer Console. לאחר מכן תוכלו ליצור שילובים ל-VID הזה.
- למטרות פיתוח ו-Field Trial, צריך ליצור פרויקט ושילוב עם שילוב ה-VID וה-PID התואם ב-Developer Console. המשתמש שמפעיל את המכשיר צריך להיות חבר בפרויקט או להופיע ברשימה של משתמשי 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 במסוף הפיתוח.
תכונות שלא נתמכות
אשכולות Matter מסוימים עדיין לא חשופים למשתמשים, אבל יכול להיות שהמערכת תשתמש בהם. ברוב המקרים, המשמעות היא שמאפיינים שנחשפים באמצעות האשכולות האלה לא גלויים למשתמשי הקצה:
| Cluster Type | Clusters |
|---|---|
| Core |
|
| Application |
|
¹ במאמר מתגים להפעלה/כיבוי של תאורה מוסבר איך השינוי הזה משפיע על מתגים להפעלה/כיבוי של תאורה.