دستورالعمل های SILICON LABS Zigbee EmberZ Net SDK

Silicon Labs فروشنده انتخابی برای OEM هایی است که شبکه Zigbee را در محصولات خود توسعه می دهند. پلتفرم Silicon Labs Zigbee یکپارچه‌ترین، کامل‌ترین و غنی‌ترین راه‌حل Zigbee موجود است. Silicon Labs EmberZNet SDK شامل اجرای Silicon Labs از مشخصات پشته Zigbee است.

ویژگی های کلیدی

زیگبی

-250+ ورودی در جدول کلید پیوند APS
پشتیبانی از ZigbeeD در Android 12 (v21.0.6113669) و Tizen (نسخه 0.1-13.1)

پشتیبانی از ماژول xG26

چند پروتکل

پشتیبانی ZigbeeD و OTBR در OpenWRT - GA
DMP BLE + CMP ZB & Matter/OT با گوش دادن همزمان در MG26 برای SoC – GA

802.15.4 جزء اولویت زمانبندی رادیویی یکپارچه
پشتیبانی از بسته بندی دبیان برای برنامه های میزبان MP – آلفا

آیتم های جدید

تغییرات مهم
اندازه جدول کلید پیوند APS (پیکربندی شده با استفاده از SL_ZIGBEE_KEY_TABLE_SIZE) از 127 به 254 ورودی افزایش یافته است.

پشتیبانی R23 برای عملکرد راه اندازی شبکه ZDD اضافه شده است. عملکرد تونل زنی بدون پشتیبانی از موارد استفاده از شبکه قدیمی در دسترس است.

اجزای Network Steering و Network Creator به‌روزرسانی شده‌اند تا از اتصال R23 پشتیبانی کنند. اینها شامل تغییرات مرتبط زیر است.
- خط‌مشی درخواست پیش‌فرض کلید پیوند مرکز اعتماد (TCLK) برای تولید کلیدهای جدید برای هر دستگاه درخواست‌کننده به‌روزرسانی شده است. هر بار که دستگاه های درخواست کننده سعی می کنند کلید پیوند مرکز اعتماد خود را به روز کنند، یک کلید جدید ایجاد می شود.
- با توجه به تغییر خط‌مشی قبلی TCLK، مؤلفه امنیت ایجادکننده شبکه اکنون به مؤلفه کلیدهای پیوند امنیتی نیاز دارد. به روز رسانی برنامه ها برای مطابقت با این نیاز جدید به روز می شود.
- یک پیکربندی جدید،
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY اضافه شده است تا امکان پیوستن با استفاده از یک کلید هسته‌ای و هش‌شده فراهم شود. این پیکربندی در قسمت Network Creator Security یافت می شود. استفاده از این خط‌مشی به هر دستگاهی که ملحق می‌شود اجازه می‌دهد یک TCLK منحصر به فرد پس از پیوستن دریافت کند، اما تلاش‌های مکرر برای به‌روزرسانی TCLK منجر به کلید جدیدی برای دستگاه درخواست‌کننده نمی‌شود. این استفاده از کلیدهای پیوند هش شده، خط‌مشی پیش‌فرض قبل از انتشار بود، و استفاده از این خط‌مشی به مرکز اعتماد اجازه می‌دهد تا از وارد کردن مؤلفه کلیدهای پیوند امنیتی، که کلیدها را در Flash ذخیره می‌کند، اجتناب کند.
  توجه داشته باشید: آزمایشگاه‌های سیلیکون استفاده از این خط‌مشی را توصیه نمی‌کنند، زیرا این امر مانع از پیوستن دستگاه‌ها به چرخاندن یا به‌روزرسانی TCLK‌های آن‌ها می‌شود.

یک مجموعه پیکربندی جدید به مؤلفه zigbee_ezsp_spi اضافه می‌شود تا پیکربندی دستگاه SPI میزبان و رابط‌های پین آن را امکان‌پذیر کند.
سابقampپروژه ها، از جمله پروژه files (slcps.) و پوشه پروژه، به دستورالعمل‌های نام‌گذاری آزمایشگاه‌های سیلیکون تغییر نام داده و به فهرست «پروژه‌ها» منتقل می‌شوند.

پشتیبانی از پلتفرم جدید

ماژول های جدید
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- تابلوهای رادیویی جدید
- 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 Gateway (که روی ncp تنظیم می شود) را به 20 افزایش داد.

رفع مشکلات

مسائل شناخته شده در نسخه فعلی

از نسخه قبلی، مسائلی با پررنگ اضافه شد. اگر نسخه‌ای را از دست داده‌اید، یادداشت‌های انتشار اخیر در این آدرس موجود است https://www.silabs.com/developers/zigbee-emberznet در برگه اسناد فنی

موارد منسوخ شده

جزء zigbee_watchdog_periodic_refresh دیگر در چارچوب برنامه Zigbee استفاده نمی شود و در این نسخه منسوخ شده است. تایمر Watchdog به طور پیش فرض برای همه s غیرفعال استampبرنامه های کاربردی در آینده یک مؤلفه مراقب بهبود یافته به SDK اضافه خواهد شد.
توجه داشته باشید: تایمر Watchdog را با مورد پیکربندی SL_LEGACY_HAL_DISABLE_WATCHDOG روی 0 در برنامه خود فعال کنید

محدودیت ها و ملاحظات شبکه

برنامه‌های پیش‌فرض Trust Center که با این نسخه EmberZNet عرضه می‌شوند، می‌توانند چندین دستگاه را در شبکه پشتیبانی کنند. این عدد بر اساس چندین فاکتور از جمله اندازه جدول پیکربندی شده، استفاده از NVM و سایر مقادیر زمان تولید و زمان اجرا تعیین می شود. کاربرانی که به دنبال ایجاد شبکه‌های بزرگ هستند، ممکن است هنگام بزرگ‌تر کردن شبکه بزرگتر از آنچه برنامه پشتیبانی می‌کند، با مشکلات منابع مواجه شوند. برای مثالampدستگاهی که یک کلید پیوند مرکز اعتماد را از مرکز اعتماد درخواست می‌کند ممکن است یک تماس sl_zigbee_af_zigbee_key_establishment_cb را در مرکز اعتماد با وضعیت h روی SL_ZIGBEE_KEY_TABLE_FULL راه‌اندازی کند، که نشان می‌دهد جدول کلید فضایی برای درخواست دستگاه یا کلید جدید برای آن ندارد. NVM3 فضای در دسترس ندارد. Silicon Labs توصیه های زیر را برای کاربرانی که به دنبال ایجاد شبکه های بزرگ هستند ارائه می دهد. برای برنامه های Trust Center، تنظیمات زیر توصیه می شود. این توصیه‌ها جامع نیستند و به‌عنوان پایه‌ای برای برنامه‌هایی هستند که قصد توسعه شبکه‌های بزرگ را دارند.

گنجاندن جزء Address Table (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 64K نیاز دارند. اندازه پیش‌فرض NVM3 در Silicon Labs Zigbee sampبرنامه های کاربردی 32K است. برنامه هایی که از NVM بیشتر استفاده می کنند ممکن است نیاز به تنظیم این مقدار حتی بیشتر داشته باشند.
- شبکه های بزرگ تا 65 گره ممکن است به اندازه کش NVM3 1200 بایت نیاز داشته باشند. رشد شبکه های بزرگتر از آن ممکن است نیاز به دو برابر کردن این مقدار به 2400 بایت داشته باشد.

این تنظیمات فقط برای مرکز اعتماد اعمال می شود

دروازه چند پروتکل و RCP

آیتم های جدید
پشتیبانی از GA SoC برای BLE DMP با Zigbee + Openthread CMP با گوش دادن همزمان در قطعات xG26 فعال است. پشتیبانی دبیان آلفا برای برنامه های Zigbeed، OTBR و Z3Gateway اضافه شده است. Zigbeed و OTBR در قالب بسته DEB برای پلتفرم مرجع انتخابی (Raspberry PI 4) نیز ارائه شده است. به اجرای همزمان Zigbee، OpenThread و بلوتوث در هاست لینوکس با یک پردازشگر چندپروتکلی، که در 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 و بلوتوث بر روی هاست لینوکس با یک پردازشگر چند پروتکلی (AN1333) به docs.silabs.com. پشتیبانی OpenWRT اکنون کیفیت GA دارد. پشتیبانی OpenWRT برای برنامه های Zigbee، OTBR و Z3Gateway اضافه شده است. Zigbeed و OTBR در قالب بسته IPK برای پلتفرم مرجع (Raspberry PI 4) نیز ارائه شده است. به اجرای همزمان Zigbee، OpenThread و بلوتوث در هاست لینوکس با یک پردازشگر چندپروتکلی که در docs.silabs.com، برای جزئیات

رفع مشکلات

مسائل شناخته شده در نسخه فعلی
از نسخه قبلی، مسائلی با پررنگ اضافه شد. اگر نسخه‌ای را از دست داده‌اید، یادداشت‌های انتشار اخیر در دسترس هستندhttps://www.silabs.com/developers/simplicity-software-development-kit.

موارد منسوخ شده
"Multiprotocol Container" که در حال حاضر در DockerHub (siliconlabsinc/multiprotocol) در دسترس است، در نسخه بعدی منسوخ خواهد شد. ظرف دیگر به‌روزرسانی نمی‌شود و می‌توان آن را از DockerHub بیرون کشید. بسته‌های مبتنی بر دبیان برای cpcd، ZigBee، و ot-br-posix، همراه با پروژه‌های بومی تولید و کامپایل شده، جایگزین عملکرد از دست رفته با حذف کانتینر خواهند شد.

با استفاده از این نسخه

این نسخه شامل موارد زیر است:

پشته Zigbee
چارچوب برنامه Zigbee
زیگبی اسampبرنامه های کاربردی

برای اطلاعات بیشتر درباره Zigbee و EmberZNet SDK به UG103.02: Zigbee Fundamentals مراجعه کنید. اگر برای اولین بار کاربر هستید، QSG180: Zigbee EmberZNet Quick-Start Guide for SDK 7.0 و بالاتر را ببینید، برای دستورالعمل های مربوط به پیکربندی محیط توسعه، ساخت و فلش کردن به صورتampبرنامه، و ارجاع اسناد به مراحل بعدی اشاره می کند.

نصب و استفاده
Zigbee EmberZNet SDK به عنوان بخشی از Simplicity SDK، مجموعه Silicon Labs SDK ارائه شده است. برای شروع سریع با Simplicity SDK، Simplicity Studio 5 را نصب کنید، که محیط توسعه شما را راه اندازی می کند و شما را در نصب Simplicity SDK راهنمایی می کند. Simplicity Studio 5 شامل همه چیزهایی است که برای توسعه محصول IoT با دستگاه‌های Silicon Labs نیاز است، از جمله راه‌انداز منابع و پروژه، ابزارهای پیکربندی نرم‌افزار، 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 نصب می شوند. اطلاعات اضافی را اغلب می توان در مقالات پایگاه دانش (KBAs) یافت. ارجاعات API و سایر اطلاعات در مورد این نسخه و نسخه های قبلی در دسترس هستند https://docs.silabs.com/.

اطلاعات امنیتی
ادغام امن خرک
برای برنامه‌هایی که انتخاب می‌کنند کلیدها را با استفاده از مولفه ذخیره‌سازی کلید امن در قسمت‌های Secure Vault-High ذخیره کنند، جدول زیر کلیدهای محافظت‌شده و ویژگی‌های حفاظت ذخیره‌سازی آنها را نشان می‌دهد که مؤلفه Zigbee Security Manager مدیریت می‌کند.کلیدهای بسته بندی شده ای که به عنوان "غیر قابل صادرات" علامت گذاری شده اند، قابل استفاده هستند اما نمی توانند استفاده شوند viewویرایش یا به اشتراک گذاشته شده در زمان اجرا. کلیدهای بسته بندی شده ای که به عنوان "Exportable" علامت گذاری شده اند را می توان در زمان اجرا استفاده کرد یا به اشتراک گذاشت، اما تا زمانی که در Flash ذخیره می شوند رمزگذاری شده باقی می مانند. برنامه های کاربری هرگز نیازی به تعامل با اکثر این کلیدها ندارند. APIهای موجود برای مدیریت کلیدهای جدول کلید پیوند یا کلیدهای گذرا هنوز در دسترس برنامه کاربر هستند و از طریق مؤلفه Zigbee Security Manager مسیریابی می شوند.

مشاوران امنیتی
برای اشتراک در Security Advisories، وارد پورتال مشتریان Silicon Labs شوید، سپس Account Home را انتخاب کنید. روی HOME کلیک کنید تا به صفحه اصلی پورتال بروید و سپس روی کاشی مدیریت اعلان ها کلیک کنید. مطمئن شوید که «اعلامیه‌های مشاوره نرم‌افزار/امنیتی و اطلاعیه‌های تغییر محصول (PCN)» علامت‌گذاری شده باشد و حداقل برای پلتفرم و پروتکل خود مشترک شده باشید. برای ذخیره هرگونه تغییر روی ذخیره کلیک کنید.

پشتیبانی کنید
مشتریان کیت توسعه واجد شرایط آموزش و پشتیبانی فنی هستند. از Silicon Laboratories Zigbee استفاده کنید web صفحه برای به دست آوردن اطلاعات در مورد تمام محصولات و خدمات Silicon Labs Zigbee و ثبت نام برای پشتیبانی محصول. می توانید با پشتیبانی آزمایشگاه سیلیکون در این آدرس تماس بگیرید http://www.silabs.com/support.

گواهی Zigbee
نسخه Ember ZNet 8.1 برای پلتفرم سازگار Zigbee برای معماری‌های SoC، NC، P و RCP واجد شرایط شده است، یک شناسه گواهی ZCP به این نسخه مرتبط است، لطفاً CSA را بررسی کنید. webسایت اینجا:
https://csa-iot.org/csa-iot_products/.

لطفا توجه داشته باشید که گواهی ZCP است fileانتشار را پست کنید و چند هفته طول می کشد تا در CSA منعکس شود webسایت برای هر گونه سؤال بیشتر، لطفاً با پشتیبانی آزمایشگاه سیلیکون در این آدرس تماس بگیرید http://www.silabs.com/support.

سوالات متداول

س: چگونه می توانم اندازه جدول کلید پیوند APS را در SDK به روز کنم؟
A: اندازه جدول کلید پیوند APS را می توان با استفاده از پارامتر SL_ZIGBEE_KEY_TABLE_SIZE پیکربندی کرد. در نسخه 8.1 از 127 به 254 ورودی افزایش یافته است.

س: چه بهبودهایی در نسخه 8.1 وجود دارد؟
پاسخ: نسخه 8.1 پیشرفت هایی مانند افزایش اندازه جدول کلید پیوند APS، تغییر نام مؤلفه ها، افزودن محافظت mutex برای صف رویداد Athe pp Framework و موارد دیگر را به ارمغان می آورد. برای لیست دقیق بهبودها به یادداشت های انتشار مراجعه کنید.

س: چگونه می توانم مشکلات حل شده در SDK را مدیریت کنم؟
پاسخ: رفع مشکلات موجود در SDK از جمله حل مشکلات احتمالی با پیکربندی اندازه جدول همسایه، تغییر نام اجزاء، رفع سربار مسیر منبع، مدیریت دستورات ZCL و موارد دیگر. برای بهره مندی از این اصلاحات، مطمئن شوید که به آخرین نسخه به روز رسانی می کنید.

اسناد / منابع

SILICON LABS Zigbee EmberZ Net SDK [pdfدستورالعمل‌ها
Zigbee EmberZ Net SDK، EmberZ Net SDK، Net SDK، SDK

مراجع

راهنمای کاربر

SILICON LABS Zigbee EmberZ Net SDK

مشخصات

اطلاعات محصول