إقران جهاز Matter

إقران الجهاز الذي تم تفعيل Matter به لتنفيذ هذا الإجراء، ستحتاج إلى رمز استجابة سريعة للإقران. قد تحتاج إلى إنشاء رمز الاستجابة السريعة هذا نفسه حسب النظام الأساسي لجهاز Matter.

الحصول على رمز استجابة سريعة

مختبر بوفالو

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

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

NCP

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 الصغيرة.

TLS9918

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

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

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

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

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

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

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

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