DIVUS vision API மென்பொருள்

விவரக்குறிப்புகள்

• தயாரிப்பு: DIVUS VISION API
• உற்பத்தியாளர்: DIVUS GmbH
• பதிப்பு: 1.00 REV0 1 – 20240528
• இடம்: Pillhof 51, Eppan (BZ), இத்தாலி

தயாரிப்பு தகவல்

DIVUS VISION API என்பது DIVUS VISION அமைப்புகளுடன் இடைமுகப்படுத்துவதற்காக வடிவமைக்கப்பட்ட ஒரு மென்பொருள் கருவியாகும். இது MQTT நெறிமுறைகளைப் பயன்படுத்தி கணினியில் உள்ள பல்வேறு கூறுகளை அணுகவும் கட்டுப்படுத்தவும் பயனர்களை அனுமதிக்கிறது.

அடிக்கடி கேட்கப்படும் கேள்விகள்

கே: பிசி அல்லது ஆட்டோமேஷன் தொழில்நுட்பம் பற்றிய முன் அறிவு இல்லாமல் DIVUS VISION API ஐப் பயன்படுத்தலாமா?

ப: ஏபிஐயின் திறமையான பயன்பாட்டை உறுதி செய்வதற்காக இந்தப் பகுதிகளில் முந்தைய அறிவைக் கொண்ட பயனர்களுக்காக கையேடு வடிவமைக்கப்பட்டுள்ளது.

பொதுவான தகவல்

• DIVUS GmbH Pillhof 51 I-39057 Eppan (BZ) - இத்தாலி

இயக்க வழிமுறைகள், கையேடுகள் மற்றும் மென்பொருள் பதிப்புரிமை மூலம் பாதுகாக்கப்படுகின்றன. அனைத்து உரிமைகளும் பாதுகாக்கப்பட்டவை. முழுமையாகவோ அல்லது பகுதியாகவோ நகலெடுப்பது, நகலெடுப்பது, மொழிபெயர்ப்பது, மொழிபெயர்ப்பது அனுமதிக்கப்படாது. தனிப்பட்ட பயன்பாட்டிற்காக மென்பொருளின் காப்பு பிரதியை உருவாக்குவதற்கு விதிவிலக்கு பொருந்தும்.
கையேடு அறிவிப்பு இல்லாமல் மாற்றத்திற்கு உட்பட்டது. இந்த ஆவணத்தில் உள்ள தரவு மற்றும் வழங்கப்பட்ட சேமிப்பக மீடியாவில் உள்ள தரவு பிழைகள் மற்றும் சரியானது என்று எங்களால் உத்தரவாதம் அளிக்க முடியாது. மேம்பாடுகளுக்கான பரிந்துரைகள் மற்றும் பிழைகள் பற்றிய குறிப்புகள் எப்போதும் வரவேற்கப்படுகின்றன. இந்த கையேட்டின் குறிப்பிட்ட இணைப்புகளுக்கும் ஒப்பந்தங்கள் பொருந்தும். இந்த ஆவணத்தில் உள்ள பெயர்கள் வர்த்தக முத்திரைகளாக இருக்கலாம், அவற்றின் சொந்த நோக்கங்களுக்காக மூன்றாம் தரப்பினரின் பயன்பாடு அவற்றின் உரிமையாளர்களின் உரிமைகளை மீறும். பயனர் அறிவுறுத்தல்கள்: இந்த கையேட்டை முதன்முறையாகப் பயன்படுத்துவதற்கு முன்பு அதைப் படித்து, எதிர்கால குறிப்புக்காக பாதுகாப்பான இடத்தில் வைக்கவும். இலக்கு குழு: கையேடு PC மற்றும் ஆட்டோமேஷன் தொழில்நுட்பத்தின் முந்தைய அறிவைக் கொண்ட பயனர்களுக்காக எழுதப்பட்டுள்ளது.

விளக்கக்காட்சி மாநாடுகள்

அறிமுகம்

பொது அறிமுகம்

இந்த கையேடு VISION API (Application Programming Interface) - ஒரு இடைமுகத்தை விவரிக்கிறது, இதன் மூலம் 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 பயனர்களின் அங்கீகாரத் தரவைப் பயன்படுத்தி மட்டுமே செயல்படும். பயனர் உரிமைகளைப் பொறுத்த வரையில், இந்தச் செயல்பாட்டிற்கான செயல்படுத்தல் அனைத்து அல்லது தனிப்பட்ட கூறுகளிலும் உள்ளமைக்கப்படலாம். அத்தியாயம்.0. பார்க்கவும். நிச்சயமாக, உங்களுக்கு ஒரு VISION திட்டமும் தேவை, அதில் நீங்கள் வெளியில் இருந்து கட்டுப்படுத்த விரும்பும் கூறுகள் முழுமையாக உள்ளமைக்கப்பட்டு அவற்றுக்கான இணைப்பு வெற்றிகரமாக சோதிக்கப்பட்டது. ஏபிஐ மூலம் தனிப்பட்ட உறுப்புகளை நிவர்த்தி செய்ய, அவற்றின் உறுப்பு ஐடி தெரிந்திருக்க வேண்டும்: இது உறுப்பு அமைப்புகளின் படிவத்தின் கீழே காட்டப்படும்

பாதுகாப்பு

பாதுகாப்பு காரணங்களுக்காக, API அணுகல் உள்நாட்டில் மட்டுமே சாத்தியமாகும் (அதாவது கிளவுட் வழியாக அல்ல). API அணுகலைச் செயல்படுத்தும்போது பாதுகாப்பு ஆபத்து குறைவாக உள்ளது. இருப்பினும், API அணுகலுக்கு பாதுகாப்பு தொடர்பான கூறுகளை இயக்கவோ அல்லது வெளிப்படையாக மறுக்கவோ கூடாது.

MQTT மற்றும் அதன் விதிமுறைகள் - சுருக்கமான விளக்கம்

• MQTT இல், அனைத்து செய்திகளின் மையப்படுத்தப்பட்ட மேலாண்மை மற்றும் விநியோகத்தின் பங்கு தரகரின் பங்கு ஆகும். MQTT சேவையகம் மற்றும் MQTT தரகர் ஆகியவை ஒத்த சொற்கள் அல்ல என்றாலும் (சர்வர் என்பது MQTT கிளையண்டுகளும் விளையாடக்கூடிய ஒரு பாத்திரத்திற்கான ஒரு பரந்த சொல்), MQTT சேவையகம் குறிப்பிடப்படும்போது இந்த கையேட்டில் எப்போதும் தரகர் குறிக்கப்படுவார். இந்த கையேட்டின் சூழலில் DIVUS KNX IQ ஆனது MQTT தரகர் / MQTT சேவையகப் பாத்திரத்தை வகிக்கிறது.
• ஒரு MQTT சேவையகம் தலைப்புகள் என்று அழைக்கப்படுவதைப் பயன்படுத்துகிறது: தரவு வகைப்படுத்தப்பட்டு, நிர்வகிக்கப்படும் மற்றும் வெளியிடப்படும் ஒரு படிநிலை அமைப்பு.
• தலைப்புகள் மூலம் மற்ற பங்கேற்பாளர்களுக்கு தரவைக் கிடைக்கச் செய்வதே முதன்மைக் குறிக்கோளாக வெளியிடுகிறது. நீங்கள் ஒரு மதிப்பை மாற்ற விரும்பினால், வெளியீட்டுச் செயலையும் பயன்படுத்தி, விரும்பிய மதிப்பு மாற்றத்துடன், விரும்பிய தலைப்புக்கு எழுதுவீர்கள். இலக்கு சாதனம் அல்லது MQTT சேவையகம் அதை பாதிக்கும் விரும்பிய மாற்றத்தைப் படித்து அதற்கேற்ப ஏற்றுக்கொள்கிறது. மாற்றம் பயன்படுத்தப்பட்டுள்ளதா என்பதைச் சரிபார்க்க, சந்தா செலுத்திய நிகழ்நேர தலைப்பில் மாற்றம் பிரதிபலிக்கிறதா என்பதைப் பார்க்கவும் - எல்லாம் சரியாக நடந்திருந்தால்.
• வாடிக்கையாளர்கள் தங்களுக்கு விருப்பமான தலைப்புகளைத் தேர்ந்தெடுக்கிறார்கள்: இது சந்தா எனப்படும். ஒவ்வொரு முறையும் ஒரு தலைப்பில்/கீழே மதிப்பு மாறும்போது, ​​அனைத்து சந்தாதாரர் கிளையண்டுகளுக்கும் தெரிவிக்கப்படும் - அதாவது ஏதாவது மாறியதா அல்லது தற்போதைய மதிப்பு என்ன என்று வெளிப்படையாகக் கேட்காமல்.
• ஒரு தலைப்பில் கிளையன்ட்_ஐடி எனப்படும் தனித்துவமான சரத்தை உள்ளிடுவதன் மூலம் MQTT சேவையகத்துடன் ஒரு தனித் தொடர்பு சேனலைத் திறக்கலாம் (அல்லது முகவரி). மதிப்புகளைச் செயலாக்க தலைப்பில் கிளையன்ட்_ஐடி பயன்படுத்தப்பட வேண்டும். இது ஒவ்வொரு மாற்றத்தின் தோற்றத்தையும் அடையாளம் காண உதவுகிறது, எந்தப் பிழைகளுக்கும் உதவுகிறது மற்றும் பிற கிளையன்ட்களைப் பாதிக்காது, ஏனெனில் ஏதேனும் பிழைக் குறியீடுகள் மற்றும் செய்திகள் உட்பட, சேவையகத்தின் தொடர்புடைய பதில்கள், அதே க்ளையன்ட்_ஐடியுடன் மட்டுமே தலைப்பை அடையும். அந்த வாடிக்கையாளர்). Client_id என்பது 0-9, az, AZ, “-“, “_” ஆகிய எழுத்துகளின் கலவையைக் கொண்ட தனித்துவமான எழுத்துச் சரமாகும்.
• பொதுவாக, DIVUS KNX IQ இன் MQTT சேவையகத்தின் சந்தா தலைப்புகள் திறவுச்சொல் நிலையைக் கொண்டிருக்கும், அதே சமயம் வெளியீட்டு தலைப்புகளில் முக்கியக் கோரிக்கை உள்ளது. வெளி மதிப்பு மாற்றம் ஏற்பட்டவுடன் அல்லது வாடிக்கையாளர் ஒரு வெளியீட்டின் மூலம் மதிப்பு மாற்றம் கோரப்பட்டு வெற்றிகரமாகப் பயன்படுத்தப்பட்டவுடன் அந்தஸ்து உள்ளவர்கள் தானாகவே புதுப்பிக்கப்படும். வெளியிடுவதற்கானவை வகை (கோரிக்கை/)பெறுதல் மற்றும் வகை (கோரிக்கை/)தொகுப்பு என மேலும் பிரிக்கப்படுகின்றன.
• மதிப்பு மாற்றங்கள் மற்றும் பிற விருப்ப அளவுருக்கள் பேலோட் என்று அழைக்கப்படும் தலைப்பில் சேர்க்கப்படும். தனிப்பட்ட உறுப்புகளின் அளவுருக்கள் (உறுப்பு-ஐடி, பெயர், வகை, செயல்பாடுகள்)

MQTT மற்றும் கிளாசிக் கிளையன்ட்-சர்வர் மாதிரி ஆகியவற்றுக்கு இடையேயான முக்கிய வேறுபாடு, கிளையன்ட் கோரும் பின்னர் தரவை மாற்றுவது, குழுசேர்தல் மற்றும் வெளியிடுதல் என்ற கருத்துகளை மையமாகக் கொண்டது. பங்கேற்பாளர்கள் தரவை வெளியிடலாம், அதை மற்றவர்களுக்குக் கிடைக்கும்படி செய்யலாம், ஆர்வமுள்ளவர்கள் அதற்கு குழுசேரலாம். இந்தக் கட்டமைப்பானது தரவுப் பரிமாற்றத்தைக் குறைத்து, ஆர்வமுள்ள அனைத்து தரப்பினரையும் புதுப்பித்த நிலையில் வைத்திருப்பதை சாத்தியமாக்குகிறது. இங்கே விவரங்கள் பற்றி மேலும்: மற்றும் சிறப்பு அளவுருக்கள் (uuid, வடிகட்டிகள்) இங்கே பயன்படுத்தப்படும். பல விருப்பங்கள் இருந்தாலும், இந்த கையேட்டில் பேலோட் JSON என வடிவமைக்கப்பட்டுள்ளது. JSON எந்தவொரு கட்டமைப்பின் தரவையும் பிரதிநிதித்துவப்படுத்த அடைப்புக்குறிகள் மற்றும் காற்புள்ளிகளைப் பயன்படுத்துகிறது, இதனால் அனுப்பப்படும் தரவு பாக்கெட்டுகளின் அளவைக் குறைக்கிறது. பேலோடுகளைப் பற்றிய கூடுதல் விவரங்களை பின்னர் கையேட்டில் காணலாம்.

• சிறப்பு நோக்கங்களுக்காக, செயல்பாட்டின் வகைக்கு ஏற்ப வடிகட்ட முடியும், எ.கா. ஆன்/ஆஃப் மட்டுமே அதாவது 1-பிட் சுவிட்சுகள். பேலோடில் உள்ள வடிகட்டிகள் அளவுரு இந்த நோக்கத்திற்காக பயன்படுத்தப்படுகிறது. வடிகட்டுதல் தற்போது செயல்பாட்டு வகையால் மட்டுமே சாத்தியமாகும்.
• தனிப்பட்ட கூறுகளை நிவர்த்தி செய்ய, அவற்றின் உறுப்பு ஐடி தேவை. இது உறுப்பு பண்புகள் மெனுவில் உள்ள VISION இல் காணலாம் அல்லது MQTT எக்ஸ்ப்ளோரரின் பொதுவான சந்தாவில் கிடைக்கும் ஒவ்வொரு உறுப்புக்கும் முன்னால் காட்டப்படும் தரவிலிருந்து நேரடியாகப் படிக்கலாம் (அங்குள்ள கூறுகள் உறுப்பு ஐடி மூலம் அகரவரிசையில் பட்டியலிடப்பட்டுள்ளன).

API அணுகலுக்கான கட்டமைப்பு

API பயனர் அணுகலுக்கான பார்வையை உள்ளமைத்தல்

ஒரு நிர்வாகியாக VISION இல், Configuration – User/API Access Management என்பதற்குச் சென்று, பயனர்கள்/API அணுகலைக் கிளிக் செய்து, எடிட்டிங் சாளரத்தைத் திறக்க 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 பயனரின் விவரம் பக்கத்தில் படிக்கவும்
• ஐபி முகவரியை பொது – நெட்வொர்க் – ஈதர்நெட் (அல்லது சின்க்ரோனைசர் வழியாக) கீழ் துவக்கி அமைப்புகளில் படிக்கவும்
• போர்ட் 8884 (இந்த துறைமுகம் இந்த நோக்கத்திற்காக ஒதுக்கப்பட்டுள்ளது)

MQTT எக்ஸ்ப்ளோரருடன் முதல் இணைப்பு மற்றும் பொது சந்தா

பொதுவாக, MQTT சந்தா மற்றும் வெளியிடும் செயல்பாடுகளை வேறுபடுத்துகிறது. MQTT எக்ஸ்ப்ளோரர், முதல் இணைப்பு செய்யப்படும் போது, ​​கிடைக்கக்கூடிய அனைத்து தலைப்புகளுக்கும் (தலைப்பு #) தானாகவே குழுசேர்வதன் மூலம் இதை எளிதாக்குகிறது. இதன் விளைவாக, கிடைக்கக்கூடிய அனைத்து உறுப்புகளுக்கும் வழிவகுக்கும் (அதாவது API பயனர் அணுகல் வழங்கப்பட்டது) வெற்றிகரமான இணைப்புக்குப் பிறகு MQTT எக்ஸ்ப்ளோரர் சாளரத்தின் இடது புறத்தில் நேரடியாகக் காணலாம். மேலும் சந்தா தலைப்புகளை உள்ளிட அல்லது # ஐ இன்னும் குறிப்பிட்ட தலைப்புடன் மாற்ற, இணைப்பு சாளரத்தில் மேம்பட்டது என்பதற்குச் செல்லவும். மேல் வலதுபுறத்தில் காட்டப்பட்டுள்ள தலைப்பு இதுபோல் தெரிகிறது:

7f4x0607849x444xxx256573x3x9x983 என்பது API பயனர்பெயர் மற்றும் objects_list ஆனது கிடைக்கக்கூடிய அனைத்து கூறுகளையும் கொண்டுள்ளது. இந்த தலைப்பு எப்போதும் புதுப்பித்த நிலையில் இருக்கும் அதாவது எந்த மதிப்பு மாற்றங்களும் நிகழ்நேரத்தில் பிரதிபலிக்கும். நீங்கள் தனிப்பட்ட உறுப்புகளுக்கு மட்டுமே குழுசேர விரும்பினால், objects_list/ க்குப் பிறகு விரும்பிய உறுப்பின் உறுப்பு ஐடியை உள்ளிடவும்.

குறிப்பு: இந்த வகை சந்தா தோராயமாக KNX பின்னூட்ட முகவரிகளுக்குப் பின்னால் உள்ள தர்க்கத்திற்கு ஒத்திருக்கிறது; இது உறுப்புகளின் தற்போதைய நிலையைக் காட்டுகிறது மற்றும் விரும்பிய மாற்றங்கள் வெற்றிகரமாகப் பயன்படுத்தப்பட்டுள்ளதா என்பதைச் சரிபார்க்கப் பயன்படுத்தப்படலாம். நீங்கள் தரவை மட்டும் படிக்க விரும்பினால், அதை மாற்றாமல் இருந்தால், இந்த வகை சந்தா போதுமானது .

ஒரு எளிய உறுப்பு JSON குறியீட்டில் இது போன்றது

குறிப்பு: எல்லா மதிப்புகளும் மேலே காட்டப்பட்டுள்ள தொடரியலைக் கொண்டுள்ளன, எ.கா. {“மதிப்பு”: “1” } சந்தா தலைப்புகளின் வெளியீடாக இருக்கும், அதே சமயம் மதிப்பை மாற்றுவதற்காக பேலோடில் மதிப்பு நேரடியாக எழுதப்படும் (அதாவது வெளியிடப்படும் தலைப்புகளுக்கு) – அடைப்புக்குறிகள் மற்றும் "மதிப்பு" தவிர்க்கப்பட்டது எ.கா. "onoff": "1".

மேம்பட்ட கட்டளைகள்

அறிமுகம்

பொதுவாக 3 வகையான தலைப்புகள் உள்ளன:

1. கிடைக்கும் கூறுகளைப் பார்க்கவும், நிகழ்நேர மதிப்பு மாற்றங்களைப் பெறவும் தலைப்பு(களை) குழுசேரவும்
2. பதில்களைப் பெற தலைப்பு(களுக்கு) குழுசேரவும் (வாடிக்கையாளர்கள் ) கோரிக்கைகளை வெளியிடவும்
3. கூறுகளை அவற்றின் மதிப்புகளுடன் பெற அல்லது அமைக்க தலைப்பு(களை) வெளியிடவும்

இங்கே காட்டப்பட்டுள்ள எண்களைப் பயன்படுத்தி இந்த வகைகளை நாங்கள் பின்னர் குறிப்பிடுவோம் (எ.கா. வகை 1, 2, 3 தலைப்புகள்). பின்வரும் பிரிவுகளிலும் அத்தியாயத்திலும் கூடுதல் விவரங்கள். 4.2

கிடைக்கக்கூடிய கூறுகளைக் காண மற்றும் நிகழ்நேர மதிப்பு மாற்றங்களைப் பெற தலைப்புகளில் குழுசேரவும்

இவை ஏற்கனவே விவரிக்கப்பட்டுள்ளன

வாடிக்கையாளரின் வெளியீட்டு கோரிக்கைகளுக்கான பதில்களைப் பெற தலைப்புகளுக்கு குழுசேரவும்

இந்த வகையான தலைப்புகள் விருப்பமானது. இது அனுமதிக்கிறது

• ஒரு தன்னிச்சையான கிளையன்ட்_ஐடியைப் பயன்படுத்தி MQTT சேவையகத்துடன் ஒரு தனிப்பட்ட தொடர்பு சேனலைத் திறக்கவும். அத்தியாயத்தில் அதைப் பற்றி மேலும். 4.2.2
• தொடர்புடைய சந்தா தலைப்பில் வெளியிடப்பட்ட கோரிக்கைகளின் முடிவைப் பெறுங்கள்: பிழைக் குறியீடு மற்றும் செய்தியுடன் வெற்றி அல்லது தோல்வி.

பதில்களைப் பெற அல்லது வெளியீட்டு கட்டளைகளை அமைக்க வெவ்வேறு தலைப்புகள் உள்ளன. தொடர்புடைய வேறுபாடு உங்கள் கணினிக்குத் தேவையான தலைப்புகளை நேராகப் பெற்றவுடன், இந்தப் படிநிலையை அகற்றிவிட்டு நேரடியாக வெளியிடும் தலைப்புகளைப் பயன்படுத்த முடிவு செய்யலாம்.

 அவற்றின் மதிப்புகளுடன் கூறுகளைப் பெற அல்லது அமைக்க தலைப்புகளை வெளியிடவும்

இந்தத் தலைப்புகள் சந்தா செலுத்துவதற்குப் போன்ற பாதையைப் பயன்படுத்துகின்றன - ஒரே மாற்றம், குழுசேரப் பயன்படுத்தப்படும் "நிலை"க்கு பதிலாக "கோரிக்கை" என்ற வார்த்தை மட்டுமே. முழு தலைப்பு பாதைகள் அத்தியாயத்தில் பின்னர் காட்டப்படும். 4.2.2\ ஒரு பெறு தலைப்பு MQTT சேவையகத்தின் கூறுகள் மற்றும் மதிப்புகளைப் படிக்கக் கோரும். உறுப்புகளின் செயல்பாட்டு வகையின் அடிப்படையில் வடிகட்டுவதற்கு பேலோட் பயன்படுத்தப்படலாம். ஒரு தனிமத்தின் சில பகுதிகளை அதன் பேலோடில் விவரிக்கப்பட்டுள்ளபடி, ஒரு செட் தலைப்பு மாற்றக் கோரும்.

கட்டளைகள் மற்றும் தொடர்புடைய பதில்களுக்கான முன்னொட்டு

 சுருக்கமான விளக்கம்

MQTT சேவையகத்திற்கு அனுப்பப்படும் அனைத்து கட்டளைகளும் பொதுவான ஆரம்ப பகுதியைக் கொண்டுள்ளன, அதாவது:

விரிவான விளக்கம்

நிகழ்நேர தலைப்புகள் (வகை 1) பொது முன்னொட்டைக் கொண்டிருக்கும் (மேலே பார்க்கவும்) பின் தொடர்ந்து வரும்

or

செட் கட்டளைகளுக்கு, பேலோட் முக்கியப் பாத்திரத்தை வகிக்கிறது, ஏனெனில் அது விரும்பிய மாற்றங்களைக் கொண்டிருக்கும் (அதாவது உறுப்புகளின் செயல்பாடுகளுக்கு மாற்றப்பட்ட மதிப்புகள்). ஒரு எச்சரிக்கை: உங்கள் வகை 3 கட்டளைகளில் தக்கவைப்பு விருப்பத்தை பயன்படுத்த வேண்டாம், ஏனெனில் இது KNX பக்கத்தில் சிக்கல்களை ஏற்படுத்தக்கூடும்.

EXAMPLE: ஒரு தனிமத்தின் மதிப்பை(களை) மாற்றுவதற்காக வெளியிடவும்

பொதுவான சந்தா மூலம் காட்டப்படும் உறுப்புகளில் ஒன்றின் மதிப்பை மாற்ற விரும்புவது எளிமையான வழக்கு.
பொதுவாக, MQTT வழியாக VISION செயல்பாட்டை மாற்றுவது/மாற்றுவது 3 படிகளைக் கொண்டுள்ளது, இவை அனைத்தும் முற்றிலும் அவசியமில்லை, ஆனால் விவரிக்கப்பட்டுள்ளபடி அவற்றைச் செயல்படுத்த பரிந்துரைக்கிறோம்.

1. நாங்கள் திருத்த விரும்பும் செயல்பாட்டைக் கொண்ட தலைப்பு தனிப்பயன் கிளையன்ட்_ஐடியைப் பயன்படுத்தி குழுசேரப்பட்டது
2. திருத்துவதற்கான தலைப்பு, 1 இல் தேர்ந்தெடுக்கப்பட்ட கிளையன்ட்_ஐடியைப் பயன்படுத்தி விரும்பிய மாற்றங்களுடன் பேலோடுடன் வெளியிடப்படுகிறது.
3. சரிபார்க்க, தலைப்பில் (1.) பதிலைக் காணலாம் - அதாவது (2.) வேலை செய்ததா இல்லையா
4. பொதுவான சந்தாவில், மாற்றங்கள் செய்யப்படும்போது அனைத்து மதிப்புகளும் புதுப்பிக்கப்படும், எல்லாம் சரியாக வேலை செய்திருந்தால், விரும்பிய மதிப்பு மாற்றத்தை(களை) நீங்கள் பார்க்கலாம்.

இதைச் செய்வதற்கான படிகள்:

1. கிளையன்ட்_ஐடி எ.கா. "திவஸ்" ஐத் தேர்ந்தெடுத்து, ஏபிஐ பயனர்பெயருக்குப் பின் பாதையில் அதைச் செருகவும்
   MQTT சேவையகத்துடன் உங்கள் சொந்த தொடர்பு சேனலுக்கு குழுசேருவதற்கான முழுமையான தலைப்பு இதுவாகும். நீங்கள் அனுப்ப விரும்பும் மாற்றங்களுக்கான பதில்களை நீங்கள் எதிர்பார்க்கும் சேவையகத்திற்கு இது தெரிவிக்கிறது. a ஐ வரையறுக்கும் நிலை/தொகுப்பு பகுதியைக் கவனியுங்கள். இது ஒரு சந்தா தலைப்பு மற்றும் பி. வகை கட்டளைகளை அமைப்பதற்கான பதில்களை அது பெறும்.
2. நிலை-கோரிக்கை முக்கிய வார்த்தைகளை மாற்றுவதைத் தவிர, வெளியீட்டு தலைப்பு ஒரே மாதிரியாக இருக்கும்
3. மாற்றம் எதைக் கொண்டிருக்க வேண்டும் என்பது பேலோடில் எழுதப்பட்டுள்ளது. இதோ சில முன்னாள்ampலெஸ்.
   • ஆன்/ஆஃப் செயல்பாடு (1 பிட்) கொண்ட உறுப்பை அணைத்தல்:
   • ஆன்/ஆஃப் செயல்பாடு (1 பிட்) கொண்ட ஒரு உறுப்பை இயக்குதல். கூடுதலாக, ஒரே கிளையண்டிலிருந்து இதுபோன்ற பல கட்டளைகள் தொடங்கப்பட்டால், uuid அளவுரு (“தனித்துவமான ஐடி”, பொதுவாக 128-8-4-4-4 இலக்கங்கள் ஹெக்ஸாக வடிவமைக்கப்பட்ட 12-பிட் சரம்) பயன்படுத்தப்படலாம் இந்த அளவுரு வினவலில் இருந்தால் - தொடர்புடைய வினவலுக்கான பதிலையும் பதிலில் காணலாம்.
   • ஸ்விட்ச் ஆன் செய்து மங்கலான வெளிச்சத்தை 50% ஆக அமைக்கவும்
   • மேலே காட்டப்பட்ட மற்றும் குழுசேர்ந்த தலைப்புக்கான பதில் (அதன் பேலோட், துல்லியமாக இருக்க வேண்டும்) பின்னர், முன்னாள்ampலெ.
     மேலே உள்ள பதில் ஒரு முன்னாள்ample சரியான பேலோட் விஷயத்தில், உறுப்பு மங்கலான செயல்பாடு இல்லை என்றாலும். பேலோடைச் சரியாகப் புரிந்து கொள்ள முடியாத அளவுக்கு கடுமையான சிக்கல்கள் இருந்தால், பதில் இப்படி இருக்கும் (எ.கா.):
     பிழைக் குறியீடுகள் மற்றும் செய்திகளின் விளக்கத்திற்கு ஆனால் பொதுவாக, http போன்ற, 200 குறியீடுகள் நேர்மறை பதில்களாகவும், 400 எதிர்மறையாகவும் இருக்கும்.

EXAMPLE: பல கூறுகளின் மதிப்புகளை மாற்றுவதற்கு வெளியிடவும்

ஒரு தனிமத்தை மாற்றுவதற்கு முன்பு காட்டப்பட்ட செயல்முறையைப் போன்றது. வித்தியாசம் என்னவென்றால், நீங்கள் தலைப்புகளில் இருந்து element_id ஐத் தவிர்த்துவிட்டு, பேலோடில் உள்ள தரவின் முன் உறுப்பு_ஐடிகளின் தொகுப்பைக் குறிப்பிடுகிறீர்கள். கீழே உள்ள தொடரியல் மற்றும் கட்டமைப்பைப் பார்க்கவும்.

கேள்விகளில் செயல்பாடு வகை மூலம் வடிகட்டவும்

பேலோடில் உள்ள வடிகட்டிகள் அளவுரு, ஒரு உறுப்பின் விரும்பிய செயல்பாடு(களை) மட்டுமே கவனிக்க அனுமதிக்கிறது. ஒரு சுவிட்ச் அல்லது டிம்மரின் ஆன்/ஆஃப் செயல்பாடு "ஆன்ஆஃப்" என்று அழைக்கப்படுகிறதுample, மற்றும் தொடர்புடைய வடிகட்டி இந்த வழியில் வரையறுக்கப்படுகிறது:

பதில் இப்படி இருக்கும், முன்னாள்ample

சதுர அடைப்புக்குறியானது நீங்கள் பல செயல்பாடுகளால் வடிகட்டலாம் என்பதைக் குறிக்கிறது, எ.கா

இது போன்ற ஒரு பதிலுக்கு வழிவகுக்கிறது:

பின் இணைப்பு

பிழை குறியீடுகள்

MQTT தகவல்தொடர்புகளில் ஏற்படும் பிழைகள் எண் குறியீட்டை உருவாக்குகின்றன. பின்வரும் அட்டவணை அதை உடைக்க உதவுகிறது.

பேலோடின் அளவுருக்கள்

பேலோட் சூழலைப் பொறுத்து வெவ்வேறு அளவுருக்களை ஆதரிக்கிறது. எந்தெந்த தலைப்புகளில் எந்த அளவுருக்கள் ஏற்படலாம் என்பதை பின்வரும் அட்டவணை காட்டுகிறது

பதிப்பு குறிப்புகள்

• பதிப்பு 1.00

செய்தி:

• முதல் வெளியீடு

ஆவணங்கள் / ஆதாரங்கள்

	DIVUS vision API மென்பொருள் [pdf] பயனர் கையேடு VISION API மென்பொருள், API மென்பொருள், மென்பொருள்
	DIVUS Vision API மென்பொருள் [pdf] பயனர் வழிகாட்டி விஷன் ஏபிஐ மென்பொருள், பார்வை, ஏபிஐ மென்பொருள், மென்பொருள்

குறிப்புகள்

• பயனர் கையேடு