تعليمات SDK لـ Zigbee EmberZ Net من SILICON LABS

Silicon Labs هي الشركة المفضلة لدى الشركات المصنعة للمعدات الأصلية التي تعمل على تطوير شبكات Zigbee في منتجاتها. تعتبر منصة Zigbee من Silicon Labs الحل الأكثر تكاملاً واكتمالاً وثراءً بالميزات من Zigbee. تحتوي مجموعة أدوات تطوير البرمجيات EmberZNet من Silicon Labs على تنفيذ Silicon Labs لمواصفات مجموعة Zigbee.

المميزات الرئيسية

زيجبي

-250+ إدخالات في جدول مفتاح ارتباط APS
دعم ZigbeeD على Android 12 (v21.0.6113669) و Tizen (v0.1-13.1)

دعم وحدة xG26

متعدد البروتوكولات

دعم ZigbeeD وOTBR على OpenWRT – GA
DMP BLE + CMP ZB & Matter/OT مع الاستماع المتزامن على MG26 لنظام SoC – GA

مكون أولوية جدول الراديو الموحد 802.15.4
دعم حزمة Debian لتطبيقات الاستضافة متعددة الوسائط – Alpha

عناصر جديدة

تغييرات هامة
تم توسيع حجم جدول مفتاح ارتباط APS (الذي تم تكوينه باستخدام SL_ZIGBEE_KEY_TABLE_SIZE) من 127 إلى 254 إدخالاً.

تمت إضافة دعم R23 لوظيفة تشغيل شبكة ZDD. تتوفر وظيفة النفق دون دعم حالات استخدام الشبكة القديمة.

تم تحديث مكونات توجيه الشبكة ومنشئ الشبكة لتشمل دعم الانضمام إلى R23. وتتضمن هذه التغييرات ذات الصلة ما يلي.
- تم تحديث سياسة طلب مفتاح ارتباط مركز الثقة (TCLK) الافتراضية لتوليد مفاتيح جديدة لكل جهاز يطلب ذلك. يتم إنشاء مفتاح جديد في كل مرة تحاول فيها الأجهزة الطالبة تحديث مفتاح ارتباط مركز الثقة الخاص بها.
- بسبب تغيير سياسة TCLK السابقة، يتطلب مكون Network Creator Security الآن مكون Security Link Keys. سيتم تحديث التطبيقات التي تتم ترقيتها لتتوافق مع هذا المتطلب الجديد.
- تكوين جديد،
  تمت إضافة SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY للسماح بالانضمام باستخدام مفتاح أساسي مجزأ. يوجد هذا التكوين ضمن مكون Network Creator Security. يسمح استخدام هذه السياسة لكل جهاز منضم بتلقي TCLK فريد بعد الانضمام، ولكن المحاولات المتكررة لتحديث TCLK لن تؤدي إلى مفتاح جديد للجهاز الطالب. كان استخدام مفاتيح الارتباط المجزأة هو السياسة الافتراضية قبل هذا الإصدار، ويسمح استخدام هذه السياسة لمركز الثقة بتجنب إدخال مكون مفاتيح ارتباط الأمان، والذي يحفظ المفاتيح في Flash.
  ملحوظة:لا توصي شركة Silicon Labs باستخدام هذه السياسة، حيث إنها تمنع الأجهزة من دمج أو تحديث TCLKs الخاصة بها.

تمت إضافة مجموعة تكوين جديدة إلى مكون zigbee_ezsp_spi للسماح بتكوين جهاز SPI المضيف وواجهات الدبوس الخاصة به.
السابقampالمشاريع، بما في ذلك المشروع fileتمت إعادة تسمية الملفات s (.slcps) ومجلد المشروع إلى إرشادات تسمية Silicon Labs ونقلها إلى دليل "المشاريع".

دعم منصة جديدة

وحدات جديدة
- ام جي ام 260 بي دي 32 في ان ايه 2
- MGM260PD32VNN2
- ام جي ام 260 بي دي 22 في ان ايه 2
- ام جي ام 260 بي بي 32 في ان ايه 5
- MGM260PB32VNN5
- ام جي ام 260 بي بي 22 في ان ايه 5
- بي جي ام 260 بي بي 22 في ان ايه 2
- بي جي ام 260 بي بي 32 في ان ايه 2
- لوحات راديو جديدة
- MGM260P-RB4350A
- MGM260P-RB4351A
جزء جديد
- efr32xg27
إكسبلورر كيت
- BRD2709A
- MGM260P-EK2713A

توثيق جديد
دليل مستخدم EZSP الجديد UG600 للإصدارات 8.1 وما فوق.

تحسينات

تم توسيع حدود SL_ZIGBEE_KEY_TABLE_SIZE حتى 254 إدخالاً.
تمت إضافة zigbee_security_link_keys إلى Z3Light.
تمت إضافة zigbee_security_link_keys إلى zigbee_mp_z3_tc_z3_tc. وتم تحديث حجم جدول المفاتيح الخاص به أيضًا.
تم زيادة حجم جدول مفتاح بوابة Z3 (الذي سيتم تعيينه على ncp) إلى 20.

المشاكل التي تم إصلاحها

المشكلات المعروفة في الإصدار الحالي

تمت إضافة المشكلات بالخط العريض منذ الإصدار السابق. إذا فاتتك إصدار ما، فإن ملاحظات الإصدار الأخيرة متاحة على https://www.silabs.com/developers/zigbee-emberznet في علامة التبويب "المستندات التقنية".

العناصر الموقوفة

لم يعد مكون zigbee_watchdog_periodic_refresh مستخدمًا في إطار عمل تطبيق Zigbee وقد تم إيقافه في هذا الإصدار. يتم تعطيل مؤقت المراقبة افتراضيًا لجميع التطبيقات.ampسيتم إضافة مكون مراقبة محسّن إلى مجموعة أدوات التطوير البرمجية في المستقبل.
ملحوظة:قم بتمكين مؤقت المراقبة باستخدام عنصر التكوين SL_LEGACY_HAL_DISABLE_WATCHDOG مضبوطًا على 0 في تطبيقك

حدود الشبكة والاعتبارات

تتمتع تطبيقات مركز الثقة الافتراضية التي تأتي مع إصدار EmberZNet هذا بالقدرة على دعم العديد من الأجهزة على الشبكة. يتم تحديد هذا الرقم بناءً على عدة عوامل، بما في ذلك أحجام الجداول المهيأة واستخدام NVM وقيم وقت التوليد ووقت التشغيل الأخرى. قد يواجه المستخدمون الذين يسعون إلى إنشاء شبكات كبيرة مشكلات في الموارد عند زيادة حجم الشبكة إلى ما هو أكبر مما يمكن للتطبيق دعمه. على سبيل المثالampعلى سبيل المثال، قد يؤدي الجهاز الذي يطلب مفتاح ارتباط مركز الثقة من مركز الثقة إلى تشغيل معاودة الاتصال sl_zigbee_af_zigbee_key_establishment_cb على مركز الثقة مع تعيين حالة h على SL_ZIGBEE_KEY_TABLE_FULL، مما يشير إلى أن جدول المفاتيح لا يحتوي على مساحة لإضافة مفتاح جديد للجهاز الطالب أو أن NVM3 ليس لديه مساحة متاحة. تقدم Silicon Labs التوصيات التالية للمستخدمين الذين يسعون إلى إنشاء شبكات كبيرة. بالنسبة لتطبيقات مركز الثقة، يوصى بالتكوينات التالية. هذه التوصيات ليست شاملة، وهي بمثابة خط أساس للتطبيقات التي تنوي تنمية شبكات كبيرة.

إدراج مكون جدول العناوين (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_DEFAULT_NVM_SIZE وNVM3_DEFAULT_CACHE_SIZE وفقًا لاستخدام NVM3
- على سبيل المثال، من المحتمل أن تتطلب أحجام الشبكات التي تزيد عن 65 عقدة حجم NVM3 يبلغ 64 كيلو بايت. حجم NVM3 الافتراضي في Silicon Labs Zigbeeampتبلغ قيمة التطبيقات 32 كيلو بايت. قد تتطلب التطبيقات التي تستخدم NVM بشكل أكبر ضبط هذه القيمة إلى قيمة أعلى.
- قد تحتاج الشبكات الكبيرة التي يصل عددها إلى 65 عقدة إلى حجم ذاكرة تخزين مؤقتة NVM3 يبلغ 1200 بايت؛ وقد تتطلب الشبكات المتنامية التي يزيد حجمها عن ذلك مضاعفة هذه القيمة إلى 2400 بايت.

تنطبق هذه التعديلات على مركز الثقة فقط

بوابة متعددة البروتوكولات و RCP

عناصر جديدة
تم تمكين دعم GA SoC لـ BLE DMP مع Zigbee + Openthread CMP مع الاستماع المتزامن على أجزاء xG26. تمت إضافة دعم Debian alpha لتطبيقات Zigbeed وOTBR وZ3Gateway. يتم توفير Zigbeed وOTBR بتنسيق حزمة DEB لمنصة المرجع المختارة (Raspberry PI 4) أيضًا. راجع تشغيل Zigbee وOpenThread وBluetooth في نفس الوقت على مضيف Linux باستخدام معالج مساعد متعدد البروتوكولات، الموجود في docs.silabs.comلمزيد من التفاصيل، تمت إضافة دعم Zigbeed لـ Tizen-0.1-13.1 لـ arm32 وaarch64 بالإضافة إلى Android 12 لـ aarch64. يمكن العثور على مزيد من المعلومات حول Zigbeed على docs.silabs.comتمت إضافة مكون "أولوية جدول الراديو الموحد 802.15.4" الجديد. يستخدم هذا المكون لتكوين أولويات الراديو لمجموعة 15.4. يتطلب المكون أيضًا مكون "radio_priority_configurator" الجديد. يسمح هذا المكون للمشاريع باستخدام أداة Radio Priority Configurator في Simplicity Studio لتكوين مستويات أولوية الراديو للمجموعة التي تتطلب ذلك.

تحسينات
تم نقل ملاحظة التطبيق تشغيل Zigbee وOpenThread وBluetooth في نفس الوقت على مضيف Linux باستخدام معالج مساعد متعدد البروتوكولات (AN1333) إلى docs.silabs.com. أصبح دعم OpenWRT الآن بجودة GA. تمت إضافة دعم OpenWRT لتطبيقات Zigbee وOTBR وZ3Gateway. يتم توفير Zigbeed وOTBR بتنسيق حزمة IPK لمنصة المرجع (Raspberry PI 4) أيضًا. راجع تشغيل Zigbee وOpenThread وBluetooth في نفس الوقت على مضيف Linux باستخدام معالج مساعد متعدد البروتوكولات، الموجود في docs.silabs.com، للتفاصيل.

المشاكل التي تم إصلاحها

المشكلات المعروفة في الإصدار الحالي
تمت إضافة الإصدارات المكتوبة بخط غامق منذ الإصدار السابق. إذا فاتتك أي إصدار، فستتوفر ملاحظات الإصدار الأخيرة علىhttps://www.silabs.com/developers/simplicity-software-development-kit.

العناصر الموقوفة
سيتم إيقاف استخدام "الحاوية متعددة البروتوكولات" المتوفرة حاليًا على DockerHub (siliconlabsinc/multiprotocol) في إصدار قادم. لن يتم تحديث الحاوية بعد الآن ويمكن سحبها من DockerHub. ستحل الحزم المستندة إلى Debian لـ cpcd وZigBee وot-br-posix، جنبًا إلى جنب مع المشاريع المولدة والمجمعة محليًا، محل الوظيفة المفقودة بإزالة الحاوية.

باستخدام هذا الإصدار

يحتوي هذا الإصدار على ما يلي:

كومة زيجبي
إطار تطبيق زيجبي
زيجبي سampلو التطبيقات

لمزيد من المعلومات حول Zigbee وEmberZNet SDK، راجع UG103.02: Zigbee Fundamentals. إذا كنت مستخدمًا لأول مرة، فراجع QSG180: دليل البدء السريع لـ Zigbee EmberZNet لـ SDK 7.0 والإصدارات الأحدث، للحصول على إرشادات حول تكوين بيئة التطوير الخاصة بك، والإنشاء والتحديث كـampتطبيق، ومراجع التوثيق التي تشير إلى الخطوات الإضافية.

التثبيت والاستخدام
يتم توفير Zigbee EmberZNet SDK كجزء من Simplicity SDK، وهي مجموعة من حزم SDK من Silicon Labs. للبدء بسرعة في استخدام Simplicity SDK، قم بتثبيت Simplicity Studio 5، والذي سيقوم بإعداد بيئة التطوير الخاصة بك ويرشدك خلال تثبيت Simplicity SDK. يتضمن Simplicity Studio 5 كل ما هو مطلوب لتطوير منتجات إنترنت الأشياء باستخدام أجهزة Silicon Labs، بما في ذلك مشغل الموارد والمشروعات، وأدوات تكوين البرامج، وIDE الكامل مع سلسلة أدوات GNU، وأدوات التحليل. تتوفر تعليمات التثبيت في دليل مستخدم 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. يمكن العثور على معلومات إضافية غالبًا في مقالات قاعدة المعرفة (KBAs). تتوفر مراجع واجهة برمجة التطبيقات والمعلومات الأخرى حول هذا الإصدار والإصدارات السابقة على https://docs.silabs.com/.

معلومات أمنية
التكامل الآمن للمخزن
بالنسبة للتطبيقات التي تختار تخزين المفاتيح بشكل آمن باستخدام مكون Secure Key Storage على أجزاء Secure Vault-High، يعرض الجدول التالي المفاتيح المحمية وخصائص حماية التخزين الخاصة بها التي يديرها مكون Zigbee Security Manager.يمكن استخدام المفاتيح المغلفة التي تم تمييزها على أنها "غير قابلة للتصدير" ولكن لا يمكن استخدامها viewيمكن استخدام المفاتيح المغلفة التي تم وضع علامة "قابلة للتصدير" عليها أو مشاركتها في وقت التشغيل ولكنها تظل مشفرة أثناء تخزينها في Flash. لا تحتاج تطبيقات المستخدم أبدًا إلى التفاعل مع غالبية هذه المفاتيح. لا تزال واجهات برمجة التطبيقات الحالية لإدارة مفاتيح جدول مفاتيح الارتباط أو المفاتيح المؤقتة متاحة لتطبيق المستخدم ولا يتم توجيهها عبر مكون Zigbee Security Manager.

نصائح أمنية
للاشتراك في Security Advisories ، قم بتسجيل الدخول إلى بوابة عملاء Silicon Labs ، ثم حدد صفحة الحساب الرئيسية. انقر فوق HOME للانتقال إلى الصفحة الرئيسية للبوابة الإلكترونية ، ثم انقر فوق لوحة إدارة الإخطارات. تأكد من تحديد "الإشعارات الاستشارية للبرامج / الأمان وإشعارات تغيير المنتج (PCNs)" ، وأنك مشترك على الأقل في النظام الأساسي والبروتوكول الخاصين بك. انقر فوق حفظ لحفظ أي تغييرات.

يدعم
عملاء Development Kit مؤهلون للحصول على التدريب والدعم الفني. استخدم مختبرات السيليكون زيجبي web صفحة للحصول على معلومات حول جميع منتجات وخدمات Silicon Labs Zigbee، وللتسجيل للحصول على دعم المنتج. يمكنك الاتصال بدعم Silicon Labs على http://www.silabs.com/support.

شهادة زيجبي
تم تأهيل إصدار Ember ZNet 8.1 لمنصة Zigbee Compliant Platform للهندسة المعمارية SoC وNC وP وRCP، وهناك معرف شهادة ZCP مرتبط بهذا الإصدار، يرجى التحقق من CSA webالموقع هنا:
https://csa-iot.org/csa-iot_products/.

يرجى ملاحظة أن شهادة ZCP هي fileيتم نشر الإصدار، ويستغرق الأمر بضعة أسابيع قبل أن يتم انعكاسه على CSA webالموقع. لأي استفسارات أخرى، يرجى الاتصال بدعم Silicon Laboratories على http://www.silabs.com/support.

الأسئلة الشائعة

س: كيف أقوم بتحديث حجم جدول مفتاح ارتباط APS في SDK؟
ج: يمكن تكوين حجم جدول مفتاح ارتباط APS باستخدام معلمة SL_ZIGBEE_KEY_TABLE_SIZE. في الإصدار 8.1، تم توسيعه من 127 إلى 254 إدخالاً.

س: ما هي التحسينات في الإصدار 8.1؟
ج: تقدم النسخة 8.1 تحسينات مثل توسيع حجم جدول مفتاح ارتباط APS، وإعادة تسمية المكونات، وإضافة حماية mutex لطابور أحداث إطار عمل Athe pp، والمزيد. راجع ملاحظات الإصدار للحصول على قائمة مفصلة بالتحسينات.

س: كيف أتعامل مع المشكلات الثابتة في SDK؟
ج: تم إصلاح المشكلات في مجموعة أدوات التطوير البرمجية بما في ذلك حل المشكلات المحتملة المتعلقة بتكوين حجم جدول الجوار، وإعادة تسمية المكونات، وإصلاح تكاليف مسار المصدر، والتعامل مع أوامر ZCL، والمزيد. تأكد من التحديث إلى أحدث إصدار للاستفادة من هذه الإصلاحات.

المستندات / الموارد

مجموعة أدوات تطوير البرمجيات Zigbee EmberZ Net من SILICON LABS [بي دي اف] تعليمات
مجموعة أدوات تطوير شبكة Zigbee EmberZ، مجموعة أدوات تطوير شبكة EmberZ، مجموعة أدوات تطوير شبكة Net، مجموعة أدوات تطوير البرامج

مراجع

دليل المستخدم

مجموعة أدوات تطوير البرمجيات Zigbee EmberZ Net من SILICON LABS

تحديد

معلومات المنتج