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

इस्तेमाल किए जा सकने वाले डिवाइस डेवलपर के लिए चेकलिस्ट

परिभाषाएं

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

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

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

Matter के लिए ऐप्लिकेशन डेवलप करने के लिए, सुझाए गए IDE एक्सटेंशन

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 ओटीए टेस्टिंग
Nordic Semiconductor nRF52840 DK ओटीए टेस्टिंग
NXP IOTZTB-DK006 डेवलपमेंट किट
Realtek Ameba D Series
Silicon Labs EFR32MG24 Dev Kit
EFR32MG Zigbee and Thread Starter Kit
Telink TLSR9528 Telink Matter डेवलपर गाइड
Texas Instruments CC2652R7 LaunchPad डेवलपमेंट किट

वेंडर आईडी

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

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

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

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

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

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

  • वीआईडी या पीआईडी का इस्तेमाल करके, इंटिग्रेशन में बदलाव करें. इसके लिए, किसी दूसरे वीआईडी या पीआईडी का इस्तेमाल करें.
  • वीआईडी या पीआईडी का इस्तेमाल करके इंटिग्रेशन मिटाएं.
टेबल: वेंडर आईडी (वीआईडी) और डिवाइस टाइप को जोड़ने की स्थितियां
किस तरह के उपयोगकर्ता, डिवाइस को Google Home नेटवर्क में शामिल कर सकते हैं?
वीआईडी का टाइप वीआईडी सर्टिफ़िकेशन और कंसोल इंटिग्रेशन का स्टेटस प्रोडक्शन
(उपभोक्ता)		 डेवलपमेंट
(डेवलपर, Field Trial उपयोगकर्ता)
टेस्ट Developer Console में कोई इंटिग्रेशन नहीं है (सर्टिफ़ाइड नहीं किया जा सकता)
टेस्ट इंटिग्रेशन Developer Console में मौजूद है (सर्टिफ़ाइड नहीं किया जा सकता)
प्रोडक्शन सर्टिफ़ाइड नहीं है, इंटिग्रेशन Developer Console में मौजूद नहीं है
प्रोडक्शन सर्टिफ़ाइड नहीं है, इंटिग्रेशन Developer Console में मौजूद है
प्रोडक्शन Alliance डीसीएल में सर्टिफ़ाइड है, लेकिन Developer Console में इंटिग्रेशन मौजूद नहीं है
प्रोडक्शन Alliance डीसीएल में सर्टिफ़ाइड है और इंटिग्रेशन 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.

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

आगे बढ़ें
डेवलपर चेकलिस्ट