أقرِن جهازك المتوافق مع 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
يتم ترميز رمز الاستجابة السريعة في عنوان 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:
افتح الرابط في متصفّح ويب لعرض رمز الاستجابة السريعة.
Silicon Labs
EFR32MG12
بعد تشغيل اللوحة، من المفترض أن يظهر رمز استجابة سريعة على شاشة LCD الصغيرة.
Telink
TLSR9518
تتم طباعة سلسلة رمز الاستجابة السريعة في وحدة التحكم التسلسلية عند تشغيل الجهاز. تحقَّق من وحدة التحكم التسلسلية، وسيظهر لك عنوان URL يعرض رمز الاستجابة السريعة عند فتحه في المتصفّح:
*** 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) الخاصة بشبكة Thread وHome Mobile من Google Android (التي يمكن استخدامها في تطبيق تابع لجهة خارجية)
تستخدم كلتا الطريقتين واجهات برمجة التطبيقات Matter وThread الخاصة بالشبكة.
تطبيق Google Home
- افتح GHA.
- انقر على في أعلى يمين الشاشة.
- انقر على إعداد الجهاز.
- انقر على جهاز جديد.
- اختَر منزلك وانقر على التالي.
- سيبحث تطبيق GHA عن جهازك. عندما يُطلب منك تحديد ما إذا كنت تريد إعداد جهازك، انقر على إعداد جهاز آخر.
- انقر على Matter الجهاز لأي نوع من الأجهزة. على جهازك الجوّال.
- وجِّه الكاميرا إلى رمز الاستجابة السريعة الخاص بجهازك (أو رمز الاستجابة السريعة الذي تم إنشاؤه على الموقع الإلكتروني).
- تابِع عملية الإقران كما هو موضّح في GHAالتسلسل.
في حال مواجهة أي مشاكل أثناء عملية الإقران مع GHA على جهازك الجوّال، اتّبِع الخطوات التالية:
- تأكَّد من تفعيل خيارات المطوّرين على جهازك الجوّال.
- بعد محاولة الاقتران الفاشلة مباشرةً، سجِّل تقرير خطأ.
حِزم تطوير البرامج (SDK) لنظام التشغيل Android
تم إتاحة حِزم تطوير البرامج (SDK) في Play services لاختبارها وإقرانها في تطبيق تابع لجهة خارجية.Android
ننصحك بالبدء باستخدام Google Home Sample App for Matter الذي يوضّح كيفية إعداد جهاز متوافق مع Matter وإقرانه والتحكّم فيه في المنظومة المتكاملة Google Home باستخدام حِزم SDK هذه.
تتوفّر مستندات مرجعية لكلتا حزمتَي تطوير البرامج (SDK) على هذا الموقع الإلكتروني:
قيود الاقتران
لا يمكن إقران جهاز Matter إلا في منظومة Google Home المتكاملة في سيناريوهات معيّنة لمعرّف المورّد ونوع الجهاز.
- لا يمكن استخدام رقم تعريف الجهاز الاختباري في جهاز مستهلك.
- يجب أن يكون رقم تعريف المورّد (VID) الخاص ببيئة الإنتاج صادرًا عن Connectivity Standards Alliance (Alliance). ستتحقّق Google من أنّك مالك معرّف البائع هذا قبل أن تتمكّن من استخدامه في Google Home Developer Console. بعد ذلك، ستتمكّن من إنشاء عمليات دمج لهذا المعرّف.
- لأغراض التطوير وField Trial، يجب إنشاء مشروع ودمجه مع تركيبة VID وPID المناسبة في Developer Console. يجب أن يكون المستخدم الذي يفعّل الجهاز عضوًا في المشروع أو مدرجًا في قائمة مستخدمي Field Trial.
- لا يمكن للمستخدمين العاديين استخدام منتجك إلا بعد أن يتم اعتماده من قِبل Alliance.
لا يمكن استخدام 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 في إعدادات الجهاز في حزمة تطوير البرامج (SDK) الخاصة ببروتوكول Matter.
يمكن أن تكون هذه المعرّفات مفيدة للتحقّق من الجهاز الذي تم إقرانه لأغراض الاختبار، خاصةً عند استخدام معرّف مورد ومعرّف منتج للاختبار (يمكن تكرارهما في عمليات الدمج).
تحديد مشاكل الإقران وحلّها
إذا سبق لك إقران جهاز بمعرّف مورّد (VID) ومعرّف منتج (PID) اختباريَين، ولكن لم يظهر الجهاز عند محاولة اختباره باستخدام "مجموعة الاختبار" في Developer Console، من المحتمل أن يكون السبب هو استخدام مجموعة معرّف المورّد ومعرّف المنتج الاختبارية نفسها في عمليات دمج متعددة.
لتحديد المشاكل وحلّها، عليك إزالة جميع أجهزة الاختبار من Developer Console وإقران الجهاز الذي تريد اختباره مرة أخرى.
للتأكّد من أنّك ربطت الجهاز الصحيح، يمكنك ضبط معلومات "الشركة المصنّعة" و"الطراز" (قيم CHIP_DEVICE_CONFIG_DEVICE_*) للجهاز على قيم فريدة في البرامج الثابتة التجريبية.
يمكنك الاطّلاع على معلومات الجهاز لمزيد من المعلومات.