मैटर डिवाइस जोड़ें

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

Ameba D

क्यूआर कोड को यूआरएल में एन्कोड किया जाता है. यह यूआरएल, 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

बोर्ड के बूट अप होने के बाद, आपको उसके छोटे एलसीडी डिसप्ले पर एक क्यूआर कोड दिखेगा.

TLSR9518

डिवाइस के बूट होने पर, क्यूआर कोड स्ट्रिंग सीरियल कंसोल में प्रिंट होती है. सीरियल कंसोल देखें. आपको एक यूआरएल दिखेगा. इसे ब्राउज़र में खोलने पर, क्यूआर कोड दिखेगा:

*** 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 Mobile और Thread के लिए Android नेटवर्क SDK टूल (जिसका इस्तेमाल तीसरे पक्ष के ऐप्लिकेशन में किया जा सकता है)

दोनों तरीके, एक ही Matter और Thread नेटवर्क एपीआई का इस्तेमाल करते हैं.

Google Home ऐप्लिकेशन

  1. GHA खोलें.
  2. सबसे ऊपर बाएं कोने में मौजूद पर टैप करें.
  3. डिवाइस सेट अप करें पर टैप करें.
  4. नया डिवाइस पर टैप करें.
  5. अपना होम चुनें और आगे बढ़ें पर टैप करें.
  6. GHA आपके डिवाइस को स्कैन करेगा. जब आपसे पूछा जाए कि आपको अपना डिवाइस सेट अप करना है या नहीं, तो कोई दूसरा डिवाइस सेट अप करें पर टैप करें.
  7. किसी भी तरह के डिवाइस के लिए, Matter डिवाइस पर टैप करें.
  8. अपने कैमरे को अपने डिवाइस के क्यूआर कोड या वेबसाइट से जनरेट किए गए क्यूआर कोड पर ले जाएं.
  9. GHA फ़्लो में बताए गए तरीके से, जोड़ने की प्रोसेस जारी रखें.

अगर आपको अपने मोबाइल डिवाइस पर GHA से जोड़ने के दौरान कोई समस्या आती है, तो:

  1. पक्का करें कि आपने अपने मोबाइल डिवाइस पर डेवलपर के विकल्प चालू किए हों.
  2. डिवाइस को जोड़ने की कोशिश के नाकाम होने के तुरंत बाद, बग की रिपोर्ट कैप्चर करें.

Android SDK टूल

अपने ऐप्लिकेशन में Matter डिवाइसों को जोड़ने और थ्रेड नेटवर्क को मैनेज करने के लिए, हमारे Android SDK टूल लागू करें

Android SDK टूल, तीसरे पक्ष के ऐप्लिकेशन में टेस्ट करने और जोड़ने के लिए, Play services में उपलब्ध कराए गए हैं.

हमारा सुझाव है कि आप Google Home Sample App for Matter से शुरू करें. इसमें, इन एसडीके टूल की मदद से, Google Home नेटवर्क में Matter की सुविधा वाले डिवाइस को जोड़ने, उसे कंट्रोल करने, और उसे चालू करने का तरीका बताया गया है.

दोनों SDK टूल के लिए रेफ़रंस दस्तावेज़, इस साइट पर उपलब्ध हैं:

डिवाइसों को जोड़ने से जुड़ी पाबंदियां

Matter डिवाइस को Google Home नेटवर्क से सिर्फ़ कुछ वेंडर आईडी और डिवाइस टाइप के साथ जोड़ा जा सकता है.

  • टेस्ट वीआईडी का इस्तेमाल, उपभोक्ता के डिवाइस में नहीं किया जा सकता.
  • आपका प्रोडक्शन वीआईडी, Connectivity Standards Alliance (Alliance) ने जारी किया हो. Google Home Developer Console में वीआईडी का इस्तेमाल करने से पहले, Google इसकी पुष्टि करेगा कि आपके पास उस वीआईडी का मालिकाना हक है. ऐसा होने के बाद, उस वीआईडी के लिए इंटिग्रेशन बनाए जा सकेंगे.
  • डेवलपमेंट और फ़ील्ड ट्रायल के लिए, Developer Console में एक प्रोजेक्ट और उससे जुड़े वीआईडी और पीआईडी कॉम्बिनेशन के साथ इंटिग्रेशन बनाना ज़रूरी है. डिवाइस को कमिशन करने वाला उपयोगकर्ता, प्रोजेक्ट का सदस्य होना चाहिए या उसे फ़ील्ड ट्रायल में हिस्सा लेने वाले उपयोगकर्ताओं की सूची में शामिल किया गया हो.
  • उपभोक्ता, आपके प्रॉडक्ट का इस्तेमाल सिर्फ़ तब कर सकते हैं, जब उसे Alliance से सर्टिफ़िकेट मिल गया हो.

वीआईडी और पीआईडी का इस्तेमाल, एक इंटिग्रेशन के लिए सिर्फ़ एक बार किया जा सकता है. अगर आपको अपने इंटिग्रेशन में एक ही वीआईडी या पीआईडी का इस्तेमाल करना है, तो आपको इनमें से कोई एक काम करना होगा:

  • वीआईडी या पीआईडी का इस्तेमाल करके, इंटिग्रेशन में बदलाव करके किसी दूसरे वीआईडी या पीआईडी पर स्विच करें.
  • VID या PID का इस्तेमाल करके इंटिग्रेशन मिटाएं.
टेबल: वेंडर आईडी (वीआईडी) और डिवाइस टाइप के हिसाब से, डिवाइस को जोड़ने के उदाहरण
किस तरह के उपयोगकर्ता, डिवाइस को Google Home के पारिस्थितिक तंत्र में शामिल कर सकते हैं?
वीआईडी का टाइप वीआईडी सर्टिफ़िकेशन और कंसोल इंटिग्रेशन की स्थिति प्रोडक्शन
(उपभोक्ता उपयोगकर्ता)
डेवलपमेंट
(डेवलपर, फ़ील्ड ट्रायल के उपयोगकर्ता)
टेस्ट Developer Console में कोई इंटिग्रेशन नहीं है (सर्टिफ़ाइड नहीं किया जा सकता)
टेस्ट इंटिग्रेशन Developer Console में मौजूद है (इसका सर्टिफ़िकेट नहीं दिया जा सकता)
प्रोडक्शन सर्टिफ़ाइड नहीं है, Developer Console में इंटिग्रेशन मौजूद नहीं है
प्रोडक्शन सर्टिफ़िकेट नहीं मिला है, इंटिग्रेशन Developer Console में मौजूद है
प्रोडक्शन Alliance डीसीएल में सर्टिफ़ाइड है, लेकिन Developer Console में इंटिग्रेशन मौजूद नहीं है
प्रोडक्शन Alliance डीसीएल में सर्टिफ़ाइड है और Developer Console में इंटिग्रेशन मौजूद है

डिवाइस की जानकारी

जोड़े गए डिवाइस की तकनीकी जानकारी, GHA में देखी जा सकती है.

  1. GHA में, डिवाइस चुनें.
  2. सबसे ऊपर दाईं ओर मौजूद आइकॉन पर टैप करें.
  3. तकनीकी जानकारी पर टैप करें.

मैन्युफ़ैक्चरर, मॉडल, और हार्डवेयर वर्शन जैसे आइडेंटिफ़ायर, डिवाइस के Matter फ़र्मवेयर से मिलते हैं, न कि Developer Console से. उदाहरण के लिए, Matter SDK में डिवाइस कॉन्फ़िगरेशन में CHIP_DEVICE_CONFIG_DEVICE_VENDOR_NAME और CHIP_DEVICE_CONFIG_DEVICE_PRODUCT_NAME वैल्यू.

इन आइडेंटिफ़ायर की मदद से, यह पुष्टि की जा सकती है कि टेस्ट के लिए किस डिवाइस को जोड़ा गया है. खास तौर पर, टेस्ट वेंडर आईडी और प्रॉडक्ट आईडी का इस्तेमाल करते समय, ऐसा किया जा सकता है. इन आईडी को सभी इंटिग्रेशन में डुप्लीकेट किया जा सकता है.

डिवाइसों को जोड़ने से जुड़ी समस्या हल करना

अगर आपने किसी डिवाइस को टेस्ट वेंडर आईडी (वीआईडी) और प्रॉडक्ट आईडी (पीआईडी) के साथ जोड़ा है, लेकिन Developer Console में Test Suite की मदद से डिवाइस की जांच करने पर वह नहीं दिखता है, तो ऐसा कई इंटिग्रेशन में एक ही टेस्ट वीआईडी और पीआईडी कॉम्बिनेशन का इस्तेमाल करने की वजह से हो सकता है.

समस्या हल करने के लिए, Developer Console से सभी टेस्ट डिवाइस हटाएं और उस डिवाइस को फिर से जोड़ें जिसकी आपको फिर से जांच करनी है.

यह पुष्टि करने के लिए कि आपने सही डिवाइस को जोड़ा है, अपने टेस्ट फ़र्मवेयर में डिवाइस के लिए मैन्युफ़ैक्चरर और मॉडल की जानकारी (CHIP_DEVICE_CONFIG_DEVICE_* वैल्यू) को यूनीक वैल्यू पर सेट किया जा सकता है.

ज़्यादा जानकारी के लिए, डिवाइस की जानकारी देखें.