دستگاه Matter خود را که از این قابلیت پشتیبانی می‌کند، جفت کنید. برای انجام این کار، به یک کد QR برای جفت شدن نیاز دارید. بسته به پلتفرم دستگاه Matter شما، ممکن است لازم باشد خودتان این کد QR را تولید کنید.
دریافت کد 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 115200to 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، لینک را در مرورگر وب باز کنید.
ان‌ایکس‌پی
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:
برای نمایش کد 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
دستگاه را جفت کنید
دو روش برای جفت کردن دستگاه وجود دارد:
- Google Home app (GHA)
- کیت‌های توسعه نرم‌افزار (SDK) گوگل برای Home Mobile و Thread Network برای Android (که می‌توانند در برنامه‌های شخص ثالث استفاده شوند)
هر دو روش از APIهای Matter و Thread Network یکسانی استفاده می‌کنند.
برنامه گوگل هوم
- GHA را باز کنید.
- روی گزینه‌ی در گوشه‌ی بالا سمت چپ ضربه بزنید.
- روی راه‌اندازی دستگاه ضربه بزنید.
- روی دستگاه جدید ضربه بزنید.
- خانه خود را انتخاب کنید و روی «بعدی» ضربه بزنید.
- GHA دستگاه شما را اسکن می‌کند. وقتی از شما می‌پرسد که آیا می‌خواهید دستگاه خود را راه‌اندازی کنید، روی «راه‌اندازی یک دستگاه دیگر» ضربه بزنید.
- برای هر نوع دستگاه، روی Matter device ضربه بزنید.
- دوربین خود را به سمت کد QR دستگاهتان (یا کد QR تولید شده توسط وب‌سایت) بگیرید.
- فرآیند جفت‌سازی را همانطور که در جریان GHA نشان داده شده است، ادامه دهید.
اگر هنگام جفت شدن با GHA در دستگاه همراه خود با مشکلی مواجه شدید:
- مطمئن شوید که گزینه‌های توسعه‌دهندگان (Developer options) را برای دستگاه همراه خود فعال کرده‌اید.
- بلافاصله پس از تلاش ناموفق برای جفت‌سازی، یک گزارش اشکال (bug report) ثبت کنید .
SDK های اندروید
کیت‌های توسعه 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 Home Developer Console ) استفاده کنید، تأیید می‌کند که شما مالک آن VID هستید. پس از این، می‌توانید برای آن VID ادغام ایجاد کنید.
- برای اهداف توسعه و Field Trial ، یک پروژه و ادغام با ترکیب VID و PID مربوطه باید در Developer Console ایجاد شود. کاربری که دستگاه را راه‌اندازی می‌کند باید یا عضوی از پروژه باشد یا در فهرست کاربران Field Trial قرار داشته باشد.
- کاربران عادی فقط زمانی می‌توانند از محصول شما استفاده کنند که توسط Alliance تأیید شده باشد.
VID و PID فقط یک بار برای یک ادغام قابل استفاده هستند. اگر می‌خواهید از VID یا PID یکسان در ادغام خود استفاده کنید، باید یکی از موارد زیر را انجام دهید:
- ادغام را با استفاده از VID یا PID به یک VID یا PID متفاوت ویرایش کنید.
- ادغام را با استفاده از VID یا PID حذف کنید.
| کدام دسته از کاربران می‌توانند دستگاه را در اکوسیستم گوگل هوم راه‌اندازی کنند؟ | |||
|---|---|---|---|
| نوع VID | صدور گواهینامه VID و وضعیت ادغام کنسول | تولید (کاربران مصرفی) | توسعه (توسعه‌دهندگان، کاربران Field Trial ) |
| تست | عدم ادغام در Developer Console (قابل تأیید نیست) | ||
| تست | یکپارچه‌سازی در Developer Console وجود دارد (قابل تأیید نیست) | ||
| تولید | گواهی‌شده نیست، یکپارچه‌سازی در Developer Console وجود ندارد | ||
| تولید | گواهی نشده، ادغام در Developer Console وجود دارد | ||
| تولید | دارای گواهینامه Alliance DCL، عدم وجود یکپارچه‌سازی در Developer Console | ||
| تولید | دارای گواهینامه Alliance DCL و قابلیت یکپارچه‌سازی در Developer Console | ||
اطلاعات دستگاه
اطلاعات فنی دستگاه جفت‌شده را می‌توان در GHA مشاهده کرد.
- در GHA ، دستگاه را انتخاب کنید.
- روی نماد در بالا سمت راست ضربه بزنید.
- روی اطلاعات فنی ضربه بزنید.
شناسه‌هایی مانند سازنده ، مدل و نسخه سخت‌افزار از میان‌افزار Matter روی دستگاه می‌آیند، نه از Developer Console . برای مثال، مقادیر CHIP_DEVICE_CONFIG_DEVICE_VENDOR_NAME و CHIP_DEVICE_CONFIG_DEVICE_PRODUCT_NAME در پیکربندی دستگاه در Matter SDK وجود دارند.
این شناسه‌ها می‌توانند برای تأیید اینکه کدام دستگاه برای اهداف آزمایشی جفت شده است، مفید باشند، به خصوص هنگام استفاده از شناسه فروشنده و شناسه محصول آزمایشی (که می‌توانند در سراسر یکپارچه‌سازی‌ها کپی شوند).
عیب‌یابی جفت‌سازی
اگر دستگاهی را با شناسه فروشنده (VID) و شناسه محصول (PID) آزمایشی جفت کرده‌اید، اما هنگام تلاش برای آزمایش دستگاه با Test Suite در Developer Console ، این شناسه‌ها نمایش داده نمی‌شوند، احتمالاً دلیل این امر استفاده از ترکیب VID و PID آزمایشی یکسان در چندین یکپارچه‌سازی است.
برای عیب‌یابی، تمام دستگاه‌های آزمایشی را از Developer Console حذف کنید و دستگاهی را که می‌خواهید دوباره آزمایش کنید، جفت کنید.
برای تأیید اینکه دستگاه صحیح را جفت کرده‌اید، می‌توانید اطلاعات سازنده و مدل (مقادیر CHIP_DEVICE_CONFIG_DEVICE_* ) دستگاه را روی مقادیر منحصر به فرد در میان‌افزار آزمایشی خود تنظیم کنید.
برای اطلاعات بیشتر به اطلاعات دستگاه مراجعه کنید.