DIVUS VISION API ሶፍትዌር

ዝርዝሮች

• ምርት፡ DIVUS VISION API
• አምራች፡ DIVUS GmbH
• ስሪት: 1.00 REV0 1 - 20240528
• ቦታ: Pillhof 51, Eppan (BZ), ጣሊያን

የምርት መረጃ

DIVUS VISION ኤፒአይ ከDIVUS VISION ስርዓቶች ጋር ለመገናኘት የተነደፈ የሶፍትዌር መሳሪያ ነው። ተጠቃሚዎች የMQTT ፕሮቶኮሎችን በመጠቀም በስርዓቱ ውስጥ ያሉትን የተለያዩ ንጥረ ነገሮች እንዲደርሱባቸው እና እንዲቆጣጠሩ ያስችላቸዋል።

የሚጠየቁ ጥያቄዎች

ጥ፡- የፒሲ ወይም አውቶሜሽን ቴክኖሎጂን ሳላውቅ DIVUS VISION API መጠቀም እችላለሁ?

መ፡ መመሪያው የኤፒአይን ቀልጣፋ አጠቃቀም ለማረጋገጥ በእነዚህ አካባቢዎች ቀድሞ እውቀት ላላቸው ተጠቃሚዎች የተዘጋጀ ነው።

አጠቃላይ መረጃ

• DIVUS GmbH Pillhof 51 I-39057 Eppan (BZ) - ጣሊያን

የአሰራር መመሪያዎች፣ መመሪያዎች እና ሶፍትዌሮች በቅጂ መብት የተጠበቁ ናቸው። መብቱ በህግ የተጠበቀ ነው። ሙሉ በሙሉ ወይም በከፊል መገልበጥ, ማባዛት, መተርጎም, መተርጎም አይፈቀድም. ለየት ያለ ሁኔታ ለግል ጥቅም የሚውል የሶፍትዌር ቅጂ ቅጂ መፍጠርን ይመለከታል።
መመሪያው ያለማሳወቂያ ሊለወጥ ይችላል. በዚህ ሰነድ እና በቀረበው የማከማቻ ማህደረ መረጃ ላይ ያለው መረጃ ከስህተቶች የጸዳ እና ትክክለኛ ስለመሆኑ ዋስትና አንሰጥም። የማሻሻያ ጥቆማዎች እና ስህተቶች ላይ ፍንጮች ሁል ጊዜ በደስታ ይቀበላሉ። ስምምነቶቹ በዚህ መመሪያ ውስጥ ለተካተቱት ተጨማሪዎችም ተፈጻሚ ይሆናሉ። በዚህ ሰነድ ውስጥ ያሉት ስያሜዎች በሶስተኛ ወገኖች ለራሳቸው ዓላማ የሚጠቀሙባቸው የንግድ ምልክቶች ሊሆኑ ይችላሉ የባለቤቶቻቸውን መብቶች ሊጥሱ ይችላሉ. የተጠቃሚ መመሪያዎች፡ እባክዎን ይህንን መመሪያ ለመጀመሪያ ጊዜ ከመጠቀምዎ በፊት ያንብቡት እና ለወደፊት ማጣቀሻ ደህንነቱ በተጠበቀ ቦታ ያስቀምጡት። የዒላማ ቡድን፡ መመሪያው የተጻፈው ቀደም ሲል ስለ ፒሲ እና አውቶሜሽን ቴክኖሎጂ እውቀት ላላቸው ተጠቃሚዎች ነው።

የዝግጅት አቀራረብ ስምምነቶች

መግቢያ

አጠቃላይ መግቢያ

ይህ ማኑዋል VISION API (Application Programming Interface) - ከውጫዊ ስርዓቶች VISION የሚስተናገድበት እና የሚቆጣጠርበት በይነገጽ ይገልፃል።
በተግባራዊ ሁኔታ, ይህ ማለት እንደ ስርዓቶችን መጠቀም ይችላሉ

• MQTT አሳሽ (https://www.microsoft.com/store/… ለሙከራ)
• የቤት ረዳት (https://www.home-assistant.io/) ወይም
• መስቀለኛ መንገድ-RED (https://nodered.org/)

በ VISION የሚተዳደሩትን አካላት ለመቆጣጠር ወይም ሁኔታቸውን ለማንበብ። ተደራሽነት እና ግንኙነት የሚከናወኑት በMQTT ፕሮቶኮል ነው፣ እሱም ርዕሶች የሚባሉትን የግለሰባዊ ተግባራትን ወይም የተግባር ስብስቦችን ለመፍታት ወይም በእነሱ ላይ ስለሚደረጉ ለውጦች ለማሳወቅ ነው። ለዚህ ዓላማ የ MQTT አገልጋይ (ደላላ) ጥቅም ላይ ይውላል, እሱም ደህንነትን እና ለተሳታፊዎች የመልዕክት አስተዳደር / ስርጭትን ይቆጣጠራል. በዚህ አጋጣሚ የMQTT አገልጋይ በቀጥታ በ DIVUS KNX IQ ላይ የሚገኝ ሲሆን በተለይ ለዚሁ ዓላማ የተዋቀረ ነው። ምንም እንኳን VISION ኤፒአይ ያለፕሮግራም እውቀት መጠቀም ቢቻልም ይህ ተግባር ለላቁ ተጠቃሚዎች ተስማሚ ነው።

ቅድመ ሁኔታዎች

በ VISION መመሪያ ላይ እንደተብራራው የኤፒአይ ተጠቃሚ እሱን ለመጠቀም በመጀመሪያ በነባሪነት መንቃት አለበት የኤፒአይ መዳረሻ የሚሰራው የኤፒአይ ተጠቃሚዎች የማረጋገጫ ውሂብን በመጠቀም ብቻ ነው። የተጠቃሚ መብቶችን በተመለከተ፣ የዚህ ተግባር ማግበር በሁሉም ወይም በግለሰብ አካላት ላይ ሊዋቀር ይችላል። ምዕራፍ 0 ተመልከት። እርግጥ ነው፣ ከውጭ ሆነው ሊቆጣጠሩዋቸው የሚፈልጓቸው ንጥረ ነገሮች ሙሉ በሙሉ የተዋቀሩበት እና ከእነሱ ጋር ያለው ግንኙነት በተሳካ ሁኔታ የተሞከረበት VISION ፕሮጀክት ያስፈልግዎታል። ነጠላ ኤለመንቶችን በኤፒአይ በኩል ማነጋገር እንዲችሉ የእነርሱ አባል መታወቂያ መታወቅ አለበት፡ ይህ በኤለመንት ቅንጅቶች ቅጽ ግርጌ ላይ ይታያል

ደህንነት

ለደህንነት ሲባል የኤፒአይ መዳረሻ የሚቻለው በአካባቢው ብቻ ነው (ማለትም በደመና በኩል አይደለም)። የኤፒአይ መዳረሻን ሲያነቃ ያለው የደህንነት ስጋት ዝቅተኛ ነው። ቢሆንም፣ ከደህንነት ጋር የተያያዙ አካላት ለኤፒአይ መዳረሻ መንቃት ወይም በግልፅ መከልከል የለባቸውም።

MQTT እና ውሎቹ - አጭር ማብራሪያ

• በMQTT ውስጥ የሁሉም መልዕክቶች የተማከለ አስተዳደር እና ስርጭት ሚና የደላላው ነው። ምንም እንኳን MQTT አገልጋይ እና MQTT ደላላ ተመሳሳይ ቃላት ባይሆኑም (አገልጋይ የMQTT ደንበኞችም ሊጫወቱት ለሚችለው ሚና ሰፊ ቃል ነው) MQTT አገልጋይ ሲጠቀስ ደላላው ሁል ጊዜ በዚህ ማኑዋል ነው። DIVUS KNX IQ ራሱ የMQTT ደላላ / MQTT አገልጋይ ሚና በዚህ ማኑዋል ውስጥ ይጫወታል።
• የMQTT አገልጋይ ርእሶች የሚባሉትን ይጠቀማል፡ ውሂቡ የሚመደበበት፣ የሚተዳደር እና የሚታተምበት ተዋረዳዊ መዋቅር።
• ህትመት መረጃን በርዕሰ ጉዳዮች ለሌሎች ተሳታፊዎች እንዲደርስ የማድረግ ዋና ግብ አለው። እሴትን ለመለወጥ ከፈለጉ፣ ወደሚፈለገው ርዕስ ከተፈለገው እሴት ለውጥ ጋር ይፃፉ፣ እንዲሁም የሕትመት እርምጃን ይጠቀሙ። የታለመው መሣሪያ ወይም የ MQTT አገልጋይ የሚፈልገውን ለውጥ ያነባል እና በዚህ መሠረት ይቀበላል። ለውጡ መተግበሩን ለማረጋገጥ፣ ለውጡ እዚያ መንጸባረቁን ለማየት በደንበኝነት የተመዘገቡበትን ቅጽበታዊ ርዕስ መመልከት ይችላሉ - ሁሉም ነገር በትክክል ከተሰራ።
• ደንበኞች የሚስቧቸውን ርዕሶች ይመርጣሉ፡ ይህ መመዝገብ ይባላል። በርዕስ ውስጥ/ከታች ያለው እሴት በተቀየረ ቁጥር ሁሉም የተመዘገቡ ደንበኞች ይነገራቸዋል - ማለትም የሆነ ነገር ተለውጧል ወይም አሁን ያለው ዋጋ ምን እንደሆነ በግልፅ መጠየቅ ሳያስፈልግ።
• በርዕስ ውስጥ ደንበኛ_አይዲ የሚባል ልዩ ሕብረቁምፊ በማስገባት ከMQTT አገልጋይ ጋር የተለየ የግንኙነት ቻናል መክፈት (ወይም አድራሻ) ማድረግ ይችላሉ። እሴቶችን ለማስኬድ ደንበኛ_መታወቂያው በርዕሱ ውስጥ ጥቅም ላይ መዋል አለበት። ይህ የእያንዳንዱን ለውጥ አመጣጥ ለመለየት ይረዳል ፣ ለማንኛውም ስህተቶች ይረዳል እና ሌሎች ደንበኞችን አይነካም ፣ ምክንያቱም ከአገልጋዩ የሚመጡ ተጓዳኝ ምላሾች ፣ ማንኛውንም የስህተት ኮድ እና መልዕክቶችን ጨምሮ ፣ እንዲሁም ርዕሱን በተመሳሳይ client_id ብቻ ይደርሳሉ (እና በዚህም ብቻ ደንበኛ)። ደንበኛ_መታወቂያ ከ0-9፣ አዝ፣ AZ፣ “-“፣ “_” ቁምፊዎችን ያካተተ ልዩ የቁምፊ ሕብረቁምፊ ነው።
• በአጠቃላይ፣ የDIVUS KNX IQ የMQTT አገልጋይ የደንበኝነት ምዝገባ ርእሶች የቁልፍ ቃል ሁኔታን ሲይዙ፣ የህትመት ርእሶች ግን የቁልፍ ቃል ጥያቄን ይይዛሉ። ደረጃ ያላቸው የውጭ እሴት ለውጥ እንደመጣ ወይም የእሴት ለውጥ በደንበኛው በራሱ በህትመት ሲጠየቅ እና በተሳካ ሁኔታ ተግባራዊ እንደተደረገ በራስ-ሰር ይዘመናሉ። ለኅትመት የሚቀርቡት ደግሞ በአይነት (ጥያቄ/) አግኝ እና ዓይነት (ጥያቄ/) ስብስብ ይከፋፈላሉ።
• የእሴት ለውጦች እና ሌሎች የአማራጭ መለኪያዎች ወደ ርእሱ ተጨምረዋል ክፍያ በሚባለው. የነጠላ ንጥረ ነገሮች መለኪያዎች (ንጥረ-መታወቂያ ፣ ስም ፣ ዓይነት ፣ ተግባራት)

በMQTT እና በሚታወቀው የደንበኛ አገልጋይ ሞዴል መካከል ያለው ዋናው ልዩነት፣ ደንበኛው የሚጠይቅበት እና ከዚያም የሚቀየርበት፣ በደንበኝነት እና በማተም ጽንሰ-ሀሳቦች ላይ ያተኮረ ነው። ተሳታፊዎች ውሂቡን ማተም እና ለሌሎች እንዲደርስ በማድረግ ፍላጎት ካላቸው ሊመዘገቡበት ይችላሉ። ይህ አርክቴክቸር የመረጃ ልውውጥን ለመቀነስ እና አሁንም ሁሉንም ፍላጎት ያላቸውን አካላት ወቅታዊ ለማድረግ ያስችላል። ስለዝርዝሮቹ ተጨማሪ እዚህ፡ እና ልዩ መለኪያዎች (uuid፣ ማጣሪያዎች) እዚህ ጥቅም ላይ መዋል አለባቸው። ምንም እንኳን ብዙ አማራጮች ቢኖሩም፣ ክፍያው በዚህ ማኑዋል ውስጥ እንደ JSON ቅርጸት ታይቷል። JSON የማንኛውም መዋቅር ውሂብን ለመወከል ቅንፎችን እና ኮማዎችን ይጠቀማል እና ስለዚህ የሚተላለፉትን የውሂብ ፓኬቶች መጠን ይቀንሳል። ስለ ክፍያ ጭነት ተጨማሪ ዝርዝሮች በመመሪያው ውስጥ በኋላ ላይ ይገኛሉ።

• ለልዩ ዓላማዎች እንደ የተግባር አይነት ማጣራት ይቻላል ለምሳሌ ማብራት/ማጥፋት ማለትም 1-ቢት ማብሪያ / ማጥፊያዎችን ብቻ ለመቅረፍ። በክፍያ ጭነት ውስጥ ያለው የማጣሪያዎች መለኪያ ለዚህ ዓላማ ጥቅም ላይ ይውላል. በአሁኑ ጊዜ ማጣራት የሚቻለው በተግባር አይነት ብቻ ነው።
• ነጠላ ኤለመንቶችን ለመቅረፍ የእነርሱ አባል መታወቂያ ያስፈልጋል። ይህ በኤለመንቱ ባሕሪያት ሜኑ ውስጥ በቪዥን ውስጥ ሊገኝ ይችላል ወይም ደግሞ በMQTT Explorer አጠቃላይ የደንበኝነት ተመዝጋቢ ውስጥ በእያንዳንዱ የሚገኝ አካል ፊት ለፊት ከሚታየው ውሂብ በቀጥታ ሊነበብ ይችላል (እነዚህ ንጥረ ነገሮች በኤለመንት መታወቂያ በፊደል ተዘርዝረዋል)።

ለኤፒአይ መዳረሻ ማዋቀር

ለኤፒአይ ተጠቃሚ መዳረሻ እይታን በማዋቀር ላይ

በ VISION እንደ አስተዳዳሪ ወደ ውቅረት - የተጠቃሚ/ኤፒአይ መዳረሻ አስተዳደር ይሂዱ፣ የተጠቃሚዎች/ኤፒአይ መዳረሻን ጠቅ ያድርጉ እና የኤፒአይ ተጠቃሚን በቀኝ ጠቅ ያድርጉ (ወይም ተጭነው ይያዙ) የአርትዖት መስኮቱን ለመክፈት። እዚያ እነዚህን መለኪያዎች እና መረጃዎች ያገኛሉ

• አንቃ (አመልካች ሳጥን)
  • ተጠቃሚው መጀመሪያ እዚህ ነቅቷል። ነባሪው ተሰናክሏል።
• የተጠቃሚ ስም
  • ይህ ሕብረቁምፊ በኤፒአይ በኩል ለመድረስ ያስፈልጋል - ከዚህ ይቅዱት።
• የይለፍ ቃል
  • ይህ ሕብረቁምፊ በኤፒአይ በኩል ለመድረስ ያስፈልጋል - ከዚህ ይቅዱት።
• ፈቃዶች
  • የ VISION አባሎችን እሴቶች የማንበብ እና የመፃፍ ነባሪ መብቶች እዚህ ሊገለጹ ይችላሉ፣ ማለትም እዚህ የተገለፀው በሁሉም ነባር እና የወደፊት አካላት ላይ ተፈጻሚ ይሆናል። የነጠላ ንጥረ ነገሮችን መዳረሻ ብቻ መፍቀድ ከፈለጉ እነዚህን ነባሪ መብቶች መቀየር የለብዎትም

በግለሰብ አካላት ላይ ፍቃዶች

ለጠቅላላው ፕሮጄክቱ የኤፒአይ መዳረሻ እንዳይሰጡ ይመከራል ነገር ግን ለሚፈለጉት አካላት ብቻ። እንደሚከተለው ይቀጥሉ

1. እንደ አስተዳዳሪ ወደ VISION ይግቡ
2. ተፈላጊውን አካል ይምረጡ እና የቅንብሮች ምናሌውን ይክፈቱ (በቀኝ ጠቅ ያድርጉ ወይም ተጭነው ይቀጥሉ ፣ ከዚያ ቅንብሮች)
3. በምናሌው ግቤት አጠቃላይ - ፈቃዶች ፣ “ነባሪ ፈቃዶችን ይሻሩ” ን ያግብሩ እና ከዚያ ወደ ንዑስ ንጥል ፈቃዶች ይሂዱ ፣ ይህም የፍቃዶች ማትሪክስ ያሳያል።
4. የቁጥጥር ፈቃዱን እዚህ ያግብሩ፣ ይህም ደግሞ ያስችላል view ፍቃድ በቀጥታ. በኤፒአይ መዳረሻ በኩል ብቻ ውሂብ ማንበብ ከፈለጉ፣ ለማንቃት በቂ ነው። view ፈቃድ.
5. ሊደርሱባቸው ለሚፈልጓቸው ንጥረ ነገሮች ሁሉ ተመሳሳይ አሰራርን ይድገሙት

በ MQTT በኩል ግንኙነት

መግቢያ

እንደ አንድ የቀድሞampለ፣ ለዊንዶውስ፣ ማክ እና ሊነክስ ባለው MQTT ኤክስፕሎረር (ምዕራፍ 1.1 ይመልከቱ) በDIVUS KNX IQ በMQTT API ተደራሽነትን እናሳያለን። ከ MQTT ጋር መሰረታዊ እውቀት እና ልምድ ይገለጻል።

ለግንኙነቱ የሚያስፈልገው ውሂብ

ቀደም ሲል እንደተጠቀሰው (ክፍል 2.1 ይመልከቱ) የተጠቃሚ ስም እና የይለፍ ቃል የኤፒአይ ተጠቃሚ ያስፈልጋል። እዚህ ማለቂያ አለview ግንኙነት ከመፈጠሩ በፊት መሰብሰብ ያለባቸው ሁሉም መረጃዎች፡-

• የተጠቃሚ ስም በ API ተጠቃሚ ዝርዝር ገጽ ላይ ያንብቡ
• የይለፍ ቃል በ API ተጠቃሚ ዝርዝር ገጽ ላይ ያንብቡ
• የአይፒ አድራሻ በጄኔራል - አውታረ መረብ - ኢተርኔት (ወይም በማመሳሰል) ስር በአስጀማሪው ቅንብሮች ውስጥ ያንብቡ።
• ወደብ 8884 (ይህ ወደብ ለዚሁ ዓላማ የተጠበቀ ነው)

የመጀመሪያ ግንኙነት ከ MQTT ኤክስፕሎረር እና አጠቃላይ ይመዝገቡ

በመደበኛነት፣ MQTT በደንበኝነት መመዝገብ እና በማተም እንቅስቃሴዎች መካከል ያለውን ልዩነት ይለያል። MQTT ኤክስፕሎረር የመጀመሪያው ግንኙነት ሲፈጠር ሁሉንም የሚገኙ ርዕሶች (ርዕስ #) በራስ ሰር በመመዝገብ ይህን ያቃልላል። በውጤቱም፣ ወደ ሁሉም የሚገኙ ንጥረ ነገሮች (ማለትም የኤፒአይ ተጠቃሚ መዳረሻ ተሰጥቷል) የሚወስደው ዛፍ ከተሳካ ግንኙነት በኋላ በMQTT Explorer መስኮት በግራ በኩል ይታያል። ተጨማሪ የደንበኝነት ተመዝጋቢ ርዕሶችን ለማስገባት ወይም # በተለየ ርዕስ ለመተካት በግንኙነት መስኮቱ ውስጥ ወደ የላቀ ይሂዱ። ከላይ በቀኝ በኩል የሚታየው ርዕስ ይህን ይመስላል።

7f4x0607849x444xxx256573x3x9x983 የኤፒአይ ተጠቃሚ ስም ሲሆን የነገሮች_ዝርዝር ሁሉንም የሚገኙትን ንጥረ ነገሮች የያዘ ነው።ይህ ርዕስ ሁል ጊዜ የተዘመነ ነው ማለትም ማንኛውም የእሴት ለውጦች በእውነተኛ ጊዜ ይገለጣሉ። ለነጠላ ኤለመንቶች መመዝገብ ከፈለግክ የተፈለገውን ኤለመንት ኤለመንት መታወቂያ ከነገር_ዝርዝር በኋላ አስገባ።

ማሳሰቢያ፡ የዚህ አይነት የደንበኝነት ተመዝጋቢ ከKNX ግብረ መልስ አድራሻዎች ጀርባ ካለው አመክንዮ ጋር ይዛመዳል። የንጥሎቹን ወቅታዊ ሁኔታ ያሳያል እና የተፈለገውን ለውጥ በተሳካ ሁኔታ መተግበሩን ለማረጋገጥ ጥቅም ላይ ሊውል ይችላል. ውሂብ ለማንበብ ብቻ ከፈለጉ ግን ካልቀየሩት የዚህ አይነት የደንበኝነት ምዝገባ በቂ ነው።

አንድ ቀላል አካል በJSON ማስታወሻ ውስጥ እንደዚህ ያለ ነገር ይመስላል

ማሳሰቢያ፡ ሁሉም እሴቶች ከላይ የሚታየው አገባብ አላቸው ለምሳሌ { “እሴት”፡ “1” } እንደ የደንበኝነት ርእሶች ውፅዓት፣ እሴቱ በቀጥታ በክፍያ ጭነት ውስጥ ተጽፎ እሴትን ለመቀየር (ማለትም ለህትመት ርዕሶች) - ቅንፍ እና “እሴት” ተትቷል ለምሳሌ “የበራ”፡ “1”።

የላቁ ትዕዛዞች

መግቢያ

በአጠቃላይ 3 አይነት ርዕሰ ጉዳዮች አሉ፡-

1. ያሉትን ክፍሎች ለማየት እና የአሁናዊ የእሴት ለውጦችን ለማግኘት ርዕስ(ዎች)ን ይመዝገቡ
2. መልሱን ለማግኘት አርእስት(ዎች) ይመዝገቡደንበኞቹ ) ጥያቄዎችን አትም
3. ኤለመንቶችን ከእሴቶቻቸው ጋር ለማግኘት ወይም ለማዘጋጀት ርዕስ(ኦች)ን ያትሙ

እዚህ ላይ የሚታየውን ቁጥር (ለምሳሌ 1፣ 2፣ 3 ያሉ ርዕሶችን) በመጠቀም እነዚህን ዓይነቶች እንጠቅሳለን። ተጨማሪ ዝርዝሮች በሚቀጥሉት ክፍሎች እና በምዕ. 4.2.

ያሉትን ንጥረ ነገሮች ለማየት እና የእውነተኛ ጊዜ የእሴት ለውጦችን ለማግኘት ርዕሶችን ሰብስክራይብ ያድርጉ

እነዚህ አስቀድሞ ተገልጸዋል

ለደንበኛው የህትመት ጥያቄዎች መልሶች ለማግኘት ርዕሶችን ይመዝገቡ

የዚህ አይነት አርእስቶች አማራጭ ናቸው። ይፈቅዳል

• የዘፈቀደ client_id በመጠቀም ከMQTT አገልጋይ ጋር ልዩ የሆነ የመገናኛ ቻናል ይክፈቱ። ስለዚያ ተጨማሪ በምዕ. 4.2.2
• በተዛማጅ የደንበኝነት መመዝገቢያ ርዕስ ላይ የማተም ጥያቄዎችን ውጤት ያግኙ፡ ስኬት ወይም ውድቀት በስህተት ኮድ እና መልእክት።

ትዕዛዞችን ለማግኘት ወይም ለማቀናበር መልሶችን ለማግኘት የተለያዩ ርዕሶች አሉ። ውስጥ ያለው ተዛማጅ ልዩነት አንዴ ለስርዓትዎ የሚያስፈልጉትን አርእስቶች በቀጥታ ካገኙ፣ ይህን ደረጃ ለማስወገድ እና ርዕሶችን በቀጥታ ለመጠቀም ሊወስኑ ይችላሉ።

 ኤለመንቶችን ከእሴቶቻቸው ለማግኘት ወይም ለማዘጋጀት ርዕሶችን ያትሙ

እነዚህ ርዕሶች ለመመዝገብ ከእነዚያ ጋር ተመሳሳይ የሆነ መንገድ ይጠቀማሉ - ብቸኛው ለውጥ ለደንበኝነት ለመመዝገብ በተጠቀመበት "ሁኔታ" ምትክ "ጥያቄ" የሚለው ቃል ብቻ ነው. የተሟሉ የርዕስ መንገዶች በኋላ ላይ ይታያሉ በምዕ. 4.2.2\ Get ርዕስ የMQTT አገልጋዩን ክፍሎች እና እሴቶች ለማንበብ ይጠይቃል። ክፍያው በንጥረ ነገሮች ተግባር አይነት ላይ ተመስርቶ ለማጣራት ሊያገለግል ይችላል። በክፍያ ጭነቱ ላይ እንደተገለጸው የተቀናበረ ርዕስ የአንድን ንጥረ ነገር አንዳንድ ክፍሎች ለመቀየር ይጠይቃል።

ለትእዛዞች እና ለተዛማጅ ምላሾች ቅድመ ቅጥያ

 አጭር ማብራሪያ

ወደ MQTT አገልጋይ የሚላኩ ሁሉም ትዕዛዞች አንድ የጋራ የመጀመሪያ ክፍል አላቸው፡

ዝርዝር ማብራሪያ

የእውነተኛ ጊዜ ርእሶች (አይነት 1) አጠቃላይ ቅድመ ቅጥያ (ከላይ ያለውን ይመልከቱ) ከዚያም ይከተላል

or

ለተቀመጡት ትዕዛዞች፣ የሚፈለገውን ለውጥ (ማለትም ለኤለመንቱ ተግባራት የተቀየሩ እሴቶች) ስለሚይዝ፣ ክፍያው ዋናውን ሚና እንደሚጫወት ግልጽ ነው። ማስጠንቀቂያ፡ በKNX በኩል ችግር ሊፈጥር ስለሚችል በእርስዎ አይነት 3 ትዕዛዞች ውስጥ ያለውን የማቆያ አማራጭ በጭራሽ አይጠቀሙ።

EXAMPሌ፡ የአንድን አካል እሴት(ዎች) ለመቀየር ያትሙ

በጣም ቀላሉ ጉዳይ በአጠቃላይ የደንበኝነት ተመዝጋቢነት ከሚታዩት ንጥረ ነገሮች ውስጥ አንዱን ዋጋ ለመለወጥ መፈለግ ነው.
በአጠቃላይ የ VISIONን ተግባር በMQTT መቀየር/መቀየር 3 ደረጃዎችን ያቀፈ ነው ፣ ሁሉም አስፈላጊ አይደሉም ፣ ግን እንደተገለጸው እንዲተገበሩ እንመክራለን።

1. አርትዕ ማድረግ የምንፈልገውን ተግባር የያዘው ርዕስ ብጁ ደንበኛ_መታወቂያን በመጠቀም ተመዝግቧል
2. የአርትዖት ርዕስ በ1 ውስጥ የተመረጠውን ደንበኛ_መታወቂያን በመጠቀም ከክፍያ ጭነት ጋር አብሮ ታትሟል።
3. ለመፈተሽ፣ መልሱን በርዕስ (1.) - ማለትም (2.) ሰርቷል ወይም አልሰራ የሚለውን ማየት ይችላሉ።
4. በአጠቃላይ የደንበኝነት ተመዝጋቢ፣ ለውጦች ሲደረጉ ሁሉም እሴቶች የሚሻሻሉበት፣ ሁሉም ነገር በትክክል ከሰራ የሚፈለገውን የእሴት ለውጥ(ቶች) ማየት ይችላሉ።

ይህንን ለማድረግ እርምጃዎች የሚከተሉት ናቸው-

1. ደንበኛ_ኢድ ለምሳሌ “Divus” ን ይምረጡ እና ከኤፒአይ ተጠቃሚ ስም በኋላ በመንገዱ ላይ ያስገቡት።
   ከMQTT አገልጋይ ጋር የእራስዎን የግንኙነት ቻናል ለመመዝገብ ይህ ሙሉ ርዕስ ነው። ይህ ለመላክ ለምትፈልጉት ለውጥ ምላሾችን የት እንደሚጠብቁ ለአገልጋዩ ይነግረዋል። ሀ የሚገልፀውን ሁኔታ/ስብስብ ክፍል አስተውል። የደንበኝነት መመዝገቢያ ርዕስ እንደሆነ እና ለ. ዓይነት ትዕዛዞችን ለማዘጋጀት መልሶችን እንደሚያገኝ.
2. የሁኔታ ጥያቄ ቁልፍ ቃላትን ከመቀየር በስተቀር የህትመት ርዕስ ተመሳሳይ ይሆናል።
3. ለውጡ ምን ማካተት እንዳለበት በክፍያው ውስጥ ተጽፏል. አንዳንድ የቀድሞ እነኚሁና።ampሌስ.
   • የማብራት/ማጥፋት ተግባር (1 ቢት) ያለውን አካል በማጥፋት ላይ፡-
   • የማብራት/ማጥፋት ተግባር (1 ቢት) ያለው ኤለመንት ማብራት። በተጨማሪም ፣ ብዙ እንደዚህ ያሉ ትዕዛዞች ከተመሳሳይ ደንበኛ ከተጀመሩ የ uuid ግቤት (“ልዩ መታወቂያ” ፣ ብዙውን ጊዜ ባለ 128-ቢት ሕብረቁምፊ በ 8-4-4-4-12 አሃዝ አስራ ሁለት አሃዝ ቅርጸት) ለመመደብ ጥቅም ላይ ሊውል ይችላል ። ለተዛማጅ መጠይቁ ምላሽ, ይህ ግቤት - በጥያቄው ውስጥ ካለ - በምላሹ ውስጥም ሊገኝ ይችላል.
   • የዲመርን ብሩህነት ወደ 50% ማብራት እና ማቀናበር
   • ከላይ ለታየው እና ለተመዘገበው ርዕስ መልሱ (የክፍያው ጭነት፣ በትክክል መሆን) ከዚያም፣ ለምሳሌampለ.
     ከላይ ያለው ምላሽ የቀድሞ ነው።ample በትክክለኛ ጭነት ሁኔታ ፣ ምንም እንኳን ንጥረ ነገሩ ምንም የማደብዘዝ ተግባር ባይኖረውም። ሸክሙ በትክክል እንዳይተረጎም የሚያደርጉ ይበልጥ አሳሳቢ ችግሮች ካሉ፣ ምላሹ ይህን ይመስላል (ለምሳሌ፦)
     ለስህተት ኮዶች እና መልእክቶች ማብራሪያ ግን በአጠቃላይ እንደ http, 200 ኮዶች አዎንታዊ መልሶች ሲሆኑ 400 አሉታዊ ናቸው.

EXAMPLE፡ ብዙ እሴቶችን ለመለወጥ ያትሙ

አሰራሩ አንድ ነጠላ ንጥረ ነገር ለመለወጥ ከዚህ በፊት ከሚታየው ጋር ተመሳሳይ ነው. ልዩነቱ ኤለመንት_አይዲውን ከርዕሶቹ ውስጥ ትተህ በመቀጠል የElement_ids ስብስብን ከውሂቡ ፊት ለፊት በመክፈያ ጭነት ውስጥ ማመላከትህ ነው። ከታች ያለውን አገባብ እና መዋቅር ይመልከቱ።

በጥያቄዎች ውስጥ በተግባር አይነት አጣራ

በደመወዝ ጭነት ውስጥ ያለው የማጣሪያዎች መለኪያ የሚፈለገው የአንድ ኤለመንት ተግባር(ዎች) ብቻ እንዲታይ ይፈቅዳል። የመቀየሪያ ወይም የማደብዘዣ ማብራት/ማጥፋት ተግባር "ማብራት" ይባላል፣ ለምሳሌample, እና ተጓዳኝ ማጣሪያው በዚህ መንገድ ይገለጻል:

መልሱ እንደዚህ ይመስላል፣ ለምሳሌample

የካሬው ቅንፍ በበርካታ ተግባራት ማጣራት እንደሚችሉ ይጠቁማል ለምሳሌ

ወደዚህ መልስ ይመራል

አባሪ

የስህተት ኮዶች

በMQTT ግንኙነት ውስጥ ያሉ ስህተቶች የቁጥር ኮድ ያስከትላሉ። የሚከተለው ሰንጠረዥ ለማፍረስ ይረዳል.

የመክፈያ መለኪያዎች

ክፍያው እንደ አውድ ላይ በመመስረት የተለያዩ መለኪያዎችን ይደግፋል። የሚከተለው ሠንጠረዥ በየትኞቹ ርዕሰ ጉዳዮች ውስጥ የትኞቹ መለኪያዎች ሊከሰቱ እንደሚችሉ ያሳያል

የስሪት ማስታወሻዎች

• አንቀፅ 1.00

ዜና፡

• የመጀመሪያ እትም።

ሰነዶች / መርጃዎች

	DIVUS VISION API ሶፍትዌር [pdf] የተጠቃሚ መመሪያ VISION API ሶፍትዌር፣ ኤፒአይ ሶፍትዌር፣ ሶፍትዌር
	DIVUS ቪዥን ኤፒአይ ሶፍትዌር [pdf] የተጠቃሚ መመሪያ ቪዥን ኤፒአይ ሶፍትዌር፣ ራዕይ፣ ኤፒአይ ሶፍትዌር፣ ሶፍትዌር

ዋቢዎች

• የተጠቃሚ መመሪያ