मैटर वर्चुअल डिवाइस

डिवाइस का SDK टूल

Matter वर्चुअल डिवाइस, डेवलपमेंट और टेस्टिंग के लिए काम के हैं Matter समाधान उपलब्ध हैं और इन्हें Google Home app (GHA) को बनाया गया. साथ ही, इसे GHA और Google Assistant, बिलकुल फ़िज़िकल Matter की तरह डिवाइस.

यह विकल्प, उन ऐप्लिकेशन डेवलपर और अन्य लोगों के लिए है जिन्हें वर्चुअल ऐप्लिकेशन की जांच या उसे पूरा करने की ज़रूरत है Matter डिवाइस, लेकिन खुद का डिवाइस बनाने के लिए संसाधन नहीं हैं फ़िज़िकल या वर्चुअल Matter डिवाइस, Google, Matter Virtual Device (MVD) की सुविधा देता है. MVD, Linux या macOS के लिए एक हल्का स्टैंडअलोन डेस्कटॉप टूल है. यह अलग-अलग तरह के वर्चुअल Matter डिवाइसों को सिम्युलेट करता है. साथ ही, वर्चुअल Matter डिवाइस की स्थितियों को कंट्रोल और दिखाने के लिए, ग्राफ़िकल यूज़र इंटरफ़ेस (जीयूआई) उपलब्ध कराता है.

MVD किसी फ़िज़िकल Matter डिवाइस से अलग है Bluetooth® कम ऊर्जा (BLE) पर निर्भर नहीं करता है या Thread® Matter फ़ैब्रिक पर काम करने के लिए. इसके बजाय, यह होस्ट का इस्तेमाल करता है कमीशन देने के लिए, Linux या macOS मशीन का मौजूदा वाई-फ़ाई नेटवर्क कनेक्शन.

अन्य टूल की तुलना में

MVD, Virtual Device Controller (VDC) इसमें एक समाधान अपने-आप शामिल हो जाता है. इसमें वर्चुअल डिवाइस को उसे कंट्रोल कर रही हूँ. इसके उलट, VDC का इस्तेमाल किसी अलग वर्चुअल Matter डिवाइस को कंट्रोल करने के लिए किया जाता है. जैसे, Matter Virtual Device Development Environment (MVD-DE) में बनाया गया डिवाइस.

ऐसा हो सकता है कि आपने पहले ही MVD-DE कोडलैब (कोड बनाना सीखना) के साथ काम कर लिया हो. इस कोडलैब में, एक तरह का वर्चुअल डिवाइस बनाया जाता है-स्मार्ट बल्ब. तय सीमा में इसके उलट, MVD में पहले से बने कई अलग-अलग वर्चुअल डिवाइस और उन्हें चलाने और कंट्रोल करने के लिए, एक इंटिग्रेट किया गया यूज़र इंटरफ़ेस (यूआई) मौजूद है.

टेबल: वर्चुअल Matter डिवाइस टूल की तुलना
MVD VDC MVD-DE (कोडलैब)
Matter वाले डिवाइस को एम्युलेट करें
एम्युलेट किए गए Matter डिवाइस को कंट्रोल करना
डेवलपमेंट से जुड़ी कोशिश की ज़रूरत है
डाउनलोड करें 100 एमबी से कम 9 जीबी 20 जीबी

वे डिवाइस जिन पर YouTube ऐप्लिकेशन से YouTube Kids का इस्तेमाल किया जा सकता है

MVD में ये Matter काम करते हैं डिवाइस के टाइप:

टेबल: Matter डिवाइस इसके लिए समर्थित प्रकार MVD
Matter डिवाइस टाइप ऐप्लिकेशन क्लस्टर होम नेटवर्क का टाइप
बुनियादी वीडियो प्लेयर 0x0006
0x0506
0x0509
टीवी
हल्के रंग का तापमान 0x0300
0x0008
0x0006
हल्की
सेंसर से संपर्क करें 0x0045
सेंसर
रोशनी कम करने की सुविधा 0x0008
0x0006
हल्की
दरवाज़ा लॉक करना 0x0101
लॉक करें
एक्सटेंडेड कलर लाइट 0x0300
0x0008
0x0006
हल्की
पंखा 0x0202
0x0006
फ़ैन
फ़्लो सेंसर 0x0404
सेंसर
जेनेरिक स्विच 0x003b
स्विच करें
आर्द्रता सेंसर 0x0405
सेंसर
लाइट सेंसर 0x0400
सेंसर
होम में लोगों की मौजूदगी का पता लगाने वाला सेंसर 0x0406
सेंसर
लाइट चालू/बंद है 0x0008
0x0006
हल्की
लाइट स्विच को चालू/बंद करना 0x0006
स्विच करें
चालू/बंद प्लग-इन यूनिट 0x0008
0x0006
आउटलेट
दबाव सेंसर 0x0403
सेंसर
पंप 0x0006
0x0200
0x0402
0x0403
0x0404
वॉटर पंप
रोबोटिक वैक्यूम क्लीनर 0x0054
0x0055
0x0061
वैक्यूम
कमरे में एयर कंडिशनर 0x0006
0x0201
0x0202
Ac
धुएं का कार्बन अलार्म 0x005C
धुआं
तापमान मापने वाला सेंसर 0x0402
सेंसर
थर्मोस्टैट 0x0201
थर्मोस्टैट
विंडो कवरिंग 0x0102
ब्लाइंड

MVD इंस्टॉल करें

MVD, 64-बिट x86 प्रोसेसर वाली उन मशीनों पर काम करता है जिनमें Debian (11 या उसके बाद का वर्शन), Ubuntu (20.04 या उसके बाद का वर्शन) या macOS है.

Linux

MVD Debian (.deb) पैकेज डाउनलोड करें

आर्मर्ड-ASCII सिग्नेचर (.asc) फ़ाइल डाउनलोड करें

इसके बाद, MVD को इंस्टॉल करने के लिए dpkg चलाएं Debian (.deb) पैकेज:

sudo dpkg -i mvd_1.4.0_amd64.deb

macOS

MVD (macOS x86) की डीएमवी फ़ाइल डाउनलोड करना

MVD (ARM64 M1) dmg फ़ाइल डाउनलोड करना

इसके बाद, इंस्टॉलेशन विंडो खोलने के लिए, dmg फ़ाइल पर दो बार क्लिक करें.

इंस्टॉलेशन पूरा करने के लिए, mvd आइकॉन को चुनें और खींचकर यहां छोड़ें Applications फ़ोल्डर:

macOS इंस्टॉल

पोर्ट के इस्तेमाल की जानकारी देखना

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

यह देखने के लिए कि किसी प्रोसेस में पोर्ट 33000 का इस्तेमाल हो रहा है या नहीं:

Linux

sudo fuser -v 33000/tcp

macOS

lsof -i:33000

आप एक निर्देश से टीसीपी पोर्ट 33000 का इस्तेमाल करके किसी भी प्रोसेस को बंद कर सकते हैं:

Linux

sudo fuser -k 33000/tcp

macOS

lsof -ti:33000 | xargs kill

MVD चलाएं

Linux

Linux पर, अपने ऐप्लिकेशन फ़ोल्डर या टर्मिनल से MVD चलाएं:

mvd

macOS

macOS पर, MVD खोलने के लिए Launchpad का इस्तेमाल करें या टर्मिनल से MVD चलाएं:

cd /Applications
open mvd.app

अपना डिवाइस कॉन्फ़िगर करें

लॉन्च होने पर मुख्य स्क्रीन दिखती है. यहां वर्चुअल डिवाइस को कॉन्फ़िगर किया जा सकता है:

  • डिवाइस टाइप: डिवाइस का टाइप चुनें. उदाहरण के लिए, लाइट, स्विच, सेंसर वगैरह.
  • डिवाइस का नाम: डिवाइस को उपयोगकर्ता के लिए आसान नाम दें.
  • डिक्रिमिनेटर: एक 12-बिट संख्या, जिसका इस्तेमाल एक से ज़्यादा प्रॉपर्टी के बीच अंतर करने के लिए किया जाता है कमीशन वाले डिवाइस के विज्ञापन. (डिफ़ॉल्ट: 3840).
  • Matter पोर्ट: Matter के लिए पोर्ट बनाने और बातचीत करने के लिए, आईपी नेटवर्क. Matter, डिफ़ॉल्ट रूप से टीसीपी/यूडीपी पोर्ट 5540 का इस्तेमाल करता है, लेकिन तो वर्चुअल डिवाइस को कॉन्फ़िगर किया जा सकता है, ताकि पोर्ट के पास मौजूद होता है, जब तक कि कोई अन्य सेवा इसका उपयोग नहीं कर रही है.
  • वेंडर आईडी: सिर्फ़ टेस्ट वेंडर आईडी 0xFFF1 काम करता है.
  • प्रॉडक्ट आईडी: सिर्फ़ 0x8000 से 0x801F तक के प्रॉडक्ट आईडी टेस्ट करें समर्थित हैं.

वर्चुअल डिवाइस कॉन्फ़िगरेशन
स्क्रीन

अपना फ़ायरवॉल कॉन्फ़िगर करना

Linux

अगर आपके कंप्यूटर में फ़ायरवॉल चालू है, तो उसे बंद करें या Matter पोर्ट पर आने वाले टीसीपी/यूडीपी कनेक्शन.

netfilter फ़ायरवॉल के चालू नियमों को देखने के लिए, यह कमांड चलाएं:

sudo iptables -L -n

अगर `ufw` का इस्तेमाल किया है, तो इसे इससे बंद किया जा सकता है:

sudo ufw disable

और इसे इनकी मदद से फिर से चालू किया जा सकता है:

sudo ufw enable

macOS

macOS पर फ़ायरवॉल को कॉन्फ़िगर या बंद करने के लिए:

  1.  Apple मेन्यू में जाएँ और सिस्टम सेटिंग चुनें.
  2. साइडबार सूची में नेटवर्क पर क्लिक करें.
  3. फ़ायरवॉल पर क्लिक करें.
  4. फ़ायरवॉल के स्विच को बंद पर टॉगल करें.

अपना डिवाइस चलाएं

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

  • चालू/बंद: ज़्यादातर डिवाइसों में यह आम तौर पर होता है.
  • लेवल: उदाहरण के लिए, एक लाइट में, लेवल को कम या ज़्यादा करने के लिए स्लाइडर का इस्तेमाल किया जा सकता है स्क्रीन की रोशनी.
  • रंग: उदाहरण के लिए, रंग लाइट की मदद से यह कंट्रोल किया जा सकता है.
  • ऑक्यूपेंसी: ऑक्युपेंसी सेंसर यह कंट्रोल देता है, ताकि व्यस्त या खाली स्थिति.

सभी वर्चुअल डिवाइसों में ये कंट्रोल होते हैं:

  • QRCode: कमीशन के लिए इस्तेमाल किया गया क्यूआर कोड दिखाता है.
  • फिर से चालू करें: वर्चुअल डिवाइस को रीस्टार्ट करता है. डिवाइस को कुछ समय के लिए नेटवर्क से डिसकनेक्ट किया जाता है.
  • रीसेट करें: इससे मौजूदा डिवाइस को फ़ैक्ट्री-रीसेट कर दिया जाता है और सभी सेटिंग मिट जाती हैं. जैसे, कमीशनिंग, मौजूदा कंट्रोल की स्थिति वगैरह
  • मिटाना: डिवाइस बंद हो जाता है और डिवाइस बनाएं स्क्रीन पर वापस आ जाता है.

वर्चुअल डिवाइस कंट्रोल
स्क्रीन

अपने डिवाइस को कमीशन दें

डिवाइस बनाते ही उसे चालू कर दिया जाता है.

डिवाइस को चालू करने के लिए कुछ ज़रूरी शर्तें पूरी करनी होंगी:

  • आपके पास Google Home Developer Console में कोई प्रोजेक्ट होना चाहिए. इस प्रोजेक्ट को ऐसा Matter इंटिग्रेशन मौजूद होना चाहिए जिसका वीआईडी/पीआईडी एक जैसा हो जिस कॉम्बिनेशन का इस्तेमाल करके आपने वर्चुअल डिवाइस को सेट अप किया है. यहां जाएं: ज़्यादा जानकारी के लिए, प्रोजेक्ट बनाने की गाइड देखें.

  • आपके पास Google Nest Hub होना चाहिए, जो Matter के साथ काम करता हो

  • आपके पास Android 8.1 या इसके बाद के वर्शन पर चलने वाला ऐसा Android फ़ोन होना चाहिए जिसमें GHA इंस्टॉल हो गया.

  • Android फ़ोन उसी वाई-फ़ाई नेटवर्क से कनेक्ट होना चाहिए जिससे हब कनेक्ट है.

  • होस्ट मशीन, वाई-फ़ाई नेटवर्क से कनेक्ट होनी चाहिए.

GHA का इस्तेमाल करके डिवाइस को कमीशन देने के लिए, QRCode पर क्लिक करें डिवाइस का क्यूआर कोड दिखाएं. इसके बाद, Matter जोड़ें डिवाइस जो किसी Matter डिवाइस को ऑनबोर्ड करने का तरीक़ा बताओ. GHA. Google Home Sample App for Matter का इस्तेमाल करके भी डिवाइस को चालू किया जा सकता है.

हमारी Matter Primer को जानें कि Matter को कमीशन कैसे दिया जाता है.

डिवाइस कंट्रोल करें

वर्चुअल डिवाइस को चालू करने के बाद, उसे कंट्रोल करने के लिए Google Home ऐप्लिकेशन या Google Assistant को आवाज़. इनमें से कोई एक विकल्प चुना जा सकता है:

  • GHA से डिवाइस कंट्रोल करें या मॉनिटर करने की स्थिति बदलने के दौरान, Assistant बजे का विकल्प चालू है वर्चुअल डिवाइस या
  • डिवाइस को कंट्रोल करने के लिए, स्थिति की निगरानी करते समय Sample App for Matter वर्चुअल डिवाइस में बदलाव या
  • MVD से डिवाइस की स्थिति को खुद कंट्रोल करें GHA में या उसके बाद निगरानी करने की स्थिति में होने वाले बदलाव Assistant.

डिवाइस से जांच करना

Assistant से टेस्ट करने के लिए, हमारा सुझाव है कि आप एक उच्चारण का इस्तेमाल करें सिम्युलेटर जैसे वीएस कोड के लिए Google Home एक्सटेंशन या Android Studio के लिए Google Home प्लगिन का इस्तेमाल करें.

डिवाइस की जानकारी देखें

डिवाइस की जानकारी वाली स्क्रीन पर, डिवाइस की पूरी जानकारी दिखती है:

  • नाम: डिवाइस को दिया गया दोस्ताना नाम.
  • डिवाइस टाइप: चुना गया डिवाइस टाइप.
  • डिसक्रिमिनेटर: मौजूदा डिवाइस डिस्क्रिमिनेटर.
  • वेंडर आईडी: डिवाइस का मौजूदा वेंडर आईडी.
  • प्रॉडक्ट आईडी: डिवाइस का मौजूदा प्रॉडक्ट आईडी.
  • RPC पोर्ट: वह RPC पोर्ट जिसका इस्तेमाल डिवाइस कंट्रोलर (जीयूआई) से करता है.
  • Matter पोर्ट: वह पोर्ट जिसका इस्तेमाल मौजूदा डिवाइस IP नेटवर्क के माध्यम से संचार करें.
  • पास कोड: नेटवर्क से डिवाइस को चालू करने के लिए इस्तेमाल किया जाने वाला पिन.
  • कॉन्फ़िगरेशन फ़ोल्डर: वर्चुअल डिवाइस को स्टोर किया जाने वाला फ़ोल्डर कॉन्फ़िगरेशन.
  • कमीशन की जानकारी: इसमें उन फ़ैब्रिक और डिवाइसों की जानकारी दिखती है जिन्हें डिवाइस जोड़ा गया है और फ़ैब्रिक में डिवाइस का नोड आईडी.

डिवाइस के लॉग देखें

अगर आपने टर्मिनल से MVD को लॉन्च किया है, तो लॉग आउटपुट दिखेगा stdout को. डिवाइस लॉग टैब पर भी डिवाइस के लॉग देखे जा सकते हैं.

डिवाइस रोकें

डिवाइस को बंद करने और उसे मिटाने के लिए, मिटाएं पर क्लिक करें.

ऐप्लिकेशन को बंद करें

कंट्रोल विंडो को बंद करने से डिवाइस मिट जाता है. साथ ही, MVD ऐप्लिकेशन. अगर आपने टर्मिनल से लॉन्च किया है, तो टर्मिनल में Ctrl-C लिखकर ऐप्लिकेशन को भी बंद करें.

सहायता पाएं

MVD से जुड़ी सहायता पाने के लिए, किसी गड़बड़ी की शिकायत करने के लिए या नई सुविधा का अनुरोध करने के लिए, अपने Google सहायता प्रतिनिधि से संपर्क करें.

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

गड़बड़ी की शिकायत करें

अगर आपको लगता है कि आपको MVD में कोई खराबी मिली है, तो समस्या पर क्लिक करके गड़बड़ी की शिकायत करें बटन क्लिक करें.

सुझाव भेजें

MVD के बारे में आपको क्या पसंद है या कैसे पसंद है, इस बारे में अपनी राय सबमिट करने के लिए हम टूल का इस्तेमाल करने के आपके अनुभव को बेहतर बना सकते हैं. इसके लिए, अपना सुझाव फ़ॉर्म भरें.

इस फ़ॉर्म को सुझाव, शिकायत या राय से लॉन्च किया जा सकता है बटन विंडो के ऊपरी-दाएं कोने में या नीचे दिए गए बटन पर क्लिक करके भी ऐसा कर सकते हैं.

हमें अपने सुझाव/राय भेजें या शिकायत करें