मैंने SmartThings हब, भाग 1 में एक नया उपकरण कैसे जोड़ा

इस लेख में मैं स्मार्टथिंग्स के लिए तथाकथित डिवाइस हैंडलर के विकास में अपने अनुभव के बारे में बात करना चाहता हूं। कार्य Z- वेव प्रोटोकॉल पर आधारित एक सार्वभौमिक उपकरण - Z-Uno के साथ-साथ इससे जुड़े बाल उपकरणों के प्रसंस्करण को जोड़ने का था।



विकास का परिचय मुझे काफी समय लगा, लेकिन अधिकांश प्रलेखन का सावधानीपूर्वक अध्ययन करने के बाद, आगे के विकास के लिए बहुत अधिक प्रयास की आवश्यकता नहीं थी। इसके परिणामस्वरूप, रूसी-भाषी उपयोगकर्ता के काम को सुविधाजनक बनाने के लिए इस लेख को लिखने का निर्णय लिया गया था।

संपूर्ण विकास प्रक्रिया GroThy भाषा SmartThings IDE वेब एप्लिकेशन में होती है। मोबाइल डिवाइस से बाहर ले जाने के लिए परीक्षण अधिक सुविधाजनक है, हालांकि, समान विकास वातावरण में डिवाइस सिमुलेटर बनाना संभव है। ग्राफिकल शेल के परीक्षण के मामले में, स्मार्टथिंग्स क्लासिक मोबाइल एप्लिकेशन ( एंड्रॉइड , आईओएस ) का उपयोग करने की आवश्यकता पहले से ही है।

प्लग-इन डिवाइस एक बोर्ड है जो आपको Z-Wave में लगभग किसी भी डिवाइस पर नियंत्रण जोड़ने की अनुमति देता है। इसके अलावा, जुड़े डिवाइस एक अलग संख्या (32 पीसी तक) हो सकते हैं। तदनुसार, सॉफ़्टवेयर स्तर पर, सभी प्रकार के जुड़े उपकरणों को संसाधित करना होगा और एप्लिकेशन को आउटपुट नियंत्रित करना होगा।

संसाधित प्रकारों की सूची:

• बाइनरी स्विच करें - केवल दो पदों वाले उपकरण: चालू / बंद
• बहुस्तरीय स्विच करें - ऐसे उपकरण जिन्हें अलग-अलग अर्थों में बंद या चालू किया जा सकता है। उदाहरण के लिए, एक डिमर।
• सेंसर मल्टीलेवल - सेंसर जो नॉन-बाइनरी मान भेजते हैं। उदाहरण के लिए, एक तापमान सेंसर।
• मीटर - एक काउंटर की तरह डिवाइस
• अधिसूचना - बाइनरी सेंसर इस प्रकार के होंगे। उदाहरण के लिए, एक रीड स्विच।
• थर्मोस्टेट - टीमों का एक अलग वर्ग जो थर्मोस्टेट के साथ काम करने के लिए जिम्मेदार है

दस्तावेज़ संरचना

दो तार्किक ब्लॉकों को अलग किया जा सकता है:

• हैंडलर के बारे में विवरण और मेटा जानकारी। इसमें डिवाइस के बारे में जानकारी शामिल है, कैसे यूआई और अन्य जानकारी खींची जानी चाहिए। इसे metadata() विधि द्वारा आवंटित किया जाता है।
  
  
  
• हैंडलर तरीके हैंडलर लॉजिक हैं। वे डिवाइस के साथ "संचार" के लिए जिम्मेदार हैं।
  
  अलग-अलग, हम पार्स () पद्धति को भेद कर सकते हैं, जो डिवाइस से प्राप्त आदेशों की व्याख्या करता है।

मैं लेखों की श्रृंखला के दौरान प्रत्येक ब्लॉक के उद्देश्य और सामग्री का अधिक विस्तार से वर्णन करूंगा।

मेटाडाटा

जैसा कि आप विधि के नाम से देख सकते हैं, इसमें मेटा-जानकारी है।

आइए इस ब्लॉक में शामिल किए गए क्रम में विचार करें:

परिभाषा ()

इस पद्धति में, तर्क क्रमशः तीन चीजों को इंगित करते हैं: हैंडलर का नाम, नाम स्थान और लेखक का नाम।

• हैंडलर का नाम भविष्य में बाल उपकरणों को बनाते समय और प्रकाशित करते समय उपयोग किया जाएगा।
• नामस्थान का उपयोग तब किया जाता है जब नाम से हैंडलर की खोज यह सुनिश्चित करने के लिए कि सही एक पाया जाता है, उदाहरण के लिए, उसी नाम वाले हैंडलर के बीच। स्मार्टथिंग्स अपने उपनाम को जीथब पर उपयोग करने की सलाह देते हैं।
• लेखक का नाम आपके नाम के साथ भरा गया है।

  definition(name: "Your device", namespace: "yournamespace", author: "your name") {} 

निम्नलिखित चर को विधि के शरीर में घोषित किया जा सकता है: attribute, capability, command, fingerprint । इसके अलावा हम और अधिक विस्तार से विचार करेंगे कि यह क्या है और इसे कब लागू किया जाता है।

कनेक्शन और फिंगरप्रिंटिंग

हम अपने डिवाइस को कनेक्ट करते हैं। हमारे मामले में, SmartThings V2 हब और Z-Uno का उपयोग किया जाएगा।

एक नया Z-Wave या ZigBee डिवाइस जोड़ने के क्षण में, हब यह पहचानने की कोशिश करेगा कि वे किस प्रकार के डिवाइस को कनेक्ट करने की कोशिश कर रहे हैं और सबसे अधिक प्रासंगिक हैंडलर की तलाश शुरू कर रहे हैं। वह इसे "फिंगरप्रिंट्स" द्वारा चुनेंगे। यदि हब कस्टम हैंडलर में मेल नहीं खाता है, तो वह निकटतम मानक टेम्प्लेट में से एक का उपयोग करने का प्रयास करेगा।

"फ़िंगरप्रिंट" को हैंडलर में सेट किया गया है ताकि यह इंगित किया जा सके कि यह किस प्रकार के उपकरणों का समर्थन करता है। आधिकारिक प्रलेखन कहता है कि वे जेड-वेव डिवाइस और ज़िगबी उपकरणों के लिए अलग-अलग होंगे, हम जेड-वेव के लिए कार्यान्वयन पर विचार करेंगे।

जेड-वेव प्रोटोकॉल डिवाइस अपने निर्माता, डिवाइस प्रकार, इसकी क्षमताओं, आदि के बारे में जानकारी संग्रहीत करते हैं। डिवाइस के साथ तथाकथित "साक्षात्कार" के दौरान, एसटी जेड-वेव कच्चे विवरण में इस जानकारी को एकत्र करता है। ऐसी रेखा का एक उदाहरण:

 zw:Ss type:2101 mfr:0086 prod:0102 model:0064 ver:1.04 zwv:4.05 lib:03 cc:5E,86,72,98,84 ccOut:5A sec:59,85,73,71,80,30,31,70,7A role:06 ff:8C07 ui:8C07 

प्रत्येक कुंजी का मूल्य "फिंगरप्रिंट" भरने के लिए उपयोग किया जाता है। प्रत्येक आइटम का विस्तृत विवरण यहां पाया जा सकता है । हम उन पर विचार करेंगे जिनका उपयोग हमारे हैंडलर में किया जाएगा।

जानकारी के साथ इस लाइन को खोजने के लिए, आपको 'माय डिवाइसेस' टैब पर जाना होगा और उस डिवाइस पर क्लिक करना होगा जिसमें हम रुचि रखते हैं (इससे पहले, डिवाइस को नेटवर्क में जोड़ा जाना चाहिए)।



mfr एक 16-बिट मान है जिसमें निर्माता ID है। निर्माताओं और उनकी आईडी की एक सूची यहां पाई जा सकती है ।

ठेस - उत्पाद प्रकार आईडी युक्त एक 16-बिट मान - एक अद्वितीय डिवाइस प्रकार आईडी।

मॉडल एक 16-बिट मान है जिसमें उत्पाद ID है।

inClusters - एक 8-बिट मान जो किसी विशेष कमांड क्लास की आवश्यकता को स्थापित करता है। उदाहरण के लिए, यदि हमें यह इंगित करने की आवश्यकता है कि हमारा हैंडलर मल्टीचैनल सीसी के साथ काम करेगा, तो आपको इसके कोड 0x60 लिखना होगा। स्मार्टथिंग्स सीसी के लिए उपलब्ध सूची की सूची यहां देखी जा सकती है ।

ये चार चाबियां हब को समझने के लिए पर्याप्त हैं कि यह हैंडलर किस डिवाइस से संबंधित है। मेरे साथ उनका कैसे उपयोग किया जाता है, इसका एक उदाहरण:

 fingerprint mfr: "0115", prod: "0110", model: "0001", inClusters: "0x60" fingerprint mfr: "0115", prod: "0111", inClusters: "0x60" 

एक डिवाइस में बड़ी संख्या में पैरामीटर हो सकते हैं, इस स्थिति में यह इस हैंडलर से सफलतापूर्वक जुड़ सकता है, हालांकि, यदि उनमें से कम से कम घोषित फिंगरप्रिंट से मेल नहीं खाता है, तो डिवाइस इस हैंडलर को अनदेखा करेगा।

स्मार्टथिंग्स फिंगरप्रिंट में निर्माता (mfr) और मॉडल (ठेस, मॉडल) के बारे में जानकारी जोड़ने की सलाह देते हैं, ताकि मामलों को बाहर किया जा सके जब एक हैंडलर की पसंद स्पष्ट नहीं होगी। उदाहरण के लिए, जब डिफ़ॉल्ट रूप से उपयोग किए जाने वाले किसी टेम्पलेट या उदाहरण के फिंगरप्रिंट आपके मेल खाएंगे।

कोड में स्थान

 metadata { definition(...) { ... fingerprint mfr: "0115", prod: "0110", model: "0001", inClusters: "0x60" fingerprint mfr: "0115", prod: "0111", inClusters: "0x60" } ... } 

लेखों का एक पूरा चक्र जारी करने की योजना है। मुझे उम्मीद है कि यह जानकारी आपको विकास में मदद करेगी।