DIVUS VISION API सॉफ्टवेअर

तपशील

• उत्पादन: DIVUS VISION API
• निर्माता: DIVUS GmbH
• आवृत्ती: 1.00 REV0 1 – 20240528
• स्थान: Pillhof 51, Eppan (BZ), इटली

उत्पादन माहिती

DIVUS VISION API हे DIVUS VISION प्रणाल्यांमध्ये इंटरफेस करण्यासाठी डिझाइन केलेले सॉफ्टवेअर टूल आहे. हे वापरकर्त्यांना MQTT प्रोटोकॉल वापरून सिस्टममधील विविध घटकांमध्ये प्रवेश आणि नियंत्रण करण्यास अनुमती देते.

वारंवार विचारले जाणारे प्रश्न

प्रश्न: मी पीसी किंवा ऑटोमेशन तंत्रज्ञानाच्या पूर्व माहितीशिवाय DIVUS VISION API वापरू शकतो का?

A: API चा कार्यक्षम वापर सुनिश्चित करण्यासाठी या क्षेत्रातील पूर्वीचे ज्ञान असलेल्या वापरकर्त्यांसाठी मॅन्युअल तयार केले आहे.

सामान्य माहिती

• DIVUS GmbH Pillhof 51 I-39057 Eppan (BZ) – इटली

ऑपरेटिंग सूचना, मॅन्युअल आणि सॉफ्टवेअर कॉपीराइटद्वारे संरक्षित आहेत. सर्व हक्क राखीव. कॉपी करणे, डुप्लिकेट करणे, भाषांतर करणे, संपूर्ण किंवा काही अंशी भाषांतर करण्याची परवानगी नाही. वैयक्तिक वापरासाठी सॉफ्टवेअरची बॅकअप प्रत तयार करण्यासाठी अपवाद लागू होतो.
मॅन्युअल सूचना न देता बदलण्याच्या अधीन आहे. आम्ही हमी देऊ शकत नाही की या दस्तऐवजात समाविष्ट केलेला डेटा आणि पुरवलेल्या स्टोरेज मीडियावरील त्रुटी मुक्त आणि योग्य आहेत. सुधारणांसाठी सूचना तसेच त्रुटींवरील सूचनांचे नेहमीच स्वागत आहे. करार या नियमावलीतील विशिष्ट संलग्नकांना देखील लागू होतात. या दस्तऐवजातील पदनाम ट्रेडमार्क असू शकतात ज्यांचा वापर तृतीय पक्ष त्यांच्या स्वत: च्या हेतूंसाठी त्यांच्या मालकांच्या अधिकारांचे उल्लंघन करू शकतात. वापरकर्ता सूचना: कृपया हे मॅन्युअल प्रथमच वापरण्यापूर्वी वाचा आणि भविष्यातील संदर्भासाठी सुरक्षित ठिकाणी ठेवा. लक्ष्य गट: पीसी आणि ऑटोमेशन तंत्रज्ञानाचे पूर्वीचे ज्ञान असलेल्या वापरकर्त्यांसाठी मॅन्युअल लिहिलेले आहे.

सादरीकरण अधिवेशने

परिचय

सामान्य परिचय

हे मॅन्युअल VISION API (ऍप्लिकेशन प्रोग्रामिंग इंटरफेस) चे वर्णन करते - एक इंटरफेस ज्याद्वारे VISION ला संबोधित केले जाऊ शकते आणि बाह्य प्रणालींमधून नियंत्रित केले जाऊ शकते.
व्यावहारिक भाषेत, याचा अर्थ असा आहे की आपण सिस्टम वापरू शकता जसे की

• MQTT एक्सप्लोरर (https://www.microsoft.com/store/… – चाचणीसाठी),
• गृह सहाय्यक (https://www.home-assistant.io/) किंवा
• नोड-लाल (https://nodered.org/)

VISION द्वारे व्यवस्थापित घटक नियंत्रित करण्यासाठी किंवा त्यांची स्थिती वाचण्यासाठी. प्रवेश आणि संप्रेषण MQTT प्रोटोकॉलद्वारे केले जाते, जे तथाकथित विषयांचा वापर वैयक्तिक फंक्शन्स किंवा फंक्शन्सच्या संचाला संबोधित करण्यासाठी किंवा त्यांच्यातील बदलांबद्दल माहिती देण्यासाठी करतात. या उद्देशासाठी MQTT सर्व्हर (दलाल) वापरला जातो, जो सुरक्षा आणि सहभागींना संदेशांचे व्यवस्थापन/वितरण हाताळतो. या प्रकरणात, MQTT सर्व्हर थेट DIVUS KNX IQ वर स्थित आहे आणि या उद्देशासाठी खास कॉन्फिगर केलेला आहे. जरी व्हिजन API प्रोग्रामिंग ज्ञानाशिवाय देखील वापरले जाऊ शकते, ही कार्यक्षमता प्रगत वापरकर्त्यांसाठी योग्य आहे.

पूर्वतयारी

VISION मॅन्युअलमध्ये स्पष्ट केल्याप्रमाणे, API वापरकर्त्याने ते वापरण्यास सक्षम होण्यासाठी डीफॉल्टनुसार प्रथम सक्रिय केले जाणे आवश्यक आहे API प्रवेश केवळ Api वापरकर्ते प्रमाणीकरण डेटा वापरून कार्य करते. जोपर्यंत वापरकर्ता अधिकारांचा संबंध आहे, या कार्यक्षमतेसाठी सक्रियकरण नंतर सर्व किंवा वैयक्तिक घटकांवर कॉन्फिगर केले जाऊ शकते. Chap.0 पहा. अर्थात, तुम्हाला VISION प्रोजेक्ट देखील आवश्यक आहे ज्यामध्ये तुम्ही बाहेरून नियंत्रित करू इच्छित घटक पूर्णपणे कॉन्फिगर केलेले आहेत आणि त्यांच्याशी कनेक्शनची यशस्वी चाचणी केली गेली आहे. API द्वारे वैयक्तिक घटकांना संबोधित करण्यात सक्षम होण्यासाठी, त्यांचा घटक आयडी माहित असणे आवश्यक आहे: हे घटकाच्या सेटिंग्ज फॉर्मच्या तळाशी प्रदर्शित केले जाते

सुरक्षितता

सुरक्षेच्या कारणास्तव, API प्रवेश केवळ स्थानिक पातळीवर शक्य आहे (म्हणजे क्लाउडद्वारे नाही). API प्रवेश सक्रिय करताना सुरक्षिततेचा धोका कमी असतो. तरीही, सुरक्षा-संबंधित घटक सक्षम केले जाऊ नयेत किंवा API प्रवेशासाठी स्पष्टपणे नाकारले जाऊ नये.

MQTT आणि त्याच्या अटी - संक्षिप्त स्पष्टीकरण

• MQTT मध्ये, केंद्रीकृत व्यवस्थापन आणि सर्व संदेश वितरणाची भूमिका ब्रोकरची असते. जरी MQTT सर्व्हर आणि MQTT ब्रोकर हे समानार्थी शब्द नसले तरी (सर्व्हर ही MQTT क्लायंट देखील बजावू शकणाऱ्या भूमिकेसाठी एक व्यापक संज्ञा आहे), जेव्हा MQTT सर्व्हरचा उल्लेख केला जातो तेव्हा ब्रोकरचा अर्थ नेहमी या मॅन्युअलमध्ये असतो. या मॅन्युअलच्या संदर्भात DIVUS KNX IQ स्वतः MQTT ब्रोकर / MQTT सर्व्हरची भूमिका बजावते.
• MQTT सर्व्हर तथाकथित विषय वापरतो: एक श्रेणीबद्ध रचना ज्यासह डेटा वर्गीकृत, व्यवस्थापित आणि प्रकाशित केला जातो.
• इतर सहभागींना विषयांद्वारे डेटा उपलब्ध करून देणे हे प्रकाशनाचे प्राथमिक उद्दिष्ट आहे. तुम्हाला एखादे मूल्य बदलायचे असल्यास, तुम्ही प्रकाशन क्रिया वापरून इच्छित मूल्य बदलासह इच्छित विषयावर लिहा. लक्ष्य उपकरण किंवा MQTT सर्व्हर त्यावर परिणाम करणारा इच्छित बदल वाचतो आणि त्यानुसार त्याचा अवलंब करतो. बदल लागू झाला आहे हे तपासण्यासाठी, बदल तेथे परावर्तित होतो की नाही हे पाहण्यासाठी तुम्ही सदस्यत्व घेतलेल्या रीअल-टाइम विषयात पाहू शकता - जर सर्व काही ठीक झाले असेल.
• ग्राहक त्यांना स्वारस्य असलेले विषय निवडतात: याला सदस्यत्व म्हणतात. प्रत्येक वेळी जेव्हा एखाद्या विषयामध्ये/खाली मूल्य बदलते, तेव्हा सर्व सदस्यत्व घेतलेल्या क्लायंटना सूचित केले जाते – म्हणजे काहीतरी बदलले आहे की नाही किंवा सध्याचे मूल्य काय आहे हे स्पष्टपणे न विचारता.
• तुम्ही विषयामध्ये client_id नावाची कोणतीही अनोखी स्ट्रिंग टाकून MQTT सर्व्हरसह एक स्वतंत्र संप्रेषण चॅनेल उघडू शकता (किंवा पत्ता). क्लायंट_आयडी मुल्यांवर प्रक्रिया करण्यासाठी विषयामध्ये वापरणे आवश्यक आहे. हे प्रत्येक बदलाचे मूळ ओळखण्यास मदत करते, कोणत्याही त्रुटींसह मदत करते आणि इतर क्लायंटवर परिणाम करत नाही, कारण सर्व्हरकडून संबंधित प्रतिसाद, कोणत्याही त्रुटी कोड आणि संदेशांसह, देखील फक्त त्याच client_id सह विषयावर पोहोचतात (आणि अशा प्रकारे फक्त तो क्लायंट). client_id ही 0-9, az, AZ, “-“, “_” वर्णांच्या कोणत्याही संयोजनाचा समावेश असलेली एक अद्वितीय वर्ण स्ट्रिंग आहे.
• सर्वसाधारणपणे, DIVUS KNX IQ च्या MQTT सर्व्हरच्या सदस्यत्वाच्या विषयांमध्ये कीवर्ड स्थिती असते, तर प्रकाशित विषयांमध्ये कीवर्ड विनंती असते. बाह्य मूल्यात बदल होताच किंवा क्लायंटने स्वतः प्रकाशनाद्वारे मूल्य बदलाची विनंती केल्यावर आणि यशस्वीरित्या लागू होताच स्थिती असलेले ते आपोआप अपडेट होतात. प्रकाशनासाठी पुढील प्रकार (विनंती/)मिळतील आणि प्रकार (विनंती/)सेटमध्ये विभागले गेले आहेत.
• मूल्य बदल आणि इतर पर्यायी पॅरामीटर्स तथाकथित पेलोडसह विषयामध्ये जोडले जातात. वैयक्तिक घटकांचे पॅरामीटर्स (घटक-आयडी, नाव, प्रकार, कार्ये)

MQTT आणि क्लासिक क्लायंट-सर्व्हर मॉडेलमधील मुख्य फरक, जिथे क्लायंट विनंती करतो आणि नंतर डेटा बदलतो, सबस्क्राइब आणि प्रकाशित करण्याच्या संकल्पनांवर केंद्रित आहे. सहभागी डेटा प्रकाशित करू शकतात, तो इतरांना उपलब्ध करून देऊ शकतात, ज्यांना स्वारस्य असल्यास ते त्याचे सदस्यत्व घेऊ शकतात. हे आर्किटेक्चर डेटा एक्सचेंज कमी करणे आणि तरीही सर्व इच्छुक पक्षांना अद्ययावत ठेवणे शक्य करते. येथे तपशीलांबद्दल अधिक: आणि विशेष पॅरामीटर्स (uuid, फिल्टर) येथे वापरले जातील. अनेक पर्याय असले तरी, पेलोड या मॅन्युअलमध्ये JSON म्हणून फॉरमॅट केलेला दाखवला आहे. JSON कोणत्याही संरचनेचा डेटा दर्शवण्यासाठी कंस आणि स्वल्पविराम वापरतो आणि अशा प्रकारे प्रसारित केल्या जाणाऱ्या डेटा पॅकेटचा आकार कमी करतो. पेलोड्सबद्दल अधिक तपशील मॅन्युअलमध्ये नंतर आढळू शकतात.

• विशेष हेतूंसाठी, फंक्शनच्या प्रकारानुसार फिल्टर करणे शक्य आहे, उदा. फक्त ऑन/ऑफ म्हणजे 1-बिट स्विचेसचा पत्ता. पेलोडमधील फिल्टर पॅरामीटर या उद्देशासाठी वापरला जातो. फिल्टरिंग सध्या फक्त फंक्शन प्रकारानुसार शक्य आहे.
• वैयक्तिक घटकांना संबोधित करण्यात सक्षम होण्यासाठी, त्यांचा घटक आयडी आवश्यक आहे. हे घटक गुणधर्म मेनूमध्ये VISION मध्ये आढळू शकते किंवा MQTT एक्सप्लोररच्या सामान्य सदस्यामध्ये प्रत्येक उपलब्ध घटकासमोर प्रदर्शित केलेल्या डेटामधून थेट वाचले जाऊ शकते (तेथे घटक आयडीनुसार वर्णक्रमानुसार सूचीबद्ध आहेत).

API प्रवेशासाठी कॉन्फिगरेशन

API वापरकर्ता प्रवेशासाठी व्हिजन कॉन्फिगर करत आहे

प्रशासक म्हणून VISION मध्ये, कॉन्फिगरेशन - वापरकर्ता/एपीआय प्रवेश व्यवस्थापन वर जा, वापरकर्ते/एपीआय प्रवेशावर क्लिक करा आणि संपादन विंडो उघडण्यासाठी API वापरकर्ता (किंवा दाबा आणि धरून ठेवा) वर राइट-क्लिक करा. तेथे तुम्हाला हे पॅरामीटर्स आणि डेटा मिळेल

• सक्षम (चेकबॉक्स)
  • वापरकर्ता प्रथम येथे सक्षम आहे. डीफॉल्ट अक्षम केले आहे
• वापरकर्तानाव
  • API द्वारे प्रवेशासाठी ही स्ट्रिंग आवश्यक आहे – ती येथून कॉपी करा
• पासवर्ड
  • API द्वारे प्रवेशासाठी ही स्ट्रिंग आवश्यक आहे – ती येथून कॉपी करा
• परवानग्या
  • VISION घटकांची मूल्ये वाचणे आणि लिहिण्याचे डीफॉल्ट अधिकार येथे परिभाषित केले जाऊ शकतात, म्हणजे येथे जे परिभाषित केले आहे ते सर्व विद्यमान आणि भविष्यातील घटकांना लागू होते. तुम्हाला फक्त वैयक्तिक घटकांमध्ये प्रवेशाची परवानगी द्यायची असल्यास, तुम्ही हे डीफॉल्ट अधिकार बदलू नयेत

वैयक्तिक घटकांवरील परवानग्या

अशी शिफारस केली जाते की तुम्ही संपूर्ण प्रकल्पासाठी API प्रवेश देऊ नका, परंतु केवळ इच्छित घटकांसाठी. खालीलप्रमाणे पुढे जा

1. प्रशासक म्हणून VISION मध्ये लॉग इन करा
2. इच्छित घटक निवडा आणि त्याचा सेटिंग्ज मेनू उघडा (उजवे-क्लिक करा किंवा दाबून ठेवा, नंतर सेटिंग्ज)
3. मेनू एंट्री अंतर्गत सामान्य – परवानग्या, “ओव्हरराइड डीफॉल्ट परवानग्या” सक्रिय करा आणि नंतर सब-आयटम परवानग्या वर जा, जे परवानग्या मॅट्रिक्स दर्शविते.
4. येथे नियंत्रण परवानगी सक्रिय करा, जे सक्षम करते view थेट परवानगी. जर तुम्हाला फक्त एपीआय ऍक्सेसद्वारे डेटा वाचायचा असेल, तर ते सक्षम करण्यासाठी पुरेसे आहे view परवानगी
5. तुम्ही प्रवेश करू इच्छित असलेल्या सर्व घटकांसाठी समान प्रक्रिया पुन्हा करा

MQTT द्वारे कनेक्शन

परिचय

माजी म्हणूनample, आम्ही DIVUS KNX IQ च्या MQTT API द्वारे MQTT एक्सप्लोरर नावाच्या तुलनेने सोप्या, विनामूल्य सॉफ्टवेअरसह प्रवेश प्रदर्शित करू (चॅप. 1.1 पहा), जे Windows, Mac आणि Linux साठी उपलब्ध आहे. MQTT सह मूलभूत ज्ञान आणि अनुभव निहित आहे.

कनेक्शनसाठी आवश्यक डेटा

आधी नमूद केल्याप्रमाणे (विभाग २.१ पहा), API वापरकर्त्याचे वापरकर्तानाव आणि पासवर्ड आवश्यक आहे. येथे एक ओव्हर आहेview कनेक्शन स्थापित करण्यापूर्वी गोळा करणे आवश्यक असलेल्या सर्व डेटापैकी:

• वापरकर्तानाव API वापरकर्त्याच्या तपशील पृष्ठावर वाचा
• एपीआय वापरकर्त्याच्या तपशील पृष्ठावर पासवर्ड वाचा
• IP पत्ता सामान्य - नेटवर्क - इथरनेट (किंवा सिंक्रोनायझरद्वारे) अंतर्गत लाँचर सेटिंग्जमध्ये वाचा
• पोर्ट 8884 (हे बंदर यासाठी राखीव आहे)

MQTT एक्सप्लोरर आणि सामान्य सदस्यता सह पहिले कनेक्शन

सामान्यत:, MQTT क्रियाकलाप सदस्यता आणि प्रकाशित दरम्यान फरक करते. जेव्हा प्रथम कनेक्शन केले जाते तेव्हा MQTT एक्सप्लोरर सर्व उपलब्ध विषयांवर (विषय #) आपोआप सदस्यता घेऊन हे सुलभ करते. परिणामी, यशस्वी कनेक्शननंतर सर्व उपलब्ध घटकांकडे नेणारे ट्री (म्हणजे API वापरकर्ता प्रवेश मंजूर) थेट MQTT एक्सप्लोरर विंडोच्या डाव्या बाजूला दिसू शकतो. पुढील सदस्यत्वाचे विषय प्रविष्ट करण्यासाठी किंवा अधिक विशिष्ट विषयासह # पुनर्स्थित करण्यासाठी, कनेक्शन विंडोमध्ये प्रगत वर जा. वरच्या उजवीकडे दर्शविलेले विषय असे काहीतरी दिसते:

जेथे 7f4x0607849x444xxx256573x3x9x983 हे API वापरकर्तानाव आहे आणि ऑब्जेक्ट्स_लिस्टमध्ये सर्व उपलब्ध घटक आहेत. हा विषय नेहमी अद्ययावत ठेवला जातो म्हणजेच कोणतेही मूल्य बदल रिअल-टाइममध्ये दिसून येतात. तुम्हाला फक्त वैयक्तिक घटकांचे सदस्यत्व घ्यायचे असल्यास, ऑब्जेक्ट्स_लिस्ट/ नंतर इच्छित घटकाचा घटक आयडी प्रविष्ट करा.

टीप: या प्रकारची सदस्यता साधारणपणे KNX फीडबॅक पत्त्यांमागील तर्काशी सुसंगत आहे; ते घटकांची सद्यस्थिती दर्शवते आणि इच्छित बदल यशस्वीरित्या लागू झाले आहेत की नाही हे तपासण्यासाठी वापरले जाऊ शकते. तुम्हाला फक्त डेटा वाचायचा असेल पण तो बदलायचा नसेल, तर या प्रकारची सदस्यता पुरेशी आहे.

JSON नोटेशनमध्ये एकच साधा घटक असे काहीतरी दिसतो

टीप: सर्व मूल्यांमध्ये वर दर्शविलेले वाक्यरचना असते उदा. सदस्यत्वाच्या विषयांचे आउटपुट म्हणून { “value”: “1” }, तर मूल्य बदलण्यासाठी थेट पेलोडमध्ये लिहिले जाते (म्हणजे प्रकाशित विषयांसाठी) – कंस आणि "मूल्य" वगळले आहेत उदा. "ऑनऑफ": "1".

प्रगत आदेश

परिचय

सर्वसाधारणपणे 3 प्रकारचे विषय आहेत:

1. उपलब्ध घटक पाहण्यासाठी आणि रिअल-टाइम मूल्य बदल मिळविण्यासाठी विषय(चे) सदस्यत्व घ्या
2. (ची उत्तरे मिळवण्यासाठी विषय(चे) सदस्यत्व घ्याक्लायंट ) विनंत्या प्रकाशित करा
3. घटक मिळवण्यासाठी किंवा त्यांच्या मूल्यांसह सेट करण्यासाठी विषय प्रकाशित करा

आम्ही नंतर येथे दर्शविलेल्या क्रमांकाचा वापर करून या प्रकारांचा संदर्भ घेऊ (उदा. प्रकार 1, 2, 3 चे विषय). पुढील विभागांमध्ये आणि अध्यायात अधिक तपशील. ४.२.

उपलब्ध घटक पाहण्यासाठी आणि रिअल-टाइम मूल्य बदल मिळविण्यासाठी विषयांची सदस्यता घ्या

हे आधीच वर्णन केले आहे

क्लायंटच्या प्रकाशित विनंत्यांची उत्तरे मिळवण्यासाठी विषयांची सदस्यता घ्या

या प्रकारचे विषय ऐच्छिक आहेत. ते करण्याची परवानगी देते

• अनियंत्रित client_id वापरून MQTT सर्व्हरसह एक अद्वितीय संप्रेषण चॅनेल उघडा. त्याबद्दल अधिक अध्यायात. ४.२.२
• संबंधित सबस्क्राइब विषयावर प्रकाशित विनंत्यांचे परिणाम मिळवा: त्रुटी कोड आणि संदेशासह यश किंवा अपयश.

उत्तरे मिळवण्यासाठी किंवा प्रकाशित कमांड सेट करण्यासाठी वेगवेगळे विषय आहेत. मध्ये संबंधित फरक एकदा तुम्हाला तुमच्या सिस्टमसाठी आवश्यक विषय मिळाल्यावर, तुम्ही ही पायरी काढून टाकण्याचा आणि थेट विषय प्रकाशित करण्याचा निर्णय घेऊ शकता.

 मिळवण्यासाठी किंवा त्यांच्या मूल्यांसह घटक सेट करण्यासाठी विषय प्रकाशित करा

हे विषय सदस्यत्व घेण्यासाठी सारखाच मार्ग वापरतात – सदस्यत्व घेण्यासाठी वापरलेल्या "स्थिती" च्या जागी "विनंती" हा एकमेव बदल आहे. संपूर्ण विषय मार्ग नंतर अध्यायात दाखवले आहेत. 4.2.2\ A get विषय MQTT सर्व्हरचे घटक आणि मूल्ये वाचण्याची विनंती करेल. पेलोडचा वापर घटकांच्या फंक्शन प्रकारावर आधारित फिल्टर करण्यासाठी केला जाऊ शकतो. एक सेट विषय घटकाचे काही भाग बदलण्याची विनंती करेल, जसे की त्याच्या पेलोडमध्ये तपशीलवार.

कमांड आणि संबंधित प्रतिसादांसाठी प्रीफिक्स

 लहान स्पष्टीकरण

MQTT सर्व्हरवर पाठवल्या जाणाऱ्या सर्व आज्ञांचा एक सामान्य प्रारंभिक भाग असतो, म्हणजे:

सविस्तर स्पष्टीकरण

रिअल-टाइम विषयांमध्ये (प्रकार 1) सामान्य उपसर्ग असेल (वर पहा) त्यानंतर

or

सेट कमांड्ससाठी, पेलोड स्पष्टपणे मुख्य भूमिका बजावते कारण त्यात इच्छित बदल असतील (म्हणजे घटकाच्या कार्यांसाठी बदललेली मूल्ये). चेतावणी: तुमच्या टाइप 3 कमांडमध्ये रिटेन पर्याय कधीही वापरू नका कारण यामुळे KNX बाजूला समस्या निर्माण होऊ शकतात.

EXAMPले: एकाच घटकाचे मूल्य(मूल्ये) बदलण्यासाठी प्रकाशित

सामान्य सबस्क्राइबद्वारे दर्शविलेल्या घटकांपैकी एकाचे मूल्य बदलण्याची इच्छा असणे ही सर्वात सोपी बाब आहे.
सर्वसाधारणपणे, MQTT द्वारे VISION चे कार्य बदलणे/स्विच करणे यामध्ये 3 पायऱ्या असतात, त्या सर्व आवश्यक नाहीत, परंतु तरीही आम्ही ते वर्णन केल्याप्रमाणे पार पाडण्याची शिफारस करतो.

1. आम्ही संपादित करू इच्छित फंक्शन समाविष्टीत विषय कस्टम client_id वापरून सदस्यत्व घेतले आहे
2. संपादनाचा विषय 1 मध्ये निवडलेल्या client_id वापरून इच्छित बदलांसह पेलोडसह प्रकाशित केला आहे.
3. तपासण्यासाठी, तुम्ही नंतर विषयातील उत्तर पाहू शकता (1.) – म्हणजे (2.) काम केले की नाही.
4. सामान्य सबस्क्राइबमध्ये, जिथे बदल केले जातात तेव्हा सर्व मूल्ये अद्यतनित केली जातात, जर सर्व काही ठीक झाले असेल तर तुम्ही इच्छित मूल्य बदल पाहू शकता.

हे करण्यासाठी पायऱ्या आहेत:

1. क्लायंट_आयडी निवडा उदा. "Divus" आणि ते API वापरकर्तानावानंतरच्या मार्गात घाला
   MQTT सर्व्हरसह तुमच्या स्वतःच्या संप्रेषण चॅनेलची सदस्यता घेण्यासाठी हा संपूर्ण विषय आहे. हे सर्व्हरला सांगते की तुम्ही पाठवू इच्छित असलेल्या बदलांना प्रतिसादांची अपेक्षा कुठे आहे. स्थिती/सेट भागाकडे लक्ष द्या जे अ परिभाषित करते. की तो सदस्यत्वाचा विषय आहे आणि ब. की त्याला टाइप कमांड सेट करण्याची उत्तरे मिळतील.
2. स्टेटस-रिक्वेस्ट कीवर्ड्स बदलल्याशिवाय प्रकाशित विषय समान असेल
3. बदलामध्ये काय असावे ते पेलोडमध्ये लिहिलेले आहे. येथे काही माजी आहेतampलेस
   • ऑन/ऑफ फंक्शन (1 बिट) असलेला घटक बंद करणे:
   • ऑन/ऑफ फंक्शन असलेल्या घटकावर स्विच करणे (1 बिट). याशिवाय, अशा अनेक आज्ञा एकाच क्लायंटकडून सुरू केल्या गेल्या असल्यास, uuid पॅरामीटर (“युनिक आयडी”, साधारणपणे 128-8-4-4-4 अंक हेक्स म्हणून स्वरूपित केलेली 12-बिट स्ट्रिंग असते) नियुक्त करण्यासाठी वापरली जाऊ शकते. संबंधित क्वेरीला प्रतिसाद, कारण हे पॅरामीटर - जर क्वेरीमध्ये असेल तर - प्रतिसादात देखील आढळू शकते.
   • चालू करणे आणि मंदपणाची चमक 50% वर सेट करणे
   • वर दर्शविलेल्या आणि सदस्यत्व घेतलेल्या विषयाचे उत्तर (त्याचे पेलोड, तंतोतंत असणे) नंतर, उदा.ampले
     वरील प्रतिसाद माजी आहेample योग्य पेलोडच्या बाबतीत, जरी घटकाचे कोणतेही मंदीकरण कार्य नाही. पेलोडचा योग्य अर्थ लावला जाणार नाही अशा अधिक गंभीर समस्या असल्यास, प्रतिसाद यासारखा दिसेल (उदा:):
     त्रुटी कोड आणि संदेशांच्या स्पष्टीकरणासाठी परंतु सर्वसाधारणपणे, http प्रमाणे, 200 कोड सकारात्मक उत्तरे आहेत तर 400 नकारात्मक आहेत.

EXAMPLE: बहु घटकांच्या मूल्यांमध्ये बदल करण्यासाठी प्रकाशित करा

ही प्रक्रिया एक घटक बदलण्यासाठी आधी दर्शविल्याप्रमाणेच आहे. फरक हा आहे की तुम्ही विषयांमधून element_id वगळता आणि नंतर पेलोडमधील डेटाच्या समोर element_id चा संच सूचित करता. खालील वाक्यरचना आणि रचना पहा.

प्रश्नांमध्ये फंक्शन प्रकारानुसार फिल्टर करा

पेलोडमधील फिल्टर पॅरामीटर घटकाचे फक्त इच्छित कार्य(चे) संबोधित करण्यास अनुमती देते. स्विच किंवा डिमरच्या ऑन/ऑफ फंक्शनला "ऑनऑफ" असे म्हणतातample, आणि संबंधित फिल्टर अशा प्रकारे परिभाषित केले आहे:

उत्तर नंतर असे दिसते, उदाample

चौरस कंस सूचित करतो की तुम्ही अनेक फंक्शन्सद्वारे फिल्टर देखील करू शकता, उदा

यासारखे उत्तर देते:

परिशिष्ट

त्रुटी कोड

MQTT संप्रेषणातील त्रुटींचा परिणाम संख्यात्मक कोडमध्ये होतो. खालील तक्ता ते तोडण्यास मदत करते.

पेलोडचे पॅरामीटर्स

पेलोड संदर्भानुसार वेगवेगळ्या पॅरामीटर्सना समर्थन देते. खालील सारणी कोणत्या विषयांमध्ये कोणते पॅरामीटर्स येऊ शकतात हे दर्शविते

आवृत्ती नोट्स

• आवृत्ती 1.00

बातम्या:

• पहिले प्रकाशन

कागदपत्रे / संसाधने

	DIVUS VISION API सॉफ्टवेअर [pdf] वापरकर्ता मॅन्युअल VISION API सॉफ्टवेअर, API सॉफ्टवेअर, सॉफ्टवेअर
	DIVUS Vision API सॉफ्टवेअर [pdf] वापरकर्ता मार्गदर्शक व्हिजन एपीआय सॉफ्टवेअर, व्हिजन, एपीआय सॉफ्टवेअर, सॉफ्टवेअर

संदर्भ

• वापरकर्ता मॅन्युअल