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 इंटिग्रेशन का नया वर्शन बन जाएगा.

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

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

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

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

  1. पेज की बाईं ओर मौजूद नेविगेशन मेन्यू में, Matter > जांच करें पर जाएं.
  2. आपको जिस इंटिग्रेशन की जांच करनी है उसके वर्शन N/A के लिए, जांच करें पर क्लिक करें. इस ऐक्शन से इंटिग्रेशन का नया वर्शन बनता है.
  3. डेवलपमेंट टेस्ट या सर्टिफ़िकेशन टेस्ट में से कोई एक टेस्ट टाइप चुनें और टेस्ट करें पर क्लिक करें.
    • अगर आपको Google के पारिस्थितिक तंत्र में सर्टिफ़िकेट पाने की तैयारी करनी है, तो सर्टिफ़िकेशन टेस्ट चुनें.
    • सर्टिफ़िकेट पाने के लिए, डेवलपमेंट टेस्ट का इस्तेमाल नहीं किया जा सकता.

  4. अपना टेस्ट कॉन्फ़िगर करें स्क्रीन पर, अपने टेस्ट के लिए कोई नाम डालें. साथ ही, जोड़ने के लिए कोई डिवाइस चुनने के लिए, डिवाइस अपने-आप जोड़ें पर क्लिक करें.

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

    टेस्ट प्लान कॉन्फ़िगर करना

      1. Make sure you installed GHA to your phone.
  1. Connect your phone with a USB cable to the host machine.
  1. You must
    [Enable USB debugging on your device](https://developer.android.com/studio/debug/dev-options#Enable-debugging)
    The `APK` `com.chip.interop.moblysnippet` will automatically download
    and install.
  1. Once your phone is connected, enter the **Pairing code** and
    **Device name** to auto-pair your device.
    • iOS डिवाइस के लिए: आपको अपने डिवाइस को मैन्युअल तरीके से जोड़ना होगा. मैन्युअल तरीके से जोड़ने के निर्देशों के लिए, Google Home ऐप्लिकेशन सेक्शन देखें.
    • अगर आपके पास कोई मौजूदा डिवाइस है, तो आपसे उस डिवाइस को अनपेयर करने और फिर से जोड़ने या किसी नए डिवाइस को जोड़ने के लिए कहा जा सकता है.

  5. आगे बढ़ें: प्लान की जांच करें बटन पर क्लिक करें.

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

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

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

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

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

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

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

पूरा होने के बाद:

टेस्ट के नतीजे देखना और उनका विश्लेषण करना

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

जांच का इतिहास

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

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

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

टेस्ट फ़ेज़ में, Console की ये स्थितियां दिखती हैं:

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

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

जिन टेस्ट केस में गड़बड़ी हुई है उनकी समीक्षा करने के लिए, Google को वजहें दी गई हैं.

 अगर ज़रूरत हो, तो फिर से जांच करें.

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

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

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

डेवलेपमेंट

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

समस्या का हल

टेस्ट सुइट में, कमीशन किया गया डिवाइस न दिखना

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

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

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

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

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

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

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

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

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

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

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

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

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

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

पीछे जाएं
Matter डिवाइस को कंट्रोल करें
आगे बढ़ें
जांच के नतीजे सबमिट करना