सिलिकॉन लैब्स ज़िगबी एम्बरज़ नेट एसडीके निर्देश

सिलिकॉन लैब्स अपने उत्पादों में ज़िगबी नेटवर्किंग विकसित करने वाले OEM के लिए पसंदीदा विक्रेता है। सिलिकॉन लैब्स ज़िगबी प्लेटफ़ॉर्म सबसे एकीकृत, पूर्ण और सुविधा संपन्न ज़िगबी समाधान उपलब्ध है। सिलिकॉन लैब्स एम्बरज़नेट SDK में ज़िगबी स्टैक विनिर्देश का सिलिकॉन लैब्स का कार्यान्वयन शामिल है।

प्रमुख विशेषताऐं

ZigBee

एपीएस लिंक कुंजी तालिका में -250+ प्रविष्टियाँ
Android 12 (v21.0.6113669) और Tizen (v0.1-13.1) पर ZigbeeD सपोर्ट

xG26 मॉड्यूल समर्थन

मल्टी प्रोटोकॉल

OpenWRT पर ZigbeeD और OTBR समर्थन – GA
डीएमपी बीएलई + सीएमपी जेडबी और मैटर/ओटी एसओसी के लिए एमजी26 पर समवर्ती श्रवण के साथ - जीए

802.15.4 एकीकृत रेडियो अनुसूचक प्राथमिकता घटक
एमपी होस्ट अनुप्रयोगों के लिए डेबियन पैकेजिंग समर्थन – अल्फा

नये आइटम

महत्वपूर्ण परिवर्तन
APS लिंक कुंजी तालिका आकार (SL_ZIGBEE_KEY_TABLE_SIZE का उपयोग करके कॉन्फ़िगर किया गया) 127 से 254 प्रविष्टियों तक विस्तारित किया गया है।

ZDD नेटवर्क कमीशनिंग कार्यक्षमता के लिए R23 समर्थन जोड़ा गया है। टनलिंग कार्यक्षमता लीगेसी नेटवर्क उपयोग मामलों के लिए समर्थन के बिना उपलब्ध है।

नेटवर्क स्टीयरिंग और नेटवर्क क्रिएटर घटकों को R23 जॉइनिंग के लिए समर्थन शामिल करने के लिए अपडेट किया गया है। इनमें निम्नलिखित संबंधित परिवर्तन शामिल हैं।
- प्रत्येक अनुरोधकर्ता डिवाइस के लिए नई कुंजियाँ उत्पन्न करने के लिए डिफ़ॉल्ट ट्रस्ट सेंटर लिंक कुंजी (TCLK) अनुरोध नीति को अपडेट किया गया है। हर बार जब अनुरोधकर्ता डिवाइस अपनी ट्रस्ट सेंटर लिंक कुंजी को अपडेट करने का प्रयास करते हैं, तो एक नई कुंजी उत्पन्न होती है।
- पिछले TCLK नीति परिवर्तन के कारण, नेटवर्क क्रिएटर सुरक्षा घटक को अब सुरक्षा लिंक कुंजी घटक की आवश्यकता है। इस नई आवश्यकता के अनुरूप अनुप्रयोगों को अपग्रेड किया जाएगा।
- एक नया विन्यास,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY को कोर, हैश की का उपयोग करके जुड़ने की अनुमति देने के लिए जोड़ा गया है। यह कॉन्फ़िगरेशन नेटवर्क क्रिएटर सुरक्षा घटक के अंतर्गत पाया जाता है। इस नीति का उपयोग प्रत्येक जुड़ने वाले डिवाइस को जुड़ने के बाद एक अद्वितीय TCLK प्राप्त करने की अनुमति देता है, लेकिन TCLK को अपडेट करने के बार-बार प्रयास करने से अनुरोध करने वाले डिवाइस के लिए एक नई कुंजी नहीं मिलेगी। हैश की गई लिंक कुंजियों का यह उपयोग इस रिलीज़ से पहले डिफ़ॉल्ट नीति थी, और इस नीति का उपयोग ट्रस्ट सेंटर को सुरक्षा लिंक कुंजी घटक को लाने से बचने की अनुमति देता है, जो फ़्लैश में कुंजियों को सहेजता है।
  टिप्पणीसिलिकॉन लैब्स इस नीति के उपयोग की अनुशंसा नहीं करता है, क्योंकि यह जुड़ने वाले उपकरणों को उनके TCLK को रोल करने या अपडेट करने से रोकता है।

होस्ट SPI डिवाइस और उसके पिन इंटरफेस के कॉन्फ़िगरेशन की अनुमति देने के लिए घटक zigbee_ezsp_spi में एक नया कॉन्फ़िगरेशन सेट जोड़ा गया है।
भूतपूर्वample परियोजनाएं, परियोजना सहित files (.slcps) और प्रोजेक्ट फ़ोल्डर का नाम बदलकर सिलिकॉन लैब्स नामकरण दिशानिर्देश कर दिया गया है और इसे "प्रोजेक्ट्स" निर्देशिका के अंतर्गत ले जाया गया है।

नया प्लेटफ़ॉर्म समर्थन

नए मॉड्यूल
- एमजीएम260पीडी32वीएनए2
- एमजीएम260पीडी32वीएनएन2
- एमजीएम260पीडी22वीएनए2
- एमजीएम260पीबी32वीएनए5
- एमजीएम260पीबी32वीएनएन5
- एमजीएम260पीबी22वीएनए5
- बीजीएम260पीबी22वीएनए2
- बीजीएम260पीबी32वीएनए2
- नये रेडियो बोर्ड
- एमजीएम260पी-आरबी4350ए
- एमजीएम260पी-आरबी4351ए
नया भाग
- एफ़आर32xg27
एक्सप्लोरर किट
- बीआरडी2709ए
- एमजीएम260पी-ईके2713ए

नया दस्तावेज़ीकरण
600 और उससे ऊपर के संस्करणों के लिए एक नया EZSP उपयोगकर्ता मार्गदर्शिका UG8.1.

सुधार

SL_ZIGBEE_KEY_TABLE_SIZE सीमा को 254 प्रविष्टियों तक बढ़ाया गया।
Z3Light में zigbee_security_link_keys जोड़ा गया।
zigbee_mp_z3_tc_z3_tc में zigbee_security_link_keys को जोड़ा गया। साथ ही इसकी कुंजी तालिका का आकार भी अपडेट किया गया।
Z3 गेटवे कुंजी तालिका का आकार (जिसे ncp पर सेट किया जाएगा) बढ़ाकर 20 कर दिया गया है।

निश्चित मुद्दे

वर्तमान रिलीज में ज्ञात मुद्दे

पिछले रिलीज़ के बाद से बोल्ड अंक जोड़े गए थे। यदि आप कोई रिलीज़ चूक गए हैं, तो हालिया रिलीज़ नोट यहां उपलब्ध हैं https://www.silabs.com/developers/zigbee-emberznet टेक डॉक्स टैब में।

पदावनत आइटम

zigbee_watchdog_periodic_refresh घटक अब Zigbee एप्लिकेशन फ़्रेमवर्क में उपयोग नहीं किया जाता है और इस रिलीज़ में इसे हटा दिया गया है। वॉचडॉग टाइमर डिफ़ॉल्ट रूप से सभी अनुप्रयोगों के लिए अक्षम हैampभविष्य में SDK में एक बेहतर वॉचडॉग घटक जोड़ा जाएगा।
टिप्पणी: अपने एप्लिकेशन में कॉन्फ़िगरेशन आइटम SL_LEGACY_HAL_DISABLE_WATCHDOG को 0 पर सेट करके वॉचडॉग टाइमर सक्षम करें

नेटवर्क सीमाएँ और विचार

इस EmberZNet रिलीज़ के साथ आने वाले डिफ़ॉल्ट ट्रस्ट सेंटर एप्लिकेशन नेटवर्क पर कई डिवाइस को सपोर्ट करने में सक्षम हैं। यह संख्या कई कारकों के आधार पर निर्धारित की जाती है, जिसमें कॉन्फ़िगर किए गए टेबल आकार, NVM उपयोग और अन्य जनरेशन समय और रन-टाइम मान शामिल हैं। बड़े नेटवर्क बनाने की चाह रखने वाले उपयोगकर्ताओं को एप्लिकेशन द्वारा सपोर्ट किए जा सकने वाले नेटवर्क से बड़ा नेटवर्क बनाते समय संसाधन संबंधी समस्याओं का सामना करना पड़ सकता है। उदाहरण के लिएampले, ट्रस्ट सेंटर से ट्रस्ट सेंटर लिंक कुंजी का अनुरोध करने वाला डिवाइस ट्रस्ट सेंटर पर sl_zigbee_af_zigbee_key_establishment_cb कॉलबैक ट्रिगर कर सकता है, जिसमें h स्थिति SL_ZIGBEE_KEY_TABLE_FULL पर सेट होती है, जो यह दर्शाता है कि कुंजी तालिका में अनुरोध करने वाले डिवाइस के लिए नई कुंजी जोड़ने के लिए जगह नहीं है या NVM3 में कोई उपलब्ध स्थान नहीं है। सिलिकॉन लैब्स बड़े नेटवर्क बनाने के इच्छुक उपयोगकर्ताओं के लिए निम्नलिखित अनुशंसाएँ प्रदान करता है। ट्रस्ट सेंटर अनुप्रयोगों के लिए, निम्नलिखित कॉन्फ़िगरेशन की अनुशंसा की जाती है। ये अनुशंसाएँ संपूर्ण नहीं हैं, और वे बड़े नेटवर्क विकसित करने के इच्छुक अनुप्रयोगों के लिए आधार रेखा के रूप में काम करती हैं।

पता तालिका घटक (zigbee_address_table) को शामिल करना,
- SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE कॉन्फ़िगरेशन आइटम को वांछित नेटवर्क के आकार पर सेट किया गया
- SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE मान अधिकतम (4) पर सेट किया गया

सुरक्षा लिंक कुंजी घटक (zigbee_security_link_keys) को शामिल करना,
- SL_ZIGBEE_KEY_TABLE_SIZE मान नेटवर्क के आकार पर सेट किया गया है
निम्नलिखित कॉन्फ़िगरेशन आइटम वांछित नेटवर्क के आकार पर सेट किए गए हैं
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, जैसा कि Zigbee Pro Stack घटक में पाया जाता है
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, जैसा कि स्रोत रूटिंग घटक में पाया जाता है, यदि स्रोत रूटिंग का उपयोग किया जाता है
NVM3 उपयोग के अनुसार NVM3_DEFAULT_NVM_SIZE और NVM3_DEFAULT_CACHE_SIZE का समायोजन
- उदाहरण के लिए 65 नोड्स से अधिक नेटवर्क आकार के लिए संभवतः 3K के NVM64 आकार की आवश्यकता होती है। सिलिकॉन लैब्स ज़िगबी में डिफ़ॉल्ट NVM3 आकारample एप्लीकेशन का मान 32K है। NVM का अधिक उपयोग करने वाले एप्लीकेशन को इस मान को और भी अधिक समायोजित करने की आवश्यकता हो सकती है।
- 65 नोड्स तक के बड़े नेटवर्कों को 3 बाइट्स के NVM1200 कैश आकार की आवश्यकता हो सकती है; इससे बड़े नेटवर्कों को इस मान को दोगुना करके 2400 बाइट्स करने की आवश्यकता हो सकती है।

ये समायोजन केवल ट्रस्ट सेंटर पर लागू होते हैं

मल्टीप्रोटोकॉल गेटवे और आरसीपी

नये आइटम
xG26 भागों पर समवर्ती श्रवण के साथ Zigbee + Openthread CMP के साथ BLE DMP के लिए GA SoC समर्थन सक्षम किया गया। Zigbeed, OTBR और Z3Gateway अनुप्रयोगों के लिए डेबियन अल्फा समर्थन जोड़ा गया है। चुने गए संदर्भ प्लेटफ़ॉर्म (रास्पबेरी PI 4) के लिए भी Zigbeed और OTBR DEB पैकेज प्रारूप में प्रदान किए जाते हैं। मल्टीप्रोटोकॉल को-प्रोसेसर के साथ लिनक्स होस्ट पर Zigbee, OpenThread और Bluetooth को समवर्ती रूप से चलाना देखें, यहाँ पाया गया docs.silabs.com, अधिक जानकारी के लिए। arm0.1 और aarch13.1 के लिए Tizen-32-64 के साथ-साथ aarch12 के लिए Android 64 के लिए Zigbeed समर्थन जोड़ा गया। Zigbeed के बारे में अधिक जानकारी यहाँ पाई जा सकती है docs.silabs.com. नया "802.15.4 एकीकृत रेडियो शेड्यूलर प्राथमिकता" घटक जोड़ा गया। इस घटक का उपयोग 15.4 स्टैक की रेडियो प्राथमिकताओं को कॉन्फ़िगर करने के लिए किया जाता है। घटक को नए "रेडियो_प्राथमिकता_कॉन्फ़िगरेटर" घटक की भी आवश्यकता होती है। यह घटक परियोजनाओं को सिंपलिसिटी स्टूडियो में रेडियो प्राथमिकता कॉन्फ़िगरेटर टूल का उपयोग करने की अनुमति देता है ताकि उन स्टैक के रेडियो प्राथमिकता स्तरों को कॉन्फ़िगर किया जा सके जिन्हें इसकी आवश्यकता है।

सुधार
अनुप्रयोग नोट मल्टीप्रोटोकॉल को-प्रोसेसर (AN1333) के साथ लिनक्स होस्ट पर ज़िगबी, ओपनथ्रेड और ब्लूटूथ को एक साथ चलाना स्थानांतरित कर दिया गया है docs.silabs.com. OpenWRT समर्थन अब GA गुणवत्ता वाला है। Zigbee, OTBR और Z3Gateway अनुप्रयोगों के लिए OpenWRT समर्थन जोड़ा गया है। संदर्भ प्लेटफ़ॉर्म (रास्पबेरी PI 4) के लिए भी Zigbeed और OTBR IPK पैकेज प्रारूप में प्रदान किए जाते हैं। मल्टीप्रोटोकॉल को-प्रोसेसर के साथ लिनक्स होस्ट पर Zigbee, OpenThread और Bluetooth को एक साथ चलाना देखें, यहाँ पाया गया docs.silabs.com, जानकारी के लिए।

निश्चित मुद्दे

वर्तमान रिलीज में ज्ञात मुद्दे
बोल्ड में लिखे गए मुद्दे पिछली रिलीज़ के बाद जोड़े गए हैं। अगर आपने कोई रिलीज़ मिस कर दी है, तो हाल ही में रिलीज़ किए गए नोट यहाँ उपलब्ध हैंhttps://www.silabs.com/developers/simplicity-software-development-kit.

पदावनत आइटम
"मल्टीप्रोटोकॉल कंटेनर" जो वर्तमान में DockerHub (siliconlabsinc/multiprotocol) पर उपलब्ध है, आगामी रिलीज़ में अप्रचलित हो जाएगा। कंटेनर को अब अपडेट नहीं किया जा सकेगा और DockerHub से खींचा नहीं जा सकेगा। cpcd, ZigBee और ot-br-posix के लिए डेबियन-आधारित पैकेज, साथ ही मूल रूप से जेनरेट और संकलित प्रोजेक्ट, कंटेनर को हटाने के साथ खोई गई कार्यक्षमता को प्रतिस्थापित करेंगे।

इस रिलीज का उपयोग करना

इस रिलीज़ में निम्नलिखित शामिल हैं:

ज़िग्बी स्टैक
ज़िग्बी एप्लीकेशन फ्रेमवर्क
ज़िग्बी एसampले एप्लीकेशन

Zigbee और EmberZNet SDK के बारे में अधिक जानकारी के लिए UG103.02: Zigbee Fundamentals देखें। यदि आप पहली बार उपयोगकर्ता हैं, तो अपने विकास परिवेश को कॉन्फ़िगर करने, निर्माण करने और फ्लैश करने के निर्देशों के लिए QSG180: SDK 7.0 और उच्चतर के लिए Zigbee EmberZNet क्विक-स्टार्ट गाइड देखें।ample अनुप्रयोग, और दस्तावेज़ संदर्भ ext चरणों की ओर इशारा करते हैं।

स्थापना और उपयोग
Zigbee EmberZNet SDK को Simplicity SDK के भाग के रूप में प्रदान किया गया है, जो कि Silicon Labs SDK का एक समूह है। Simplicity SDK के साथ जल्दी से शुरुआत करने के लिए, Simplicity Studio 5 को इंस्टॉल करें, जो आपके विकास परिवेश को सेट करेगा और Simplicity SDK इंस्टॉलेशन के माध्यम से आपको मार्गदर्शन करेगा। Simplicity Studio 5 में Silicon Labs डिवाइस के साथ IoT उत्पाद विकास के लिए आवश्यक सभी चीजें शामिल हैं, जिसमें संसाधन और प्रोजेक्ट लॉन्चर, सॉफ़्टवेयर कॉन्फ़िगरेशन टूल, GNU टूलचेन के साथ पूर्ण IDE और विश्लेषण टूल शामिल हैं। इंस्टॉलेशन निर्देश ऑनलाइन Simplicity Studio 5 उपयोगकर्ता गाइड में दिए गए हैं। वैकल्पिक रूप से, Simplicity SDK को GitHub से नवीनतम संस्करण डाउनलोड या क्लोन करके मैन्युअल रूप से इंस्टॉल किया जा सकता है। देखें https://github.com/SiliconLabs/simplicity_sdk अधिक जानकारी के लिए। Simplicity Studio डिफ़ॉल्ट रूप से Simplicity SDK को निम्न में इंस्टॉल करता है:

(विंडोज़): C:\Users\\SimplicityStudio\SDKs\simplicity_sdk

(MacOS): /Users//SimplicityStudio/SDKs/simplicity_sdk

SDK संस्करण के लिए विशिष्ट दस्तावेज़ SDK के साथ इंस्टॉल किए जाते हैं। अतिरिक्त जानकारी अक्सर नॉलेज बेस लेखों (KBA) में पाई जा सकती है। इस और पहले के रिलीज़ के बारे में API संदर्भ और अन्य जानकारी यहाँ उपलब्ध है https://docs.silabs.com/.

सुरक्षा जानकारी
सुरक्षित तिजोरी एकीकरण
उन अनुप्रयोगों के लिए जो सुरक्षित वॉल्ट-हाई भागों पर सुरक्षित कुंजी संग्रहण घटक का उपयोग करके कुंजियों को सुरक्षित रूप से संग्रहीत करना चुनते हैं, निम्न तालिका संरक्षित कुंजी और उनकी भंडारण सुरक्षा विशेषताओं को दिखाती है जिन्हें ज़िगबी सुरक्षा प्रबंधक घटक प्रबंधित करता है।"गैर-निर्यात योग्य" के रूप में चिह्नित की गई लपेटी हुई कुंजियों का उपयोग किया जा सकता है लेकिन नहीं किया जा सकता है viewरनटाइम पर संपादित या साझा की जाती हैं। लपेटी गई कुंजियाँ जिन्हें "निर्यात योग्य" के रूप में चिह्नित किया जाता है, रनटाइम पर उपयोग या साझा की जा सकती हैं, लेकिन फ़्लैश में संग्रहीत होने पर एन्क्रिप्टेड रहती हैं। उपयोगकर्ता अनुप्रयोगों को इनमें से अधिकांश कुंजियों के साथ कभी भी बातचीत करने की आवश्यकता नहीं होती है। लिंक कुंजी तालिका कुंजियों या क्षणिक कुंजियों को प्रबंधित करने के लिए मौजूदा API अभी भी उपयोगकर्ता अनुप्रयोग के लिए उपलब्ध हैं और उन्हें ज़िगबी सुरक्षा प्रबंधक घटक के माध्यम से रूट किया जाता है।

सुरक्षा सलाह
सुरक्षा सलाह की सदस्यता लेने के लिए, सिलिकॉन लैब्स ग्राहक पोर्टल में लॉग इन करें, फिर अकाउंट होम चुनें। पोर्टल होम पेज पर जाने के लिए होम पर क्लिक करें और फिर नोटिफिकेशन प्रबंधित करें टाइल पर क्लिक करें। सुनिश्चित करें कि 'सॉफ़्टवेयर/सुरक्षा सलाहकार नोटिस और उत्पाद परिवर्तन नोटिस (पीसीएन)' चेक किया गया है, और आपने अपने प्लेटफ़ॉर्म और प्रोटोकॉल के लिए कम से कम सब्सक्राइब किया है। किसी भी परिवर्तन को सहेजने के लिए सहेजें पर क्लिक करें।

सहायता
विकास किट ग्राहक प्रशिक्षण और तकनीकी सहायता के लिए पात्र हैं। सिलिकॉन प्रयोगशालाओं ज़िग्बी का उपयोग करें web सभी सिलिकॉन लैब्स ज़िगबी उत्पादों और सेवाओं के बारे में जानकारी प्राप्त करने और उत्पाद सहायता के लिए साइन अप करने के लिए पेज पर जाएँ। आप सिलिकॉन लैबोरेटरीज सहायता से यहाँ संपर्क कर सकते हैं http://www.silabs.com/support.

ज़िगबी प्रमाणन
एम्बर ZNet 8.1 रिलीज को SoC, NC, P, और RCP आर्किटेक्चर के लिए Zigbee अनुरूप प्लेटफ़ॉर्म के लिए योग्य बनाया गया है, इस रिलीज से जुड़ी एक ZCP प्रमाणन आईडी है, कृपया CSA की जाँच करें webसाइट यहाँ:
https://csa-iot.org/csa-iot_products/.

कृपया ध्यान दें कि ZCP प्रमाणीकरण fileरिलीज के बाद इसे लागू किया जाता है, तथा सीएसए पर इसे लागू होने में कुछ सप्ताह का समय लगता है webसाइट। किसी भी अन्य प्रश्न के लिए, कृपया सिलिकॉन प्रयोगशालाओं के समर्थन से संपर्क करें http://www.silabs.com/support.

पूछे जाने वाले प्रश्न

प्रश्न: मैं SDK में APS लिंक कुंजी तालिका आकार को कैसे अद्यतन करूं?
उत्तर: APS लिंक कुंजी तालिका आकार को SL_ZIGBEE_KEY_TABLE_SIZE पैरामीटर का उपयोग करके कॉन्फ़िगर किया जा सकता है। संस्करण 8.1 में, इसे 127 से बढ़ाकर 254 प्रविष्टियाँ कर दिया गया है।

प्रश्न: संस्करण 8.1 में क्या सुधार हैं?
उत्तर: संस्करण 8.1 में कई सुधार किए गए हैं, जैसे कि APS लिंक कुंजी तालिका का आकार बढ़ाना, घटकों का नाम बदलना, Athe pp Framework ईवेंट कतार के लिए म्यूटेक्स सुरक्षा जोड़ना, और बहुत कुछ। सुधारों की विस्तृत सूची के लिए रिलीज़ नोट्स देखें।

प्रश्न: मैं SDK में तय की गई समस्याओं को कैसे संभालूँ?
उत्तर: SDK में संभावित समस्याओं को ठीक किया गया है, जिसमें पड़ोसी तालिका आकार कॉन्फ़िगरेशन, घटकों का नाम बदलना, स्रोत रूट ओवरहेड को ठीक करना, ZCL कमांड को संभालना, और बहुत कुछ शामिल है। सुनिश्चित करें कि आप इन सुधारों से लाभ उठाने के लिए नवीनतम संस्करण में अपडेट करें।

दस्तावेज़ / संसाधन

सिलिकॉन लैब्स ज़िगबी एम्बरज़ नेट एसडीके [पीडीएफ] निर्देश
ज़िगबी एम्बरज़ेड नेट एसडीके, एम्बरज़ेड नेट एसडीके, नेट एसडीके, एसडीके

संदर्भ

उपयोगकर्ता पुस्तिका

सिलिकॉन लैब्स ज़िगबी एम्बरज़ नेट एसडीके

विशेष विवरण

उत्पाद की जानकारी