להתאים את המכשיר התומך ב-Matter. לשם כך, תצטרכו קוד QR להתאמה. יכול להיות שתצטרכו ליצור את קוד ה-QR הזה בעצמכם, בהתאם לפלטפורמה של מכשיר Matter שלכם.
קבלת קוד QR
מעבדת בופלו
BL602
המחרוזת של קוד ה-QR מודפסת במסוף הטורי בעת הפעלת המכשיר. בודקים את המסוף הטורי. יוצגו לכם הודעות כאלה:
Booting BL602 Chip... ██████╗ ██╗ ██████╗ ██████╗ ██████╗ ██╔══██╗██║ ██╔════╝ ██╔═████╗╚════██╗ ██████╔╝██║ ███████╗ ██║██╔██║ █████╔╝ ██╔══██╗██║ ██╔═══██╗████╔╝██║██╔═══╝ ██████╔╝███████╗╚██████╔╝╚██████╔╝███████╗ ╚═════╝ ╚══════╝ ╚═════╝ ╚═════╝ ╚══════╝ ... [INFO] ================================================== [INFO] chip-bl602-lighting-example starting [INFO] ================================================== ... [INFO] [SVR] SetupQRCode: [MT:NOTAREALQRCODE01234] [INFO] [SVR] Copy/paste the below URL in a browser to see the QR Code: [INFO] [SVR] https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%NOTAREALQRCODE01234 ...
פותחים את הקישור בדפדפן אינטרנט כדי להציג את קוד ה-QR.
BL702
המחרוזת של קוד ה-QR מודפסת במסוף הטורי בעת הפעלת המכשיר. בודקים את המסוף הטורי. אמורות להופיע הודעות כאלה:
[ 0][-][PROGR] ================================================== [ 0][-][PROGR] bouffalolab chip-lighting-example, built at Dec 14 2022 02:05:19 [ 0][-][PROGR] ================================================== ... [ 1636][-][PROGR] Starting OpenThread task [ 1655][DL][PROGR] Device Configuration: [ 1703][DL][PROGR] Serial Number: TEST_SN [ 1703][DL][PROGR] Vendor Id: 65521 (0xFFF1) [ 1703][DL][PROGR] Product Id: 32773 (0x8005) [ 1752][DL][PROGR] Hardware Version: 0 [ 1799][DL][PROGR] Setup Pin Code (0 for UNKNOWN/ERROR): 20202021 [ 1846][DL][PROGR] Setup Discriminator (0xFFFF for UNKNOWN/ERROR): 3840 (0xF00) [ 1893][DL][PROGR] Manufacturing Date: (not set) [ 1893][DL][PROGR] Device Type: 65535 (0xFFFF) [ 1987][SVR][PROGR] SetupQRCode: [MT:NOTAREALQRCODE01234] [ 1987][SVR][PROGR] Copy/paste the below URL in a browser to see the QR Code: [ 1988][SVR][PROGR] https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%NOTAREALQRCODE01234
Espressif
Getting the QR code differs for each type of ESP32-based kit:
ESP32 DevkitC
- Connect the device to a host machine and use a serial
terminal to connect to it and display its logs. For example, on a
Linux host machine, you might use
screen /dev/ttyUSB0 115200
to connect to the device and view logs if it is attached to the host at/dev/ttyUSB0
. - A URL is displayed in the logs when the device is first booted.
Open the link in a web browser to display the QR code.
M5Stack ESP32
When first booted, the device will display a QR code menu option. Select it to see the QR code in the device's display.
ESP32 WROVER Kit
The device shows the QR code immediately after booting.
Nordic Semiconductor
nRF52840
Since the nRF52840 board doesn't have a display, the QR code string is printed in the serial console when it boots up. For example:
I: 1317 [SVR]SetupQRCode: [MT:I347HHY00 0C9SS0] I: 1321 [SVR]Copy/paste the below URL in a browser to see the QR Code: I: 1327 [SVR]https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3AI347HHY00%200C9SS0
פותחים את הקישור בדפדפן אינטרנט כדי להציג את קוד ה-QR.
ליגת ההוקי הלאומית (NXP)
K32W
המחרוזת של קוד ה-QR מודפסת במסוף הטורי בעת הפעלת המכשיר. בודקים את המסוף הטורי. יוצגו לכם הודעות כאלה:
[Info]Welcome to NXP Lighting Demo App [Info]OpenThread started: OK ... [Info]Server Listening... [Info]SetupQRCode: [MT:I34DVDY00 0C9SS0] [Info]Copy/paste the below URL in a browser to see the QR Code: [Info]https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3AI34DVDY00%200C9SS0 ...
פותחים את הקישור בדפדפן אינטרנט כדי להציג את קוד ה-QR.
ריאלטק
אמבה ד.
קוד ה-QR מקודד בכתובת URL, שמודפסת במסוף הטורי בזמן הפעלת הלוח של Ameba D:
Setup PIN code: 20202021 (0x1344225)
Short Manual(decimal) setup code: 34970112332
Long Manual(decimal) setup code: 749701123309050652796
QR CODE Text: 'MT:NOTAREALQRCODE01234'
Copy/paste the below URL in a browser to see the QR CODE:
https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3ANOTAREALQRCODE01234
פותחים את הקישור בדפדפן אינטרנט כדי להציג את קוד ה-QR.
מעבדות Silicon
EFR32MG12
אחרי הפעלת הלוח, אמור להופיע קוד QR בצג ה-LCD הקטן.
טיקישור
TLSR9518
המחרוזת של קוד ה-QR מודפסת במסוף הטורי כשהמכשיר מופעל. בודקים את המסוף הטורי. אמורה להופיע כתובת URL להצגת קוד ה-QR כשפותחים אותה בדפדפן:
*** Booting Zephyr OS build v3.1.0-rc1-3593-gdac17979d626 *** I: Init CHIP stack I: Starting CHIP task … I: 812 [DL]BLEManagerImpl::ConfigureAdvertisingData I: 823 [DL]Setting device name to : "TelinkMatter" … I: 1093 [SVR]SetupQRCode: [MT:NOTAREALQRCODE01234] I: 1099 [SVR]Copy/paste the below URL in a browser to see the QR Code: I: 1107 [SVR]https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3ANOTAREALQRCODE01234
התאמת המכשיר
יש שתי דרכים להתאים את המכשיר:
- Google Home app (GHA)
- ערכות ה-SDK של Google Home לנייד ו-Thread Network SDK עבור Android (שאפשר להשתמש בהן באפליקציה של צד שלישי)
שתי השיטות משתמשות באותם ממשקי API של Matter ו-Thread Network.
אפליקציית Google Home
- פותחים את GHA.
- מקישים על בפינה הימנית העליונה.
- מקישים על הגדרת מכשיר.
- מקישים על מכשיר חדש.
- בוחרים את הבית ומקישים על הבא.
- GHA יבצע סריקה לאיתור המכשיר שלך. כשמוצגת ההודעה אם רוצים להגדיר את המכשיר, מקישים על הגדרת מכשיר אחר.
- מקישים על מכשיר אחד (Matter) לכל סוג מכשיר.
- מכוונים את המצלמה אל קוד ה-QR של המכשיר (או אל קוד ה-QR שנוצר על ידי האתר).
- ממשיכים בתהליך ההתאמה כפי שמצוין בתהליך של GHA.
אם נתקלתם בבעיות במהלך ההתאמה עם GHA במכשיר הנייד:
- ודאו שהפעלתם את האפשרויות למפתחים במכשיר הנייד.
- מיד לאחר ניסיון ההתאמה שנכשל, יוצרים דוח על באג.
ערכות SDK ל-Android
Android ערכות SDK זמינות ב-Play services למטרות בדיקה והתאמה באפליקציה של צד שלישי.
מומלץ להתחיל עם Google Home Sample App for Matter, שמדגים איך לבצע עמלה, להתאים ולשלוט במכשיר שתומך ב-Matter בסביבה העסקית של Google Home באמצעות ערכות ה-SDK האלה.
תיעוד עזר עבור שתי ערכות ה-SDK זמין באתר זה:
הגבלות על התאמה
ניתן להתאים מכשיר Matter בסביבה העסקית של Google Home רק בתרחישים מסוימים של מזהה ספק וסוג מכשיר.
- לא ניתן להשתמש ב-VID לבדיקה במכשיר צרכן.
- ה-VID של סביבת הייצור חייב להיות מונפק על ידי Connectivity Standards Alliance (Alliance). Google תאמת את הבעלות שלכם על ה-VID הזה כדי שתוכלו להשתמש בו בGoogle Home Developer Console. לאחר מכן, תוכלו ליצור שילובים ל-VID הזה.
- למטרות פיתוח וניסויי שטח, יש ליצור ב-Developer Console פרויקט ושילוב עם השילוב המתאים של VID ו-PID. המשתמש שמזמין את המכשיר חייב להיות חבר בפרויקט או להיכלל ברשימת המשתמשים שמשתתפים בניסוי.
- צרכנים יכולים להשתמש במוצר רק אם הוא אושר על ידי Alliance.
אילו סוגי משתמשים יכולים להקצות את המכשיר לסביבה העסקית של Google Home? | |||
---|---|---|---|
סוג VID | סטטוס אישור VID וסטטוס השילוב של המסופים | ייצור
(משתמשים צרכנים) |
פיתוח
(מפתחים, משתמשים בתקופת ניסיון) |
בדיקה | אין שילוב ב-Developer Console (לא ניתן לקבל אישור) | ||
בדיקה | קיים שילוב ב-Developer Console (לא ניתן לאשר אותו) | ||
Production | לא אושר, השילוב לא קיים ב-Developer Console | ||
Production | לא אושר, השילוב קיים ב-Developer Console | ||
Production | אושר ב-DCL של Alliance, השילוב לא קיים בDeveloper Console | ||
Production | מאושר ב-DCL של Alliance והשילוב קיים בDeveloper Console |
פרטי המכשיר
מידע טכני על המכשיר המותאם זמין בGHA.
- בGHA, בוחרים את המכשיר.
- מקישים על הסמל בצד שמאל למעלה.
- מקישים על מידע טכני.
מזהים כמו יצרן, דגם וגרסת חומרה מגיעים מהקושחה Matter שבמכשיר, ולא מ-Developer Console. לדוגמה, הערכים CHIP_DEVICE_CONFIG_DEVICE_VENDOR_NAME
ו-CHIP_DEVICE_CONFIG_DEVICE_PRODUCT_NAME
בתצורת המכשיר ב- Matter SDK.
המזהים האלה יכולים לעזור לכם לוודא איזה מכשיר הותאם למטרות בדיקה, במיוחד כשמשתמשים במזהה ספק ובמזהה המוצר לבדיקה (אפשר לשכפל אותם בכל השילובים).
פתרון בעיות בהתאמה
אם התאמתם מכשיר למזהה ספק (VID) ולמזהה מוצר (PID) לבדיקה, אבל הוא לא מופיע כשמנסים לבדוק את המכשיר עם חבילת הבדיקה ב-Developer Console, סביר להניח שהסיבה לכך היא שימוש באותו שילוב של VID ו-PID לבדיקה.
כדי לפתור את הבעיה, צריך להסיר את כל מכשירי הבדיקה מ-Developer Console ולהתאים את המכשיר שרוצים לבדוק שוב.
כדי לוודא שהתאמתם את המכשיר הנכון, אפשר להגדיר את פרטי היצרן והדגם (ערכים של CHIP_DEVICE_CONFIG_DEVICE_*
) במכשיר כערכים ייחודיים בקושחת הבדיקה.
למידע נוסף, ראו מידע מהמכשירים שלך.