إقران جهاز 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) للشبكة Thread من Google للأجهزة الجوّالة و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
الإنتاج معتمد في DCL في Alliance، وتتوفر عملية الدمج في Developer Console

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

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

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

تأتي المعرّفات، مثل الشركة المصنّعة والطراز وإصدار الجهاز من البرامج الثابتة 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_*) للجهاز على قيم فريدة في البرامج الثابتة للاختبار.

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