DIVUS VISION API මෘදුකාංගය

පිරිවිතර

• නිෂ්පාදනය: DIVUS VISION API
• නිෂ්පාදකයා: DIVUS GmbH
• අනුවාදය: 1.00 REV0 1 - 20240528
• ස්ථානය: Pillhof 51, Eppan (BZ), ඉතාලිය

නිෂ්පාදන තොරතුරු

DIVUS VISION API යනු DIVUS VISION පද්ධති සමඟ අතුරු මුහුණත් කිරීම සඳහා නිර්මාණය කර ඇති මෘදුකාංග මෙවලමකි. MQTT ප්‍රොටෝකෝල භාවිතයෙන් පද්ධතිය තුළ විවිධ අංග වෙත ප්‍රවේශ වීමට සහ පාලනය කිරීමට එය පරිශීලකයින්ට ඉඩ සලසයි.

නිති අසන පැණ

ප්‍ර: PC හෝ ස්වයංක්‍රීය තාක්‍ෂණය පිළිබඳ පූර්ව දැනුමකින් තොරව මට DIVUS VISION API භාවිතා කළ හැකිද?

A: API කාර්යක්ෂමව භාවිතා කිරීම සහතික කිරීම සඳහා මෙම ප්‍රදේශවල පෙර දැනුම ඇති පරිශීලකයින් සඳහා අත්පොත සකස් කර ඇත.

සාමාන්ය තොරතුරු

• DIVUS GmbH Pillhof 51 I-39057 Eppan (BZ) - ඉතාලිය

මෙහෙයුම් උපදෙස්, අත්පොත් සහ මෘදුකාංග ප්‍රකාශන හිමිකම මගින් ආරක්ෂා කර ඇත. සියලු හිමිකම් ඇවිරිණි. පිටපත් කිරීම, අනුපිටපත් කිරීම, පරිවර්තනය කිරීම, සම්පූර්ණයෙන් හෝ අර්ධ වශයෙන් පරිවර්තනය කිරීමට අවසර නැත. පුද්ගලික භාවිතය සඳහා මෘදුකාංගයේ උපස්ථ පිටපතක් නිර්මාණය කිරීම සඳහා ව්යතිරේකයක් අදාළ වේ.
අත්පොත දැනුම්දීමකින් තොරව වෙනස් කිරීමට යටත් වේ. මෙම ලේඛනයේ සහ සපයන ලද ගබඩා මාධ්‍යයේ අඩංගු දත්ත දෝෂ රහිත සහ නිවැරදි බව අපට සහතික කළ නොහැක. වැඩිදියුණු කිරීම් සඳහා වන යෝජනා මෙන්ම දෝෂ පිළිබඳ ඉඟි සැමවිටම සාදරයෙන් පිළිගනිමු. මෙම අත්පොතෙහි විශේෂිත ඇමුණුම් සඳහාද ගිවිසුම් අදාළ වේ. මෙම ලේඛනයේ ඇති තනතුරු තුන්වන පාර්ශ්වයන් ඔවුන්ගේ අරමුණු සඳහා භාවිතා කිරීම ඔවුන්ගේ අයිතිකරුවන්ගේ අයිතිවාසිකම් උල්ලංඝනය කළ හැකි වෙළඳ ලකුණු විය හැකිය. පරිශීලක උපදෙස්: කරුණාකර මෙම අත්පොත පළමු වරට භාවිතා කිරීමට පෙර කියවා අනාගත පරිශීලනය සඳහා ආරක්ෂිත ස්ථානයක තබා ගන්න. ඉලක්ක කණ්ඩායම: අත්පොත ලියා ඇත්තේ PC සහ ස්වයංක්‍රීය තාක්‍ෂණය පිළිබඳ පෙර දැනුමක් ඇති පරිශීලකයින් සඳහා ය.

ඉදිරිපත් කිරීමේ සම්මුතීන්

හැඳින්වීම

සාමාන්ය හැඳින්වීම

මෙම අත්පොත VISION API (යෙදුම් ක්‍රමලේඛන අතුරුමුහුණත) විස්තර කරයි - බාහිර පද්ධති වලින් VISION ආමන්ත්‍රණය කළ හැකි සහ පාලනය කළ හැකි අතුරු මුහුණතක්.
ප්‍රායෝගිකව, මෙයින් අදහස් කරන්නේ ඔබට වැනි පද්ධති භාවිතා කළ හැකි බවයි

• MQTT Explorer (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 පරිශීලක සත්‍යාපන දත්ත භාවිතයෙන් පමණි. පරිශීලක අයිතිවාසිකම් සම්බන්ධයෙන් ගත් කල, මෙම ක්‍රියාකාරීත්වය සඳහා සක්‍රිය කිරීම සියලු හෝ තනි මූලද්‍රව්‍ය මත වින්‍යාසගත කළ හැක. 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 (සහ ඒ අනුව පමණි. එම සේවාදායකයා). Client_id යනු 0-9, az, AZ, "-", "_" අක්ෂරවල ඕනෑම සංයෝජනයකින් සමන්විත අද්විතීය අක්ෂර මාලාවකි.
• සාමාන්‍යයෙන්, DIVUS KNX IQ හි MQTT සේවාදායකයේ ග්‍රාහක මාතෘකා වල මූල පද තත්ත්වය අඩංගු වන අතර ප්‍රකාශන මාතෘකා වල මූල පද ඉල්ලීම අඩංගු වේ. බාහිර අගය වෙනස් වීමක් සිදු වූ වහාම හෝ සේවාලාභියා විසින්ම ප්‍රකාශනයක් හරහා අගය වෙනස් කිරීමක් ඉල්ලා ඇති අතර එය සාර්ථකව යෙදූ වහාම තත්ත්වය ඇති ඒවා ස්වයංක්‍රීයව යාවත්කාලීන වේ. ප්‍රකාශනය සඳහා වන ඒවා වර්ග (ඉල්ලීම/) ලබා ගැනීම සහ වර්ගය (ඉල්ලීම/) කට්ටලය ලෙස බෙදා ඇත.
• අගය වෙනස් කිරීම් සහ අනෙකුත් විකල්ප පරාමිතීන් ඊනියා ගෙවීම සමඟ මාතෘකාවට එකතු කරනු ලැබේ. තනි මූලද්‍රව්‍යවල පරාමිතීන් (මූලද්‍රව්‍ය-id, නම, වර්ගය, ශ්‍රිත)

MQTT සහ සම්භාව්‍ය සේවාදායක-සේවාදායක ආකෘතිය අතර ඇති ප්‍රධාන වෙනස, සේවාලාභියා ඉල්ලා සිටින සහ පසුව දත්ත වෙනස් කරන, දායක වීම සහ ප්‍රකාශ කිරීම යන සංකල්ප මත කේන්ද්‍රගත වේ. සහභාගිවන්නන්ට දත්ත ප්‍රකාශයට පත් කළ හැකිය, එය අන් අයට ලබා ගත හැකි වන පරිදි, උනන්දුවක් දක්වන්නේ නම් එයට දායක විය හැකිය. මෙම ගෘහනිර්මාණ ශිල්පය දත්ත හුවමාරුව අවම කිරීමට සහ තවමත් උනන්දුවක් දක්වන පාර්ශවයන් යාවත්කාලීනව තබා ගැනීමට හැකි වේ. මෙහි විස්තර ගැන වැඩි විස්තර: සහ විශේෂ පරාමිති (uuid, ෆිල්ටර්) මෙහි භාවිතා කිරීමට නියමිතය. විකල්ප කිහිපයක් තිබුණද, මෙම අත්පොතෙහි ගෙවුම් භාරය JSON ලෙස හැඩතල ගන්වා ඇත. JSON ඕනෑම ව්‍යුහයක දත්ත නිරූපණය කිරීමට වරහන් සහ කොමා භාවිතා කරන අතර එමඟින් සම්ප්‍රේෂණය කළ යුතු දත්ත පැකට් වල ප්‍රමාණය අවම කරයි. ගෙවීම් පිළිබඳ වැඩි විස්තර පසුව අත්පොතෙහි සොයාගත හැකිය.

• විශේෂ අරමුණු සඳහා, ශ්‍රිතයේ වර්ගය අනුව පෙරීමට හැකිය, උදා: 1-බිට් ස්විචයන් සක්‍රිය / අක්‍රිය කිරීමට පමණි. මේ සඳහා payload හි ඇති filters පරාමිතිය භාවිතා වේ. පෙරීම දැනට කළ හැක්කේ ශ්‍රිත වර්ගය අනුව පමණි.
• තනි මූලද්‍රව්‍ය ඇමතීමට හැකි වීමට, ඒවායේ මූලද්‍රව්‍ය ID අවශ්‍ය වේ. මෙය මූලද්‍රව්‍ය ගුණාංග මෙනුවෙහි VISION හි සොයා ගත හැක හෝ MQTT Explorer හි සාමාන්‍ය ග්‍රාහකත්වය තුළ පවතින එක් එක් මූලද්‍රව්‍ය ඉදිරියෙහි දර්ශනය වන දත්ත වලින් සෘජුවම කියවිය හැකිය (මූලද්‍රව්‍ය ID මගින් අකාරාදී ලෙස ලැයිස්තුගත කර ඇත).

API ප්‍රවේශය සඳහා වින්‍යාස කිරීම

API පරිශීලක ප්‍රවේශය සඳහා දර්ශනය වින්‍යාස කිරීම

පරිපාලකයෙකු ලෙස VISION හි, Configuration – User/API Access Management වෙත ගොස්, Users/API ප්‍රවේශය මත ක්ලික් කර, සංස්කරණ කවුළුව විවෘත කිරීමට API පරිශීලක (හෝ ඔබා අල්ලාගෙන සිටින්න) මත දකුණු-ක්ලික් කරන්න. එහිදී ඔබට මෙම පරාමිතීන් සහ දත්ත සොයාගත හැකිය

• සබල කරන්න (තිරීක් පෙට්ටිය)
  • පරිශීලකයා මුලින්ම මෙහි සක්‍රීය කර ඇත. පෙරනිමිය අබල කර ඇත
• පරිශීලක නාමය
  • API හරහා ප්‍රවේශය සඳහා මෙම තන්තුව අවශ්‍ය වේ - එය මෙතැනින් පිටපත් කරන්න
• මුරපදය
  • API හරහා ප්‍රවේශය සඳහා මෙම තන්තුව අවශ්‍ය වේ - එය මෙතැනින් පිටපත් කරන්න
• අවසර
  • VISION මූලද්‍රව්‍යවල අගයන් කියවීම සහ ලිවීම සඳහා වන පෙරනිමි අයිතිය මෙහි අර්ථ දැක්විය හැක, එනම් මෙහි නිර්වචනය කර ඇති දේ පවතින සහ අනාගත මූලද්‍රව්‍ය සියල්ලටම අදාළ වේ. ඔබට තනි මූලද්‍රව්‍ය වෙත පමණක් ප්‍රවේශය ලබා දීමට අවශ්‍ය නම්, ඔබ මෙම පෙරනිමි අයිතීන් වෙනස් නොකළ යුතුය

තනි තනි මූලද්රව්ය මත අවසර

ඔබ සම්පූර්ණ ව්‍යාපෘතියට API ප්‍රවේශය ලබා නොදෙන ලෙස නිර්දේශ කරනු ලැබේ, නමුත් අවශ්‍ය මූලද්‍රව්‍ය සඳහා පමණි. පහත පරිදි ඉදිරියට යන්න

1. පරිපාලකයෙකු ලෙස VISION වෙත ලොග් වන්න
2. අපේක්ෂිත මූලද්‍රව්‍යය තෝරා එහි සැකසුම් මෙනුව විවෘත කරන්න (දකුණු-ක්ලික් කරන්න හෝ ඔබන්න, පසුව සැකසීම්)
3. මෙනු ඇතුළත් කිරීම යටතේ General – Permissions, “Override default Permissions” සක්‍රිය කර පසුව අවසර අනුකෘතිය පෙන්වන අනු අයිතම අවසර වෙත යන්න.
4. මෙහි පාලන අවසරය සක්‍රිය කරන්න, එය ද සක්‍රීය කරයි view සෘජුවම අවසරය. ඔබට API ප්‍රවේශය හරහා පමණක් දත්ත කියවීමට අවශ්‍ය නම්, එය සබල කිරීමට ප්‍රමාණවත් වේ view අවසරය.
5. ඔබට ප්‍රවේශ වීමට අවශ්‍ය සියලුම අංග සඳහා එකම ක්‍රියා පටිපාටිය නැවත කරන්න

MQTT හරහා සම්බන්ධතාවය

හැඳින්වීම

හිටපු කෙනෙක් විදියටample, අපි Windows, Mac සහ Linux සඳහා ලබා ගත හැකි MQTT Explorer නම් සාපේක්ෂ සරල, නිදහස් මෘදුකාංගයක් සමඟින් DIVUS KNX IQ හි MQTT API හරහා ප්‍රවේශය පෙන්වනු ඇත. MQTT සමඟ මූලික දැනුමක් සහ අත්දැකීමක් ඇඟවුම් කෙරේ.

සම්බන්ධතාවය සඳහා අවශ්‍ය දත්ත

කලින් සඳහන් කළ පරිදි (2.1 කොටස බලන්න), API පරිශීලකයාගේ පරිශීලක නාමය සහ මුරපදය අවශ්‍ය වේ. මෙන්න ඕවර් එකක්view සම්බන්ධතාවයක් ස්ථාපිත කිරීමට පෙර එකතු කළ යුතු සියලුම දත්ත වලින්:

• පරිශීලක නාමය API පරිශීලකයාගේ විස්තර පිටුවේ කියවන්න
• මුරපදය API පරිශීලකයාගේ විස්තර පිටුවේ කියවන්න
• IP ලිපිනය General – Network – Ethernet (හෝ Synchronizer හරහා) යටතේ දියත් කිරීමේ සැකසුම් තුළ කියවන්න.
• වරාය 8884 (මෙම වරාය මේ සඳහා වෙන් කර ඇත)

MQTT ගවේෂකය සමඟ පළමු සම්බන්ධතාවය සහ සාමාන්‍ය දායකත්වය

සාමාන්‍යයෙන්, MQTT ග්‍රාහකත්වය සහ ප්‍රකාශන ක්‍රියාකාරකම් අතර වෙනස හඳුනා ගනී. MQTT Explorer පළමු සම්බන්ධතාවය සිදු කරන විට පවතින සියලුම මාතෘකා (මාතෘකා #) වෙත ස්වයංක්‍රීයව දායක වීමෙන් මෙය සරල කරයි. එහි ප්‍රතිඵලයක් වශයෙන්, පවතින සියලුම මූලද්‍රව්‍ය වෙත යොමු වන ගස (එනම් API පරිශීලක ප්‍රවේශය ලබා දී ඇත) සාර්ථක සම්බන්ධතාවයකින් පසු MQTT Explorer කවුළුවේ වම් පස ප්‍රදේශයේ සෘජුවම දැකිය හැක. තවදුරටත් ග්‍රාහකත්ව මාතෘකා ඇතුළු කිරීමට හෝ # වඩාත් නිශ්චිත මාතෘකාවක් සමඟ ප්‍රතිස්ථාපනය කිරීමට, සම්බන්ධතා කවුළුවෙහි උසස් වෙත යන්න. ඉහළ දකුණේ පෙන්වා ඇති මාතෘකාව මේ වගේ දෙයක් පෙනේ:

7f4x0607849x444xxx256573x3x9x983 යනු API පරිශීලක නාමය වන අතර objects_list හි පවතින සියලුම මූලද්‍රව්‍ය අඩංගු වේ. මෙම මාතෘකාව සැමවිටම යාවත්කාලීනව තබා ඇත, එනම් ඕනෑම අගයක වෙනසක් තත්‍ය කාලීනව එහි පිළිබිඹු වේ. ඔබට තනි මූලද්‍රව්‍ය සඳහා පමණක් දායක වීමට අවශ්‍ය නම්, objects_list/ ට පසුව අපේක්ෂිත මූලද්‍රව්‍යයේ මූලද්‍රව්‍ය ID ඇතුළත් කරන්න.

සටහන: මෙම ආකාරයේ ග්‍රාහකත්වය KNX ප්‍රතිපෝෂණ ලිපින පිටුපස ඇති තර්කයට දළ වශයෙන් අනුරූප වේ; එය මූලද්‍රව්‍යවල වත්මන් තත්ත්වය පෙන්නුම් කරන අතර අපේක්ෂිත වෙනස්කම් සාර්ථකව යෙදී ඇත්දැයි පරීක්ෂා කිරීමට භාවිතා කළ හැක. ඔබට දත්ත කියවීමට පමණක් අවශ්‍ය නමුත් එය වෙනස් නොකරන්නේ නම්, මෙම ආකාරයේ දායක වීම ප්‍රමාණවත් වේ .

JSON අංකනයේ තනි සරල මූලද්‍රව්‍යයක් මේ වගේ දෙයක් පෙනේ

සටහන: සියලුම අගයන් ග්‍රාහක මාතෘකා වල ප්‍රතිදානය ලෙස ඉහත පෙන්වා ඇති වාක්‍ය ඛණ්ඩය ඇත, (එනම් ප්‍රකාශන මාතෘකා සඳහා) අගය වෙනස් කිරීම සඳහා අගය සෘජුවම ගෙවීමේ ලියා ඇත - වරහන් සහ "අගය" ඉවත් කර ඇත උදා: "onoff": "1".

උසස් විධාන

හැඳින්වීම

පොදුවේ මාතෘකා වර්ග 3 ක් ඇත:

1. පවතින මූලද්‍රව්‍ය බැලීමට සහ තත්‍ය කාලීන අගය වෙනස් කිරීම් ලබා ගැනීමට මාතෘකා(ය) දායක වන්න
2. පිළිතුරු ලබා ගැනීමට මාතෘකා(න්) දායක වන්න (සේවාදායකයින් ) ඉල්ලීම් ප්‍රකාශ කරන්න
3. මූලිකාංග ලබා ගැනීමට හෝ ඒවායේ අගයන් සමඟ සැකසීමට මාතෘකා(ය) ප්‍රකාශ කරන්න

අපි පසුව මෙහි පෙන්වා ඇති අංක භාවිතා කර මෙම වර්ග වෙත යොමු කරමු (උදා. 1, 2, 3 වර්ගයේ මාතෘකා). වැඩි විස්තර පහත කොටස්වල සහ පරිච්ඡේදයේ. 4.2

පවතින මූලද්‍රව්‍ය බැලීමට සහ තත්‍ය කාලීන වටිනාකම් වෙනස්කම් ලබා ගැනීමට මාතෘකා දායක වන්න

මේවා දැනටමත් විස්තර කර ඇත

සේවාදායකයාගේ ප්‍රකාශන ඉල්ලීම්වලට පිළිතුරු ලබා ගැනීමට මාතෘකා දායක වන්න

මෙම ආකාරයේ මාතෘකා විකල්ප වේ. එය ඉඩ දෙයි

• අත්තනෝමතික client_id භාවිතා කිරීමෙන් MQTT සේවාදායකය සමඟ අද්විතීය සන්නිවේදන නාලිකාවක් විවෘත කරන්න. පරිච්ඡේදයේ ඒ ගැන වැඩි විස්තර. 4.2.2
• අදාළ ග්‍රාහකත්ව මාතෘකාව මත ප්‍රකාශන ඉල්ලීම්වල ප්‍රතිඵල ලබා ගන්න: දෝෂ කේතය සහ පණිවිඩය සමඟ සාර්ථකත්වය හෝ අසාර්ථකත්වය.

ප්‍රකාශන විධාන ලබා ගැනීමට හෝ සැකසීමට පිළිතුරු ලබා ගැනීමට විවිධ මාතෘකා තිබේ. අනුරූප වෙනස ඔබ ඔබේ පද්ධතියට අවශ්‍ය මාතෘකා කෙලින්ම ලබා ගත් පසු, ඔබට මෙම පියවර ඉවත් කර ප්‍රකාශන මාතෘකා කෙලින්ම භාවිතා කිරීමට තීරණය කළ හැක.

 ඒවායේ අගයන් සහිත මූලද්‍රව්‍ය ලබා ගැනීමට හෝ සැකසීමට මාතෘකා ප්‍රකාශයට පත් කරන්න

මෙම මාතෘකා දායක වීම සඳහා ඒවාට සමාන මාර්ගයක් භාවිතා කරයි - එකම වෙනස වන්නේ දායක වීමට භාවිතා කරන "තත්ත්වය" වෙනුවට "ඉල්ලීම" යන වචනයයි. සම්පූර්ණ මාතෘකා මාර්ග පසුව පරිච්ඡේදයේ පෙන්වනු ලැබේ. 4.2.2\ ලබා ගැනීමේ මාතෘකාවක් MQTT සේවාදායකයේ මූලද්‍රව්‍ය සහ අගයන් කියවීමට ඉල්ලා සිටී. මූලද්‍රව්‍යවල ක්‍රියාකාරී වර්ගය මත පදනම්ව පෙරීමට ගෙවීමට භාවිතා කළ හැක. සකසන මාතෘකාවක් එහි ගෙවීමේ විස්තර කර ඇති පරිදි, මූලද්‍රව්‍යයක සමහර කොටස් වෙනස් කිරීමට ඉල්ලා සිටිනු ඇත.

විධාන සහ අනුරූප ප්‍රතිචාර සඳහා උපසර්ගය

 කෙටි පැහැදිලි කිරීම

MQTT සේවාදායකයට යවනු ලබන සියලුම විධානයන්ට පොදු ආරම්භක කොටසක් ඇත, එනම්:

සවිස්තරාත්මක පැහැදිලි කිරීම

තත්‍ය කාලීන මාතෘකා (වර්ගය 1) සාමාන්‍ය උපසර්ගය (ඉහත බලන්න) පසුව අනුගමනය කරනු ඇත

or

සකසන ලද විධාන සඳහා, අපේක්ෂිත වෙනස්කම් (එනම් මූලද්‍රව්‍යයේ ක්‍රියාකාරකම් සඳහා වෙනස් කළ අගයන්) අඩංගු වන බැවින් ගෙවීම් භාරය පැහැදිලිවම ප්‍රධාන භූමිකාව ඉටු කරයි. අවවාදයයි: KNX පැත්තෙන් ගැටළු ඇති කළ හැකි බැවින් ඔබේ 3 වර්ගයේ විධානවල රඳවා ගැනීමේ විකල්පය කිසි විටෙක භාවිතා නොකරන්න.

EXAMPLE: තනි මූලද්‍රව්‍යයක අගය(ය) වෙනස් කිරීම සඳහා ප්‍රකාශනය කරන්න

සරලම අවස්ථාව නම් සාමාන්‍ය ග්‍රාහකත්වය මගින් පෙන්වන එක් මූලද්‍රව්‍යයක අගය වෙනස් කිරීමට අවශ්‍ය වීමයි.
සාමාන්‍යයෙන් කථා කරන විට, MQTT හරහා VISION ශ්‍රිතයක් වෙනස් කිරීම/මාරු කිරීම පියවර 3 කින් සමන්විත වේ, ඒ සියල්ලම අත්‍යවශ්‍ය නොවන නමුත් විස්තර කර ඇති පරිදි ඒවා ක්‍රියාත්මක කිරීමට අපි නිර්දේශ කරමු.

1. අපට සංස්කරණය කිරීමට අවශ්‍ය කාර්යය අඩංගු මාතෘකාව අභිරුචි client_id භාවිතයෙන් දායක වේ
2. සංස්කරණය සඳහා මාතෘකාව 1 හි තෝරාගත් client_id භාවිතයෙන් අපේක්ෂිත වෙනස්කම් සමඟ ගෙවීම සමඟ ප්‍රකාශයට පත් කෙරේ.
3. පරීක්ෂා කිරීමට, ඔබට පසුව මාතෘකාව (1.) - එනම් (2.) ක්‍රියා කළේද නැද්ද යන්නෙහි පිළිතුර දැකිය හැක
4. සාමාන්‍ය ග්‍රාහකත්වය තුළ, වෙනස්කම් සිදු කරන විට සියලුම අගයන් යාවත්කාලීන වන විට, සියල්ල හොඳින් ක්‍රියාත්මක වී ඇත්නම් ඔබට අවශ්‍ය අගය වෙනස්වීම් (ය) දැකිය හැකිය.

මෙය කිරීමට පියවර වන්නේ:

1. Client_id එකක් තෝරන්න උදා: "Divus" සහ API පරිශීලක නාමයෙන් පසු මාර්ගයට ඇතුල් කරන්න
   MQTT සේවාදායකය සමඟ ඔබේම සන්නිවේදන නාලිකාවට දායක වීම සඳහා සම්පූර්ණ මාතෘකාව මෙයයි. මෙය ඔබ යැවීමට අදහස් කරන වෙනස්කම් වලට ප්‍රතිචාර බලාපොරොත්තු වන සේවාදායකයට කියයි. a නිර්වචනය කරන තත්ත්‍වය/කට්ටල කොටස සැලකිල්ලට ගන්න. එය දායක මාතෘකාවක් බව සහ බී. එය ආකාරයේ විධාන සැකසීමට පිළිතුරු ලැබෙනු ඇති බව.
2. තත්ත්ව ඉල්ලීම් මූල පද මාරු කිරීම හැර ප්‍රකාශන මාතෘකාව එකම වේ
3. වෙනස් කිරීම සමන්විත විය යුතු දේ ගෙවීමේ ලියා ඇත. මෙන්න සමහර හිටපුamples.
   • සක්‍රිය / අක්‍රිය ශ්‍රිතයක් ඇති මූලද්‍රව්‍ය ක්‍රියා විරහිත කිරීම (බිට් 1):
   • සක්‍රිය / අක්‍රිය ශ්‍රිතයක් ඇති මූලද්‍රව්‍යයක් සක්‍රිය කිරීම (බිට් 1). මීට අමතරව, එවැනි විධාන කිහිපයක් එකම සේවාලාභියාගෙන් ආරම්භ කරන්නේ නම්, uuid පරාමිතිය ("අද්විතීය හැඳුනුම්පත", සාමාන්‍යයෙන් 128-8-4-4-4 ඉලක්කම් හෙක්ස් ලෙස ෆෝමැට් කර ඇති 12-බිට් තන්තුවකි) පැවරීමට භාවිතා කළ හැක. අදාළ විමසුමට ප්‍රතිචාරය, මෙම පරාමිතිය - විමසුමේ තිබේ නම් - ප්‍රතිචාරයෙන් ද සොයාගත හැක.
   • ඩිමර් එකක දීප්තිය 50% දක්වා ක්‍රියාත්මක කිරීම සහ සැකසීම
   • ඉහත පෙන්වා ඇති සහ දායක වූ මාතෘකාවට පිළිතුර (එහි ගෙවීම්, නිශ්චිතව කිවහොත්) එවිට, උදාample.
     ඉහත ප්‍රතිචාරය හිටපු එකකිampමූලද්‍රව්‍යයට අඳුරු කිරීමේ කාර්යයක් නොමැති වුවද, නිවැරදි ගෙවීමක් සම්බන්ධයෙන් le. බර පැටවීම නිවැරදිව අර්ථකථනය නොකිරීමට හේතු වන බරපතල ගැටළු තිබේ නම්, ප්‍රතිචාරය මේ ආකාරයෙන් පෙනෙනු ඇත (උදා:
     දෝෂ කේත සහ පණිවිඩ පිළිබඳ පැහැදිලි කිරීමක් සඳහා නමුත් සාමාන්‍යයෙන්, http සඳහා මෙන්, කේත 200 ක් ධනාත්මක පිළිතුරු වන අතර 400 ඍණ වේ.

EXAMPLE: බහු මූලද්‍රව්‍ය අගයන් වෙනස් කිරීම සඳහා ප්‍රකාශනය කරන්න

ක්‍රියා පටිපාටිය තනි මූලද්‍රව්‍යයක් වෙනස් කිරීමට පෙර පෙන්වා ඇති ආකාරයට සමාන වේ. වෙනස වන්නේ ඔබ මාතෘකා වලින් element_id ඉවත් කර පසුව ගෙවීමේ ඇතුළත දත්ත ඉදිරියෙන් Element_id කට්ටලය දැක්වීමයි. පහත වාක්‍ය ඛණ්ඩය සහ ව්‍යුහය බලන්න.

විමසුම්වල ක්‍රියාකාරී වර්ගය අනුව පෙරහන් කරන්න

ගෙවීමේ ඇති පෙරහන් පරාමිතිය මඟින් මූලද්‍රව්‍යයක අපේක්ෂිත ශ්‍රිත(ය) පමණක් ආමන්ත්‍රණය කිරීමට ඉඩ සලසයි. ස්විචයක හෝ ඩිමර් එකක සක්‍රිය/අක්‍රිය කාර්යය "onoff" ලෙස හැඳින්වේ, උදාample, සහ අනුරූප පෙරහන මේ ආකාරයෙන් අර්ථ දක්වා ඇත:

එවිට පිළිතුර මේ ආකාරයට පෙනේ, උදාහරණයක් ලෙසample

වර්ග වරහන මඟින් ඔබට ශ්‍රිත කිහිපයකින්ද පෙරීමට හැකි බව පෙන්වයි, උදා

මෙවැනි පිළිතුරක් වෙත යොමු කරයි:

උපග්රන්ථය

දෝෂ කේත

MQTT සන්නිවේදනයේ දෝෂ සංඛ්‍යාත්මක කේතයක් ඇති කරයි. පහත වගුව එය බිඳ දැමීමට උපකාරී වේ.

ගෙවීමේ පරාමිතීන්

පේලෝඩ් සන්දර්භය අනුව විවිධ පරාමිතීන් සඳහා සහය දක්වයි. පහත වගුවේ දැක්වෙන්නේ කුමන මාතෘකා තුළ ඇතිවිය හැකි පරාමිති මොනවාද යන්නයි

අනුවාද සටහන්

• අනුවාදය 1.00

පුවත්:

• පළමු ප්රකාශනය

ලේඛන / සම්පත්

	DIVUS VISION API මෘදුකාංගය [pdf] පරිශීලක අත්පොත VISION API මෘදුකාංග, API මෘදුකාංග, මෘදුකාංග
	DIVUS Vision API මෘදුකාංගය [pdf] පරිශීලක මාර්ගෝපදේශය Vision API මෘදුකාංගය, දැක්ම, API මෘදුකාංගය, මෘදුකාංගය

යොමු කිරීම්

• පරිශීලක අත්පොත