ডিভাস ভিশন এপিআই সফটওয়্যার

স্পেসিফিকেশন

• পণ্য: ডিভাস ভিশন API
• প্রস্তুতকারক: DIVUS GmbH
• সংস্করণ: 1.00 REV0 1 - 20240528
• অবস্থান: Pillhof 51, Eppan (BZ), ইতালি

পণ্য তথ্য

DIVUS VISION API হল একটি সফ্টওয়্যার টুল যা ডিভাস ভিশন সিস্টেমের সাথে ইন্টারফেস করার জন্য ডিজাইন করা হয়েছে। এটি ব্যবহারকারীদের MQTT প্রোটোকল ব্যবহার করে সিস্টেমের মধ্যে বিভিন্ন উপাদান অ্যাক্সেস এবং নিয়ন্ত্রণ করতে দেয়।

FAQ

প্রশ্ন: আমি কি পিসি বা অটোমেশন প্রযুক্তি সম্পর্কে পূর্ব জ্ঞান ছাড়াই ডিভাস ভিশন 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-তে অবস্থিত এবং এই উদ্দেশ্যে বিশেষভাবে কনফিগার করা হয়েছে। যদিও VISION API প্রোগ্রামিং জ্ঞান ছাড়া ব্যবহার করা যেতে পারে, এই কার্যকারিতা উন্নত ব্যবহারকারীদের জন্য উপযুক্ত।

পূর্বশর্ত

VISION ম্যানুয়ালটিতে যেমন ব্যাখ্যা করা হয়েছে, API ব্যবহারকারীকে অবশ্যই ডিফল্টরূপে সক্রিয় করতে হবে যাতে এটি ব্যবহার করতে সক্ষম হতে পারে API অ্যাক্সেস শুধুমাত্র Api ব্যবহারকারীদের প্রমাণীকরণ ডেটা ব্যবহার করে কাজ করে। যতদূর ব্যবহারকারীর অধিকার উদ্বিগ্ন, এই কার্যকারিতার জন্য সক্রিয়করণ তখন হয় সমস্ত বা পৃথক উপাদানগুলিতে কনফিগার করা যেতে পারে। অধ্যায়.0 দেখুন। অবশ্যই, আপনার একটি ভিশন প্রকল্পেরও প্রয়োজন যেখানে আপনি বাইরে থেকে নিয়ন্ত্রণ করতে চান এমন উপাদানগুলি সম্পূর্ণরূপে কনফিগার করা হয়েছে এবং তাদের সাথে সংযোগটি সফলভাবে পরীক্ষা করা হয়েছে৷ API এর মাধ্যমে পৃথক উপাদানগুলিকে সম্বোধন করতে সক্ষম হতে, তাদের উপাদান আইডি অবশ্যই জানা থাকতে হবে: এটি উপাদানের সেটিংস ফর্মের নীচে প্রদর্শিত হয়

নিরাপত্তা

নিরাপত্তার কারণে, API অ্যাক্সেস শুধুমাত্র স্থানীয়ভাবে সম্ভব (অর্থাৎ ক্লাউডের মাধ্যমে নয়)। API অ্যাক্সেস সক্রিয় করার সময় নিরাপত্তা ঝুঁকি তাই কম। তবুও, নিরাপত্তা-প্রাসঙ্গিক উপাদানগুলিকে API অ্যাক্সেসের জন্য সক্রিয় বা স্পষ্টভাবে অস্বীকার করা উচিত নয়।

MQTT এবং এর শর্তাবলী - সংক্ষিপ্ত ব্যাখ্যা

• MQTT-তে, কেন্দ্রীভূত ব্যবস্থাপনা এবং সমস্ত বার্তা বিতরণের ভূমিকা হল ব্রোকারের। যদিও MQTT সার্ভার এবং MQTT ব্রোকার সমার্থক শব্দ নয় (সার্ভার একটি ভূমিকার জন্য একটি বিস্তৃত শব্দ যা MQTT ক্লায়েন্টরাও খেলতে পারে), যখন MQTT সার্ভারের উল্লেখ করা হয় তখন ব্রোকারকে সর্বদা এই ম্যানুয়ালটিতে বোঝানো হয়। এই ম্যানুয়ালটির প্রেক্ষাপটে DIVUS KNX IQ নিজেই MQTT ব্রোকার/MQTT সার্ভারের ভূমিকা পালন করে।
• একটি MQTT সার্ভার তথাকথিত বিষয়গুলি ব্যবহার করে: একটি শ্রেণিবদ্ধ কাঠামো যার সাথে ডেটা শ্রেণীবদ্ধ, পরিচালিত এবং প্রকাশিত হয়।
• বিষয়ের মাধ্যমে অন্যান্য অংশগ্রহণকারীদের কাছে ডেটা উপলব্ধ করাই প্রকাশনার প্রাথমিক লক্ষ্য। আপনি যদি একটি মান পরিবর্তন করতে চান, আপনি একটি প্রকাশনা অ্যাকশন ব্যবহার করে পছন্দসই মান পরিবর্তনের সাথে পছন্দসই বিষয়ে লিখুন। টার্গেট ডিভাইস বা MQTT সার্ভার কাঙ্খিত পরিবর্তন পড়ে যা এটিকে প্রভাবিত করে এবং সেই অনুযায়ী এটি গ্রহণ করে। পরিবর্তনটি প্রয়োগ করা হয়েছে তা পরীক্ষা করার জন্য, আপনি সাবস্ক্রাইব করা রিয়েল-টাইম বিষয় দেখতে পারেন যে পরিবর্তনটি সেখানে প্রতিফলিত হয়েছে কিনা – যদি সবকিছু ঠিকঠাক কাজ করে।
• ক্লায়েন্টরা তাদের আগ্রহের বিষয়গুলি নির্বাচন করে: একে সদস্যতা বলা হয়। প্রতিবার একটি বিষয়ের মধ্যে/নীচে একটি মান পরিবর্তিত হলে, সমস্ত সাবস্ক্রাইব করা ক্লায়েন্টকে অবহিত করা হয় - যেমন স্পষ্টভাবে কিছু পরিবর্তন হয়েছে কিনা বা বর্তমান মানটি কী তা জিজ্ঞাসা না করেই।
• আপনি একটি বিষয়ে ক্লায়েন্ট_আইডি নামক কোনো অনন্য স্ট্রিং প্রবেশ করে MQTT সার্ভারের সাথে একটি পৃথক যোগাযোগ চ্যানেল খুলতে পারেন (বা ঠিকানা)। মান প্রক্রিয়া করার জন্য ক্লায়েন্ট_আইডি অবশ্যই বিষয়টিতে ব্যবহার করা উচিত। এটি প্রতিটি পরিবর্তনের উত্স সনাক্ত করতে কাজ করে, যে কোনও ত্রুটির সাথে সাহায্য করে এবং অন্যান্য ক্লায়েন্টদের প্রভাবিত করে না, কারণ সার্ভার থেকে সংশ্লিষ্ট প্রতিক্রিয়াগুলি, যে কোনও ত্রুটি কোড এবং বার্তাগুলি সহ, শুধুমাত্র একই ক্লায়েন্ট_আইডি দিয়ে বিষয়টিতে পৌঁছায় (এবং এইভাবে শুধুমাত্র সেই ক্লায়েন্ট)। ক্লায়েন্ট_আইডি একটি অনন্য অক্ষর স্ট্রিং যা 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 সরাসরি অনুমতি। আপনি যদি শুধুমাত্র API অ্যাক্সেসের মাধ্যমে ডেটা পড়তে চান তবে এটি সক্ষম করার জন্য যথেষ্ট view অনুমতি
5. আপনি অ্যাক্সেস করতে চান এমন সমস্ত উপাদানগুলির জন্য একই পদ্ধতি পুনরাবৃত্তি করুন

MQTT এর মাধ্যমে সংযোগ

ভূমিকা

প্রাক্তন হিসেবেample, আমরা DIVUS KNX IQ-এর MQTT API-এর মাধ্যমে MQTT এক্সপ্লোরার নামে একটি অপেক্ষাকৃত সহজ, বিনামূল্যের সফ্টওয়্যার (অধ্যায় 1.1 দেখুন), যা উইন্ডোজ, ম্যাক এবং লিনাক্সের জন্য উপলব্ধ। MQTT এর সাথে একটি মৌলিক জ্ঞান এবং অভিজ্ঞতা নিহিত।

সংযোগের জন্য প্রয়োজনীয় ডেটা

পূর্বে উল্লিখিত হিসাবে (বিভাগ 2.1 দেখুন), API ব্যবহারকারীর ব্যবহারকারীর নাম এবং পাসওয়ার্ড প্রয়োজন। এখানে একটি ওভারview সংযোগ স্থাপনের আগে যে সমস্ত ডেটা সংগ্রহ করতে হবে:

• ব্যবহারকারীর নাম API ব্যবহারকারীর বিস্তারিত পৃষ্ঠায় পড়ুন
• API ব্যবহারকারীর বিস্তারিত পৃষ্ঠায় পাসওয়ার্ড পড়ুন
• IP ঠিকানা সাধারণ - নেটওয়ার্ক - ইথারনেট (বা সিঙ্ক্রোনাইজারের মাধ্যমে) এর অধীনে লঞ্চার সেটিংসে পড়ুন
• পোর্ট 8884 (এই বন্দরটি এই উদ্দেশ্যে সংরক্ষিত)

MQTT এক্সপ্লোরার এবং সাধারণ সদস্যতার সাথে প্রথম সংযোগ

সাধারণত, MQTT সাবস্ক্রাইব এবং প্রকাশের কার্যকলাপের মধ্যে পার্থক্য করে। MQTT এক্সপ্লোরার এটিকে সহজ করে তোলে স্বয়ংক্রিয়ভাবে সমস্ত উপলব্ধ বিষয়গুলিতে (বিষয় #) সদস্যতা নেওয়ার মাধ্যমে যখন প্রথম সংযোগ করা হয়। ফলস্বরূপ, যে গাছটি সমস্ত উপলব্ধ উপাদানের দিকে নিয়ে যায় (অর্থাৎ API ব্যবহারকারীর অ্যাক্সেস মঞ্জুর করা হয়েছে) সফল সংযোগের পরে সরাসরি MQTT এক্সপ্লোরার উইন্ডোর বাম দিকের অংশে দেখা যাবে। আরও সাবস্ক্রাইব বিষয় লিখতে বা আরও নির্দিষ্ট বিষয় দিয়ে # প্রতিস্থাপন করতে, সংযোগ উইন্ডোতে অ্যাডভান্সড-এ যান। উপরের ডানদিকে প্রদর্শিত বিষয় এই মত কিছু দেখায়:

যেখানে 7f4x0607849x444xxx256573x3x9x983 হল API ব্যবহারকারীর নাম এবং অবজেক্ট_লিস্টে সমস্ত উপলব্ধ উপাদান রয়েছে৷ এই বিষয়টি সর্বদা আপ টু ডেট রাখা হয় অর্থাৎ যে কোনও মান পরিবর্তন সেখানে রিয়েল-টাইমে প্রতিফলিত হয়৷ আপনি যদি শুধুমাত্র পৃথক উপাদানগুলিতে সদস্যতা নিতে চান তবে অবজেক্ট_লিস্ট/ এর পরে পছন্দসই উপাদানটির উপাদান আইডি লিখুন।

দ্রষ্টব্য: এই ধরনের সাবস্ক্রাইব মোটামুটিভাবে KNX প্রতিক্রিয়া ঠিকানাগুলির পিছনে যুক্তির সাথে মিলে যায়; এটি উপাদানগুলির বর্তমান অবস্থা দেখায় এবং পছন্দসই পরিবর্তনগুলি সফলভাবে প্রয়োগ করা হয়েছে কিনা তা পরীক্ষা করতে ব্যবহার করা যেতে পারে। আপনি যদি শুধুমাত্র ডেটা পড়তে চান কিন্তু পরিবর্তন না করেন তবে এই ধরনের সাবস্ক্রাইবই যথেষ্ট।

একটি একক সাধারণ উপাদান JSON স্বরলিপিতে এরকম কিছু দেখায়

দ্রষ্টব্য: সমস্ত মানগুলির উপরে দেখানো সিনট্যাক্স রয়েছে যেমন { "মান": "1" } সাবস্ক্রাইব বিষয়গুলির আউটপুট হিসাবে, যখন মানটি একটি মান পরিবর্তন করতে পেলোডে সরাসরি লেখা হয় (যেমন বিষয় প্রকাশের জন্য) - বন্ধনী এবং "মান" বাদ দেওয়া হয়েছে যেমন "অনঅফ": "1"।

উন্নত কমান্ড

ভূমিকা

সাধারণভাবে 3 ধরণের বিষয় রয়েছে:

1. উপলভ্য উপাদান দেখতে এবং রিয়েল-টাইম মান পরিবর্তন পেতে বিষয়(গুলি) সদস্যতা নিন
2. (এর উত্তর পেতে বিষয়(গুলি) সদস্যতা নিনক্লায়েন্টরা ) অনুরোধ প্রকাশ
3. তাদের মান সহ উপাদান পেতে বা সেট করতে বিষয়(গুলি) প্রকাশ করুন

আমরা পরে এখানে দেখানো সংখ্যায়ন ব্যবহার করে এই ধরণের উল্লেখ করব (যেমন টাইপ 1, 2, 3 এর বিষয়)। নিম্নলিখিত বিভাগে এবং অধ্যায়ে আরও বিশদ বিবরণ। 4.2।

উপলভ্য উপাদানগুলি দেখতে এবং রিয়েল-টাইম মূল্য পরিবর্তনগুলি পেতে বিষয়গুলি সাবস্ক্রাইব করুন

এগুলি ইতিমধ্যে বর্ণনা করা হয়েছে

ক্লায়েন্টের প্রকাশের অনুরোধের উত্তর পেতে বিষয়গুলি সাবস্ক্রাইব করুন

এই ধরনের বিষয় ঐচ্ছিক. এটি করার অনুমতি দেয়

• একটি নির্বিচারে ক্লায়েন্ট_আইডি ব্যবহার করে MQTT সার্ভারের সাথে একটি অনন্য যোগাযোগ চ্যানেল খুলুন। অধ্যায়ে যে সম্পর্কে আরো. 4.2.2
• সংশ্লিষ্ট সাবস্ক্রাইব বিষয়ে অনুরোধ প্রকাশের ফলাফল পান: ত্রুটি কোড এবং বার্তা সহ সাফল্য বা ব্যর্থতা।

উত্তর পেতে বা প্রকাশের কমান্ড সেট করার জন্য বিভিন্ন বিষয় রয়েছে। মধ্যে সংশ্লিষ্ট পার্থক্য একবার আপনি আপনার সিস্টেমের জন্য প্রয়োজনীয় বিষয়গুলি সরাসরি পেয়ে গেলে, আপনি এই পদক্ষেপটি সরানোর এবং সরাসরি প্রকাশের বিষয়গুলি ব্যবহার করার সিদ্ধান্ত নিতে পারেন৷

 তাদের মানগুলির সাথে উপাদানগুলি পেতে বা সেট করতে বিষয়গুলি প্রকাশ করুন

এই বিষয়গুলি সাবস্ক্রাইব করার জন্য অনুরূপ একটি পথ ব্যবহার করে - শুধুমাত্র পরিবর্তন হল "অনুরোধ" শব্দটি সাবস্ক্রাইব করার জন্য ব্যবহৃত "স্থিতি" এর জায়গায়। সম্পূর্ণ বিষয়ের পথগুলি পরে চ্যাপে দেখানো হয়েছে। 4.2.2\ একটি get বিষয় MQTT সার্ভারের উপাদান এবং মান পড়ার অনুরোধ করবে। পেলোডটি উপাদানগুলির ফাংশনের ধরণের উপর ভিত্তি করে ফিল্টার করতে ব্যবহার করা যেতে পারে। একটি সেট টপিক একটি উপাদানের কিছু অংশ পরিবর্তন করার জন্য অনুরোধ করবে, যেমন তার পেলোডে বিস্তারিত আছে।

কমান্ড এবং সংশ্লিষ্ট প্রতিক্রিয়াগুলির জন্য প্রিফিক্স

 সংক্ষিপ্ত ব্যাখ্যা

MQTT সার্ভারে পাঠানো সমস্ত কমান্ডের একটি সাধারণ প্রাথমিক অংশ থাকে, যথা:

বিস্তারিত ব্যাখ্যা

রিয়েল-টাইম বিষয়ের (টাইপ 1) সাধারণ উপসর্গ থাকবে (উপরে দেখুন) তারপরে

or

সেট কমান্ডের জন্য, পেলোড স্পষ্টতই প্রধান ভূমিকা পালন করে কারণ এতে কাঙ্খিত পরিবর্তনগুলি থাকবে (যেমন উপাদানের ফাংশনের জন্য পরিবর্তিত মান)। একটি সতর্কতা: আপনার টাইপ 3 কমান্ডে রিটেন বিকল্পটি কখনই ব্যবহার করবেন না কারণ এটি KNX দিকে সমস্যা সৃষ্টি করতে পারে।

EXAMPলে: একটি একক উপাদানের মূল্য(গুলি) পরিবর্তনের জন্য প্রকাশনা

সাধারণ সাবস্ক্রাইব দ্বারা দেখানো উপাদানগুলির একটির মান পরিবর্তন করতে চাওয়া সবচেয়ে সহজ।
সাধারণভাবে বলতে গেলে, MQTT-এর মাধ্যমে VISION-এর একটি ফাংশন পরিবর্তন/বদলতে 3টি ধাপ থাকে, যার সবকটিই একেবারে প্রয়োজনীয় নয়, কিন্তু তবুও আমরা বর্ণনা অনুযায়ী সেগুলি চালানোর পরামর্শ দিই।

1. যে বিষয়টিতে আমরা যে ফাংশনটি সম্পাদনা করতে চাই সেটিকে একটি কাস্টম ক্লায়েন্ট_আইডি ব্যবহার করে সাবস্ক্রাইব করা হয়েছে
2. সম্পাদনার বিষয় 1-এ নির্বাচিত ক্লায়েন্ট_আইডি ব্যবহার করে পছন্দসই পরিবর্তন সহ পেলোডের সাথে একসাথে প্রকাশিত হয়েছে।
3. পরীক্ষা করার জন্য, আপনি তারপরে বিষয়ের উত্তর দেখতে পারেন (1.) – অর্থাৎ (2.) কাজ করেছে কি না
4. সাধারণ সাবস্ক্রাইব-এ, যেখানে পরিবর্তন করা হলে সমস্ত মান আপডেট করা হয়, সবকিছু ঠিকঠাক থাকলে আপনি পছন্দসই মান পরিবর্তন(গুলি) দেখতে পাবেন।

এটি করার পদক্ষেপগুলি হল:

1. একটি ক্লায়েন্ট_আইডি নির্বাচন করুন যেমন "ডিভাস" এবং 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

খবর:

• প্রথম প্রকাশনা

দলিল/সম্পদ

	ডিভাস ভিশন এপিআই সফটওয়্যার [পিডিএফ] ব্যবহারকারী ম্যানুয়াল ভিশন এপিআই সফটওয়্যার, এপিআই সফটওয়্যার, সফটওয়্যার
	ডিভাস ভিশন API সফ্টওয়্যার [পিডিএফ] ব্যবহারকারীর নির্দেশিকা ভিশন এপিআই সফটওয়্যার, ভিশন, এপিআই সফটওয়্যার, সফটওয়্যার

তথ্যসূত্র

• ব্যবহারকারীর ম্যানুয়াল