DIVUS VISION API ဆော့ဖ်ဝဲ

သတ်မှတ်ချက်များ

• ထုတ်ကုန်- DIVUS VISION API
• ထုတ်လုပ်သူ- DIVUS GmbH
• ဗားရှင်း- 1.00 REV0 1 – 20240528
• တည်နေရာ- Pillhof 51၊ Eppan (BZ)၊ အီတလီ

ထုတ်ကုန်အချက်အလက်

DIVUS VISION API သည် DIVUS VISION စနစ်များနှင့် ချိတ်ဆက်ရန်အတွက် ဒီဇိုင်းထုတ်ထားသော ဆော့ဖ်ဝဲကိရိယာတစ်ခုဖြစ်သည်။ ၎င်းသည် အသုံးပြုသူများအား MQTT ပရိုတိုကောများကို အသုံးပြု၍ စနစ်အတွင်းရှိ အစိတ်အပိုင်းအမျိုးမျိုးကို ဝင်ရောက်ထိန်းချုပ်နိုင်စေပါသည်။

အမြဲမေးလေ့ရှိသောမေးခွန်းများ

မေး- PC သို့မဟုတ် automation နည်းပညာကို ကြိုတင်မသိဘဲ DIVUS VISION API ကို သုံးနိုင်ပါသလား။

A- API ကို ထိရောက်စွာအသုံးပြုမှုသေချာစေရန် ဤနယ်ပယ်များရှိ ယခင်အသိပညာရှိသော သုံးစွဲသူများအတွက် လက်စွဲကို အံဝင်ခွင်ကျဖြစ်စေပါသည်။

ယေဘုယျသတင်းအချက်အလက်

• DIVUS GmbH Pillhof 51 I-39057 Eppan (BZ) – အီတလီ

လည်ပတ်မှုလမ်းညွှန်ချက်များ၊ လက်စွဲစာအုပ်များနှင့် ဆော့ဖ်ဝဲများကို မူပိုင်ခွင့်ဖြင့် ကာကွယ်ထားသည်။ မူပိုင်ခွင့်ကိုလက်ဝယ်ထားသည်။ ကူးယူခြင်း၊ ပွားခြင်း၊ ဘာသာပြန်ခြင်း၊ တစ်စိတ်တစ်ပိုင်း သို့မဟုတ် တစ်စိတ်တစ်ပိုင်း ဘာသာပြန်ဆိုခြင်းကို ခွင့်မပြုပါ။ ခြွင်းချက်တစ်ခုသည် ကိုယ်ရေးကိုယ်တာအသုံးပြုရန်အတွက် ဆော့ဖ်ဝဲ၏ အရန်မိတ္တူဖန်တီးမှုတွင် အကျုံးဝင်ပါသည်။
လက်စွဲစာအုပ်သည် သတိပေးချက်မရှိဘဲ ပြောင်းလဲနိုင်သည်။ ဤစာရွက်စာတမ်းတွင်ပါရှိသော အချက်အလက်များနှင့် ပံ့ပိုးပေးထားသည့် သိုလှောင်မှုမီဒီယာတွင်ပါရှိသော အချက်အလက်များသည် အမှားအယွင်းများကင်းစင်ပြီး မှန်ကန်ကြောင်း ကျွန်ုပ်တို့အာမခံနိုင်မည်မဟုတ်ပေ။ တိုးတက်မှုအတွက် အကြံပြုချက်များနှင့် အမှားများအတွက် အရိပ်အမြွက်များကို အမြဲကြိုဆိုပါသည်။ သဘောတူညီချက်များသည် ဤလမ်းညွှန်ချက်၏ သီးခြားနောက်ဆက်တွဲများနှင့်လည်း သက်ဆိုင်ပါသည်။ ဤစာရွက်စာတမ်းရှိ သတ်မှတ်ချက်များသည် ၎င်းတို့၏ကိုယ်ပိုင်ရည်ရွယ်ချက်များအတွက် ပြင်ပအဖွဲ့အစည်းများမှ အသုံးပြုသည့် ကုန်ပစ္စည်းအမှတ်တံဆိပ်များဖြစ်နိုင်ပြီး ၎င်းတို့၏ပိုင်ရှင်များ၏အခွင့်အရေးများကို ချိုးဖောက်နိုင်သည်။ အသုံးပြုသူလမ်းညွှန်ချက်များ- ပထမအကြိမ်အသုံးမပြုမီ ဤလက်စွဲစာအုပ်ကိုဖတ်ပြီး နောင်အကိုးအကားအတွက် ဘေးကင်းသောနေရာတွင်ထားပါ။ ပစ်မှတ်အုပ်စု- PC နှင့် automation နည်းပညာဆိုင်ရာ ယခင်အသိပညာရှိသော သုံးစွဲသူများအတွက် လက်စွဲစာအုပ်ကို ရေးသားထားပါသည်။

တင်ပြချက် သဘောတူညီချက်များ

နိဒါန်း

အထွေထွေမိတ်ဆက်

ဤလက်စွဲစာအုပ်တွင် VISION API (Application Programming Interface) - VISION ကို ပြင်ပစနစ်များမှ ကိုင်တွယ်ဖြေရှင်းနိုင်ပြီး ထိန်းချုပ်နိုင်သည့် အင်တာဖေ့စ်တစ်ခုဖြစ်သည်။
လက်တွေ့ အသုံးအနှုန်းများတွင်၊ ဤကဲ့သို့သော စနစ်များကို သင်အသုံးပြုနိုင်သည်ဟု ဆိုလိုသည်။

• MQTT Explorer (https://www.microsoft.com/store/… – စမ်းသပ်ရန်)၊
• အိမ်အကူ (https://www.home-assistant.io/) သို့မဟုတ်
• Node-RED (https://nodered.org/)

VISION မှ စီမံခန့်ခွဲသည့် အစိတ်အပိုင်းများကို ထိန်းချုပ်ရန် သို့မဟုတ် ၎င်းတို့၏ အခြေအနေကို ဖတ်ရှုပါ။ တစ်ဦးချင်းစီ လုပ်ဆောင်ချက်များ သို့မဟုတ် လုပ်ဆောင်ချက်အစုံများကို ကိုင်တွယ်ဖြေရှင်းရန် သို့မဟုတ် ၎င်းတို့အား ပြောင်းလဲမှုများအကြောင်း အသိပေးရန် ခေါင်းစဉ်များကို အသုံးပြုသည့် MQTT ပရိုတိုကောမှတစ်ဆင့် ဝင်ရောက်ခြင်းနှင့် ဆက်သွယ်ရေးသည် ဖြစ်ပေါ်လာသည်။ MQTT ဆာဗာ (ပွဲစား) အား လုံခြုံရေးနှင့် ပါဝင်သူများထံသို့ မက်ဆေ့ချ်များ စီမံခန့်ခွဲခြင်း/ဖြန့်ဝေခြင်းကို ကိုင်တွယ်ပေးသည့် ဤရည်ရွယ်ချက်အတွက် အသုံးပြုပါသည်။ ဤကိစ္စတွင်၊ MQTT ဆာဗာသည် DIVUS KNX IQ ပေါ်တွင် တိုက်ရိုက်တည်ရှိပြီး ဤရည်ရွယ်ချက်အတွက် အထူးစီစဉ်ထားသည်။ VISION API ကို ပရိုဂရမ်းမင်း မသိဘဲ အသုံးပြုနိုင်သော်လည်း၊ ဤလုပ်ဆောင်ချက်သည် အဆင့်မြင့်အသုံးပြုသူများအတွက် သင့်လျော်ပါသည်။

လိုအပ်ချက်

VISION လက်စွဲတွင် ရှင်းပြထားသည့်အတိုင်း API အသုံးပြုသူသည် ၎င်းကိုအသုံးပြုနိုင်စေရန်အတွက် API အသုံးပြုသူသည် Api အသုံးပြုသူများ စစ်မှန်ကြောင်းအထောက်အထားစိစစ်ခြင်းဒေတာကို အသုံးပြု၍သာ လုပ်ဆောင်နိုင်စေရန်အတွက် မူရင်းအတိုင်း အသက်သွင်းရမည်ဖြစ်သည်။ အသုံးပြုသူ၏အခွင့်အရေးများကို အလေးထားသလောက်၊ ဤလုပ်ဆောင်နိုင်စွမ်းအတွက် အသက်သွင်းခြင်းကို ထို့နောက် အစိတ်အပိုင်းအားလုံး သို့မဟုတ် တစ်ခုချင်းစီတွင် သော်လည်းကောင်း စီစဉ်သတ်မှတ်နိုင်သည်။ Chap.0 ကိုကြည့်ပါ။ ပြင်ပမှ သင်ထိန်းချုပ်လိုသော အစိတ်အပိုင်းများကို အပြည့်အဝပြင်ဆင်ပြီး ၎င်းတို့နှင့်ချိတ်ဆက်မှုကို အောင်မြင်စွာစမ်းသပ်ပြီးဖြစ်သည့် VISION ပရောဂျက်တစ်ခုလည်း လိုအပ်ပါသည်။ API မှတစ်ဆင့် ဒြပ်စင်တစ်ခုစီကို ကိုင်တွယ်ဖြေရှင်းနိုင်စေရန် ၎င်းတို့၏ဒြပ်စင် ID ကို သိထားရမည်- ၎င်းကို ဒြပ်စင်၏ဆက်တင်ပုံစံ၏အောက်ခြေတွင် ပြသထားသည်။

လုံခြုံရေး

လုံခြုံရေးအကြောင်းပြချက်များအတွက် API အသုံးပြုခွင့်သည် စက်တွင်းတွင်သာ ဖြစ်နိုင်သည် (ဆိုလိုသည်မှာ cloud မှတဆင့်မဟုတ်)။ ထို့ကြောင့် 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 ဆာဗာ၏ စာရင်းသွင်းအကြောင်းအရာများတွင် သော့ချက်စာလုံးအခြေအနေပါဝင်ပြီး ထုတ်ဝေသည့်အကြောင်းအရာများတွင် သော့ချက်စာလုံးတောင်းဆိုမှုပါရှိသည်။ ပြင်ပတန်ဖိုးပြောင်းလဲမှုတစ်ခု သို့မဟုတ် ထုတ်ဝေမှုမှတစ်ဆင့် သုံးစွဲသူကိုယ်တိုင်က တန်ဖိုးပြောင်းလဲမှုတစ်ခု တောင်းဆိုပြီးသည်နှင့် အောင်မြင်စွာ အသုံးချပြီးသည်နှင့် အဆင့်အတန်းရှိသော ၎င်းတို့ကို အလိုအလျောက် အပ်ဒိတ်လုပ်မည်ဖြစ်သည်။ ထုတ်ဝေရန်အတွက် အမျိုးအစား (တောင်းဆိုချက်/)get နှင့် အမျိုးအစား (တောင်းဆိုချက်/) သတ်မှတ် ဟူ၍ ခွဲခြားထားသည်။
• တန်ဖိုးပြောင်းလဲမှုများနှင့် အခြားရွေးချယ်နိုင်သော ကန့်သတ်ဘောင်များကို payload ဟုခေါ်သည့် အကြောင်းအရာတွင် ထည့်သွင်းထားသည်။ ဒြပ်စင်တစ်ခုချင်းစီ၏ ကန့်သတ်ချက်များ (ဒြပ်စင် ID၊ အမည်၊ အမျိုးအစား၊ လုပ်ဆောင်ချက်များ)

MQTT နှင့် သုံးစွဲသူက တောင်းဆိုပြီးနောက် ဒေတာကို ပြောင်းလဲသည့် ဂန္တဝင် ဖောက်သည်-ဆာဗာ မော်ဒယ်နှင့် MQTT အကြား အဓိက ကွာခြားချက်မှာ စာရင်းသွင်းခြင်းနှင့် ထုတ်ဝေခြင်းဆိုင်ရာ သဘောတရားများအပေါ် အဓိကထားခြင်းဖြစ်သည်။ ပါဝင်သူများသည် ဒေတာများကို ထုတ်ဝေနိုင်ပြီး စိတ်ဝင်စားပါက ၎င်းကို စာရင်းသွင်းနိုင်သူ အခြားသူများထံ ရရှိနိုင်စေမည်ဖြစ်သည်။ ဤဗိသုကာလက်ရာသည် ဒေတာဖလှယ်မှုကို လျှော့ချနိုင်စေပြီး စိတ်ဝင်စားသူအားလုံးကို အပ်ဒိတ်ဖြစ်စေသည်။ ဤနေရာတွင်အသေးစိတ်အချက်များအကြောင်း နောက်ထပ်နှင့် အထူးကန့်သတ်ဘောင်များ (uuid၊ စစ်ထုတ်မှုများ) ကို ဤနေရာတွင် အသုံးပြုရမည်ဖြစ်သည်။ ရွေးချယ်စရာများစွာရှိသော်လည်း payload ကို ဤလက်စွဲစာအုပ်တွင် JSON အဖြစ် ဖော်မတ်ပြထားသည်။ JSON သည် မည်သည့်ဖွဲ့စည်းပုံ၏ဒေတာကိုကိုယ်စားပြုရန် ကွင်းစကွင်းပိတ်နှင့် ကော်မာကိုအသုံးပြုပြီး ပေးပို့ရမည့်ဒေတာပက်ကေ့ခ်ျများ၏အရွယ်အစားကို လျှော့ချပေးသည်။ payloads များအကြောင်း နောက်ထပ်အသေးစိတ်အချက်အလက်များကို နောက်ပိုင်းတွင် manual တွင်တွေ့နိုင်ပါသည်။

• အထူးရည်ရွယ်ချက်များအတွက်၊ ဥပမာ- အဖွင့်/အပိတ်များသာ ကိုင်တွယ်ဖြေရှင်းရန်၊ ဥပမာ- 1-bit ခလုတ်များကို အမျိုးအစားအလိုက် စစ်ထုတ်နိုင်သည်။ payload ရှိ filters parameter ကို ဤရည်ရွယ်ချက်အတွက် အသုံးပြုပါသည်။ စစ်ထုတ်ခြင်းကို လက်ရှိတွင် လုပ်ဆောင်ချက်အမျိုးအစားအလိုက်သာ လုပ်ဆောင်နိုင်သည်။
• ဒြပ်စင်တစ်ခုချင်းစီကို ကိုင်တွယ်ဖြေရှင်းနိုင်ရန် ၎င်းတို့၏ အစိတ်အပိုင်း ID လိုအပ်ပါသည်။ ၎င်းကို MQTT Explorer ၏ ယေဘူယျစာရင်းသွင်းမှုတွင် ရရှိနိုင်သောဒြပ်စင်တစ်ခုစီ၏ရှေ့တွင် ပြသထားသည့် ဒေတာများမှ တိုက်ရိုက်ဖတ်ရှုနိုင်သည် (VISION) တွင် တွေ့ရှိနိုင်သည် (ဒြပ်စင် ID ဖြင့် အက္ခရာစဉ်အလိုက် ဖော်ပြထားသည်)။

API သုံးစွဲခွင့်အတွက် ဖွဲ့စည်းမှု

API အသုံးပြုသူဝင်ရောက်ခွင့်အတွက် Vision ကိုပြင်ဆင်ခြင်း။

စီမံခန့်ခွဲသူအနေဖြင့် VISION တွင်၊ Configuration – User/API Access Management သို့သွားပါ၊ Users/API access ကိုနှိပ်ပြီး တည်းဖြတ်ဝင်းဒိုးကိုဖွင့်ရန် API အသုံးပြုသူပေါ်တွင် right-click (သို့မဟုတ် ဖိထားပါ)။ ထိုနေရာတွင် သင်သည် ဤသတ်မှတ်ချက်များနှင့် ဒေတာများကို တွေ့လိမ့်မည်။

• ဖွင့်ပါ (အမှတ်ခြစ်ရန်နေရာ)
  • အသုံးပြုသူကို ဤနေရာတွင် ဦးစွာဖွင့်ထားသည်။ ပုံသေကို ပိတ်ထားသည်။
• အသုံးပြုသူအမည်
  • API မှတစ်ဆင့် ဝင်ရောက်အသုံးပြုရန်အတွက် ဤစာကြောင်းကို လိုအပ်သည် - ၎င်းကို ဤနေရာမှ ကူးယူပါ။
• စကားဝှက်
  • API မှတစ်ဆင့် ဝင်ရောက်အသုံးပြုရန်အတွက် ဤစာကြောင်းကို လိုအပ်သည် - ၎င်းကို ဤနေရာမှ ကူးယူပါ။
• ခွင့်ပြုချက်များ
  • VISION ဒြပ်စင်များ၏ တန်ဖိုးများကို ဖတ်ရှုခြင်းနှင့် ရေးသားခြင်းအတွက် မူရင်းအခွင့်အရေးများကို ဤနေရာတွင် သတ်မှတ်နိုင်သည်၊ ဆိုလိုသည်မှာ ဤနေရာတွင် သတ်မှတ်ထားသောအရာသည် လက်ရှိနှင့် အနာဂတ် ဒြပ်စင်များအားလုံးနှင့် သက်ဆိုင်ပါသည်။ တစ်သီးပုဂ္ဂလဒြပ်စင်များကိုသာ ဝင်ရောက်ခွင့်ပြုလိုပါက၊ ဤမူလအခွင့်အရေးများကို မပြောင်းသင့်ပါ။

သီးသန့်ဒြပ်စင်များပေါ်တွင် ခွင့်ပြုချက်များ

ပရောဂျက်တစ်ခုလုံးကို API ဝင်ခွင့်မပေးဘဲ လိုချင်သောဒြပ်စင်များကိုသာ ခွင့်ပြုရန် အကြံပြုထားသည်။ အောက်ပါအတိုင်းလုပ်ဆောင်ပါ။

1. စီမံခန့်ခွဲသူအဖြစ် VISION သို့ ဝင်ရောက်ပါ။
2. လိုချင်သောဒြပ်စင်ကိုရွေးချယ်ပြီး၎င်း၏ဆက်တင်များမီနူးကိုဖွင့်ပါ (ညာဖက်ကလစ်နှိပ်ပါ သို့မဟုတ် ဆက်နှိပ်ပါ၊ ထို့နောက် ဆက်တင်များ)
3. မီနူးထည့်သွင်းမှု အထွေထွေ- ခွင့်ပြုချက်များအောက်တွင်၊ "မူရင်းခွင့်ပြုချက်များကို လွှမ်းမိုးရန်" ကိုဖွင့်ပြီး ခွင့်ပြုချက်မက်ထရစ်ကိုပြသသည့်အရာခွဲခွင့်ပြုချက်များသို့ သွားပါ။
4. ထိန်းချုပ်ခွင့်ကို ဤနေရာတွင် ဖွင့်ပါ၊ ၎င်းကိုလည်း ဖွင့်ပေးသည်။ view တိုက်ရိုက်ခွင့်ပြုချက်။ API access မှတဆင့် ဒေတာများကိုသာ ဖတ်လိုပါက၊ ၎င်းကို enable လုပ်ရန် လုံလောက်ပါသည်။ view ခွင့်ပြုချက်။
5. သင်ဝင်ရောက်လိုသော အစိတ်အပိုင်းအားလုံးအတွက် တူညီသောလုပ်ငန်းစဉ်ကို ပြန်လုပ်ပါ။

MQTT မှတဆင့်ချိတ်ဆက်မှု

နိဒါန်း

ရည်းစားဟောင်းအဖြစ်ampထို့ကြောင့်၊ Windows၊ Mac နှင့် Linux အတွက်ရရှိနိုင်သည့် အတော်လေးရိုးရှင်းပြီး MQTT Explorer (အခန်း 1.1 ကိုကြည့်ပါ) ဟုခေါ်သော ရိုးရှင်းပြီး အခမဲ့ဆော့ဖ်ဝဲလ်ဖြင့် DIVUS KNX IQ ၏ MQTT API မှတစ်ဆင့် ဝင်ရောက်ကြည့်ရှုမှုကို သရုပ်ပြပါမည်။ MQTT တွင် အခြေခံ ဗဟုသုတနှင့် အတွေ့အကြုံကို ဆိုလိုပါသည်။

ချိတ်ဆက်မှုအတွက် လိုအပ်သောဒေတာ

အစောပိုင်းတွင်ဖော်ပြထားသည့်အတိုင်း (အပိုင်း 2.1 ကိုကြည့်ပါ) API အသုံးပြုသူ၏အသုံးပြုသူအမည်နှင့် စကားဝှက် လိုအပ်ပါသည်။ ဒီမှာ တစ်ခုပြီးတစ်ခုview ချိတ်ဆက်မှုတစ်ခုမစတင်မီ စုဆောင်းရမည့်ဒေတာအားလုံး၏-

• အသုံးပြုသူအမည် API အသုံးပြုသူ၏အသေးစိတ်စာမျက်နှာတွင် ဖတ်ရှုပါ။
• စကားဝှက်ကို API အသုံးပြုသူ၏အသေးစိတ်စာမျက်နှာတွင်ဖတ်ပါ။
• IP လိပ်စာကို General – Network – Ethernet (သို့မဟုတ် Synchronizer မှတဆင့်) အောက်ရှိ launcher ဆက်တင်များတွင် ဖတ်ပါ။
• Port 8884 (ဤဆိပ်ကမ်းကို ဤရည်ရွယ်ချက်အတွက် သီးသန့်ထားပါသည်)

MQTT စူးစမ်းရှာဖွေသူနှင့် အထွေထွေစာရင်းသွင်းမှုဖြင့် ပထမဆုံးချိတ်ဆက်ပါ။

ပုံမှန်အားဖြင့်၊ MQTT သည် စာရင်းသွင်းခြင်းနှင့် ထုတ်ဝေခြင်းဆိုင်ရာ လုပ်ဆောင်ချက်များကို ခွဲခြားသည်။ MQTT Explorer သည် ပထမဆုံးချိတ်ဆက်မှုပြုလုပ်သောအခါတွင် ရရှိနိုင်သောအကြောင်းအရာအားလုံး (topic #) ကို အလိုအလျောက်စာရင်းသွင်းခြင်းဖြင့် ၎င်းကိုရိုးရှင်းစေသည်။ ရလဒ်အနေဖြင့်၊ ရရှိနိုင်သောဒြပ်စင်များအားလုံးကိုဦးတည်သောသစ်ပင် (ဆိုလိုသည်မှာ API အသုံးပြုသူဝင်ရောက်ခွင့်ပေးထားသည်) အောင်မြင်စွာချိတ်ဆက်ပြီးနောက် MQTT Explorer ဝင်းဒိုး၏ဘယ်ဘက်ခြမ်းတွင် တိုက်ရိုက်တွေ့မြင်နိုင်ပါသည်။ နောက်ထပ်စာရင်းသွင်းသည့်အကြောင်းအရာများကို ထည့်သွင်းရန် သို့မဟုတ် # ကို ပိုမိုတိကျသောအကြောင်းအရာဖြင့် အစားထိုးရန်၊ ချိတ်ဆက်မှုဝင်းဒိုးရှိ Advanced သို့ သွားပါ။ ညာဘက်အပေါ်ထောင့်တွင် ပြထားသည့် အကြောင်းအရာသည် ဤကဲ့သို့ ဖြစ်သည်-

7f4x0607849x444xxx256573x3x9x983 သည် API အသုံးပြုသူအမည်နှင့် objects_list တွင် ရရှိနိုင်သောဒြပ်စင်များ အားလုံးကို ပါ၀င်ပါသည်။ ဤအကြောင်းအရာသည် အမြဲတမ်းနောက်ဆုံးပေါ်နေပါသည် ဆိုလိုသည်မှာ တန်ဖိုးပြောင်းလဲမှုမှန်သမျှသည် ထိုနေရာတွင် အချိန်နှင့်တပြေးညီ ထင်ဟပ်နေပါသည်။ ဒြပ်စင်တစ်ခုစီသို့သာ စာရင်းသွင်းလိုပါက၊ objects_list/ ပြီးနောက် လိုချင်သောဒြပ်စင် ID ကို ထည့်ပါ။

မှတ်ချက်- ဤစာရင်းသွင်းမှုအမျိုးအစားသည် KNX တုံ့ပြန်ချက်လိပ်စာများ၏ နောက်ကွယ်ရှိ ယုတ္တိဗေဒနှင့် ဆက်စပ်နေပါသည်။ ၎င်းသည် ဒြပ်စင်များ၏ လက်ရှိ အခြေအနေကို ပြသပြီး အလိုရှိသော အပြောင်းအလဲများကို အောင်မြင်စွာ အသုံးချခြင်း ရှိ၊ မရှိ စစ်ဆေးရန် အသုံးပြုနိုင်သည်။ ဒေတာများကိုသာ ဖတ်ချင်သော်လည်း မပြောင်းလဲပါက၊ ဤစာရင်းသွင်းမှုအမျိုးအစားသည် လုံလောက်ပါသည်။

ရိုးရှင်းသောဒြပ်စင်တစ်ခုသည် JSON သင်္ကေတတွင် ဤအရာကဲ့သို့ တစ်ခုခုကို မြင်တွေ့ရသည်။

မှတ်ချက်- တန်ဖိုးများအားလုံးတွင် အထက်တွင်ပြသထားသည့် syntax ပါရှိသည် ဥပမာ- { “value”: “1” } သည် စာရင်းသွင်းအကြောင်းအရာများ၏ အထွက်အဖြစ်၊ တန်ဖိုးကို တန်ဖိုးတစ်ခုပြောင်းလဲရန်အတွက် payload တွင် တိုက်ရိုက်ရေးထားသော်လည်း တန်ဖိုး (ဆိုလိုသည်မှာ ထုတ်ဝေသည့်အကြောင်းအရာများအတွက်) – ကွင်းပိတ်များနှင့် “တန်ဖိုး” ကို ချန်လှပ်ထားပါသည် ဥပမာ- “onoff”: “1”။

အဆင့်မြင့်အမိန့်များ

နိဒါန်း

ယေဘူယျအားဖြင့် ခေါင်းစဉ် 3 မျိုးရှိသည်။

1. ရနိုင်သောဒြပ်စင်များကိုကြည့်ရှုရန်နှင့် အချိန်နှင့်တပြေးညီ တန်ဖိုးပြောင်းလဲမှုများရယူရန် ခေါင်းစဉ်(များ)ကို စာရင်းသွင်းပါ။
2. အဖြေများရယူရန် ခေါင်းစဉ်(များ) စာရင်းသွင်းပါ (ဖောက်သည်များ ) တောင်းဆိုချက်များကို ထုတ်ပြန်ပါ။
3. ခေါင်းစဉ်(များ)ကို ရယူရန် သို့မဟုတ် ၎င်းတို့၏တန်ဖိုးများဖြင့် အစိတ်အပိုင်းများကို သတ်မှတ်ရန် ထုတ်ဝေပါ။

ဤနေရာတွင် ဖော်ပြထားသော နံပါတ်များကို အသုံးပြု၍ နောက်ပိုင်းတွင် ဤအမျိုးအစားများကို ရည်ညွှန်းပါမည် (ဥပမာ အမျိုးအစား 1၊ 2၊ 3)။ နောက်ထပ်အသေးစိတ်အချက်အလက်များကို အောက်ပါကဏ္ဍများနှင့် အခန်းတွင် ဖော်ပြထားသည်။ ၄.၂။

ရနိုင်သောဒြပ်စင်များကိုကြည့်ရှုရန်နှင့် အချိန်နှင့်တပြေးညီ တန်ဖိုးပြောင်းလဲမှုများရယူရန် ခေါင်းစဉ်များကို စာရင်းသွင်းပါ

ဒါတွေကို ဖော်ပြပြီးသားပါ။

ဖောက်သည်၏ထုတ်ဝေမှုတောင်းဆိုချက်များအတွက် အဖြေများရယူရန် ခေါင်းစဉ်များကို စာရင်းသွင်းပါ

ဤအကြောင်းအရာမျိုးသည် စိတ်ကြိုက်ရွေးချယ်နိုင်သည်။ လုပ်ဖို့ခွင့်ပြုပါတယ်။

• မတရားသော client_id ကိုအသုံးပြုခြင်းဖြင့် MQTT ဆာဗာနှင့် ထူးခြားသောဆက်သွယ်ရေးလမ်းကြောင်းကိုဖွင့်ပါ။ အဲဒီအကြောင်းတွေကို အခန်းထဲမှာ ထပ်ပြီးဖော်ပြထားပါတယ်။ ၄.၂.၂
• သက်ဆိုင်ရာ စာရင်းသွင်းမှု ခေါင်းစဉ်တွင် ထုတ်ဝေရန် တောင်းဆိုမှုများ၏ ရလဒ်ကို ရယူပါ- အမှားကုဒ်နှင့် မက်ဆေ့ချ်ဖြင့် အောင်မြင်မှု သို့မဟုတ် ကျရှုံးမှု။

အဖြေများရယူရန် သို့မဟုတ် ထုတ်ဝေရန် ညွှန်ကြားချက်များ သတ်မှတ်ရန် မတူညီသော အကြောင်းအရာများ ရှိပါသည်။ သက်ဆိုင်သောကွာခြားချက် သင့်စနစ်အတွက် လိုအပ်သောအကြောင်းအရာများကို မှန်ကန်စွာရရှိပြီးသည်နှင့် သင်သည် ဤအဆင့်ကို ဖယ်ရှားရန်နှင့် ထုတ်ဝေမည့်အကြောင်းအရာများကို တိုက်ရိုက်အသုံးပြုရန် ဆုံးဖြတ်နိုင်ပါသည်။

 ရယူရန် သို့မဟုတ် ၎င်းတို့၏တန်ဖိုးများနှင့်အတူ ဒြပ်စင်များ သတ်မှတ်ရန် အကြောင်းအရာများကို ထုတ်ပြန်ပါ

ဤအကြောင်းအရာများသည် စာရင်းသွင်းရန်လမ်းကြောင်းနှင့် ဆင်တူသောလမ်းကြောင်းကိုအသုံးပြုသည် - တစ်ခုတည်းသောပြောင်းလဲမှုမှာ စာရင်းသွင်းရန်အသုံးပြုသည့် "အခြေအနေ" အစား "တောင်းဆိုမှု" ဟူသောစကားလုံးဖြစ်သည်။ ပြီးပြည့်စုံသော အကြောင်းအရာလမ်းကြောင်းများကို နောက်ပိုင်းတွင် အခန်းတွင် ပြထားသည်။ 4.2.2\ ခေါင်းစဉ်တစ်ခုသည် MQTT ဆာဗာ၏ အစိတ်အပိုင်းများနှင့် တန်ဖိုးများကို ဖတ်ရန် တောင်းဆိုလိမ့်မည်။ ဒြပ်စင်များ၏ လုပ်ဆောင်ချက်အမျိုးအစားအပေါ် အခြေခံ၍ ပေးဆောင်မှုအား စစ်ထုတ်ရန် အသုံးပြုနိုင်သည်။ သတ်မှတ်အကြောင်းအရာတစ်ခုသည် ၎င်း၏ payload တွင်အသေးစိတ်ပါရှိသည့်အတိုင်း ဒြပ်စင်တစ်ခု၏ အစိတ်အပိုင်းအချို့ကို ပြောင်းလဲရန် တောင်းဆိုပါမည်။

ညွှန်ကြားချက်များနှင့် သက်ဆိုင်သော တုံ့ပြန်မှုများအတွက် ရှေ့ပြေး

 အတိုချုံးရှင်းပြချက်

MQTT ဆာဗာသို့ ပို့လိုက်သော အမိန့်များအားလုံးတွင် ဘုံကနဦး အစိတ်အပိုင်းတစ်ခု ရှိသည်၊ ဆိုလိုသည်မှာ-

အသေးစိတ်ရှင်းပြချက်

အချိန်နှင့်တပြေးညီ အကြောင်းအရာများ (အမျိုးအစား 1) တွင် ယေဘူယျရှေ့ဆက် (အထက်တွင်ကြည့်ပါ) ပါရှိမည်ဖြစ်ပြီး ၎င်းနောက်တွင် လိုက်ပါမည်ဖြစ်သည်။

or

set commands များအတွက်၊ payload သည် လိုချင်သောပြောင်းလဲမှုများ (ဆိုလိုသည်မှာ element ၏လုပ်ဆောင်ချက်များအတွက်ပြောင်းလဲထားသောတန်ဖိုးများ) ပါဝင်သောကြောင့် payload တွင်အဓိကအခန်းကဏ္ဍမှသိသာထင်ရှားပါသည်။ သတိပေးချက်- KNX ဘက်တွင် ပြဿနာများဖြစ်စေနိုင်သောကြောင့် သင့်အမျိုးအစား 3 ညွှန်ကြားချက်များတွင် ထိန်းသိမ်းခြင်းရွေးချယ်ခွင့်ကို ဘယ်တော့မှ မသုံးပါနှင့်။

EXAMPLE- ဒြပ်စင်တစ်ခု၏ တန်ဖိုး(များ)ကို ပြောင်းလဲရန်အတွက် ထုတ်ပြန်ခြင်း

အရိုးရှင်းဆုံး ကိစ္စမှာ ယေဘူယျ စာရင်းသွင်းမှုမှ ပြထားသော ဒြပ်စင်တစ်ခု၏ တန်ဖိုးကို ပြောင်းလဲလိုခြင်း ဖြစ်သည်။
ယေဘူယျအားဖြင့်ပြောရလျှင်၊ MQTT မှတစ်ဆင့် VISION ၏လုပ်ဆောင်ချက်ကိုပြောင်းလဲခြင်း/ပြောင်းခြင်းတွင် အဆင့် 3 ဆင့်ပါဝင်ပြီး အားလုံးသည် လုံးဝမလိုအပ်ဘဲ၊ သို့သော်လည်း ဖော်ပြထားသည့်အတိုင်း လုပ်ဆောင်ရန် ကျွန်ုပ်တို့ အကြံပြုပါသည်။

1. ကျွန်ုပ်တို့ တည်းဖြတ်လိုသော လုပ်ဆောင်ချက်ပါရှိသော အကြောင်းအရာသည် စိတ်ကြိုက် client_id ကို အသုံးပြု၍ စာရင်းသွင်းထားသည်။
2. တည်းဖြတ်ခြင်းအတွက် ခေါင်းစဉ်အား 1 တွင်ရွေးချယ်ထားသော client_id ကို အသုံးပြု၍ လိုချင်သောအပြောင်းအလဲများနှင့်အတူ payload နှင့်အတူ ထုတ်ဝေထားသည်။
3. စစ်ဆေးရန်၊ ခေါင်းစဉ် (1.) တွင် အဖြေကို ကြည့်ရှုနိုင်သည် – ဆိုလိုသည်မှာ (2.) အလုပ်လုပ်သည်ဖြစ်စေ၊
4. ယေဘူယျစာရင်းသွင်းမှုတွင်၊ အပြောင်းအလဲများပြုလုပ်သည့်အခါ တန်ဖိုးအားလုံးကို အပ်ဒိတ်လုပ်သည့်အခါ၊ အရာအားလုံး အဆင်ပြေသွားပါက လိုချင်သောတန်ဖိုးပြောင်းလဲမှု(များ) ကို သင်တွေ့မြင်နိုင်ပါသည်။

ထိုသို့လုပ်ဆောင်ရန် အဆင့်များမှာ-

1. client_id ဥပမာ "Divus" ကိုရွေးပြီး API အသုံးပြုသူအမည်ပြီးနောက် လမ်းကြောင်းတွင် ထည့်သွင်းပါ။
   ဤသည်မှာ MQTT ဆာဗာဖြင့် သင့်ကိုယ်ပိုင်ဆက်သွယ်ရေးချန်နယ်သို့ စာရင်းသွင်းခြင်းအတွက် ပြီးပြည့်စုံသောအကြောင်းအရာဖြစ်သည်။ ၎င်းသည် သင်ပေးပို့လိုသော အပြောင်းအလဲများအတွက် တုံ့ပြန်မှုများကို သင်မျှော်လင့်ထားသည့်နေရာ ဆာဗာအား ပြောပြသည်။ a ကိုသတ်မှတ်ပေးသော status/set အပိုင်းကိုသတိပြုပါ။ စာရင်းသွင်းထားသောအကြောင်းအရာနှင့် b ဖြစ်သည် ။ အမျိုးအစား commands များကို သတ်မှတ်ရန် အဖြေများ ရရှိမည်ဖြစ်သည်။
2. ထုတ်ဝေမှုအကြောင်းအရာသည် အခြေအနေတောင်းဆိုချက်သော့ချက်စာလုံးများကို ပြောင်းခြင်းမှလွဲ၍ တူညီပါမည်။
3. ပြောင်းလဲသင့်သည်များကို payload တွင်ရေးထားသည်။ ဒါကတော့ ရည်းစားဟောင်းတွေပါ။amples
   • အဖွင့်/အပိတ် လုပ်ဆောင်ချက် (1 ဘစ်) ပါသော ဒြပ်စင်ကို ပိတ်ခြင်း-
   • အဖွင့်/အပိတ် လုပ်ဆောင်ချက် (1 ဘစ်) ပါသည့် ဒြပ်စင်တစ်ခုကို ပြောင်းနေသည်။ ထို့အပြင်၊ ထိုကဲ့သို့သော command အများအပြားကို တူညီသော client မှစတင်ပါက၊ uuid ကန့်သတ်ဘောင် (“ထူးခြားသော ID” သည် အများအားဖြင့် 128-8-4-4-4 ဂဏန်း hex အဖြစ်ဖော်မတ်ထားသည့် 12-bit string တစ်ခုဖြစ်သည်) ကို တာဝန်ပေးရန်အတွက် အသုံးပြုနိုင်သည်။ ဤ parameter သည် — query တွင်ရှိနေပါက- တုံ့ပြန်မှုတွင် သက်ဆိုင်သည့်မေးမြန်းမှုအပေါ် တုံ့ပြန်မှုကိုလည်း တွေ့နိုင်ပါသည်။
   • ဖွင့်ပြီး မှိန်စက်၏ တောက်ပမှုကို 50% သို့ သတ်မှတ်ပါ
   • အထက်ဖော်ပြပါအကြောင်းအရာနှင့် စာရင်းသွင်းထားသော ခေါင်းစဉ်အတွက် အဖြေ (၎င်း၏ပေးဆောင်မှု၊ တိကျမှုရှိစေရန်) သည် ဥပမာ၊ampလဲ့
     အထက်ဖော်ပြပါ တုံ့ပြန်မှုသည် ဟောင်းတစ်ဦးဖြစ်သည်။ample သည် မှန်ကန်သော payload ၏ကိစ္စတွင်၊ ဒြပ်စင်တွင် မှိန်ခြင်းလုပ်ဆောင်မှု မရှိသော်လည်း၊ payload ကို မှန်ကန်စွာ အဓိပ္ပါယ်မဖော်နိုင်ဘဲ ပိုမိုပြင်းထန်သော ပြဿနာများရှိနေပါက၊ တုံ့ပြန်မှုသည် ဤကဲ့သို့ ဖြစ်နေမည် (ဥပမာ--
     အမှားကုဒ်များနှင့် မက်ဆေ့ချ်များ၏ ရှင်းလင်းချက်အတွက်၊ သို့သော် ယေဘုယျအားဖြင့် http ကဲ့သို့ပင်၊ 200 ကုဒ်များသည် အပြုသဘောဆောင်သော အဖြေများဖြစ်ပြီး 400 သည် အနုတ်လက္ခဏာဖြစ်သည်။

EXAMPLE- ဒြပ်စင်များစွာ၏တန်ဖိုးများကို ပြောင်းလဲရန်အတွက် ထုတ်ပြန်ပါ။

လုပ်ထုံးလုပ်နည်းသည် တစ်ခုတည်းသောဒြပ်စင်တစ်ခုကို ပြောင်းလဲရန် ရှေ့တွင်ပြသထားသည့်အရာနှင့် ဆင်တူသည်။ ကွာခြားချက်မှာ အကြောင်းအရာများမှ element_id ကို သင်ဖယ်ထုတ်ပြီး payload အတွင်းရှိဒေတာ၏ရှေ့တွင် element_ids အစုအဝေးကိုညွှန်ပြခြင်းဖြစ်သည်။ အောက်တွင် syntax နှင့် structure ကိုကြည့်ပါ။

မေးခွန်းများတွင် လုပ်ဆောင်ချက်အမျိုးအစားအလိုက် စစ်ထုတ်ပါ။

payload ရှိ filters parameter သည် element တစ်ခု၏အလိုရှိသော function(များ) ကိုသာဖြေရှင်းရန်ခွင့်ပြုသည်။ ခလုတ် သို့မဟုတ် မှိန်စက်၏ အဖွင့်/အပိတ် လုပ်ဆောင်ချက်ကို ဥပမာအားဖြင့် “ဖွင့်/ပိတ်” ဟုခေါ်သည်။ample၊ နှင့် သက်ဆိုင်ရာ filter ကို ဤနည်းဖြင့် သတ်မှတ်သည်-

အဖြေက ဥပမာအားဖြင့် ဒီလိုပုံရတယ်။ample

စတုရန်းကွင်းပိတ်သည် သင်သည် လုပ်ဆောင်ချက်များစွာဖြင့်လည်း စစ်ထုတ်နိုင်ကြောင်း ညွှန်ပြသည်၊ ဥပမာ

ဤကဲ့သို့သောအဖြေကိုဖြစ်ပေါ်စေသည်-

နောက်ဆက်တွဲ

အမှားကုတ်

MQTT ဆက်သွယ်မှုတွင် အမှားအယွင်းများသည် ဂဏန်းကုဒ်တစ်ခု ဖြစ်ပေါ်သည်။ အောက်ပါဇယားသည် ၎င်းကို ဖြိုခွဲရန် ကူညီပေးသည်။

PAYLOAD ၏ ဘောင်များ

payload သည် အကြောင်းအရာပေါ်မူတည်၍ မတူညီသော ဘောင်များကို ပံ့ပိုးပေးသည်။ အောက်ပါဇယားသည် မည်သည့်အကြောင်းအရာများတွင် မည်သည့် parameters များ ဖြစ်ပေါ်နိုင်သည်ကို ပြသသည်။

ဗားရှင်းမှတ်စုများ

• မူကွဲ ၁.၁၉

သတင်း-

• ပထမအကြိမ်ထုတ်ဝေခြင်း။

စာရွက်စာတမ်းများ / အရင်းအမြစ်များ

	DIVUS VISION API ဆော့ဖ်ဝဲ [pdf] အသုံးပြုသူလက်စွဲ VISION API ဆော့ဖ်ဝဲ၊ API ဆော့ဖ်ဝဲ၊ ဆော့ဖ်ဝဲ
	DIVUS Vision API ဆော့ဖ်ဝဲ [pdf] အသုံးပြုသူလမ်းညွှန် Vision API Software၊ Vision၊ API Software၊ Software

ကိုးကား

• အသုံးပြုသူလက်စွဲ