התאמה של מכשיר חשוב

התאמה של המכשיר שתומך ב-Matter. לשם כך, תצטרכו קוד QR להתאמה. בהתאם לפלטפורמה של מכשיר Matter, יכול להיות שתצטרכו ליצור את קוד ה-QR הזה בעצמכם.

קבלת קוד QR

מעבדה Bouffalo

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

  1. 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.
  2. 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.

Realtek

אמבה ד'

קוד ה-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.

מעבדות סיליקון

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

התאמת המכשיר

יש שתי דרכים להתאים את המכשיר:

  1. Google Home app (GHA)
  2. ערכות ה-SDK של Google Home לנייד ו-Thread רשת עבור Android (אפשר להשתמש בהן באפליקציה של צד שלישי)

שתי שיטות ה-API משתמשות באותם ממשקי API של הרשת Matter ו-Thread.

אפליקציית Google Home

  1. פותחים את GHA.
  2. מקישים על בפינה הימנית העליונה.
  3. מקישים על הגדרת המכשיר.
  4. מקישים על מכשיר חדש.
  5. בוחרים את הבית ומקישים על הבא.
  6. האפליקציה GHA תסרוק את המכשיר שלך. כשמוצגת ההודעה אם להגדיר את המכשיר, מקישים על הגדרת מכשיר אחר.
  7. מקישים על מכשיר אחד (Matter) לכל סוג של מכשיר.
  8. מכוונים את המצלמה לקוד ה-QR של המכשיר (או לקוד ה-QR שנוצר על ידי האתר).
  9. ממשיכים בתהליך ההתאמה כפי שמצוין בתהליך של GHA.

אם תיתקלו בבעיות במהלך ההתאמה עם GHA במכשיר הנייד:

  1. מוודאים שאפשרויות למפתחים מופעלות במכשיר הנייד.
  2. מיד אחרי ניסיון ההתאמה שנכשל, יוצרים דוח על באג.

ערכות Android SDK

מטמיעים את ערכות ה-SDK ל-Android כדי להתאים מכשירים בתקן Matter ולנהל רשתות של פרוטוקול Thread באפליקציה

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

פרטי המכשיר

אפשר לראות מידע טכני על המכשיר המותאם ב-GHA.

  1. בGHA, בוחרים את המכשיר.
  2. מקישים על הסמל בפינה השמאלית העליונה.
  3. מקישים על מידע טכני.

מזהים כמו Manufacturer, Model וגרסת החומרה מגיעים מהקושחה של Matter במכשיר, ולא מה-Developer Console. לדוגמה, הערכים CHIP_DEVICE_CONFIG_DEVICE_VENDOR_NAME ו-CHIP_DEVICE_CONFIG_DEVICE_PRODUCT_NAME בהגדרת המכשיר ב- Matter SDK.

המזהים האלה יכולים לעזור לאמת איזה מכשיר הותאם למטרות בדיקה, במיוחד כשמשתמשים במזהה ספק לבדיקה ובמזהה מוצר (שאפשר לשכפל בכל השילובים).

פתרון בעיות בהתאמה

אם התאמתם מכשיר למזהה ספק (VID) ולמזהה מוצר (PID) לבדיקה, אבל הוא לא מופיע כשמנסים לבדוק את המכשיר עם חבילת Test ב-Developer Console, סביר להניח שהסיבה לכך היא שימוש באותו שילוב של VID ו-PID לבדיקה בכמה שילובים.

כדי לפתור את הבעיה, מסירים את כל מכשירי הבדיקה מ-Developer Console ומתאימים את המכשיר שרוצים לבדוק שוב.

כדי לוודא שההתאמתם את המכשיר הנכון, תוכלו להגדיר את פרטי היצרן והדגם (ערכי CHIP_DEVICE_CONFIG_DEVICE_*) של המכשיר לערכים ייחודיים בקושחה של הבדיקה.

למידע נוסף, ראו מידע מהמכשירים.