دستگاه مجهز به Matter را جفت کنید. برای انجام این کار، به رمزینه پاسخ‌سریع برای جفت‌سازی نیاز دارید. بسته به پلاتفرم دستگاه Matter، ممکن است لازم باشد این رمزینه پاسخ‌سریع را خودتان تولید کنید.
دریافت رمزینه پاسخ‌سریع
Bouffalo Lab
BL602
رشته رمزینه پاسخ‌سریع هنگام راه‌اندازی دستگاه در کنسول سریال چاپ می‌شود. کنسول سریال خود را بررسی کنید و باید پیام‌هایی مانند این را ببینید:
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 ...
پیوند را در مرورگر وب باز کنید تا رمزینه پاسخ‌سریع نمایش داده شود.
BL702
رشته رمزینه پاسخ‌سریع هنگام راه‌اندازی دستگاه در کنسول سریال چاپ می‌شود. کنسول سریال خود را بررسی کنید و باید پیام‌هایی مانند این را ببینید:
[ 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
پیوند را در مرورگر وب باز کنید تا رمزینه پاسخ‌سریع نمایش داده شود.
NXP
K32W
رشته رمزینه پاسخ‌سریع هنگام راه‌اندازی دستگاه در کنسول سریال چاپ می‌شود. کنسول سریال خود را بررسی کنید و باید پیام‌هایی مانند این را ببینید:
[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 ...
پیوند را در مرورگر وب باز کنید تا رمزینه پاسخ‌سریع نمایش داده شود.
Realtek
Ameba D
رمزینه پاسخ‌سریع در نشانی وبی کدگذاری شده است که هنگام راه‌اندازی برد 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:
پیوند را در مرورگر وب باز کنید تا رمزینه پاسخ‌سریع نمایش داده شود.
Silicon Labs
EFR32MG12
وقتی برد راه‌اندازی شد، باید رمزینه پاسخ‌سریعی در نمایشگر LCD کوچک آن ببینید.
Telink
TLSR9518
رشته رمزینه پاسخ‌سریع هنگام راه‌اندازی دستگاه در کنسول سریال چاپ می‌شود. کنسول سریال را بررسی کنید و باید نشانی وبی را ببینید که وقتی در مرورگر باز می‌شود، رمزینه پاسخ‌سریع را نمایش می‌دهد:
*** 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)
- کیت‌های توسعه نرم‌افزار Home Mobile و Thread Network متعلق به Google برای Android (که می‌توانند در برنامه طرف سوم استفاده شوند)
هر دو روش از میاناهای برنامه‌سازی کاربردی شبکه Matter و Thread یکسانی استفاده می‌کنند.
برنامه Google Home
- GHA را باز کنید.
- روی در گوشه بالا سمت راست تک‌ضرب بزنید.
- روی راه‌اندازی دستگاه تک‌ضرب بزنید.
- روی دستگاه جدید تک‌ضرب بزنید.
- خانه خود را انتخاب کنید و روی بعدی تک‌ضرب بزنید.
- GHA دستگاهتان را اسکن می‌کند. وقتی از شما پرسیده شد که آیا می‌خواهید دستگاهتان را راه‌اندازی کنید، روی راه‌اندازی دستگاهی دیگر تک‌ضرب بزنید.
- برای هر نوع دستگاهی، روی دستگاه Matter تک‌ضرب بزنید.
- دوربین را به‌سمت رمزینه پاسخ‌سریع دستگاهتان (یا رمزینه پاسخ‌سریع تولیدشده توسط وب‌سایت) بگیرید.
- فرایند جفت‌سازی را طبق دستورالعمل‌های جریان GHA ادامه دهید.
اگر درطول جفت‌سازی با GHA در دستگاه همراهتان با مشکلی مواجه شدید:
- مطمئن شوید گزینه‌های توسعه‌دهندگان را برای دستگاه همراهتان فعال کرده باشید.
- بلافاصله پس‌از تلاش ناموفق برای جفت‌سازی، گزارش اشکال را ضبط کنید.
کیت‌های توسعه نرم‌افزار Android
Android کیت توسعه نرم‌افزار در Play services برای آزمایش و جفت‌سازی در برنامه طرف سوم دردسترس قرار گرفته است.
پیشنهاد می‌کنیم با Google Home Sample App for Matter شروع کنید که نحوه راه‌اندازی، مرتبط‌سازی، و کنترل دستگاه سازگار با Matter در بوم‌سازگان Google Home با این کیت‌های توسعه نرم‌افزار را نشان می‌دهد.
اسناد مرجع برای هر دو کیت توسعه نرم‌افزار در این سایت دردسترس است:
محدودیت‌های جفت‌سازی
دستگاه 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 وجود دارد | ||
| تولید | در 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.
این شناسه‌ها می‌توانند برای اعتبارسنجی اینکه کدام دستگاه برای اهداف آزمایش جفت شده است مفید باشند، به‌ویژه هنگام استفاده از «شناسه فروشنده» و «شناسه محصول» آزمایشی (که می‌تواند در ادغام‌ها تکرار شود).
عیب‌یابی جفت‌سازی
اگر دستگاهی را با «شناسه فروشنده» (VID) و «شناسه محصول» (PID) آزمایشی مرتبط کرده‌اید، اما وقتی می‌خواهید دستگاه را با «مجموعه آزمون» آزمایش کنید در Developer Console نشان داده نمی‌شود، احتمالاً دلیل آن استفاده از ترکیب VID و PID آزمایشی یکسان در چندین ادغام است.
برای عیب‌یابی، همه دستگاه‌های آزمایشی را از Developer Console بردارید و دستگاهی را که می‌خواهید آزمایش کنید دوباره جفت کنید.
برای تأیید اینکه دستگاه درست را جفت کرده‌اید، می‌توانید اطلاعات «سازنده» و «مدل» (مقادیر CHIP_DEVICE_CONFIG_DEVICE_*) را برای دستگاه روی مقادیر منحصربه‌فرد در سفت‌افزار آزمایشی تنظیم کنید.
برای اطلاعات بیشتر، به اطلاعات دستگاه مراجعه کنید.