Matter के साथ शुरू करें

गूगल का होम डेवलपर कार्यक्रम डिवाइस निर्माताओं को अपने स्मार्ट होम उपकरणों को गूगल होम इकोसिस्टम से जोड़ने की अनुमति देता है. हम स्मार्ट होम डिवाइसों के लिए, स्थानीय तौर पर उपलब्ध सुविधाओं को बेहतर बना रहे हैं. इसके तहत, Matter की सुविधा वाले डिवाइसों को सेटअप करने के लिए, Google Home app (GHA) का इस्तेमाल किया जा सकेगा. साथ ही, उन्हें Google Assistant, GHA या Google Nest Hub (2nd gen) जैसे स्मार्ट डिसप्ले की मदद से कंट्रोल किया जा सकेगा.

यह दस्तावेज़ बताता है कि Google Home इकोसिस्टम में Matter-समर्थित प्लेटफ़ॉर्म बनाने और उसे एकीकृत करने का तरीका कैसे शुरू करें.

डिसक्लेमर

Matterदस्तावेज़ में बताई गई प्रक्रियाओं के बारे में, इन बातों का ध्यान रखें:

  • हमारा सुझाव है कि डेवलपमेंट के लिए इस्तेमाल किए जा रहे खाते में, सिर्फ़ एक Matter-इनेबल किया गया हब कनेक्ट किया गया हो, ताकि टेस्टिंग की जा सके. एक ही समय में कनेक्ट किए गए या परीक्षण के दौरान एक ही संरचना से कनेक्ट किए गए कई Matter-सक्षम हब के परिणामस्वरूप अप्रत्याशित व्यवहार हो सकता है.
  • सभी प्रक्रियाएं Matter नमूनों के निर्माण और फ्लैशिंग के लिए Ubuntu 20.04 चलाने वाली Linux मशीन के उपयोग को मानती हैं, जिनका परीक्षण Google द्वारा किया गया है. यद्यपि macOS मशीनें समर्थित हैं, परन्तु Linux की अनुशंसा की जाती है. आवश्यकतानुसार मैक-विशिष्ट निर्देशों को प्रक्रियाओं में शामिल किया जाता है.

कैसे बनाएं

Google Home इकोसिस्टम के साथ एकीकृत होने वाला Matter-सक्षम डिवाइस बनाने के लिए, आपको Matter-संगत डेवलपमेंट बोर्ड और Matter SDK के साथ काम करना होगा.

इसे इस्तेमाल करने का सबसे आसान तरीका है कि आप हमारे कोडलैब देखें. हम निम्नलिखित में से कम से कम एक कोडलैब करने की अनुशंसा करते हैं:

इसके बाद, समर्थित डिवाइसों की हमारी सूची देखें ताकि यह सुनिश्चित किया जा सके कि आप जिन डिवाइसों को एकीकृत करने की योजना बना रहे हैं, वे Google Home इकोसिस्टम में समर्थित हैं. इसके बाद, डेवलपर के लिए चेकलिस्ट पढ़ें. इससे आपको प्रोजेक्ट बनाने से लेकर लॉन्च करने तक के पूरे डेवलपमेंट फ़्लो के बारे में जानकारी मिलेगी.

ऐसे डिवाइस जिन पर यह सुविधा काम करती है डेवलपर के लिए चेकलिस्ट

परिभाषाएं

इस दस्तावेज़ में निम्नलिखित शब्दों का प्रयोग किया गया है:

बॉर्डर राऊटर
एक हब जो Thread-सक्षम डिवाइसों के लिए एक सामान्य-उद्देश्य Thread बॉर्डर राउटर को कार्यान्वित करता है.
हब
समर्थित Google Nest डिवाइस, जैसे कि Google Nest Hub (2nd gen). Matter की सुविधा वाले डिवाइसों को Assistant, GHA, और स्मार्ट डिसप्ले जैसे अन्य प्लैटफ़ॉर्म से कंट्रोल करने के लिए, एक हब की ज़रूरत होती है.
Matter-सक्षम डिवाइस
ऐसा डिवाइस या डेवलपमेंट बोर्ड जिस पर Matter-सक्षम बिल्ड या सैंपल ऐप्लिकेशन फ़्लैश किया गया हो.
मोबाइल डिवाइस
युग्मन में सहायता के लिए उपयोग किया गया परीक्षण फ़ोन. फ़िलहाल, यह Android फ़ोन है.

ज़रूरी शर्तें

मैटर डेवलपमेंट के लिए अनुशंसित IDE एक्सटेंशन

Matter-सक्षम डिवाइस को Google Home इकोसिस्टम के साथ पूरी तरह से एकीकृत करने के लिए, डेवलपर के पास ये चीज़ें होनी चाहिए:

  1. थ्रेड समर्थन वाला Google हब, जो थ्रेड-सक्षम डिवाइसों के लिए बॉर्डर राउटर और स्मार्ट होम इंटेंट को रूट करने के लिए स्थानीय पूर्ति पथ, दोनों के रूप में कार्य करेगा.
  2. एक मोबाइल डिवाइस (परीक्षण फ़ोन) जो न्यूनतम आवश्यकताओं को पूरा करता है:
    • Android O (8.1, एपीआई लेवल 27 या इसके बाद का वर्शन)
    • iOS (v16.5 या नया)
    • BLE क्षमता
  3. Matter की सुविधा वाले डिवाइस के लिए, वेंडर आईडी (वीआईडी) और प्रॉडक्ट आईडी (पीआईडी).
  4. Matter की सुविधा वाला डिवाइस. यह डिवाइस Google Home इकोसिस्टम में समर्थित Matter डिवाइस प्रकारों में से एक होना चाहिए, और यह हो सकता है:
    • Matter की सुविधा वाले फ़र्मवेयर के साथ आपका प्रॉडक्ट.
    • एंड-टू-एंड पुष्टि के लिए, इनमें से किसी एक Matter डिवाइस का इस्तेमाल करें:
टेबल: Matter सिलिकॉन वेंडर के उदाहरण
वेंडर प्लैटफ़ॉर्म Thread सहायता गाइड
Bouffalo Lab BL602
BL702
Espressif ESP32 OTA टेस्टिंग
Nordic Semiconductor nRF52840 DK OTA टेस्टिंग
NXP IOTZTB-DK006 डेवलपमेंट किट
Realtek Ameba D Series
Silicon Labs EFR32MG24 Dev Kit
EFR32MG Zigbee और Thread स्टार्टर किट
Telink TLSR9528 Telink Matter डेवलपर गाइड
टेक्सस इंस्ट्रुमेंट्स CC2652R7 LaunchPad डेवलपमेंट किट

वेंडर आईडी

डिफ़ॉल्ट रूप से, सीएसए की ओर से असाइन किए गए किसी एक वीआईडी का इस्तेमाल, जांच के लिए किया जा सकता है. इनमें से कोई एक चुनें: 0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.

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

इस VID को आपके डिवाइस के फ़र्मवेयर में लागू किया जाना चाहिए.

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

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

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

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

प्रॉडक्ट आईडी

डिवाइस के बारे में जानकारी, Matter बुनियादी जानकारी क्लस्टर से पढ़ी जाती है. आपके डिवाइस के फ़र्मवेयर में एन्कोड किया गया प्रॉडक्ट आईडी, Developer Console में Matter इंटिग्रेशन के प्रॉडक्ट आईडी से मेल खाना चाहिए.

ऐसे फ़ीचर जो काम नहीं करते

कुछ Matter क्लस्टर को अब तक उपयोगकर्ताओं के लिए उपलब्ध नहीं कराया गया है. हालांकि, सिस्टम इनका इस्तेमाल कर सकता है. ज़्यादातर मामलों में, इसका मतलब है कि इन क्लस्टर के ज़रिए दिखाए गए एट्रिब्यूट, असली उपयोगकर्ताओं को नहीं दिखते:

Table: Matter clusters not exposed to users in the Google Home ecosystem
Cluster Type Clusters
Core
  • Binding ¹
  • Label
  • Fixed Label
  • User Label
  • Actions
  • Group Key
  • Localization Configuration
  • Time Format Localization
  • Unit Localization
  • Power Source Configuration
  • Power Source
  • Diagnostics clusters (Diagnostic Logs, General Diagnostics, Software Diagnostics, Thread Network Diagnostics, Wi-Fi Network Diagnostics, Ethernet Network Diagnostics)
  • Time Synchronization
  • Mode Select
Application
  • Groups and Scenes are not directly supported. Equivalent functionality is available via Routines.
  • All Media clusters. Equivalent functionality is available via Google Cast.

¹ लाइट चालू/बंद करने वाले स्विच पर इसका क्या असर पड़ेगा, यह जानने के लिए लाइट चालू/बंद करने वाले स्विच लेख पढ़ें.