إقران جهاز Matter

يمكنك إقران الجهاز الذي تم تفعيل "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

  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

افتح الرابط في متصفّح الويب لعرض رمز الاستجابة السريعة.

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

أميبا دي

يكون رمز الاستجابة السريعة مرمّزًا في عنوان 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

افتح الرابط في متصفّح الويب لعرض رمز الاستجابة السريعة.

مختبرات سيليكون

EFR32MG12

بعد تشغيل اللوحة، من المفترض أن يظهر رمز استجابة سريعة على شاشة LCD الصغيرة.

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

إقران الجهاز

تتوفّر طريقتان لإقران الجهاز:

  1. Google Home app (GHA)
  2. حِزم تطوير البرامج (SDK) الخاصة بشبكة Google Home للأجهزة الجوّالة و"Thread" للموقع الإلكتروني Android (يمكن استخدامها في تطبيق تابع لجهة خارجية)

تستخدم كلتا الطريقتين واجهات برمجة تطبيقات الشبكة Matter وThread نفسها.

تطبيق Google Home

  1. افتح "GHA".
  2. انقر على في أعلى اليمين.
  3. انقر على إعداد الجهاز.
  4. انقر على جهاز جديد.
  5. اختَر منزلك وانقر على التالي.
  6. سيبحث تطبيق "GHA" عن جهازك. عند ظهور إشعار يطلب منك تحديد ما إذا كنت تريد إعداد جهازك، انقر على إعداد جهاز آخر.
  7. انقر على جهاز واحد (Matter) لأي نوع جهاز.
  8. وجِّه الكاميرا إلى رمز الاستجابة السريعة لجهازك (أو رمز الاستجابة السريعة الذي أنشأه الموقع الإلكتروني).
  9. تابِع عملية الإقران كما هو موضّح في مسار GHA.

إذا واجهتك أي مشاكل أثناء الإقران مع "GHA" على جهازك الجوّال:

  1. تأكَّد من أنّ خيارات المطوّرين مفعَّلة على جهازك الجوّال.
  2. بعد محاولة الإقران الفاشلة مباشرةً، سجِّل تقرير خطأ.

حِزم تطوير البرامج (SDK) لنظام التشغيل Android

تنفيذ حِزم تطوير البرامج (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 هذا.
  • لأغراض التطوير والتجربة الميدانية، يجب إنشاء مشروع ودمج مع تركيبة VID وPID المقابلة في Developer Console. يجب أن يكون المستخدم الذي يفوض الجهاز إما عضوًا في المشروع أو مدرجًا في قائمة مستخدمي التجربة الميدانية.
  • يمكن للمستخدمين العاديين استخدام منتجك فقط بعد أن يتم اعتماده من قِبل "Alliance".
جدول: سيناريوهات إقران نوع الجهاز ومعرّف المورّد (VID)
ما هي أنواع المستخدمين الذين يمكنهم إدراج الجهاز ضمن منظومة Google Home المتكاملة؟
نوع VID حالة دمج وحدة التحكّم وشهادة VID مرحلة الإنتاج
(المستخدمون من المستهلكين)
التطوير
(المطوّرون ومستخدمي الفترة التجريبية)
Test ما مِن عملية دمج في Developer Console (لا يمكن الاعتماد عليها)
Test عملية الدمج متوفّرة في Developer Console (لا يمكن اعتمادها).
الإنتاج لم يتم اعتماد الحساب لأنّ عملية الدمج غير متاحة في Developer Console.
الإنتاج لم يتم اعتماد الخدمة، ولكن هناك عملية دمج متاحة في "Developer Console".
الإنتاج معتمَد في DCL لـ Alliance، ولا يمكن الدمج في Developer Console
الإنتاج معتمَد في Alliance DCL وتتوفّر عملية الدمج في Developer Console

معلومات الجهاز

يمكن عرض المعلومات الفنية للجهاز المقترِن في GHA.

  1. في GHA، اختَر الجهاز.
  2. انقر على الرمز في أعلى يسار الشاشة.
  3. انقر على المعلومات الفنية.

تأتي المعرّفات، مثل Manufacturer وطراز وإصدار الجهاز، من برامج Matter الثابتة على الجهاز، وليس من Developer Console. على سبيل المثال، القيمتان CHIP_DEVICE_CONFIG_DEVICE_VENDOR_NAME وCHIP_DEVICE_CONFIG_DEVICE_PRODUCT_NAME في ضبط الجهاز ضمن حزمة تطوير البرامج (SDK) لمعيار Matter.

يمكن أن تكون هذه المعرّفات مفيدة للتحقّق من الجهاز الذي تم إقرانه لأغراض الاختبار، خاصةً عند استخدام رقم تعريف المورّد ومعرّف المنتج التجريبي (الذي يمكن تكراره في عمليات الدمج).

تحديد مشاكل الإقران وحلّها

إذا كنت قد أقرنت جهازًا بمعرّف المورّد التجريبي (VID) ومعرّف المنتج (PID)، ولكنّه لا يظهر عند محاولة اختبار الجهاز باستخدام مجموعة الاختبار في Developer Console، فمن المحتمل أن يرجع ذلك إلى استخدام تركيبة VID الاختبارية ومعرّف المنتج (PID) نفسها عبر عمليات دمج متعددة.

لتحديد المشاكل وحلّها، عليك إزالة جميع الأجهزة الاختبارية من "Developer Console" وإقران الجهاز الذي تريد اختباره مرة أخرى.

للتأكّد من إقران الجهاز الصحيح، يمكنك ضبط معلومات الشركة المصنّعة والطراز (قيم CHIP_DEVICE_CONFIG_DEVICE_*) للجهاز على قيم فريدة في البرامج الثابتة للاختبار.

راجِع معلومات الجهاز للحصول على مزيد من المعلومات.