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 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. يقينا، توهان کي هڪ VISION پروجيڪٽ جي ضرورت آهي جنهن ۾ عناصر جيڪي توهان ٻاهران ڪنٽرول ڪرڻ چاهيو ٿا مڪمل طور تي ترتيب ڏنل آهن ۽ انهن سان ڪنيڪشن ڪاميابي سان آزمائي وئي آهي. API ذريعي انفرادي عناصر کي پتو ڏيڻ جي قابل ٿي، انهن جي عنصر جي سڃاڻپ هجڻ گهرجي: هي عنصر جي سيٽنگ فارم جي تري ۾ ڏيکاريل آهي

سيڪيورٽي

سيڪيورٽي سببن لاء، API جي رسائي صرف مقامي طور تي ممڪن آهي (يعني بادل ذريعي نه). حفاظتي خطرو جڏهن API جي رسائي کي چالو ڪري ٿو تنهن ڪري گهٽ آهي. ان جي باوجود، سيڪيورٽي سان لاڳاپيل عناصر کي فعال نه ڪيو وڃي يا واضح طور تي API جي رسائي لاء رد ڪيو وڃي.

MQTT ۽ ان جا شرط - مختصر وضاحت

• MQTT ۾، سڀني پيغامن جي مرڪزي انتظام ۽ تقسيم جو ڪردار بروکر جو آهي. جيتوڻيڪ MQTT سرور ۽ MQTT بروکر مترادف نه آهن (سرور هڪ وسيع اصطلاح آهي هڪ ڪردار لاءِ جيڪو MQTT ڪلائنٽ پڻ ادا ڪري سگهن ٿا)، بروکر هميشه هن دستور ۾ هوندو آهي جڏهن MQTT سرور جو ذڪر ڪيو ويندو آهي. DIVUS KNX IQ پاڻ هن دستور جي حوالي سان MQTT بروکر / MQTT سرور جو ڪردار ادا ڪري ٿو.
• هڪ MQTT سرور نام نهاد عنوانن کي استعمال ڪري ٿو: هڪ ترتيب واري جوڙجڪ جنهن سان ڊيٽا کي درجه بندي، منظم ۽ شايع ڪيو ويندو آهي.
• اشاعت جو بنيادي مقصد آهي ڊيٽا کي ٻين شرڪت ڪندڙن کي عنوانن ذريعي دستياب ڪرڻ. جيڪڏھن توھان ھڪ قدر تبديل ڪرڻ چاھيو ٿا، توھان گھربل موضوع تي لکو ٿا گھربل قدر جي تبديلي سان، پڻ پبلشنگ ايڪشن استعمال ڪندي. ٽارگيٽ ڊيوائس يا MQTT سرور گهربل تبديلي پڙهي ٿو جيڪو ان تي اثرانداز ٿئي ٿو ۽ ان مطابق ان کي اختيار ڪري ٿو. چيڪ ڪرڻ لاءِ ته تبديلي لاڳو ڪئي وئي آهي، توهان سبسڪرائب ٿيل ريئل ٽائم موضوع ۾ ڏسي سگهو ٿا ته ڇا تبديلي اتي ظاهر ٿئي ٿي - جيڪڏهن سڀ ڪجهه ٺيڪ ٿي چڪو آهي.
• گراهڪ انهن موضوعن کي چونڊيندا آهن جيڪي انهن جي دلچسپي رکن ٿا: ان کي سبسڪرائب ڪرڻ چئبو آهي. هر دفعي ڪنهن موضوع ۾/هيٺ ڏنل قدر تبديل ٿئي ٿي، سڀ رڪنيت حاصل ڪندڙ ڪلائنٽ کي ڄاڻ ڏني وڃي ٿي - يعني واضح طور تي پڇڻ جي بغير ته ڇا ڪا شيءِ تبديل ٿي آهي يا موجوده قيمت ڇا آهي.
• توهان کوليو (يا پتو) هڪ الڳ ڪميونيڪيشن چينل MQTT سرور سان ڪنهن به منفرد اسٽرنگ کي داخل ڪري هڪ موضوع ۾ client_id نالي سان. ڪلائنٽ_id ضرور استعمال ڪيو وڃي موضوع ۾ قدرن کي پروسيس ڪرڻ لاءِ. اهو هر تبديلي جي اصليت کي سڃاڻڻ ۾ مدد ڪري ٿو، ڪنهن به غلطي سان مدد ڪري ٿو ۽ ٻين ڪلائنٽ تي اثر انداز نٿو ڪري، جيئن سرور کان لاڳاپيل جواب، ڪنهن به غلطي ڪوڊس ۽ پيغامن سميت، پڻ صرف ساڳئي ڪلائنٽ_id سان موضوع تائين پهچن ٿا (۽ اهڙيء طرح صرف اهو گراهڪ). client_id هڪ منفرد ڪردار اسٽرنگ آهي جنهن ۾ ڪردارن جي ڪنهن به ميلاپ تي مشتمل آهي 0-9، az، AZ، ​​"-"، "_".
• عام طور تي، DIVUS KNX IQ جي MQTT سرور جي رڪنيت حاصل ڪرڻ واري عنوانن ۾ ڪي ورڊ اسٽيٽس شامل آهن، جڏهن ته شايع ٿيل عنوانن ۾ لفظ جي درخواست شامل آهي. اهي اسٽيٽس پاڻمرادو اپڊيٽ ٿي ويندا آهن جيئن ئي ڪا بيروني قدر جي تبديلي ٿئي ٿي يا جيئن ئي ڪلائنٽ طرفان هڪ پبلش ذريعي ئي قدر جي تبديلي جي درخواست ڪئي وئي آهي ۽ ڪاميابيءَ سان لاڳو ڪئي وئي آهي. جيڪي پبلشنگ لاءِ آهن انهن ۾ ورهايل آهن قسم جي (درخواست/)حاصل ۽ قسم جي (درخواست/)سيٽ.
• قدر جي تبديلين ۽ ٻيا اختياري پيٽرول شامل ڪيا ويا آھن موضوع ۾ نام نهاد پيل لوڊ سان. انفرادي عناصر جا پيرا ميٽر (عنصر-id، نالو، قسم، افعال)

MQTT ۽ کلاسک ڪلائنٽ-سرور ماڊل جي وچ ۾ بنيادي فرق، جتي ڪلائنٽ درخواستون ڪري ٿو ۽ پوءِ ڊيٽا تبديل ڪري ٿو، سبسڪرائب ۽ شايع ڪرڻ جي تصورن تي مرڪز آهي. شرڪت ڪندڙ ڊيٽا شايع ڪري سگھن ٿا، ان کي ٻين لاء دستياب بڻائڻ، جيڪي جيڪڏھن دلچسپي وٺندا آھن ان کي رڪنيت حاصل ڪري سگھن ٿا. هي فن تعمير ان کي ممڪن بڻائي ٿو ڊيٽا جي مٽاسٽا کي گھٽائڻ ۽ اڃا تائين سڀني دلچسپي پارٽين کي تاريخ تائين رکو. هتي تفصيلن بابت وڌيڪ: ۽ خاص پيٽرولر (uuid، فلٽر) هتي استعمال ڪيا ويندا. جيتوڻيڪ اتي ڪيترائي اختيار آھن، پيل لوڊ ڏيکاريل آھي فارميٽ ۾ JSON طور ھن دستور ۾. JSON ڪنهن به ڍانچي جي ڊيٽا جي نمائندگي ڪرڻ لاءِ بریکٹ ۽ ڪاما استعمال ڪري ٿو ۽ اهڙيءَ طرح ڊيٽا پيڪيٽ جي سائيز کي گھٽائي ٿو منتقل ٿيڻ لاءِ. پيلي لوڊ بابت وڌيڪ تفصيل بعد ۾ دستياب ۾ ڳولهي سگهجن ٿا.

• خاص مقصدن لاءِ، فلٽر ڪرڻ ممڪن آهي فنڪشن جي قسم جي مطابق، مثال طور پتو ڏيڻ لاءِ صرف آن/آف يعني 1-bit سوئچز. پيلي لوڊ ۾ فلٽر پيٽرولر هن مقصد لاء استعمال ڪيو ويندو آهي. فلٽرنگ في الحال صرف فنڪشن جي قسم سان ممڪن آهي.
• انفرادي عناصر کي پتو ڏيڻ جي قابل ٿي، انهن جي عنصر جي سڃاڻپ گهربل آهي. اهو عنصر پراپرٽيز مينيو ۾ VISION ۾ ڳولهي سگهجي ٿو يا سڌو سنئون ڊيٽا مان پڻ پڙهي سگهجي ٿو جيڪو MQTT ايڪسپلورر جي عام سبسڪرپشن ۾ هر دستياب عنصر جي سامهون ڏيکاريل آهي (عناصر اتي الفابيٽ جي ترتيب سان عنصر جي ID سان درج ٿيل آهن).

API جي رسائي لاءِ ترتيب

API استعمال ڪندڙ جي رسائي لاءِ ويزن کي ترتيب ڏيڻ

VISION ۾ ايڊمنسٽريٽر جي حيثيت سان، وڃو ڪنفيگريشن - يوزر/API رسائي مئنيجمينٽ، ڪلڪ ڪريو Users/API رسائي تي ۽ ساڄي ڪلڪ ڪريو API يوزر تي (يا دٻايو ۽ رکو) ايڊيٽنگ ونڊو کولڻ لاءِ. اتي توهان کي اهي پيٽرول ۽ ڊيٽا ملندا

• فعال ڪريو (چڪ باڪس)
  • استعمال ڪندڙ کي پهريون ڀيرو فعال ڪيو ويو آهي هتي. ڊفالٽ بند ٿيل آهي
• يوزر نالو
  • ھي اسٽرنگ API ذريعي رسائي لاءِ گھربل آھي - ان کي ھتان نقل ڪريو
• پاسورڊ
  • ھي اسٽرنگ API ذريعي رسائي لاءِ گھربل آھي - ان کي ھتان نقل ڪريو
• اجازتون
  • VISION عناصر جي قدرن کي پڙهڻ ۽ لکڻ لاءِ ڊفالٽ حق هتي بيان ڪري سگهجن ٿا، يعني جيڪي هتي بيان ڪيا ويا آهن اهو سڀني موجوده ۽ مستقبل جي عنصرن تي لاڳو ٿئي ٿو. جيڪڏهن توهان صرف انفرادي عناصر تائين رسائي جي اجازت ڏيڻ چاهيو ٿا، توهان کي انهن ڊفالٽ حقن کي تبديل نه ڪرڻ گهرجي

انفرادي عنصرن تي اجازتون

اها صلاح ڏني وئي آهي ته توهان API کي پوري پروجيڪٽ تائين رسائي نه ڏيو، پر صرف گهربل عناصر تائين. ھيٺ ڏنل طريقي سان اڳتي وڌو

1. منتظم طور VISION ۾ لاگ ان ٿيو
2. مطلوب عنصر چونڊيو ۽ ان جي سيٽنگون مينيو کوليو (ساڄي ڪلڪ ڪريو يا دٻايو، پوء سيٽنگون)
3. مينيو ۾ داخل ٿيو جنرل - اجازتون، چالو ڪريو "اوور رائڊ ڊفالٽ اجازتون" ۽ پوءِ وڃو ذيلي شيون اجازتون، جيڪو ڏيکاري ٿو اجازتن جي ميٽرڪس.
4. هتي ڪنٽرول جي اجازت کي چالو ڪريو، جيڪو پڻ فعال ڪري ٿو view سڌو سنئون اجازت. جيڪڏهن توهان صرف API جي رسائي ذريعي ڊيٽا پڙهڻ چاهيو ٿا، اهو ڪافي آهي view اجازت.
5. ساڳئي طريقي کي ورجايو سڀني عناصر لاء جيڪو توهان رسائي ڪرڻ چاهيو ٿا

MQTT ذريعي ڪنيڪشن

تعارف

هڪ سابق جي طور تيampلي، اسان DIVUS KNX IQ جي MQTT API ذريعي رسائي ڏيکارينداسين نسبتاً سادو، مفت سافٽ ويئر جنهن کي MQTT ايڪسپلورر سڏيو ويندو آهي (ڏسو باب 1.1)، جيڪو ونڊوز، ميڪ ۽ لينڪس لاءِ دستياب آهي. هڪ بنيادي ڄاڻ ۽ تجربو MQTT سان گڏ آهي.

ڪنيڪشن لاءِ گهربل ڊيٽا

جيئن اڳ ذڪر ڪيو ويو آهي (ڏسو سيڪشن 2.1)، API استعمال ڪندڙ جو يوزر نالو ۽ پاسورڊ گهربل آهي. هتي هڪ اوور آهيview سڀني ڊيٽا جو جيڪو ڪنيڪشن قائم ٿيڻ کان اڳ گڏ ڪيو وڃي.

• استعمال ڪندڙ جو نالو API استعمال ڪندڙ جي تفصيل واري صفحي تي پڙهو
• پاسورڊ API استعمال ڪندڙ جي تفصيل واري صفحي تي پڙهو
• IP پتو پڙهو لانچر سيٽنگن ۾ جنرل جي تحت نيٽ ورڪ - ايٿرنيٽ (يا هم وقت سازي ذريعي)
• پورٽ 8884 (هي بندرگاهه هن مقصد لاءِ مخصوص آهي)

MQTT ايڪسپلورر ۽ جنرل سبسڪرائب سان پهريون ڪنيڪشن

عام طور تي، MQTT سرگرمين جي وچ ۾ فرق ڪري ٿو رڪنيت حاصل ڪرڻ ۽ شايع ڪرڻ. MQTT ايڪسپلورر ان کي آسان بڻائي ٿو پاڻمرادو سبسڪرائب ڪري سڀني دستياب عنوانن (موضوع #) جي رڪنيت حاصل ڪرڻ سان جڏهن پهريون ڪنيڪشن ٺاهيو ويو آهي. نتيجي طور، وڻ جيڪو سڀني دستياب عناصر ڏانهن وٺي ٿو (يعني API صارف جي رسائي ڏني وئي) سڌو سنئون MQTT ايڪسپلورر ونڊو جي کاٻي هٿ واري علائقي ۾ ڪامياب ڪنيڪشن کانپوءِ ڏسي سگھجي ٿو. وڌيڪ رڪنيت جا عنوان داخل ڪرڻ لاءِ يا # کي وڌيڪ مخصوص موضوع سان تبديل ڪرڻ لاءِ، ڪنيڪشن ونڊو ۾ ايڊوانسڊ ڏانھن وڃو. مٿي ساڄي پاسي ڏيکاريل موضوع ڪجهه هن طرح نظر اچي ٿو:

جتي 7f4x0607849x444xxx256573x3x9x983 API يوزرنيم آهي ۽ objects_list ۾ سڀ موجود عناصر شامل آهن. هي موضوع هميشه تازه ترين رکيو ويندو آهي يعني ڪا به قدر جي تبديلي اصل وقت ۾ ظاهر ٿيندي آهي. جيڪڏهن توهان صرف انفرادي عناصر جي رڪنيت حاصل ڪرڻ چاهيو ٿا، مطلوب عنصر جي عنصر ID داخل ڪريو objects_list/ کان پوء.

نوٽ: هن قسم جي رڪنيت تقريبن KNX تاثرات پتي جي پويان منطق سان ملندڙ آهي؛ اهو عناصر جي موجوده حيثيت ڏيکاري ٿو ۽ استعمال ڪري سگهجي ٿو ته ڇا گهربل تبديليون ڪاميابي سان لاڳو ڪيون ويون آهن. جيڪڏهن توهان صرف ڊيٽا پڙهڻ چاهيو ٿا پر ان کي تبديل نه ڪريو، هن قسم جي رڪنيت ڪافي آهي.

ھڪڙو سادو عنصر ڪجھھ ڏسڻ ۾ اچي ٿو JSON نوٽيفڪيشن ۾

نوٽ: سڀني قدرن ۾ مٿي ڏيکاريل نحو آهي مثال طور { “value”: “1” } سبسڪرائب ٿيل عنوانن جي پيداوار جي طور تي، جڏهن ته قيمت سڌي طرح پيل لوڊ ۾ لکيو ويو آهي قدر کي تبديل ڪرڻ لاءِ (يعني شايع ٿيل عنوانن لاءِ) – بریکٹس ۽ "قدر" کي ختم ڪيو ويو آھي مثال طور "onoff": "1".

ترقي يافته حڪم

تعارف

عام طور تي 3 قسم جا موضوع آهن:

1. رڪنيت حاصل ڪريو موضوع (موضوع) دستياب عناصر کي ڏسڻ ۽ حقيقي وقت جي قيمت تبديلين کي حاصل ڪرڻ لاء
2. سبسڪرائب ڪريو موضوع (موضوعن) جا جواب حاصل ڪرڻ لاءِ (گراهڪ ) درخواستون شايع ڪريو
3. پبلش ڪريو موضوع(ن) کي حاصل ڪرڻ يا سيٽ ڪرڻ لاءِ عنصرن کي سندن قدرن سان

اسان بعد ۾ هتي ڏيکاريل نمبرنگ استعمال ڪندي انهن قسمن جو حوالو ڏينداسين (مثال طور قسم 1، 2، 3 جا عنوان). وڌيڪ تفصيل هيٺ ڏنل حصن ۾ ۽ باب ۾. 4.2.

موجود عنصرن کي ڏسڻ ۽ حقيقي وقت ۾ قدري تبديليون حاصل ڪرڻ لاءِ عنوانن کي سبسڪرائب ڪريو

اهي اڳ ۾ بيان ڪيا ويا آهن

سبسڪرائب ڪريو عنوانن جا جواب حاصل ڪرڻ لاءِ ڪلائنٽ جي پبلش درخواستن جا جواب

هن قسم جا موضوع اختياري آهن. اها اجازت ڏئي ٿي

• MQTT سرور سان هڪ منفرد ڪميونيڪيشن چينل کوليو هڪ صوابديدي client_id استعمال ڪندي. انهي بابت وڌيڪ باب ۾. 4.2.2
• لاڳاپيل رڪنيت واري موضوع تي شايع ٿيل درخواستن جو نتيجو حاصل ڪريو: غلطي ڪوڊ ۽ پيغام سان ڪاميابي يا ناڪامي.

حاصل ڪرڻ لاءِ جواب حاصل ڪرڻ يا شايع ڪرڻ لاءِ ڪمانڊ ترتيب ڏيڻ لاءِ مختلف موضوع آهن. لاڳاپيل فرق ۾ هڪ دفعو توهان پنهنجي سسٽم لاءِ گهربل عنوان حاصل ڪري سگهو ٿا، توهان هن قدم کي هٽائڻ جو فيصلو ڪري سگهو ٿا ۽ سڌو سنئون عنوانن کي شايع ڪريو استعمال ڪريو.

 حاصل ڪرڻ لاءِ عنوان شايع ڪريو يا عنصرن کي انھن جي قدرن سان سيٽ ڪريو

اهي عنوان سبسڪرائب ڪرڻ لاءِ هڪ جهڙو رستو استعمال ڪندا آهن - صرف تبديلي آهي لفظ ”درخواست“ جي جاءِ تي ”اسٽيٽس“ سبسڪرائب ڪرڻ لاءِ استعمال ڪيو ويو. مڪمل موضوع جا رستا بعد ۾ باب ۾ ڏيکاريا ويا آهن. 4.2.2\ هڪ حاصل موضوع MQTT سرور جي عناصر ۽ قدر پڙهڻ جي درخواست ڪندو. فلٽر ڪرڻ لاءِ پيل لوڊ استعمال ٿي سگھي ٿو عناصر جي فنڪشن جي قسم جي بنياد تي. هڪ سيٽ موضوع هڪ عنصر جي ڪجهه حصن کي تبديل ڪرڻ جي درخواست ڪندو، جيئن تفصيلي ان جي پيلي لوڊ ۾.

اڳوڻن حڪمن ۽ لاڳاپيل جوابن لاءِ

 مختصر وضاحت

سڀئي حڪم جيڪي MQTT سرور ڏانهن موڪليا ويا آهن هڪ عام ابتدائي حصو آهي، يعني:

تفصيلي وضاحت

حقيقي وقت جي عنوانن (قسم 1) ۾ عام اڳڀرائي هوندي (مٿي ڏسو) ان کان پوءِ

or

مقرر ڪيل حڪمن لاء، پيلي لوڊ واضح طور تي بنيادي ڪردار ادا ڪري ٿو جيئن ان ۾ گهربل تبديليون شامل هونديون (يعني عنصر جي ڪمن لاء تبديل ٿيل قدر). هڪ ڊيڄاريندڙ: توهان جي ٽائپ 3 حڪمن ۾ برقرار رکڻ جو اختيار ڪڏهن به استعمال نه ڪريو ڇو ته اهو KNX پاسي تي مسئلا پيدا ڪري سگهي ٿو.

EXAMPLE: ھڪڙي عنصر جي قيمت کي تبديل ڪرڻ لاء شايع ڪريو

عام سبسڪرائب پاران ڏيکاريل عنصرن مان ھڪڙي جي قيمت کي تبديل ڪرڻ چاھيو ٿا سڀ کان آسان ڪيس.
عام طور تي ڳالهائڻ، MQTT ذريعي VISION جي فنڪشن کي تبديل ڪرڻ/سوئچ ڪرڻ 3 مرحلن تي مشتمل آهي، اهي سڀئي نه آهن جيڪي بلڪل ضروري آهن، پر ان جي باوجود اسان انهن کي بيان ڪيل طور تي عمل ڪرڻ جي سفارش ڪريون ٿا.

1. موضوع جنهن ۾ فنڪشن شامل آهي جنهن کي اسين ايڊٽ ڪرڻ چاهيون ٿا، ڪسٽم ڪلائنٽ_id استعمال ڪندي رڪنيت حاصل ڪئي وئي آهي
2. ايڊيٽنگ لاءِ موضوع 1 ۾ چونڊيل client_id استعمال ڪندي گهربل تبديلين سان گڏ پيل لوڊ سان گڏ شايع ڪيو ويو آهي.
3. چيڪ ڪرڻ لاءِ، پوءِ توھان جواب ڏسي سگھو ٿا موضوع ۾ (1.) - يعني ڇا (2.) ڪم ڪيو يا نه
4. عام سبسڪرائب ۾، جتي سڀ قيمتون اپڊيٽ ڪيون وينديون آهن جڏهن تبديليون ڪيون وينديون آهن، توهان ڏسي سگهو ٿا گهربل قدر تبديلي (جي) جيڪڏهن سڀ ڪجهه ٺيڪ ٿي چڪو آهي.

هن کي ڪرڻ لاء قدم آهن:

1. هڪ ڪلائنٽ_id چونڊيو مثال طور "Divus" ۽ ان کي رستي ۾ داخل ڪريو API يوزرنيم کان پوءِ
   MQTT سرور سان توهان جي پنهنجي ڪميونيڪيشن چينل جي رڪنيت حاصل ڪرڻ لاءِ هي مڪمل موضوع آهي. اهو سرور کي ٻڌائي ٿو جتي توهان انهن تبديلين جي جوابن جي توقع ڪندا آهيو جيڪي توهان موڪلڻ چاهيندا آهيو. نوٽ ڪريو اسٽيٽس/ سيٽ حصو جيڪو وضاحت ڪري ٿو a. ته اهو هڪ رڪنيت وارو موضوع آهي ۽ ب. ته اهو جواب حاصل ڪندو قسم جي حڪمن کي سيٽ ڪرڻ لاءِ.
2. اشاعت جو موضوع ساڳيو هوندو سواءِ اسٽيٽس-درخواست جي لفظن کي مٽائڻ جي
3. تبديلي ڇا تي مشتمل هجڻ گهرجي اهو پيل لوڊ ۾ لکيل آهي. هتي ڪجهه مثال آهنamples.
   • هڪ عنصر کي بند ڪرڻ جنهن ۾ آن/آف فنڪشن آهي (1 بٽ):
   • هڪ عنصر تي سوئچنگ جنهن ۾ آن / آف فنڪشن آهي (1 بٽ). ان کان علاوه، جيڪڏهن اهڙا ڪيترائي حڪم هڪ ئي ڪلائنٽ کان شروع ڪيا ويا آهن، uuid پيٽرولر ("منفرد ID"، عام طور تي هڪ 128-bit اسٽرنگ فارميٽ ٿيل آهي 8-4-4-4-12 عدد هيڪس) کي تفويض ڪرڻ لاءِ استعمال ڪري سگهجي ٿو. لاڳاپيل سوال جو جواب، جيئن ته هي پيٽرول - جيڪڏهن سوال ۾ موجود آهي - پڻ جواب ۾ ڳولي سگھجي ٿو.
   • سوئچ آن ڪرڻ ۽ هڪ dimmer جي چمڪ کي 50٪ تائين سيٽ ڪرڻ
   • مٿي ڏيکاريل ۽ سبسڪرائب ٿيل موضوع جو جواب (ان جو پيل لوڊ، صحيح هجڻ لاءِ) پوءِ آهي، مثال لاءِampلي.
     مٿي ڏنل جواب هڪ اڳوڻو آهيample هڪ صحيح پيل لوڊ جي صورت ۾، جيتوڻيڪ عنصر ۾ ڪو به مدھم فعل نه آهي. جيڪڏهن اتي وڌيڪ سنگين مسئلا آهن جن ۾ پيل لوڊ جي صحيح تشريح نه ڪئي وڃي، جواب هن طرح نظر ايندو (مثال طور):
     غلطي ڪوڊس ۽ پيغامن جي وضاحت لاءِ پر عام طور تي، جهڙوڪ http لاءِ، 200 ڪوڊ مثبت جواب آهن جڏهن ته 400 منفي آهن.

EXAMPLE: ڪيترن ئي عنصرن جي قدرن کي تبديل ڪرڻ لاءِ شايع ڪريو

اهو طريقو ساڳيو آهي جيڪو هڪ عنصر کي تبديل ڪرڻ کان اڳ ڏيکاريل آهي. فرق اهو آهي ته توهان عنصر_id کي عنوانن مان ڪڍي ڇڏيو ۽ پوءِ پيل لوڊ اندر ڊيٽا جي سامهون عنصر_ids جي سيٽ کي ظاهر ڪريو. ھيٺ ڏنل نحو ۽ جوڙجڪ ڏسو.

سوالن ۾ فنڪشن جي قسم ذريعي فلٽر ڪريو

پيلي لوڊ ۾ فلٽر پيراميٽر اجازت ڏئي ٿو صرف هڪ عنصر جي گهربل فنڪشن کي خطاب ڪرڻ جي. سوئچ يا ڊمر جي آن/آف فنڪشن کي ”آن آف“ چئبو آهي، مثال طورample، ۽ لاڳاپيل فلٽر هن طرح بيان ڪيو ويو آهي:

جواب وري هن طرح ڏسڻ ۾ اچي ٿو، مثال طورample

چورس بریکٹ ظاهر ڪري ٿو ته توهان پڻ ڪيترن ئي ڪمن ذريعي فلٽر ڪري سگهو ٿا، مثال طور

هن طرح هڪ جواب ڏئي ٿو:

ضميمو

غلطي جا ڪوڊ

MQTT ڪميونيڪيشن ۾ غلطيون عددي ڪوڊ جي نتيجي ۾. هيٺ ڏنل جدول ان کي ٽوڙڻ ۾ مدد ڪري ٿي.

پيلوڊ جا پيرا ميٽرز

پئلوڊ مختلف پيٽرولن کي سپورٽ ڪري ٿو حوالن جي لحاظ سان. هيٺ ڏنل جدول ڏيکاري ٿو ته ڪهڙا پيرا ميٽر ٿي سگهن ٿا ڪهڙن عنوانن ۾

ورشن نوٽس

• ورژن 1.00

خبر:

• پهرين اشاعت

دستاويز / وسيلا

	DIVUS VISION API سافٽ ويئر [pdf] استعمال ڪندڙ دستياب VISION API سافٽ ويئر، API سافٽ ويئر، سافٽ ويئر
	DIVUS Vision API سافٽ ويئر [pdf] استعمال ڪندڙ ھدايت Vision API سافٽ ويئر، Vision، API سافٽ ويئر، سافٽ ويئر

حوالو

• استعمال ڪندڙ دستي