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

Google का Home Developer Program, डिवाइस बनाने वाली कंपनियों को अपने स्मार्ट होम डिवाइसों को Google Home के नेटवर्क से कनेक्ट करने की अनुमति देता है. हम स्मार्ट होम ऐक्शन के लोकल फ़ुलफ़िलमेंट पाथ को बेहतर बना रहे हैं. इससे 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 का इस्तेमाल करने का सुझाव दिया जाता है. ज़रूरत के मुताबिक, Mac के लिए खास निर्देश भी दिए गए हैं.

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

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

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

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

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

परिभाषाएं

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

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

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

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

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

  1. Thread की सुविधा वाला Google हब. यह Thread की सुविधा वाले डिवाइसों के लिए border router के तौर पर काम करता है. साथ ही, स्मार्ट होम इंटेंट को रूट करने के लिए, लोकल फ़ुलफ़िलमेंट पाथ के तौर पर भी काम करता है.
  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 OTA टेस्टिंग
Nordic Semiconductor nRF52840 DK OTA टेस्टिंग
NXP IOTZTB-DK006 डेवलपमेंट किट
Realtek Ameba D Series
Silicon Labs EFR32MG24 Dev Kit
EFR32MG Zigbee and Thread Starter Kit
Telink TLSR9528 Telink Matter डेवलपर गाइड
टेक्सास इंस्ट्रूमेंट्स CC2652R7 LaunchPad डेवलपमेंट किट

वेंडर आईडी

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

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

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

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

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

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.

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