DIVUS VISION API સોફ્ટવેર
વિશિષ્ટતાઓ
- ઉત્પાદન: DIVUS VISION API
- ઉત્પાદક: DIVUS GmbH
- સંસ્કરણ: 1.00 REV0 1 – 20240528
- સ્થાન: Pillhof 51, Eppan (BZ), ઇટાલી
ઉત્પાદન માહિતી
DIVUS VISION API એ DIVUS VISION સિસ્ટમ સાથે ઇન્ટરફેસ કરવા માટે રચાયેલ સોફ્ટવેર ટૂલ છે. તે વપરાશકર્તાઓને MQTT પ્રોટોકોલનો ઉપયોગ કરીને સિસ્ટમમાં વિવિધ ઘટકોને ઍક્સેસ અને નિયંત્રિત કરવાની મંજૂરી આપે છે.
FAQ
પ્ર: શું હું પીસી અથવા ઓટોમેશન ટેક્નોલોજીની પૂર્વ જાણકારી વિના DIVUS VISION API નો ઉપયોગ કરી શકું?
A: API ના કાર્યક્ષમ ઉપયોગની ખાતરી કરવા માટે આ ક્ષેત્રોમાં અગાઉના જ્ઞાન ધરાવતા વપરાશકર્તાઓ માટે માર્ગદર્શિકા તૈયાર કરવામાં આવી છે.
સામાન્ય માહિતી
- DIVUS GmbH પિલહોફ 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 પર સ્થિત છે અને આ હેતુ માટે ખાસ ગોઠવેલું છે. જો કે VISION API નો ઉપયોગ પ્રોગ્રામિંગ જ્ઞાન વિના પણ થઈ શકે છે, આ કાર્યક્ષમતા અદ્યતન વપરાશકર્તાઓ માટે યોગ્ય છે.
પૂર્વજરૂરીયાતો
VISION મેન્યુઅલમાં સમજાવ્યા મુજબ, API વપરાશકર્તાએ તેનો ઉપયોગ કરવા માટે સક્ષમ થવા માટે ડિફૉલ્ટ રૂપે સૌપ્રથમ સક્રિય હોવું આવશ્યક છે, API ઍક્સેસ ફક્ત Api વપરાશકર્તાઓ પ્રમાણીકરણ ડેટાનો ઉપયોગ કરીને કાર્ય કરે છે. જ્યાં સુધી વપરાશકર્તાના અધિકારોનો સંબંધ છે, આ કાર્યક્ષમતા માટે સક્રિયકરણ પછી બધા અથવા વ્યક્તિગત ઘટકો પર ગોઠવી શકાય છે. જુઓ પ્રકરણ.0. અલબત્ત, તમારે એક VISION પ્રોજેક્ટની પણ જરૂર છે જેમાં તમે જે તત્વોને બહારથી નિયંત્રિત કરવા માંગો છો તે સંપૂર્ણ રીતે ગોઠવેલા હોય અને તેમની સાથેના જોડાણનું સફળતાપૂર્વક પરીક્ષણ કરવામાં આવ્યું હોય. API દ્વારા વ્યક્તિગત ઘટકોને સંબોધવામાં સક્ષમ થવા માટે, તેમનું તત્વ ID જાણવું આવશ્યક છે: આ તત્વના સેટિંગ્સ ફોર્મના તળિયે પ્રદર્શિત થાય છે
સુરક્ષા
સુરક્ષા કારણોસર, API ઍક્સેસ ફક્ત સ્થાનિક રીતે જ શક્ય છે (એટલે કે ક્લાઉડ દ્વારા નહીં). API ઍક્સેસ સક્રિય કરતી વખતે સુરક્ષા જોખમ તેથી ઓછું છે. તેમ છતાં, સુરક્ષા-સંબંધિત તત્વો સક્ષમ ન હોવા જોઈએ અથવા API ઍક્સેસ માટે સ્પષ્ટપણે નકારવા જોઈએ.
MQTT અને તેની શરતો - સંક્ષિપ્ત સમજૂતી
MQTT માં, તમામ સંદેશાઓના કેન્દ્રિય સંચાલન અને વિતરણની ભૂમિકા બ્રોકરની છે. જો કે MQTT સર્વર અને MQTT બ્રોકર સમાનાર્થી નથી (સર્વર એ ભૂમિકા માટે એક વ્યાપક શબ્દ છે જે MQTT ક્લાયન્ટ પણ ભજવી શકે છે), જ્યારે MQTT સર્વરનો ઉલ્લેખ કરવામાં આવે ત્યારે બ્રોકર હંમેશા આ માર્ગદર્શિકામાં હોય છે. આ મેન્યુઅલના સંદર્ભમાં DIVUS KNX IQ પોતે MQTT બ્રોકર/MQTT સર્વરની ભૂમિકા ભજવે છે.
MQTT સર્વર કહેવાતા વિષયોનો ઉપયોગ કરે છે: એક અધિક્રમિક માળખું જેની સાથે ડેટાને વર્ગીકૃત, સંચાલિત અને પ્રકાશિત કરવામાં આવે છે.
પ્રકાશનનો પ્રાથમિક ધ્યેય વિષયો દ્વારા અન્ય સહભાગીઓને ડેટા ઉપલબ્ધ કરાવવાનો છે. જો તમે મૂલ્ય બદલવા માંગતા હો, તો તમે પ્રકાશન ક્રિયાનો ઉપયોગ કરીને, ઇચ્છિત મૂલ્યમાં ફેરફાર સાથે ઇચ્છિત વિષય પર લખો છો. લક્ષ્ય ઉપકરણ અથવા MQTT સર્વર ઇચ્છિત ફેરફારને વાંચે છે જે તેને અસર કરે છે અને તે મુજબ તેને અપનાવે છે. ફેરફાર લાગુ થયો છે કે નહીં તે તપાસવા માટે, તમે સબ્સ્ક્રાઇબ કરેલ રીઅલ-ટાઇમ વિષયમાં જોઈ શકો છો કે ફેરફાર ત્યાં પ્રતિબિંબિત થાય છે કે કેમ - જો બધું બરાબર થઈ ગયું છે.
ક્લાયન્ટ તેમને રુચિ ધરાવતા વિષયો પસંદ કરે છે: આને સબ્સ્ક્રાઇબિંગ કહેવામાં આવે છે. દર વખતે જ્યારે કોઈ વિષયમાં/નીચે મૂલ્ય બદલાય છે, ત્યારે બધા સબ્સ્ક્રાઇબ કરેલા ગ્રાહકોને જાણ કરવામાં આવે છે - એટલે કે કંઈક બદલાયું છે કે શું વર્તમાન મૂલ્ય શું છે તે સ્પષ્ટપણે પૂછ્યા વિના.
તમે વિષયમાં client_id નામની કોઈપણ અનન્ય સ્ટ્રિંગ દાખલ કરીને MQTT સર્વર સાથે એક અલગ સંચાર ચેનલ (અથવા સરનામું) ખોલી શકો છો. મૂલ્યોની પ્રક્રિયા કરવા માટે વિષયમાં client_id નો ઉપયોગ કરવો આવશ્યક છે. આ દરેક ફેરફારના મૂળને ઓળખવામાં મદદ કરે છે, કોઈપણ ભૂલમાં મદદ કરે છે અને અન્ય ક્લાયંટને અસર કરતું નથી, કારણ કે સર્વર તરફથી અનુરૂપ પ્રતિસાદો, કોઈપણ ભૂલ કોડ્સ અને સંદેશાઓ સહિત, પણ તે જ client_id સાથે વિષય સુધી પહોંચે છે (અને તેથી જ તે ગ્રાહક). client_id એ 0-9, az, AZ, “-“, “_” અક્ષરોના કોઈપણ સંયોજનનો સમાવેશ કરતી અનન્ય અક્ષર સ્ટ્રિંગ છે.
સામાન્ય રીતે, DIVUS KNX IQ ના MQTT સર્વરના સબ્સ્ક્રાઇબ વિષયોમાં કીવર્ડ સ્થિતિ હોય છે, જ્યારે પ્રકાશિત વિષયોમાં કીવર્ડ વિનંતી હોય છે. બાહ્ય મૂલ્યમાં ફેરફાર થતાંની સાથે જ અથવા ક્લાયન્ટ દ્વારા જ પ્રકાશન દ્વારા મૂલ્યમાં ફેરફારની વિનંતી કરવામાં આવે અને સફળતાપૂર્વક લાગુ કરવામાં આવે કે તરત જ સ્ટેટસ ધરાવનારને આપમેળે અપડેટ કરવામાં આવે છે. જે પ્રકાશન માટે છે તેને આગળ પ્રકાર (વિનંતી/)ગેટ અને પ્રકાર (વિનંતી/)સેટમાં વિભાજિત કરવામાં આવે છે.
મૂલ્ય ફેરફારો અને અન્ય વૈકલ્પિક પરિમાણો કહેવાતા પેલોડ સાથે વિષયમાં ઉમેરવામાં આવે છે. વ્યક્તિગત ઘટકોના પરિમાણો (તત્વ-આઈડી, નામ, પ્રકાર, કાર્યો)
MQTT અને ક્લાસિક ક્લાયંટ-સર્વર મોડલ વચ્ચેનો મુખ્ય તફાવત, જ્યાં ક્લાયંટ વિનંતી કરે છે અને પછી ડેટા બદલે છે, તે સબ્સ્ક્રાઇબ અને પબ્લિશના ખ્યાલો પર કેન્દ્રિત છે. સહભાગીઓ ડેટા પ્રકાશિત કરી શકે છે, તેને અન્ય લોકો માટે ઉપલબ્ધ કરાવી શકે છે, જેમને રસ હોય તો તેમાં સબ્સ્ક્રાઇબ કરી શકે છે. આ આર્કિટેક્ચર ડેટા એક્સચેન્જને ઓછું કરવાનું શક્ય બનાવે છે અને હજુ પણ તમામ રસ ધરાવતા પક્ષોને અદ્યતન રાખે છે. અહીં વિગતો વિશે વધુ: અને વિશેષ પરિમાણો (uuid, ફિલ્ટર્સ) અહીં ઉપયોગમાં લેવાના છે. ઘણા વિકલ્પો હોવા છતાં, પેલોડ આ માર્ગદર્શિકામાં JSON તરીકે ફોર્મેટ કરેલ બતાવવામાં આવે છે. JSON કોઈપણ માળખાના ડેટાને રજૂ કરવા માટે કૌંસ અને અલ્પવિરામનો ઉપયોગ કરે છે અને આ રીતે ટ્રાન્સમિટ થવા માટે ડેટા પેકેટના કદને ઘટાડે છે. પેલોડ્સ વિશે વધુ વિગતો પછીથી મેન્યુઅલમાં મળી શકે છે.
ખાસ હેતુઓ માટે, ફંક્શનના પ્રકાર અનુસાર ફિલ્ટર કરવું શક્ય છે, દા.ત. ફક્ત ચાલુ/બંધ એટલે કે 1-બીટ સ્વીચોને સંબોધવા માટે. પેલોડમાં ફિલ્ટર્સ પેરામીટર આ હેતુ માટે વપરાય છે. ફિલ્ટરિંગ હાલમાં ફંક્શન પ્રકાર દ્વારા જ શક્ય છે.
વ્યક્તિગત ઘટકોને સંબોધવામાં સક્ષમ થવા માટે, તેમના ઘટક ID જરૂરી છે. આ એલિમેન્ટ પ્રોપર્ટીઝ મેનૂમાં VISION માં મળી શકે છે અથવા MQTT એક્સપ્લોરરના સામાન્ય સબ્સ્ક્રાઇબમાં દરેક ઉપલબ્ધ ઘટકની સામે પ્રદર્શિત થતા ડેટામાંથી સીધું પણ વાંચી શકાય છે (ત્યાં તત્વો એલિમેન્ટ ID દ્વારા મૂળાક્ષરોમાં સૂચિબદ્ધ છે).
API ઍક્સેસ માટે રૂપરેખાંકન
API વપરાશકર્તા ઍક્સેસ માટે વિઝનને ગોઠવી રહ્યું છે
એડમિનિસ્ટ્રેટર તરીકે VISION માં, Configuration – User/API એક્સેસ મેનેજમેન્ટ પર જાઓ, Users/API એક્સેસ પર ક્લિક કરો અને એડિટિંગ વિન્ડો ખોલવા માટે API યુઝર (અથવા દબાવી રાખો) પર જમણું-ક્લિક કરો. ત્યાં તમને આ પરિમાણો અને ડેટા મળશે
- સક્ષમ કરો (ચેકબોક્સ)
- વપરાશકર્તા પ્રથમ અહીં સક્ષમ છે. ડિફૉલ્ટ અક્ષમ છે
- વપરાશકર્તા નામ
- આ સ્ટ્રિંગ API દ્વારા ઍક્સેસ કરવા માટે જરૂરી છે - તેને અહીંથી કૉપિ કરો
- પાસવર્ડ
- આ સ્ટ્રિંગ API દ્વારા ઍક્સેસ કરવા માટે જરૂરી છે - તેને અહીંથી કૉપિ કરો
- પરવાનગીઓ
- VISION તત્વોના મૂલ્યો વાંચવા અને લખવા માટેના મૂળભૂત અધિકારો અહીં વ્યાખ્યાયિત કરી શકાય છે, એટલે કે અહીં જે વ્યાખ્યાયિત કરવામાં આવી છે તે તમામ વર્તમાન અને ભાવિ ઘટકોને લાગુ પડે છે. જો તમે ફક્ત વ્યક્તિગત ઘટકોને ઍક્સેસ કરવાની મંજૂરી આપવા માંગતા હો, તો તમારે આ ડિફૉલ્ટ અધિકારોને બદલવું જોઈએ નહીં
વ્યક્તિગત તત્વો પર પરવાનગીઓ
એવી ભલામણ કરવામાં આવે છે કે તમે સમગ્ર પ્રોજેક્ટ માટે API ઍક્સેસ ન આપો, પરંતુ માત્ર ઇચ્છિત ઘટકોને જ આપો. નીચે પ્રમાણે આગળ વધો
- VISION માં એડમિનિસ્ટ્રેટર તરીકે લોગ ઇન કરો
- ઇચ્છિત તત્વ પસંદ કરો અને તેનું સેટિંગ્સ મેનૂ ખોલો (જમણું-ક્લિક કરો અથવા દબાવી રાખો, પછી સેટિંગ્સ)
- મેનુ એન્ટ્રી જનરલ – પરવાનગીઓ હેઠળ, "ઓવરરાઇડ ડિફોલ્ટ પરવાનગીઓ" સક્રિય કરો અને પછી સબ-આઇટમ પરવાનગીઓ પર જાઓ, જે પરવાનગી મેટ્રિક્સ બતાવે છે.
- અહીં નિયંત્રણ પરવાનગી સક્રિય કરો, જે સક્ષમ કરે છે view સીધી પરવાનગી. જો તમે ફક્ત API ઍક્સેસ દ્વારા ડેટા વાંચવા માંગતા હો, તો તે સક્ષમ કરવા માટે પૂરતું છે view પરવાનગી
- તમે ઍક્સેસ કરવા માંગો છો તે તમામ ઘટકો માટે સમાન પ્રક્રિયાને પુનરાવર્તિત કરો
MQTT દ્વારા કનેક્શન
પરિચય
ભૂતપૂર્વ તરીકેample, અમે DIVUS KNX IQ ના MQTT API દ્વારા MQTT એક્સપ્લોરર (જુઓ પ્રકરણ 1.1) નામના પ્રમાણમાં સરળ, મફત સોફ્ટવેર સાથે એક્સેસ દર્શાવીશું, જે Windows, Mac અને Linux માટે ઉપલબ્ધ છે. MQTT સાથે મૂળભૂત જ્ઞાન અને અનુભવ ગર્ભિત છે.
કનેક્શન માટે જરૂરી ડેટા
અગાઉ ઉલ્લેખ કર્યા મુજબ (વિભાગ 2.1 જુઓ), API વપરાશકર્તાનું વપરાશકર્તા નામ અને પાસવર્ડ જરૂરી છે. અહીં એક ઓવર છેview કનેક્શન સ્થાપિત થાય તે પહેલાં એકત્રિત થવો જોઈએ તે તમામ ડેટામાંથી:
- વપરાશકર્તા નામ API વપરાશકર્તાના વિગતવાર પૃષ્ઠ પર વાંચો
- API વપરાશકર્તાના વિગતવાર પૃષ્ઠ પર પાસવર્ડ વાંચો
- IP એડ્રેસ જનરલ - નેટવર્ક - ઇથરનેટ (અથવા સિંક્રોનાઇઝર દ્વારા) હેઠળ લોન્ચર સેટિંગ્સમાં વાંચો
- પોર્ટ 8884 (આ પોર્ટ આ હેતુ માટે આરક્ષિત છે)
MQTT એક્સપ્લોરર અને સામાન્ય સબ્સ્ક્રાઇબ સાથે પ્રથમ જોડાણ
સામાન્ય રીતે, MQTT સબ્સ્ક્રાઇબ અને પ્રકાશિત પ્રવૃત્તિઓ વચ્ચે તફાવત કરે છે. જ્યારે પ્રથમ કનેક્શન કરવામાં આવે ત્યારે MQTT એક્સપ્લોરર બધા ઉપલબ્ધ વિષયો (વિષય #) પર આપમેળે સબ્સ્ક્રાઇબ કરીને આને સરળ બનાવે છે. પરિણામે, વૃક્ષ કે જે તમામ ઉપલબ્ધ તત્વો તરફ દોરી જાય છે (એટલે કે API વપરાશકર્તા ઍક્સેસ મંજૂર) સફળ જોડાણ પછી MQTT એક્સપ્લોરર વિન્ડોની ડાબી બાજુના વિસ્તારમાં સીધા જ જોઈ શકાય છે. વધુ સબ્સ્ક્રાઇબ વિષયો દાખલ કરવા અથવા # ને વધુ ચોક્કસ વિષય સાથે બદલવા માટે, કનેક્શન વિંડોમાં એડવાન્સ્ડ પર જાઓ. ઉપર જમણી બાજુએ દર્શાવેલ વિષય આના જેવો દેખાય છે:
જ્યાં 7f4x0607849x444xxx256573x3x9x983 એ API વપરાશકર્તાનામ છે અને ઑબ્જેક્ટ્સ_લિસ્ટમાં ઉપલબ્ધ તમામ ઘટકોનો સમાવેશ થાય છે. આ વિષય હંમેશા અદ્યતન રાખવામાં આવે છે એટલે કે કોઈપણ મૂલ્યના ફેરફારો ત્યાં રીઅલ-ટાઇમમાં પ્રતિબિંબિત થાય છે. જો તમે ફક્ત વ્યક્તિગત ઘટકો પર સબ્સ્ક્રાઇબ કરવા માંગતા હો, તો ઑબ્જેક્ટ્સ_લિસ્ટ/ પછી ઇચ્છિત ઘટકનું એલિમેન્ટ ID દાખલ કરો.
નોંધ: આ પ્રકારનું સબ્સ્ક્રાઇબ લગભગ KNX પ્રતિસાદ સરનામાં પાછળના તર્કને અનુરૂપ છે; તે તત્વોની વર્તમાન સ્થિતિ દર્શાવે છે અને ઇચ્છિત ફેરફારો સફળતાપૂર્વક લાગુ થયા છે કે કેમ તે ચકાસવા માટે તેનો ઉપયોગ થઈ શકે છે. જો તમે માત્ર ડેટા વાંચવા માંગતા હો પરંતુ તેને બદલવા માંગતા નથી, તો આ પ્રકારનું સબ્સ્ક્રાઇબ પૂરતું છે.
JSON નોટેશનમાં એક સરળ તત્વ કંઈક આના જેવું દેખાય છે
નોંધ: બધા મૂલ્યોમાં ઉપર દર્શાવેલ વાક્યરચના હોય છે દા.ત. { “મૂલ્ય”: “1” } સબ્સ્ક્રાઇબ વિષયોના આઉટપુટ તરીકે, જ્યારે મૂલ્ય (એટલે કે પ્રકાશિત વિષયો માટે) - કૌંસ અને "મૂલ્ય" અવગણવામાં આવે છે દા.ત. "ઓનઓફ": "1".
અદ્યતન આદેશો
પરિચય
સામાન્ય રીતે 3 પ્રકારના વિષયો છે:
- ઉપલબ્ધ ઘટકો જોવા અને વાસ્તવિક સમયના મૂલ્યમાં ફેરફાર મેળવવા માટે વિષય(ઓ)ને સબ્સ્ક્રાઇબ કરો
- (ના જવાબો મેળવવા માટે વિષય(ઓ)ને સબ્સ્ક્રાઇબ કરોગ્રાહકો ) વિનંતીઓ પ્રકાશિત કરો
- તત્વો મેળવવા અથવા તેમના મૂલ્યો સાથે સેટ કરવા વિષય(ઓ) પ્રકાશિત કરો
અમે પછીથી અહીં બતાવેલ નંબરિંગનો ઉપયોગ કરીને આ પ્રકારોનો સંદર્ભ લઈશું (દા.ત. પ્રકાર 1, 2, 3 ના વિષયો). વધુ વિગતો નીચેના વિભાગોમાં અને પ્રકરણમાં. 4.2.
ઉપલબ્ધ તત્વો જોવા અને વાસ્તવિક સમયના મૂલ્ય ફેરફારો મેળવવા માટે વિષયોને સબ્સ્ક્રાઇબ કરો
આનું વર્ણન પહેલાથી જ કરવામાં આવ્યું છે
ક્લાયન્ટની પ્રકાશિત વિનંતીઓના જવાબો મેળવવા માટે વિષયોને સબ્સ્ક્રાઇબ કરો
આ પ્રકારના વિષયો વૈકલ્પિક છે. તે પરવાનગી આપે છે
- મનસ્વી client_id નો ઉપયોગ કરીને MQTT સર્વર સાથે અનન્ય સંચાર ચેનલ ખોલો. પ્રકરણમાં તે વિશે વધુ. 4.2.2
- અનુરૂપ સબ્સ્ક્રાઇબ વિષય પર પ્રકાશિત વિનંતીઓનું પરિણામ મેળવો: ભૂલ કોડ અને સંદેશ સાથે સફળતા અથવા નિષ્ફળતા.
જવાબો મેળવવા અથવા પ્રકાશિત આદેશો સેટ કરવા માટે વિવિધ વિષયો છે. માં અનુરૂપ તફાવત
એકવાર તમે તમારી સિસ્ટમ માટે જરૂરી વિષયો મેળવી લો, પછી તમે આ પગલું દૂર કરવાનું નક્કી કરી શકો છો અને પ્રકાશિત વિષયોનો સીધો ઉપયોગ કરી શકો છો.
તેમના મૂલ્યો સાથે તત્વો મેળવવા અથવા સેટ કરવા વિષયો પ્રકાશિત કરો
આ વિષયો સબ્સ્ક્રાઇબ કરવા જેવા જ પાથનો ઉપયોગ કરે છે - સબ્સ્ક્રાઇબ કરવા માટે ઉપયોગમાં લેવાતા "સ્થિતિ" ની જગ્યાએ માત્ર ફેરફાર એ "વિનંતી" શબ્દ છે. સંપૂર્ણ વિષયના માર્ગો પછીથી પ્રકરણમાં બતાવવામાં આવ્યા છે. 4.2.2\ A get ટોપિક MQTT સર્વરના તત્વો અને મૂલ્યો વાંચવાની વિનંતી કરશે. પેલોડનો ઉપયોગ તત્વોના કાર્ય પ્રકાર પર આધારિત ફિલ્ટર કરવા માટે થઈ શકે છે. એક સેટ વિષય તેના પેલોડમાં વિગતવાર દર્શાવ્યા મુજબ, ઘટકના કેટલાક ભાગોને બદલવાની વિનંતી કરશે.
આદેશો અને અનુરૂપ પ્રતિભાવો માટે પ્રીફિક્સ
ટૂંકું સમજૂતી
MQTT સર્વર પર મોકલવામાં આવતા તમામ આદેશોમાં સામાન્ય પ્રારંભિક ભાગ હોય છે, એટલે કે:
વિગતવાર સમજૂતી
રીઅલ-ટાઇમ વિષયો (પ્રકાર 1) માં સામાન્ય ઉપસર્ગ હશે (ઉપર જુઓ) ત્યારબાદ
or
સેટ આદેશો માટે, પેલોડ દેખીતી રીતે મુખ્ય ભૂમિકા ભજવે છે કારણ કે તેમાં ઇચ્છિત ફેરફારો (એટલે કે તત્વના કાર્યો માટે બદલાયેલ મૂલ્યો) હશે. ચેતવણી: તમારા ટાઈપ 3 કમાન્ડમાં ક્યારેય રીટેઈન વિકલ્પનો ઉપયોગ કરશો નહીં કારણ કે તે KNX બાજુ પર સમસ્યાઓનું કારણ બની શકે છે.
EXAMPLE: એક તત્વના મૂલ્ય(S) ને બદલવા માટે પ્રકાશિત કરો
સામાન્ય સબ્સ્ક્રાઇબ દ્વારા દર્શાવેલ ઘટકોમાંથી એકનું મૂલ્ય બદલવાની ઇચ્છા રાખવાનો સૌથી સરળ કેસ છે.
સામાન્ય રીતે કહીએ તો, MQTT દ્વારા VISION ના ફંક્શનને બદલવા/સ્વિચ કરવામાં 3 સ્ટેપ્સનો સમાવેશ થાય છે, જેમાંથી તમામ બિલકુલ જરૂરી નથી, પરંતુ તેમ છતાં અમે તેમને વર્ણવ્યા મુજબ અમલમાં મૂકવાની ભલામણ કરીએ છીએ.
- વિષય કે જેમાં આપણે ફેરફાર કરવા માંગીએ છીએ તે ફંક્શન ધરાવે છે તે કસ્ટમ client_id નો ઉપયોગ કરીને સબ્સ્ક્રાઇબ થયેલ છે
- સંપાદન માટેનો વિષય 1 માં પસંદ કરેલ client_id નો ઉપયોગ કરીને ઇચ્છિત ફેરફારો સાથે પેલોડ સાથે પ્રકાશિત થાય છે.
- તપાસવા માટે, પછી તમે વિષયમાં જવાબ જોઈ શકો છો (1.) - એટલે કે (2.) કામ કર્યું કે નહીં
- સામાન્ય સબ્સ્ક્રાઇબમાં, જ્યાં ફેરફારો કરવામાં આવે ત્યારે તમામ મૂલ્યો અપડેટ થાય છે, જો બધું બરાબર થઈ ગયું હોય તો તમે ઇચ્છિત મૂલ્યમાં ફેરફાર(ઓ) જોઈ શકો છો.
આ કરવા માટેના પગલાં આ પ્રમાણે છે:
- ક્લાઈન્ટ_આઈડી પસંદ કરો દા.ત. “Divus” અને તેને API વપરાશકર્તાનામ પછી પાથમાં દાખલ કરો
MQTT સર્વર સાથે તમારી પોતાની સંચાર ચેનલ પર સબ્સ્ક્રાઇબ કરવા માટેનો આ સંપૂર્ણ વિષય છે. આ સર્વરને જણાવે છે કે તમે જે ફેરફારો મોકલવા માગો છો તેના પ્રતિસાદોની તમે અપેક્ષા રાખો છો. સ્ટેટસ/સેટ ભાગ પર ધ્યાન આપો જે a વ્યાખ્યાયિત કરે છે. કે તે સબ્સ્ક્રાઇબ વિષય છે અને બી. કે તેને સેટ ટાઇપ કમાન્ડના જવાબો મળશે. - સ્ટેટસ-રિક્વેસ્ટ કીવર્ડ્સને સ્વિચ કરવા સિવાય પ્રકાશિત વિષય સમાન હશે
- ફેરફારમાં શું હોવું જોઈએ તે પેલોડમાં લખેલું છે. અહીં કેટલાક ભૂતપૂર્વ છેampલેસ
- ઓન/ઓફ ફંક્શન (1 બીટ):
- ઓન/ઓફ ફંક્શન (1 બીટ) ધરાવતું એલિમેન્ટ ઓન કરવું. વધુમાં, જો આવા ઘણા આદેશો એક જ ક્લાયન્ટથી શરૂ કરવામાં આવે તો, uuid પેરામીટર ("યુનિક ID", સામાન્ય રીતે 128-બીટ સ્ટ્રિંગ છે જે 8-4-4-4-12 અંક હેક્સ તરીકે ફોર્મેટ કરવામાં આવે છે) નો ઉપયોગ અસાઇન કરવા માટે કરી શકાય છે. અનુરૂપ ક્વેરીનો પ્રતિભાવ, કારણ કે આ પરિમાણ – જો ક્વેરી માં હાજર હોય તો – પણ પ્રતિભાવમાં મળી શકે છે.
- સ્વિચ કરવું અને ડિમરની તેજને 50% પર સેટ કરવી
- ઉપર દર્શાવેલ અને સબ્સ્ક્રાઇબ કરેલ વિષયનો જવાબ (તેનું પેલોડ, ચોક્કસ હોવા માટે) છે, તો ભૂતપૂર્વ માટેample
ઉપરોક્ત પ્રતિભાવ ભૂતપૂર્વ છેampયોગ્ય પેલોડના કિસ્સામાં le, જો કે તત્વમાં કોઈ ડિમિંગ ફંક્શન નથી. જો પેલોડને યોગ્ય રીતે અર્થઘટન ન કરવા માટે વધુ ગંભીર સમસ્યાઓ હોય, તો પ્રતિભાવ આના જેવો દેખાશે (દા.ત.):
ભૂલ કોડ્સ અને સંદેશાઓની સમજૂતી માટે પરંતુ સામાન્ય રીતે, જેમ કે http માટે, 200 કોડ હકારાત્મક જવાબો છે જ્યારે 400 નકારાત્મક છે.
- ઓન/ઓફ ફંક્શન (1 બીટ):
EXAMPLE: બહુવિધ તત્વોના મૂલ્યોને બદલવા માટે પ્રકાશિત કરો
પ્રક્રિયા એક તત્વ બદલવા માટે પહેલાં બતાવેલ એક જેવી જ છે. તફાવત એ છે કે તમે વિષયોમાંથી element_id ને છોડી દો અને પછી પેલોડની અંદરના ડેટાની સામે element_ids ના સેટને સૂચવો. નીચે વાક્યરચના અને માળખું જુઓ.
ક્વેરીઝમાં ફંક્શન પ્રકાર દ્વારા ફિલ્ટર કરો
પેલોડમાં ફિલ્ટર્સ પરિમાણ એલિમેન્ટના ફક્ત ઇચ્છિત કાર્ય(ઓ) ને સંબોધિત કરવાની મંજૂરી આપે છે. સ્વીચ અથવા ડિમરના ચાલુ/બંધ કાર્યને "ઓનઓફ" કહેવામાં આવે છે, ઉદાહરણ તરીકેample, અને અનુરૂપ ફિલ્ટર આ રીતે વ્યાખ્યાયિત થયેલ છે:
જવાબ પછી આના જેવો દેખાય છે, ભૂતપૂર્વ માટેample
ચોરસ કૌંસ સૂચવે છે કે તમે કેટલાક કાર્યો દ્વારા પણ ફિલ્ટર કરી શકો છો, દા.ત
આના જેવા જવાબ તરફ દોરી જાય છે:
પરિશિષ્ટ
ભૂલ કોડ્સ
MQTT સંચારમાં ભૂલો સંખ્યાત્મક કોડમાં પરિણમે છે. નીચેનું કોષ્ટક તેને તોડવામાં મદદ કરે છે.
પેલોડના પરિમાણો
પેલોડ સંદર્ભના આધારે વિવિધ પરિમાણોને સપોર્ટ કરે છે. નીચેના કોષ્ટક બતાવે છે કે કયા વિષયોમાં કયા પરિમાણો આવી શકે છે
સંસ્કરણ નોંધો
- સંસ્કરણ 1.00
સમાચાર:
• પ્રથમ પ્રકાશન
દસ્તાવેજો / સંસાધનો
 |
DIVUS VISION API સોફ્ટવેર [પીડીએફ] વપરાશકર્તા માર્ગદર્શિકા VISION API સૉફ્ટવેર, API સૉફ્ટવેર, સૉફ્ટવેર |
 |
DIVUS વિઝન API સોફ્ટવેર [પીડીએફ] વપરાશકર્તા માર્ગદર્શિકા વિઝન API સૉફ્ટવેર, વિઝન, API સૉફ્ટવેર, સૉફ્ટવેર |