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

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

קבלת קוד QR

Bouffalo Lab

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

Ameba D

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

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 לנייד ולרשת Thread עבור Android (שאפשר להשתמש בהן באפליקציה של צד שלישי)

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

אפליקציית Google Home

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

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

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

ערכות SDK ל-Android

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

ערכות ה-SDK של Android זמינות ב-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 הזה.
  • למטרות פיתוח ובדיקות שדה, צריך ליצור פרויקט ושילוב עם שילוב ה-VID וה-PID התואם ב-Developer Console. המשתמש שמפעיל את המכשיר צריך להיות חבר בפרויקט או להופיע ברשימה של משתמשי הניסוי בשטח.
  • משתמשים פרטיים יוכלו להשתמש במוצר רק אחרי שהוא יאושר על ידי Alliance.

אפשר להשתמש ב-VID וב-PID רק פעם אחת בשילוב אחד. אם רוצים להשתמש באותו VID או PID בשילוב, צריך:

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

פרטי המכשיר

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

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

מזהים כמו יצרן, דגם וגרסת החומרה מגיעים מקושחת 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_*) של המכשיר לערכים ייחודיים בקושחת הבדיקה.

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