កម្មវិធី 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 ដោយមិនមានចំណេះដឹងពីមុនអំពីកុំព្យូទ័រ ឬបច្ចេកវិទ្យាស្វ័យប្រវត្តិកម្មបានទេ?

ចម្លើយ៖ សៀវភៅណែនាំនេះត្រូវបានរៀបចំឡើងសម្រាប់អ្នកប្រើប្រាស់ដែលមានចំណេះដឹងពីមុននៅក្នុងផ្នែកទាំងនេះ ដើម្បីធានាបាននូវការប្រើប្រាស់ API ប្រកបដោយប្រសិទ្ធភាព។

ព័ត៌មានទូទៅ

• DIVUS GmbH Pillhof 51 I-39057 Eppan (BZ) - អ៊ីតាលី

សេចក្តីណែនាំប្រតិបត្តិការ សៀវភៅណែនាំ និងកម្មវិធីត្រូវបានការពារដោយការរក្សាសិទ្ធិ។ រក្សាសិទ្ធិគ្រប់យ៉ាង។ ការចម្លង ការចម្លង ការបកប្រែ ការបកប្រែទាំងស្រុង ឬមួយផ្នែកមិនត្រូវបានអនុញ្ញាតទេ។ ករណីលើកលែងមួយអនុវត្តចំពោះការបង្កើតច្បាប់ចម្លងបម្រុងទុកនៃកម្មវិធីសម្រាប់ការប្រើប្រាស់ផ្ទាល់ខ្លួន។
សៀវភៅណែនាំអាចផ្លាស់ប្តូរដោយគ្មានការជូនដំណឹងជាមុន។ យើងមិនអាចធានាថាទិន្នន័យដែលមាននៅក្នុងឯកសារនេះ និងនៅលើឧបករណ៍ផ្ទុកដែលបានផ្គត់ផ្គង់នោះមិនមានកំហុស និងត្រឹមត្រូវ។ ការផ្តល់យោបល់សម្រាប់ការកែលម្អ ក៏ដូចជាការណែនាំអំពីកំហុសគឺតែងតែត្រូវបានស្វាគមន៍។ កិច្ចព្រមព្រៀងក៏អនុវត្តចំពោះឧបសម្ព័ន្ធជាក់លាក់ចំពោះសៀវភៅណែនាំនេះផងដែរ។ ការរចនានៅក្នុងឯកសារនេះអាចជាពាណិជ្ជសញ្ញាដែលការប្រើប្រាស់ដោយភាគីទីបីសម្រាប់គោលបំណងផ្ទាល់ខ្លួនរបស់ពួកគេអាចរំលោភលើសិទ្ធិរបស់ម្ចាស់របស់ពួកគេ។ ការណែនាំរបស់អ្នកប្រើ៖ សូមអានសៀវភៅណែនាំនេះមុនពេលប្រើវាជាលើកដំបូង ហើយរក្សាទុកវានៅកន្លែងដែលមានសុវត្ថិភាពសម្រាប់ជាឯកសារយោងនាពេលអនាគត។ ក្រុមគោលដៅ៖ សៀវភៅណែនាំត្រូវបានសរសេរសម្រាប់អ្នកប្រើប្រាស់ដែលមានចំណេះដឹងពីមុនអំពីកុំព្យូទ័រ និងបច្ចេកវិទ្យាស្វ័យប្រវត្តិកម្ម។

អនុសញ្ញាបទបង្ហាញ

សេចក្តីផ្តើម

ការណែនាំទូទៅ

សៀវភៅដៃនេះពិពណ៌នាអំពី 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 ប៉ុណ្ណោះ។ តាម​ដែល​សិទ្ធិ​អ្នក​ប្រើ​មាន​ការ​ព្រួយ​បារម្ភ ការ​ធ្វើ​ឱ្យ​សកម្ម​សម្រាប់​មុខងារ​នេះ​អាច​ត្រូវ​បាន​កំណត់​រចនាសម្ព័ន្ធ​ទាំង​លើ​ធាតុ​នីមួយៗ ឬ​លើ​ធាតុ​នីមួយៗ។ សូមមើលជំពូកទី 0 ។ ជាការពិតណាស់ អ្នកក៏ត្រូវការគម្រោង VISION ដែលធាតុដែលអ្នកចង់គ្រប់គ្រងពីខាងក្រៅត្រូវបានកំណត់រចនាសម្ព័ន្ធយ៉ាងពេញលេញ ហើយការតភ្ជាប់ទៅពួកវាត្រូវបានសាកល្បងដោយជោគជ័យ។ ដើម្បីអាចដោះស្រាយធាតុនីមួយៗតាមរយៈ API លេខសម្គាល់ធាតុរបស់ពួកគេត្រូវតែដឹង៖ វាត្រូវបានបង្ហាញនៅផ្នែកខាងក្រោមនៃទម្រង់ការកំណត់របស់ធាតុ

សុវត្ថិភាព

សម្រាប់ហេតុផលសុវត្ថិភាព ការចូលប្រើ API គឺអាចធ្វើទៅបានតែក្នុងមូលដ្ឋានប៉ុណ្ណោះ (ពោលគឺមិនមែនតាមរយៈពពក)។ ដូច្នេះហានិភ័យសុវត្ថិភាពនៅពេលបើកដំណើរការការចូលប្រើ API គឺទាប។ យ៉ាង​ណា​ក៏​ដោយ ធាតុ​ដែល​ទាក់​ទង​នឹង​សុវត្ថិភាព​មិន​គួរ​ត្រូវ​បាន​បើក ឬ​បដិសេធ​យ៉ាង​ច្បាស់​សម្រាប់​ការ​ចូល​ប្រើ API ទេ។

MQTT និងលក្ខខណ្ឌរបស់វា – ការពន្យល់សង្ខេប

• នៅក្នុង MQTT តួនាទីនៃការគ្រប់គ្រងកណ្តាល និងការចែកចាយសារទាំងអស់គឺជារបស់ឈ្មួញកណ្តាល។ ទោះបីជាម៉ាស៊ីនមេ MQTT និងឈ្មួញកណ្តាល MQTT មិនមែនជាពាក្យដូចគ្នា (ម៉ាស៊ីនមេគឺជាពាក្យទូលំទូលាយសម្រាប់តួនាទីដែលអតិថិជន MQTT ក៏អាចលេងបាន) ឈ្មួញកណ្តាលតែងតែមានន័យនៅក្នុងសៀវភៅណែនាំនេះនៅពេលដែលម៉ាស៊ីនមេ MQTT ត្រូវបានលើកឡើង។ DIVUS KNX IQ ខ្លួនវាដើរតួជាឈ្មួញកណ្តាល MQTT / ម៉ាស៊ីនមេ MQTT នៅក្នុងបរិបទនៃសៀវភៅណែនាំនេះ។
• ម៉ាស៊ីនមេ MQTT ប្រើអ្វីដែលគេហៅថាប្រធានបទ៖ រចនាសម្ព័ន្ធឋានានុក្រមដែលទិន្នន័យត្រូវបានចាត់ថ្នាក់ គ្រប់គ្រង និងបោះពុម្ពផ្សាយ។
• ការបោះពុម្ពផ្សាយមានគោលដៅចម្បងក្នុងការធ្វើឱ្យទិន្នន័យអាចរកបានសម្រាប់អ្នកចូលរួមផ្សេងទៀតតាមរយៈប្រធានបទ។ ប្រសិនបើអ្នកចង់ផ្លាស់ប្តូរតម្លៃ អ្នកសរសេរទៅប្រធានបទដែលចង់បាន រួមជាមួយនឹងការផ្លាស់ប្តូរតម្លៃដែលចង់បាន ដោយប្រើសកម្មភាពបោះពុម្ពផងដែរ។ ឧបករណ៍គោលដៅ ឬម៉ាស៊ីនមេ MQTT អានការផ្លាស់ប្តូរដែលចង់បានដែលប៉ះពាល់ដល់វា ហើយទទួលយកវាទៅតាមនោះ។ ដើម្បីពិនិត្យមើលថាការផ្លាស់ប្តូរនេះត្រូវបានអនុវត្ត អ្នកអាចរកមើលនៅក្នុងប្រធានបទពេលវេលាជាក់ស្តែងដែលបានជាវ ដើម្បីមើលថាតើការផ្លាស់ប្តូរត្រូវបានឆ្លុះបញ្ចាំងនៅទីនោះដែរឬទេ – ប្រសិនបើអ្វីៗដំណើរការបានល្អ។
• អតិថិជនជ្រើសរើសប្រធានបទដែលពួកគេចាប់អារម្មណ៍៖ នេះហៅថាការជាវ។ រាល់ពេលដែលតម្លៃផ្លាស់ប្តូរនៅក្នុង/ខាងក្រោមប្រធានបទ អតិថិជនដែលបានជាវទាំងអស់ត្រូវបានជូនដំណឹង - ពោលគឺដោយមិនចាំបាច់សួរឱ្យច្បាស់ថាតើមានអ្វីមួយបានផ្លាស់ប្តូរ ឬតម្លៃបច្ចុប្បន្នគឺជាអ្វី។
• អ្នកអាចបើក (ឬអាសយដ្ឋាន) បណ្តាញទំនាក់ទំនងដាច់ដោយឡែកជាមួយម៉ាស៊ីនមេ MQTT ដោយបញ្ចូលខ្សែអក្សរតែមួយគត់ដែលហៅថា client_id នៅក្នុងប្រធានបទមួយ។ client_id ត្រូវតែប្រើក្នុងប្រធានបទដើម្បីដំណើរការតម្លៃ។ វាបម្រើដើម្បីកំណត់អត្តសញ្ញាណប្រភពដើមនៃការផ្លាស់ប្តូរនីមួយៗ ជួយជាមួយនឹងកំហុសណាមួយ និងមិនប៉ះពាល់ដល់អតិថិជនផ្សេងទៀត ដោយសារការឆ្លើយតបដែលត្រូវគ្នាពីម៉ាស៊ីនមេ រួមទាំងលេខកូដ និងសារដែលមានកំហុសណាមួយ ក៏ឈានដល់ប្រធានបទជាមួយ client_id ដូចគ្នា (ហើយដូច្នេះតែប៉ុណ្ណោះ អតិថិជននោះ)។ client_id គឺ​ជា​ខ្សែ​តួអក្សរ​ពិសេស​ដែល​មាន​ការ​រួម​បញ្ចូល​គ្នា​នៃ​តួអក្សរ 0-9, az, AZ, “-“, “_” ។
• ជាទូទៅ ប្រធានបទជាវរបស់ម៉ាស៊ីនមេ MQTT នៃ DIVUS KNX IQ មានស្ថានភាពពាក្យគន្លឹះ ខណៈពេលដែលប្រធានបទផ្សព្វផ្សាយមានសំណើពាក្យគន្លឹះ។ អ្នកដែលមានស្ថានភាពត្រូវបានធ្វើបច្ចុប្បន្នភាពដោយស្វ័យប្រវត្តិភ្លាមៗនៅពេលដែលមានការផ្លាស់ប្តូរតម្លៃខាងក្រៅ ឬភ្លាមៗនៅពេលដែលការផ្លាស់ប្តូរតម្លៃត្រូវបានស្នើសុំដោយអតិថិជនផ្ទាល់តាមរយៈការបោះពុម្ព និងត្រូវបានអនុវត្តដោយជោគជ័យ។ ឯកសារសម្រាប់បោះពុម្ពត្រូវបានបែងចែកបន្ថែមទៀតទៅជាប្រភេទ (សំណើ/)ទទួល និងប្រភេទ (សំណើ/)កំណត់។
• ការផ្លាស់ប្តូរតម្លៃ និងប៉ារ៉ាម៉ែត្រជម្រើសផ្សេងទៀតត្រូវបានបន្ថែមទៅប្រធានបទជាមួយនឹងអ្វីដែលហៅថា payload ។ ប៉ារ៉ាម៉ែត្រនៃធាតុបុគ្គល (ធាតុ-លេខសម្គាល់ឈ្មោះប្រភេទមុខងារ)

ភាពខុសគ្នាសំខាន់រវាង MQTT និងគំរូម៉ាស៊ីនបម្រើអតិថិជនបុរាណ ដែលអតិថិជនស្នើសុំ ហើយបន្ទាប់មកផ្លាស់ប្តូរទិន្នន័យ គឺផ្តោតលើគោលគំនិតនៃការជាវ និងការបោះពុម្ពផ្សាយ។ អ្នកចូលរួមអាចបោះផ្សាយទិន្នន័យ ដែលធ្វើឱ្យវាអាចរកបានសម្រាប់អ្នកដទៃ ដែលប្រសិនបើចាប់អារម្មណ៍អាចជាវវាបាន។ ស្ថាបត្យកម្មនេះធ្វើឱ្យវាអាចធ្វើទៅបានដើម្បីកាត់បន្ថយការផ្លាស់ប្តូរទិន្នន័យ ហើយនៅតែរក្សាគ្រប់ភាគីដែលចាប់អារម្មណ៍ថ្មីៗ។ បន្ថែមអំពីព័ត៌មានលម្អិតនៅទីនេះ៖ ហើយប៉ារ៉ាម៉ែត្រពិសេស (uuid តម្រង) នឹងត្រូវប្រើនៅទីនេះ។ ទោះបីជាមានជម្រើសជាច្រើនក៏ដោយ បន្ទុកត្រូវបានបង្ហាញជាទម្រង់ JSON នៅក្នុងសៀវភៅណែនាំនេះ។ JSON ប្រើតង្កៀប និងសញ្ញាក្បៀសដើម្បីតំណាងឱ្យទិន្នន័យនៃរចនាសម្ព័ន្ធណាមួយ ហើយដូច្នេះកាត់បន្ថយទំហំនៃកញ្ចប់ទិន្នន័យដែលត្រូវបញ្ជូន។ ព័ត៌មានលម្អិតបន្ថែមអំពីបន្ទុកអាចត្រូវបានរកឃើញនៅពេលក្រោយនៅក្នុងសៀវភៅណែនាំ។

• សម្រាប់គោលបំណងពិសេស វាអាចត្រងតាមប្រភេទនៃមុខងារ ឧ. ដើម្បីដោះស្រាយតែការបើក/បិទ ពោលគឺ 1-bit switches។ ប៉ារ៉ាម៉ែត្រតម្រងនៅក្នុង payload ត្រូវបានប្រើសម្រាប់គោលបំណងនេះ។ បច្ចុប្បន្នការត្រងគឺអាចធ្វើទៅបានតែតាមប្រភេទមុខងារប៉ុណ្ណោះ។
• ដើម្បីអាចដោះស្រាយធាតុនីមួយៗបាន លេខសម្គាល់ធាតុរបស់ពួកគេត្រូវបានទាមទារ។ នេះអាចត្រូវបានរកឃើញនៅក្នុង VISION នៅក្នុងម៉ឺនុយលក្ខណសម្បត្តិធាតុ ឬក៏អាចអានដោយផ្ទាល់ពីទិន្នន័យដែលត្រូវបានបង្ហាញនៅពីមុខធាតុនីមួយៗដែលមាននៅក្នុងការជាវទូទៅរបស់ MQTT Explorer (ធាតុមានរាយអក្ខរក្រមតាមលេខសម្គាល់ធាតុ)។

ការកំណត់រចនាសម្ព័ន្ធសម្រាប់ការចូលប្រើ API

កំណត់រចនាសម្ព័ន្ធ Vision សម្រាប់ការចូលប្រើ API របស់អ្នកប្រើ

នៅក្នុង VISION ក្នុងនាមជាអ្នកគ្រប់គ្រង សូមចូលទៅកាន់ Configuration – User/API Access Management ចុចលើ Users/API access ហើយចុចខាងស្តាំលើ API User (ឬចុចអោយជាប់) ដើម្បីបើកផ្ទាំងកែសម្រួល។ នៅទីនោះអ្នកនឹងឃើញប៉ារ៉ាម៉ែត្រ និងទិន្នន័យទាំងនេះ

• បើក (ប្រអប់ធីក)
  • អ្នកប្រើប្រាស់ត្រូវបានបើកជាលើកដំបូងនៅទីនេះ។ លំនាំដើមត្រូវបានបិទ
• ឈ្មោះអ្នកប្រើប្រាស់
  • ខ្សែអក្សរនេះត្រូវបានទាមទារសម្រាប់ការចូលប្រើតាមរយៈ API – ចម្លងវាពីទីនេះ
• ពាក្យសម្ងាត់
  • ខ្សែអក្សរនេះត្រូវបានទាមទារសម្រាប់ការចូលប្រើតាមរយៈ API – ចម្លងវាពីទីនេះ
• ការអនុញ្ញាត
  • សិទ្ធិលំនាំដើមសម្រាប់ការអាន និងសរសេរតម្លៃនៃធាតុ VISION អាចត្រូវបានកំណត់នៅទីនេះ ពោលគឺអ្វីដែលកំណត់នៅទីនេះអនុវត្តចំពោះធាតុដែលមានស្រាប់ និងអនាគតទាំងអស់។ ប្រសិនបើអ្នកគ្រាន់តែចង់អនុញ្ញាតឱ្យចូលប្រើធាតុនីមួយៗ អ្នកមិនគួរផ្លាស់ប្តូរសិទ្ធិលំនាំដើមទាំងនេះទេ។

ការអនុញ្ញាតលើធាតុបុគ្គល

វាត្រូវបានណែនាំថាអ្នកមិនផ្តល់សិទ្ធិចូលប្រើ API ដល់គម្រោងទាំងមូលនោះទេ ប៉ុន្តែសម្រាប់តែធាតុដែលចង់បានប៉ុណ្ណោះ។ បន្តដូចខាងក្រោម

1. ចូល VISION ជាអ្នកគ្រប់គ្រង
2. ជ្រើសរើសធាតុដែលចង់បាន ហើយបើកម៉ឺនុយការកំណត់របស់វា (ចុចកណ្ដុរស្ដាំ ឬចុចបន្ត បន្ទាប់មកការកំណត់)
3. នៅក្រោមធាតុម៉ឺនុយទូទៅ - ការអនុញ្ញាត ធ្វើឱ្យសកម្ម "បដិសេធការអនុញ្ញាតលំនាំដើម" ហើយបន្ទាប់មកចូលទៅកាន់ធាតុរង ការអនុញ្ញាត ដែលបង្ហាញម៉ាទ្រីសការអនុញ្ញាត។
4. ធ្វើឱ្យការអនុញ្ញាតការគ្រប់គ្រងនៅទីនេះ ដែលបើកដំណើរការផងដែរ។ view ការអនុញ្ញាតដោយផ្ទាល់។ ប្រសិនបើអ្នកគ្រាន់តែចង់អានទិន្នន័យតាមរយៈការចូលប្រើ API វាគ្រប់គ្រាន់ក្នុងការបើកដំណើរការ view ការអនុញ្ញាត។
5. ធ្វើបែបបទដដែលៗសម្រាប់ធាតុទាំងអស់ដែលអ្នកចង់ចូលប្រើ

ការតភ្ជាប់តាមរយៈ MQTT

ការណែនាំ

ក្នុងនាមជាអតីតampដូច្នេះ យើងនឹងបង្ហាញការចូលប្រើប្រាស់តាមរយៈ MQTT API នៃ DIVUS KNX IQ ជាមួយនឹងកម្មវិធីឥតគិតថ្លៃដែលសាមញ្ញហៅថា MQTT Explorer (សូមមើលជំពូក 1.1) ដែលអាចប្រើបានសម្រាប់ Windows, Mac និង Linux ។ ចំណេះដឹង និងបទពិសោធន៍ជាមូលដ្ឋានជាមួយ MQTT ត្រូវបានបង្កប់ន័យ។

ទិន្នន័យដែលត្រូវការសម្រាប់ការភ្ជាប់

ដូចដែលបានរៀបរាប់ខាងលើ (សូមមើលផ្នែក 2.1) ឈ្មោះអ្នកប្រើ និងពាក្យសម្ងាត់របស់អ្នកប្រើ API ត្រូវបានទាមទារ។ នេះគឺចប់ហើយ។view នៃទិន្នន័យទាំងអស់ដែលត្រូវតែប្រមូលមុនពេលការតភ្ជាប់ត្រូវបានបង្កើតឡើង៖

• ឈ្មោះអ្នកប្រើប្រាស់ អាននៅលើទំព័រលម្អិតរបស់អ្នកប្រើ API
• ពាក្យសម្ងាត់ អាននៅលើទំព័រលម្អិតរបស់អ្នកប្រើ API
• អាសយដ្ឋាន IP សូមអាននៅក្នុងការកំណត់កម្មវិធីបើកដំណើរការនៅក្រោម ទូទៅ – បណ្តាញ – អ៊ីសឺរណិត (ឬតាមរយៈ Synchronizer)
• ច្រក 8884 (ច្រកនេះត្រូវបានបម្រុងទុកសម្រាប់គោលបំណងនេះ)

ការតភ្ជាប់ដំបូងជាមួយ MQTT EXPLORER និងការជាវទូទៅ

ជាធម្មតា MQTT បែងចែករវាងសកម្មភាពជាវ និងបោះផ្សាយ។ MQTT Explorer សម្រួលវាដោយការជាវដោយស្វ័យប្រវត្តិចំពោះប្រធានបទដែលមានទាំងអស់ (ប្រធានបទ #) នៅពេលដែលការតភ្ជាប់ដំបូងត្រូវបានបង្កើតឡើង។ ជាលទ្ធផល មែកធាងដែលនាំទៅដល់ធាតុដែលមានទាំងអស់ (ពោលគឺការចូលប្រើ API របស់អ្នកប្រើដែលត្រូវបានផ្តល់) អាចមើលឃើញដោយផ្ទាល់នៅក្នុងតំបន់ខាងឆ្វេងនៃបង្អួច MQTT Explorer បន្ទាប់ពីការតភ្ជាប់ជោគជ័យ។ ដើម្បីបញ្ចូលប្រធានបទជាវបន្ថែម ឬដើម្បីជំនួស # ជាមួយប្រធានបទជាក់លាក់បន្ថែមទៀត សូមចូលទៅកាន់កម្រិតខ្ពស់នៅក្នុងបង្អួចការតភ្ជាប់។ ប្រធានបទដែលបង្ហាញនៅខាងស្តាំខាងលើមើលទៅដូចនេះ៖

ដែលជាកន្លែងដែល 7f4x0607849x444xxx256573x3x9x983 គឺជាឈ្មោះអ្នកប្រើប្រាស់ API និង objects_list មានធាតុដែលមានទាំងអស់។ ប្រធានបទនេះតែងតែត្រូវបានរក្សាឱ្យទាន់សម័យជានិច្ច ពោលគឺការផ្លាស់ប្តូរតម្លៃណាមួយត្រូវបានឆ្លុះបញ្ចាំងនៅទីនោះក្នុងពេលវេលាជាក់ស្តែង។ ប្រសិនបើអ្នកគ្រាន់តែចង់ជាវធាតុនីមួយៗ បញ្ចូលលេខសម្គាល់ធាតុនៃធាតុដែលចង់បានបន្ទាប់ពី objects_list/។

ចំណាំ៖ ប្រភេទនៃការជាវនេះប្រហាក់ប្រហែលនឹងតក្កវិជ្ជានៅពីក្រោយអាសយដ្ឋានមតិកែលម្អរបស់ KNX ។ វាបង្ហាញស្ថានភាពបច្ចុប្បន្ននៃធាតុ ហើយអាចត្រូវបានប្រើដើម្បីពិនិត្យមើលថាតើការផ្លាស់ប្តូរដែលចង់បានត្រូវបានអនុវត្តដោយជោគជ័យដែរឬទេ។ ប្រសិន​បើ​អ្នក​គ្រាន់​តែ​ចង់​អាន​ទិន្នន័យ​តែ​មិន​បាន​ផ្លាស់​ប្តូ​រ​វា​ប្រភេទ​នៃ​ការ​ជាវ​នេះ​គឺ​គ្រប់គ្រាន់​។

ធាតុសាមញ្ញតែមួយមើលទៅដូចនេះនៅក្នុងសញ្ញាណ JSON

ចំណាំ៖ តម្លៃទាំងអស់មានវាក្យសម្ព័ន្ធដែលបានបង្ហាញខាងលើឧទាហរណ៍ { “value”: “1” } ជាលទ្ធផលនៃប្រធានបទជាវ ខណៈពេលដែលតម្លៃត្រូវបានសរសេរដោយផ្ទាល់នៅក្នុង payload ដើម្បីផ្លាស់ប្តូរតម្លៃមួយ (ឧទាហរណ៍សម្រាប់ប្រធានបទផ្សព្វផ្សាយ) – តង្កៀប និង "តម្លៃ" ត្រូវបានលុបចោលឧទាហរណ៍ "បិទ": "1" ។

ពាក្យបញ្ជាកម្រិតខ្ពស់

ការណែនាំ

ជាទូទៅមានប្រធានបទ ៣ ប្រភេទ៖

1. ជាវប្រធានបទដើម្បីមើលធាតុដែលមាន និងដើម្បីទទួលបានការផ្លាស់ប្តូរតម្លៃក្នុងពេលជាក់ស្តែង
2. ជាវប្រធានបទ ដើម្បីទទួលបានចម្លើយចំពោះ (អតិថិជន ) ផ្សព្វផ្សាយសំណើ
3. បោះពុម្ពប្រធានបទដើម្បីទទួលបាន ឬកំណត់ធាតុជាមួយនឹងតម្លៃរបស់វា។

ក្រោយមកយើងនឹងយោងទៅលើប្រភេទទាំងនេះដោយប្រើលេខរៀងដែលបានបង្ហាញនៅទីនេះ (ឧទាហរណ៍ ប្រធានបទនៃប្រភេទ 1, 2, 3)។ ព័ត៌មានលម្អិតបន្ថែមនៅក្នុងផ្នែកខាងក្រោម និងនៅក្នុងជំពូក។ ៤.២.

ជាវប្រធានបទដើម្បីមើលធាតុដែលមាន និងទទួលបានការផ្លាស់ប្តូរតម្លៃក្នុងពេលជាក់ស្តែង

ទាំងនេះត្រូវបានពិពណ៌នារួចហើយ

ជាវប្រធានបទដើម្បីទទួលបានចម្លើយចំពោះសំណើបោះពុម្ពរបស់អតិថិជន

ប្រធានបទប្រភេទនេះគឺស្រេចចិត្ត។ វាអនុញ្ញាតឱ្យ

• បើកបណ្តាញទំនាក់ទំនងតែមួយគត់ជាមួយម៉ាស៊ីនមេ MQTT ដោយប្រើ អតិថិជន_id បំពាន។ បន្ថែមទៀតអំពីវានៅក្នុងជំពូក។ ៤.២.២
• ទទួលបានលទ្ធផលនៃសំណើបោះផ្សាយលើប្រធានបទជាវដែលត្រូវគ្នា៖ ជោគជ័យ ឬបរាជ័យជាមួយនឹងលេខកូដកំហុស និងសារ។

មានប្រធានបទផ្សេងៗគ្នាដើម្បីទទួលបានចម្លើយដើម្បីទទួលបាន ឬកំណត់ពាក្យបញ្ជាបោះពុម្ពផ្សាយ។ ភាពខុសគ្នាដែលត្រូវគ្នានៅក្នុង នៅពេលដែលអ្នកទទួលបានប្រធានបទដែលត្រូវការសម្រាប់ប្រព័ន្ធរបស់អ្នកត្រង់ អ្នកអាចសម្រេចចិត្តដកជំហាននេះចេញ ហើយប្រើប្រាស់ប្រធានបទផ្សព្វផ្សាយដោយផ្ទាល់។

 ផ្សព្វផ្សាយប្រធានបទដើម្បីទទួលបាន ឬកំណត់ធាតុជាមួយនឹងតម្លៃរបស់ពួកគេ

ប្រធានបទទាំងនេះប្រើផ្លូវស្រដៀងនឹងផ្លូវសម្រាប់ការជាវ - ការផ្លាស់ប្តូរតែមួយគត់គឺពាក្យ "ស្នើសុំ" ជំនួសឱ្យ "ស្ថានភាព" ដែលប្រើដើម្បីជាវ។ ផ្លូវប្រធានបទពេញលេញត្រូវបានបង្ហាញនៅពេលក្រោយនៅក្នុងជំពូក។ 4.2.2\ ប្រធានបទទទួលបាននឹងស្នើសុំអានធាតុ និងតម្លៃរបស់ម៉ាស៊ីនមេ MQTT ។ payload អាចត្រូវបានប្រើដើម្បីត្រងដោយផ្អែកលើប្រភេទមុខងារនៃធាតុ។ ប្រធានបទដែលបានកំណត់នឹងស្នើសុំឱ្យផ្លាស់ប្តូរផ្នែកខ្លះនៃធាតុមួយ ដូចដែលបានរៀបរាប់លម្អិតនៅក្នុងបន្ទុករបស់វា។

បុព្វបទសម្រាប់ពាក្យបញ្ជា និងការឆ្លើយតបដែលត្រូវគ្នា។

 ការពន្យល់ខ្លីៗ

ពាក្យបញ្ជាទាំងអស់ដែលត្រូវបានផ្ញើទៅម៉ាស៊ីនមេ MQTT មានផ្នែកដំបូងទូទៅគឺ៖

ការពន្យល់លម្អិត

ប្រធានបទពេលវេលាជាក់ស្តែង (ប្រភេទទី 1) នឹងមានបុព្វបទទូទៅ (សូមមើលខាងលើ) បន្ទាប់មកបន្តដោយ

or

សម្រាប់សំណុំពាក្យបញ្ជា payload ជាក់ស្តែងដើរតួសំខាន់ព្រោះវានឹងមានការផ្លាស់ប្តូរដែលចង់បាន (ឧទាហរណ៍តម្លៃដែលបានផ្លាស់ប្តូរសម្រាប់មុខងាររបស់ធាតុ) ។ ការព្រមាន៖ កុំប្រើជម្រើសរក្សាទុកនៅក្នុងពាក្យបញ្ជាប្រភេទ 3 របស់អ្នកព្រោះវាអាចបណ្តាលឱ្យមានបញ្ហានៅលើផ្នែក KNX ។

EXAMPLE៖ បោះពុម្ពផ្សាយសម្រាប់ការផ្លាស់ប្តូរតម្លៃនៃធាតុតែមួយ

ករណីសាមញ្ញបំផុតគឺចង់ផ្លាស់ប្តូរតម្លៃនៃធាតុណាមួយដែលបង្ហាញដោយការជាវទូទៅ។
និយាយជាទូទៅ ការផ្លាស់ប្តូរ/ប្តូរមុខងាររបស់ VISION តាមរយៈ MQTT មាន 3 ជំហាន ដែលមិនមែនទាំងអស់សុទ្ធតែចាំបាច់នោះទេ ប៉ុន្តែយើងសូមផ្តល់អនុសាសន៍ឱ្យអនុវត្តពួកវាដូចដែលបានពិពណ៌នា។

1. ប្រធានបទដែលមានមុខងារដែលយើងចង់កែសម្រួលត្រូវបានជាវដោយប្រើ Custom client_id
2. ប្រធានបទសម្រាប់ការកែសម្រួលត្រូវបានបោះពុម្ពរួមគ្នាជាមួយនឹងបន្ទុកជាមួយនឹងការផ្លាស់ប្តូរដែលចង់បានដោយប្រើ client_id ដែលបានជ្រើសរើសក្នុង 1 ។
3. ដើម្បីពិនិត្យមើល អ្នកអាចឃើញចម្លើយនៅក្នុងប្រធានបទ (1.) – ពោលគឺថាតើ (2.) ដំណើរការឬអត់។
4. នៅក្នុងការជាវទូទៅ ដែលតម្លៃទាំងអស់ត្រូវបានធ្វើបច្ចុប្បន្នភាពនៅពេលដែលការផ្លាស់ប្តូរត្រូវបានធ្វើឡើង អ្នកអាចឃើញការផ្លាស់ប្តូរតម្លៃដែលចង់បាន ប្រសិនបើអ្វីៗដំណើរការបានល្អ។

ជំហានដើម្បីធ្វើវាគឺ៖

1. ជ្រើសរើស client_id ឧទាហរណ៍ "Divus" ហើយបញ្ចូលវាទៅក្នុងផ្លូវបន្ទាប់ពីឈ្មោះអ្នកប្រើ API
   នេះគឺជាប្រធានបទពេញលេញសម្រាប់ការជាវឆានែលទំនាក់ទំនងផ្ទាល់ខ្លួនរបស់អ្នកជាមួយម៉ាស៊ីនមេ MQTT ។ វាប្រាប់ម៉ាស៊ីនមេដែលអ្នករំពឹងថានឹងមានការឆ្លើយតបចំពោះការផ្លាស់ប្តូរដែលអ្នកមានបំណងផ្ញើ។ កត់សម្គាល់ស្ថានភាព/កំណត់ផ្នែកដែលកំណត់ a. ថាវាជាប្រធានបទជាវ និង ខ. ថាវានឹងទទួលបានចម្លើយដើម្បីកំណត់ប្រភេទពាក្យបញ្ជា។
2. ប្រធានបទបោះពុម្ពផ្សាយនឹងដូចគ្នា លើកលែងតែការប្តូរពាក្យគន្លឹះស្ថានភាព-សំណើ
3. អ្វីដែលការផ្លាស់ប្តូរគួរតែមានគឺត្រូវបានសរសេរនៅក្នុង payload ។ នេះគឺជាអតីតមួយចំនួនamples ។
   • ការបិទធាតុដែលមានមុខងារបើក/បិទ (1 ប៊ីត)៖
   • ប្តូរធាតុដែលមានមុខងារបើក/បិទ (1 ប៊ីត)។ លើសពីនេះទៀត ប្រសិនបើពាក្យបញ្ជាបែបនេះជាច្រើនត្រូវបានចាប់ផ្តើមពីម៉ាស៊ីនភ្ញៀវដូចគ្នា ប៉ារ៉ាម៉ែត្រ uuid ("លេខសម្គាល់តែមួយគត់" ជាធម្មតាជាខ្សែអក្សរ 128 ប៊ីតដែលបានធ្វើទ្រង់ទ្រាយជា 8-4-4-4-12 ខ្ទង់ hex) អាចត្រូវបានប្រើដើម្បីផ្តល់ ការឆ្លើយតបទៅនឹងសំណួរដែលត្រូវគ្នា ដោយសារប៉ារ៉ាម៉ែត្រនេះ - ប្រសិនបើមាននៅក្នុងសំណួរ - ក៏អាចត្រូវបានរកឃើញនៅក្នុងការឆ្លើយតបផងដែរ។
   • បើក និងកំណត់ពន្លឺនៃ dimmer ដល់ 50%
   • ចម្លើយចំពោះប្រធានបទដែលបានបង្ហាញ និងជាវខាងលើ (បន្ទុករបស់វា ដើម្បីឱ្យច្បាស់លាស់) គឺបន្ទាប់មកសម្រាប់ ឧ.ampលេ
     ការឆ្លើយតបខាងលើគឺជាអតីតample ក្នុងករណីបន្ទុកត្រឹមត្រូវ ទោះបីជាធាតុមិនមានមុខងារបន្ថយពន្លឺក៏ដោយ។ ប្រសិនបើមានបញ្ហាធ្ងន់ធ្ងរជាងនេះ ដែលនាំឱ្យបន្ទុកមិនត្រូវបានបកស្រាយត្រឹមត្រូវ ការឆ្លើយតបនឹងមើលទៅដូចនេះ (ឧទាហរណ៍)៖
     សម្រាប់ការពន្យល់អំពីលេខកូដកំហុស និងសារ ប៉ុន្តែជាទូទៅ ដូចជាសម្រាប់ http លេខកូដ 200 គឺជាចម្លើយវិជ្ជមាន ខណៈដែល 400 គឺអវិជ្ជមាន។

EXAMPLE៖ បោះពុម្ពផ្សាយសម្រាប់ការផ្លាស់ប្តូរតម្លៃធាតុជាច្រើន។

នីតិវិធីគឺស្រដៀងគ្នាទៅនឹងអ្វីដែលបានបង្ហាញពីមុនដើម្បីផ្លាស់ប្តូរធាតុតែមួយ។ ភាពខុសគ្នានោះគឺថាអ្នកលុប element_id ចេញពីប្រធានបទ ហើយបន្ទាប់មកបង្ហាញសំណុំ element_ids នៅពីមុខទិន្នន័យនៅខាងក្នុង payload ។ សូមមើលវាក្យសម្ព័ន្ធ និងរចនាសម្ព័ន្ធខាងក្រោម។

ត្រងតាមប្រភេទមុខងារនៅក្នុងសំណួរ

ប៉ារ៉ាម៉ែត្រតម្រងនៅក្នុង payload អនុញ្ញាតតែមុខងារដែលចង់បាននៃធាតុមួយដែលត្រូវបានដោះស្រាយ។ មុខងារបិទ/បើកនៃកុងតាក់ ឬ dimmer ត្រូវបានគេហៅថា "onoff" ឧទាហរណ៍ample ហើយតម្រងដែលត្រូវគ្នាត្រូវបានកំណត់តាមវិធីនេះ៖

ចម្លើយមើលទៅដូចនេះ ឧample

តង្កៀប​ការ៉េ​បង្ហាញ​ថា​អ្នក​ក៏​អាច​ត្រង​ដោយ​មុខងារ​មួយ​ចំនួន​ដែរ ឧ

នាំឱ្យមានចម្លើយដូចនេះ៖

ឧបសម្ព័ន្ធ

កូដកំហុស

កំហុសក្នុងការទំនាក់ទំនង MQTT បណ្តាលឱ្យមានលេខកូដលេខ។ តារាងខាងក្រោមជួយបំបែកវាចុះ។

ប៉ារ៉ាម៉ែត្រនៃបន្ទុក

payload គាំទ្រប៉ារ៉ាម៉ែត្រផ្សេងគ្នាអាស្រ័យលើបរិបទ។ តារាងខាងក្រោមបង្ហាញពីប៉ារ៉ាម៉ែត្រដែលអាចកើតឡើងនៅក្នុងប្រធានបទណាមួយ។

កំណត់ចំណាំកំណែ

• VERSION ៥.៥

ព័ត៌មាន៖

• ការបោះពុម្ពលើកដំបូង

ឯកសារ/ធនធាន

	កម្មវិធី DIVUS VISION API [pdf] សៀវភៅណែនាំអ្នកប្រើប្រាស់ កម្មវិធី VISION API កម្មវិធី API កម្មវិធី
	កម្មវិធី DIVUS Vision API [pdf] ការណែនាំអ្នកប្រើប្រាស់ កម្មវិធី Vision API កម្មវិធី Vision កម្មវិធី API កម្មវិធី

ឯកសារយោង

• សៀវភៅណែនាំអ្នកប្រើប្រាស់