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

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

इस दस्तावेज़ में, Google Home नेटवर्क में Matter के साथ काम करने वाले प्लैटफ़ॉर्म को बनाने और इंटिग्रेट करने का तरीका बताया गया है.

डिसक्लेमर

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

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

बनाने का तरीका

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

शुरू करने का सबसे आसान तरीका, हमारे कोडलैब पर जाना है. हमारा सुझाव है कि आप इनमें से कम से कम एक कोडलैब को पूरा करें:

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

इस सुविधा के साथ काम करने वाले डिवाइस डेवलपर के लिए चेकलिस्ट

परिभाषाएं

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

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

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

Matter के डेवलपमेंट के लिए सुझाए गए आईडीई एक्सटेंशन

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

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

वेंडर आईडी

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

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

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

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 में इंटिग्रेशन मौजूद है

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

डिवाइस की जानकारी, Matter बुनियादी जानकारी वाले क्लस्टर से पढ़ी जाती है. आपके डिवाइस के फ़र्मवेयर में एन्कोड किया गया प्रॉडक्ट आईडी, डेवलपर कंसोल में 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.

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