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

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

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

डिसक्लेमर

Matter के 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).
Assistant, GHA, और स्मार्ट डिसप्ले जैसे अन्य प्लैटफ़ॉर्म की मदद से, Matter-सुविधा वाले डिवाइसों को कंट्रोल करने के लिए, हब की ज़रूरत होती है.
AssistantGHA
Matter की सुविधा वाला डिवाइस
यह ऐसा डिवाइस या डेवलपमेंट बोर्ड है जिसे Matter की सुविधा वाले बिल्ड या सैंपल ऐप्लिकेशन के साथ फ़्लैश किया गया है.
मोबाइल डिवाइस
यह वह टेस्ट फ़ोन है जिसका इस्तेमाल पेयर करने में मदद के लिए किया जाता है. फ़िलहाल, यह एक Android फ़ोन है.

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

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

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

  1. Thread की सुविधा वाला Google हब . यह Thread की सुविधा वाले डिवाइसों के लिए बॉर्डर राऊटर के तौर पर काम करता है. साथ ही, स्मार्ट होम इंटेंट को रूट करने के लिए, लोकल फ़ुलफ़िलमेंट पाथ के तौर पर भी काम करता है.
  2. ऐसा मोबाइल डिवाइस (टेस्ट फ़ोन) जो ज़रूरी शर्तें पूरी करता हो:
    • Android O (8.1, एपीआई लेवल 27 या इसके बाद का वर्शन)
    • iOS (v16.5 या इसके बाद का वर्शन)
    • BLE की सुविधा
  3. वेंडर आईडी (वीआईडी) और प्रॉडक्ट आईडी (पीआईडी) for the Matter-enabled device.
  4. 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 के लिए डेवलपर गाइड
Texas Instruments CC2652R7 LaunchPad डेवलपमेंट किट

वेंडर आईडी

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

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

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

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

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

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

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

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

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