إقران جهاز 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

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

Silicon Labs

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 وحالة الدمج مع وحدة التحكّم مرحلة الإنتاج
(المستخدمون من المستهلكين)
مرحلة التطوير
(المطوّرون ومستخدمو الإصدار التجريبي)
اختبار ما مِن عملية دمج في Developer Console (لا يمكن الاعتماد عليها)
اختبار يتوفّر الدمج في Developer Console (لا يمكن اعتماده)
الإنتاج لم يتم اعتماد الحساب لأنّ عملية الدمج غير متاحة في Developer Console.
الإنتاج لم يتم اعتماد الخدمة، ولكن هناك عملية دمج متاحة في "Developer Console".
الإنتاج معتمَد في DCL في Alliance، ولكن عملية الدمج لا موجودة في Developer Console
الإنتاج معتمَد في DCL لـ Alliance وهناك عملية دمج في Developer Console

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

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

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

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

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

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

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

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

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

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