Matter इंटिग्रेशन की जांच करना

Google Home Developer Console में जांच पेज उपलब्ध होता है. इस पेज पर जाकर, Google Home Test Suite का इस्तेमाल करके, Matter इंटिग्रेशन के लिए जांचों को कॉन्फ़िगर किया जा सकता है और उन्हें चलाया जा सकता है. Test Suite, Developer Console में बनाया गया एक अलग ऐप्लिकेशन है. यह इंटिग्रेशन की सभी जांचों को मैनेज करता है.

इंटिग्रेशन के वेंडर आईडी और प्रॉडक्ट आईडी के लिए, डिवाइसों को चालू किया जाना चाहिए. साथ ही, Developer Console के साथ इस्तेमाल किए जा रहे खाते के लिए, Google Home app (GHA) में उपलब्ध होना चाहिए, ताकि उनकी जांच की जा सके. ज़्यादा जानकारी के लिए, Matter डिवाइस को जोड़ना लेख पढ़ें.

Test Suite को उन डिवाइसों के सेट पर चलाया जा सकता है जो किसी खास Matter प्रोजेक्ट कॉन्फ़िगरेशन से जुड़े हों. यह बहुत ज़रूरी है कि आप अपने इंटिग्रेशन पर Test Suite चलाएं, ताकि यह पक्का किया जा सके कि सब कुछ ठीक से काम कर रहा है.

टेस्ट पेज पर, Matter इंटिग्रेशन की सूची दिखती है. इनमें वे इंटिग्रेशन शामिल होते हैं जो पूरे हो चुके हैं और जिनकी जांच की जा सकती है. ये इंटिग्रेशन, टेस्ट के लिए तैयार सेक्शन में दिखते हैं.

Matter इंटिग्रेशन की जांच की जा चुकी है. ये जांच की गई सेक्शन में दिखते हैं.

टेस्ट प्लान के टाइप

इस तरह के टेस्ट प्लान उपलब्ध हैं:

  • डेवलपमेंट टेस्ट प्लान का इस्तेमाल, Matter का इस्तेमाल करके डिवाइसों को कंट्रोल करने की सुविधा की जांच करने के लिए किया जाता है. इनमें बदलाव किया जा सकता है, लेकिन इन्हें Matter सर्टिफ़िकेशन के लिए सबमिट नहीं किया जा सकता.

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

  • सीएसए इंटरऑप टेस्ट प्लान की मदद से, टेस्ट स्टेज को स्किप किया जा सकता है. साथ ही, Connectivity Standards Alliance (Alliance) इंटरऑप टेस्ट लैब के नतीजों का इस्तेमाल किया जा सकता है. यह टेस्ट विकल्प, ज़रूरी शर्तें पूरी करने वाले सभी डिवाइस टाइप के लिए उपलब्ध है.

सर्टिफ़िकेशन के लिए टेस्ट के नतीजे सबमिट करने के लिए, Developer Console में मौजूद Developer Console का इस्तेमाल करें.Test Suite अगर आपको डेवलपमेंट के दौरान, जांच के लिए Test Suite को चलाना है, तो स्टैंडअलोन वर्शन के लिए Google Home Test Suite पेज देखें.

इंटिग्रेशन के वर्शन

सर्टिफ़िकेशन के लिए टेस्ट प्लान बनाने पर, इंटिग्रेशन का नया वर्शन बन जाता है. नंबर वाला यह वर्शन, Developer Consoleटेस्ट टैब से आगे की सभी इंटिग्रेशन सूचियों में शामिल होता है.

नंबर वाले अन्य वर्शन से कभी भी नए वर्शन नहीं बनाए जाते. उदाहरण के लिए, किसी इंटिग्रेशन के लिए बनाया गया पहला टेस्ट प्लान, उस इंटिग्रेशन के लिए v.1 वर्शन बनाएगा. दूसरा टेस्ट प्लान बनाने पर, उस इंटिग्रेशन के लिए v.2 वर्शन बन जाएगा. हालांकि, यह वर्शन v.1 पर आधारित नहीं होगा. इसके बजाय, यह वर्शन इंटिग्रेशन के बिना वर्शन वाले इंस्टेंस पर आधारित है. यह v.1 की तरह ही है.

इंटिग्रेशन का लागू नहीं है वर्शन, इंटिग्रेशन के ऐसे इंस्टेंस को दिखाता है जिसका कोई वर्शन नहीं है. इसे डेवलप करें टैब पर मैनेज किया जाता है.

दूसरे शब्दों में, Developer Console में Matter > जांच करें पर जाकर:

  • अगर इंटिग्रेशन के लागू नहीं है वर्शन के लिए जांच करें पर क्लिक किया जाता है, तो एक नया वर्शन बनाया जाता है. वर्शन का नंबर, नंबर वाले किसी भी मौजूदा वर्शन से एक ज़्यादा होगा.
    • अगर नंबर वाला कोई वर्शन मौजूद नहीं है, तो v.1 वर्शन बनाया जाता है.
    • अगर वर्शन v.1 मौजूद है, तो वर्शन v.2 बनाया जाता है. अगर वर्शन v.2 मौजूद है, तो वर्शन v.3 बनाया जाता है. इसी तरह, आगे के वर्शन बनाए जाते हैं.
  • अगर इंटिग्रेशन के नंबर वाले वर्शन (उदाहरण के लिए, v.1) के लिए टेस्ट करें पर क्लिक किया जाता है, तो नया वर्शन नहीं बनाया जाता है. इसके बजाय, वर्शन v.1 को फिर से टेस्ट किया जाता है.

ज़्यादा जानकारी के लिए, इंटिग्रेशन वर्शनिंग देखें.

टेस्ट प्लान बनाना

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

सर्टिफ़िकेशन के लिए टेस्ट प्लान बनाने से पहले, पक्का करें कि आपने ये काम पूरे कर लिए हों:

  1. कंपनी प्रोफ़ाइल बनाई हो.
  2. आपने इंटिग्रेशन के लिए प्रोडक्शन वेंडर आईडी (वीआईडी) डाला हो.
  3. कॉन्फ़िगर किया गया सेटअप और ब्रैंडिंग.

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

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

टेस्ट प्लान बनाने के लिए:

तीन विकल्पों के साथ नया टेस्ट प्लान बनाना

Developer Console पर जाएं

  1. प्रोजेक्ट की सूची में, उस प्रोजेक्ट के बगल में मौजूद खोलें पर क्लिक करें जिस पर आपको काम करना है.

  2. पेज के बाईं ओर मौजूद नेविगेशन मेन्यू में, Matter > टेस्ट करें पर जाएं.

  3. आपको जिस इंटिग्रेशन की जांच करनी है उसके लागू नहीं है वर्शन के लिए, जांच करें पर क्लिक करें. इस कार्रवाई से, एक नया इंटिग्रेशन वर्शन बनता है.

  4. टेस्ट का टाइप चुनें और टेस्ट करें पर क्लिक करें.

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

    टेस्ट प्लान का नाम डालना और उसे कॉन्फ़िगर करना

    • Android डिवाइस के लिए:

      1. पक्का करें कि आपने अपने फ़ोन पर GHA इंस्टॉल किया हो.
      2. अपने फ़ोन को यूएसबी केबल की मदद से होस्ट मशीन से कनेक्ट करें.
      3. आपको अपने डिवाइस पर यूएसबी डीबग करने की सुविधा चालू करनी होगी APK com.chip.interop.moblysnippet अपने-आप डाउनलोड और इंस्टॉल हो जाएगा.
      4. फ़ोन कनेक्ट होने के बाद, अपने डिवाइस को अपने-आप जोड़ने के लिए, पेयरिंग कोड और डिवाइस का नाम डालें.
    • iOS डिवाइस के लिए:

      1. आपको अपने डिवाइस को मैन्युअल तरीके से जोड़ना होगा. मैन्युअल तरीके से पेयर करने के निर्देश पाने के लिए, Google Home ऐप्लिकेशन सेक्शन देखें.
      2. अगर आपके पास पहले से कोई डिवाइस है, तो आपसे डिवाइस को अनपेयर करने और फिर से पेयर करने या किसी नए डिवाइस को पेयर करने के लिए कहा जा सकता है.
  6. आगे बढ़ें: टेस्ट प्लान बटन पर क्लिक करें.

  7. टेस्ट प्लान बनाएं पेज पर, टेस्ट सुइट सेक्शन में जाकर, वे टेस्ट सुइट चुनें जिन्हें आपको चलाना है.

टेस्ट प्लान बनाना अगर आपको Test Suite से बाहर निकलना है, तो Developer Center पर वापस जाएं पर क्लिक करें.

टेस्ट प्लान चलाना

Test Suite में, टेस्ट प्लान बनाएं पेज पर जाकर, टेस्ट चलाएं पर क्लिक करें. टेस्ट एनवायरमेंट पेज दिखता है. इसमें सभी टेस्ट का स्टेटस और लॉग दिखते हैं.

टेस्ट पूरा होने के बाद, नतीजे दिखते हैं. हर टेस्ट सुइट के बगल में, उसके एक्ज़ीक्यूशन का स्टेटस दिखता है (पास हुआ, फ़ेल हुआ).

लॉग पैनल में, हर टेस्ट के एक्ज़ीक्यूशन का स्टेटस दिखता है.

परीक्षण परिणाम टेस्ट एनवायरमेंट पेज पर जाकर, टेस्ट प्लान को फिर से टेस्ट करने के लिए, टेस्ट पूरा होने के बाद सबसे ऊपर मौजूद फिर से टेस्ट करें पर क्लिक करें.

यह प्रोसेस पूरी होने के बाद:

टेस्ट के नतीजे देखना और उनकी व्याख्या करना

Test Suite में मौजूद टेस्ट का इतिहास पेज पर, आपको डेवलपमेंट प्लान या सबमिट न किए गए सर्टिफ़िकेशन टेस्ट प्लान के पिछले टेस्ट के नतीजे दिख सकते हैं. इसके लिए, टेस्ट प्लान सेक्शन में जाकर, अपने हिसाब से टेस्ट प्लान के लिए फिर से टेस्ट करें पर क्लिक करें. इससे आपको टेस्ट एनवायरमेंट पेज पर ले जाया जाता है. इस पेज पर, उस टेस्ट के नतीजे दिखते हैं.

टेस्ट का इतिहास

सबमिट किए गए सर्टिफ़िकेशन प्लान के लिए, टेस्ट के नतीजों की रिपोर्ट देखने के लिए, सर्टिफ़िकेशन के लिए सेव किया गया सेक्शन में जाकर, नतीजे पर क्लिक करें.

Developer Console में मौजूद जांच टैब से, इंटिग्रेशन के किसी वर्शन के लिए जांच के नतीजे भी ऐक्सेस किए जा सकते हैं. उस पेज पर मौजूद किसी भी इंटिग्रेशन वर्शन के जांच के इतिहास के लिए, देखें पर क्लिक करें. इससे आपको Test Suite में जांच के इतिहास पेज पर ले जाया जाएगा.

कंसोल के स्टेटस

टेस्टिंग के दौरान, Console की ये स्थितियां दिखती हैं:

Section स्टेटस ब्यौरा ज़रूरी शर्त आगे क्या करें
परीक्षण के लिए तैयार तैयार integration का यह वर्शन, टेस्ट करने के लिए तैयार है. लागू नहीं integrationके इस वर्शन को टेस्ट करें.
जांचा गया तैयार integration के इस वर्शन की जांच की जा चुकी है. इसे Field Trial या सर्टिफ़िकेशन के लिए सबमिट किया जा सकता है.

वर्शन की जांच की गई और उसे सेव किया गया.

जांच के सभी फ़ेल हुए मामलों में, Google को समीक्षा करने के लिए वजहें शामिल होती हैं.

अगर आपको फिर से जांच करनी है, तो फिर से जांच करें पर क्लिक करें.

फिर से जांच करें

सर्टिफ़िकेशन

अगर आपको सर्टिफ़िकेशन के लिए फिर से जांच करनी है, तो जांच शुरू करने के बाद आपको अपने डिवाइस को फिर से जोड़ना होगा.

डेवलेपमेंट

अगर आपको डेवलपमेंट के लिए फिर से जांच करनी है, तो बिना दोबारा पेयर किए मौजूदा डिवाइस का इस्तेमाल किया जा सकता है.

समस्या का हल

कमीशन किया गया डिवाइस, Test Suite में नहीं दिखता

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

समस्या हल करने के लिए, Developer Console से सभी टेस्ट डिवाइस हटाएं. इसके बाद, उस डिवाइस को फिर से जोड़ें जिस पर आपको टेस्ट करना है.

यह पुष्टि करने के लिए कि आपने सही डिवाइस को जोड़ा है, डिवाइस के लिए मैन्युफ़ैक्चरर और मॉडल की जानकारी (CHIP_DEVICE_CONFIG_DEVICE_* वैल्यू) सेट करें. इसके लिए, अपने टेस्ट फ़र्मवेयर में यूनीक वैल्यू सेट करें.

ज़्यादा जानकारी के लिए, डिवाइस की जानकारी देखें.

अपने डिवाइस के VID/PID की पुष्टि करना

अगर आपको Google के साथ इंटिग्रेशन डेवलप करना है, तो आपको Google Home Console पर एक प्रोजेक्ट और इंटिग्रेशन बनाना होगा.

ब्लूटूथ स्निफ़र से जुड़ी समस्याएं हल करना

आपके डिवाइस से बीकन की जा रही VID/PID वैल्यू, Developer Console प्रोजेक्ट में डाली गई VID/PID वैल्यू से मेल खानी चाहिए.

  • वीआईडी 0xFFF10xFFF4 सिर्फ़ टेस्टिंग के लिए रिज़र्व किए जाते हैं. इनका इस्तेमाल, बुनियादी कमीशनिंग और कंट्रोल टेस्ट के लिए किया जा सकता है. हालांकि, इनका इस्तेमाल डेवलपमेंट के इन चरणों के दौरान नहीं किया जा सकता:

nRF Connect for Mobile जैसे ब्लूटूथ इंजीनियरिंग ऐप्लिकेशन का इस्तेमाल करके, Service Data फ़ील्ड में बीकन वाले डिवाइस का VID/PID देखा जा सकता है.

nRF Connect के Android वर्शन के इस स्क्रीनशॉट में, आपको दिखेगा कि VID/PID को 5A23FFFE के तौर पर लिस्ट किया गया है. यह Service Data फ़ील्ड के चौथे बाइट से शुरू होता है. इससे पता चलता है कि 5A23 का VID और FFFE का PID, दोनों लिटिल एंडियन फ़ॉर्मैट में हैं.

BLE ऐप्लिकेशन, वैल्यू को लिटिल एंडियन में दिखाता है, लेकिन Developer Console प्रोजेक्ट में डाली गई VID/PID वैल्यू, बिग एंडियन में होती हैं.

पुष्टि करें कि Actions Console प्रोजेक्ट में, ब्लूटूथ स्निफ़र के हिसाब से सही वैल्यू और फ़ॉर्मैट डाला गया हो.

उदाहरण के लिए दिए गए स्क्रीनशॉट में मौजूद वैल्यू के लिए, Developer Console में VID और PID की वैल्यू 235A और FEFF होगी.