SILICON LABS Zigbee EmberZ Net SDK 说明

对于将 Zigbee 网络开发到其产品中的 OEM 来说，Silicon Labs 是首选供应商。Silicon Labs Zigbee 平台是目前集成度最高、最完整、功能最丰富的 Zigbee 解决方案。Silicon Labs EmberZNet SDK 包含 Silicon Labs 对 Zigbee 堆栈规范的实现。

主要特色

Zigbee

-APS 链接密钥表中有 250 多个条目
Android 12 (v21.0.6113669) 和 Tizen (v0.1-13.1) 支持 ZigbeeD

xG26 模块支持

多协议

OpenWRT – GA 上的 ZigbeeD 和 OTBR 支持
DMP BLE + CMP ZB 和 Matter/OT 在 MG26 上支持并发监听，适用于 SoC – GA

802.15.4 统一无线电调度器优先级组件
Debian 打包支持 MP 主机应用程序 – Alpha

新品

重要变更
APS 链路密钥表大小（使用 SL_ZIGBEE_KEY_TABLE_SIZE 配置）从 127 个扩展到 254 个条目。

为 ZDD 网络调试功能添加了 R23 支持。隧道功能在不支持传统网络用例的情况下可用。

网络指导和网络创建器组件已更新，以支持 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 不会为请求设备产生新密钥。在此版本之前，使用哈希链接密钥是默认策略，使用此策略允许信任中心避免引入 Security Link Keys 组件，该组件将密钥保存在 Flash 中。
  笔记：Silicon Labs 不建议使用此策略，因为这会阻止加入的设备滚动或更新其 TCLK。

向组件 zigbee_ezsp_spi 添加了一个新的配置集，以允许配置主机 SPI 设备及其引脚接口。
前任ample 项目，包括项目 files（.slcps）和项目文件夹被重命名为 Silicon Labs 命名指南并移至“projects”目录下。

新平台支持

新模块
- 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 网关密钥表大小（将设置为 ncp）增加到 20。

修正问题

当前版本中的已知问题

粗体显示的问题是自上一版本以来添加的。如果您错过了某个版本，可以在以下位置找到最新的版本说明： https://www.silabs.com/developers/zigbee-emberznet 在技术文档选项卡中。

弃用的项目

zigbee_watchdog_periodic_refresh 组件不再用于 Zigbee 应用程序框架，并且在此版本中已弃用。默认情况下，所有 s 的看门狗定时器均处于禁用状态ample 应用程序。未来将会在 SDK 中添加改进的看门狗组件。
笔记：在应用程序中将配置项 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 使用情况调整 NVM3_DEFAULT_NVM_SIZE 和 NVM3_DEFAULT_CACHE_SIZE
- 例如，超过 65 个节点的网络规模可能需要 3K 的 NVM64 大小。Silicon Labs Zigbee s 中的默认 NVM3 大小ample 应用程序为 32K。使用 NVM 较多的应用程序可能需要将此值调整得更高。
- 最多 65 个节点的大型网络可能需要 3 字节的 NVM1200 缓存大小；大于该值的网络可能需要将该值加倍至 2400 字节。

这些调整仅适用于信任中心

多协议网关和 RCP

新品
启用 GA SoC 对 BLE DMP 的支持，使用 Zigbee + Openthread CMP 并发监听 xG26 部件。已为 Zigbeed、OTBR 和 Z3Gateway 应用程序添加了 Debian alpha 支持。Zigbeed 和 OTBR 也以 DEB 包格式提供，适用于所选参考平台 (Raspberry PI 4)。请参阅在 Linux 主机上使用多协议协处理器同时运行 Zigbee、OpenThread 和蓝牙，网址为文档.silabs.com，了解详情。添加了对适用于 arm0.1 和 aarch13.1 的 Tizen-32-64 以及适用于 aarch12 的 Android 64 的 Zigbeed 支持。有关 Zigbeed 的更多信息，请访问文档.silabs.com添加了新的“802.15.4 统一无线电调度程序优先级”组件。此组件用于配置 15.4 堆栈的无线电优先级。该组件还需要新的“radio_priority_configurator”组件。此组件允许项目使用 Simplicity Studio 中的 Radio Priority Configurator 工具来配置需要它的堆栈的无线电优先级。

改进
应用笔记《在具有多协议协处理器的 Linux 主机上同时运行 Zigbee、OpenThread 和蓝牙》（AN1333）已移至文档.silabs.com。OpenWRT 支持现已达到 GA 质量。已为 Zigbee、OTBR 和 Z3Gateway 应用程序添加了 OpenWRT 支持。Zigbeed 和 OTBR 也以 IPK 包格式提供给参考平台 (Raspberry PI 4)。请参阅在 Linux 主机上使用多协议协处理器同时运行 Zigbee、OpenThread 和蓝牙，网址为文档.silabs.com，以获取详细信息。

修正问题

当前版本中的已知问题
粗体问题为上一版本之后新增的问题。如果您错过了某个版本，可从以下网址获取最新发布说明：https://www.silabs.com/developers/simplicity-software-development-kit.

弃用的项目
目前在 DockerHub (siliconlabsinc/multiprotocol) 上可用的“多协议容器”将在即将发布的版本中弃用。该容器将不再更新，也无法从 DockerHub 中拉取。基于 Debian 的 cpcd、ZigBee 和 ot-br-posix 软件包以及本地生成和编译的项目将取代因删除容器而丢失的功能。

使用此版本

此版本包含以下内容：

Zigbee堆栈
Zigbee应用框架
紫蜂Samp应用程序

有关 Zigbee 和 EmberZNet SDK 的更多信息，请参阅 UG103.02：Zigbee 基础知识。如果您是首次使用，请参阅 QSG180：SDK 7.0 及更高版本的 Zigbee EmberZNet 快速入门指南，了解有关配置开发环境、构建和刷新的说明ample 应用程序以及指向后续步骤的文档参考。

安装和使用
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 用户指南中提供了安装说明。或者，可以通过从 GitHub 下载或克隆最新版本来手动安装 Simplicity SDK。请参阅 https://github.com/SiliconLabs/simplicity_sdk 了解更多信息。Simplicity Studio 默认将 Simplicity SDK 安装在：

（Windows）：C:\Users\\SimplicityStudio\SDKs\simplicity_sdk

（MacOS）：/用户//SimplicityStudio/SDKs/simplicity_sdk

SDK 版本专用的文档随 SDK 一起安装。其他信息通常可以在知识库文章 (KBA) 中找到。有关此版本和早期版本的 API 参考和其他信息可在以下网址获取 https://docs.silabs.com/.

安全信息
安全保管库集成
对于选择使用 Secure Vault-High 部件上的安全密钥存储组件安全存储密钥的应用程序，下表显示了 Zigbee 安全管理器组件管理的受保护密钥及其存储保护特性。可以使用但不能使用标记为“不可导出”的包装密钥 view运行时可编辑或共享。标记为“可导出”的封装密钥可在运行时使用或共享，但在存储在闪存中时仍保持加密状态。用户应用程序永远不需要与这些密钥中的大多数进行交互。用于管理链接密钥表密钥或临时密钥的现有 API 仍可供用户应用程序使用，并且可通过 Zigbee 安全管理器组件路由。

安全建议
要订阅安全公告，请登录 Silicon Labs 客户门户，然后选择帐户主页。单击“主页”转到门户主页，然后单击“管理通知”磁贴。确保选中“软件/安全咨询通知和产品变更通知 (PCN)”，并且您至少订阅了您的平台和协议。单击保存以保存任何更改。

支持
开发套件客户有资格获得培训和技术支持。使用 Silicon Laboratories Zigbee web 页面，获取有关所有 Silicon Labs Zigbee 产品和服务的信息，并注册产品支持。您可以通过以下方式联系 Silicon Laboratories 支持： http://www.silabs.com/support.

Zigbee 认证
Ember ZNet 8.1 版本已获得 SoC、NC、P 和 RCP 架构的 Zigbee 兼容平台认证，此版本具有 ZCP 认证 ID，请检查 CSA web网站在这里：
https://csa-iot.org/csa-iot_products/.

请注意，ZCP 认证 file发布后，需要几周时间才能反映在 CSA 上 web网站。如有任何疑问，请联系 Silicon Laboratories 支持部门 http://www.silabs.com/support.

常见问题解答

问：如何更新 SDK 中的 APS 链接密钥表大小？
A：APS 链路密钥表大小可以使用 SL_ZIGBEE_KEY_TABLE_SIZE 参数配置。在 8.1 版本中，它已从 127 个条目扩展到 254 个条目。

问：8.1版本有哪些改进？
答：版本 8.1 带来了一些增强功能，例如扩展 APS 链接密钥表大小、重命名组件、为 Athe pp Framework 事件队列添加互斥保护等。请参阅发行说明，了解改进的详细列表。

问：如何处理 SDK 中已修复的问题？
答：已修复 SDK 中的问题，包括解决邻居表大小配置的潜在问题、重命名组件、修复源路由开销、处理 ZCL 命令等。请确保更新到最新版本以从这些修复中受益。

文件/资源

硅实验室 Zigbee EmberZ Net SDK [pdf] 指示
Zigbee EmberZ Net SDK、EmberZ Net SDK、Net SDK、SDK

参考

用户手册

硅实验室 Zigbee EmberZ Net SDK

规格

产品信息