SILICON LABS Zigbee EmberZ Net SDK 說明

Silicon Labs 是 OEM 廠商在其產品中開發 Zigbee 網路的首選供應商。 Silicon Labs Zigbee 平台是目前整合度最高、最完整且功能最豐富的 Zigbee 解決方案。 Silicon Labs EmberZNet SDK 包含 Silicon Labs 對 Zigbee 堆疊規範的實作。

主要特點

紫蜂

APS 連結密鑰表中超過 -250 個條目
Android 12 (v21.0.6113669) 和 Tizen (v0.1-13.1) 上的 ZigbeeD 支持

xG26 模組支持

多協議

OpenWRT 上的 ZigbeeD 和 OTBR 支援 – GA
DMP BLE + CMP ZB 和 Matter/OT，在 SoC 的 MG26 上進行並發監聽 – GA

802.15.4 統一無線電調度程序優先權組件
MP 主機應用程式的 Debian 打包支援 – Alpha

新商品

重要變化
APS 連結密鑰表大小（使用 SL_ZIGBEE_KEY_TABLE_SIZE 配置）從 127 個條目擴展到 254 個條目。

新增了對 ZDD 網路偵錯功能的 R23 支援。隧道功能無需支援舊網路用例即可使用。

Network Steering 和 Network Creator 元件已更新，包括對 R23 加入的支援。其中包括以下相關變更。
- 預設信任中心連結金鑰 (TCLK) 請求策略已更新，可為每個請求裝置產生新金鑰。每次請求裝置嘗試更新其信任中心連結金鑰時，都會產生一個新金鑰。
- 由於先前的 TCLK 策略更改，Network Creator 安全元件現在需要安全連結金鑰元件。應用程式升級將進行更新以符合此新要求。
- 全新配置，
  新增了 SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY 以允許使用核心雜湊金鑰加入。此配置位於 Network Creator 安全組件下。使用此策略可讓每個加入裝置在加入後接收唯一的 TCLK，但重複嘗試更新 TCLK 不會導致請求裝置取得新金鑰。使用雜湊連結金鑰是此版本之前的預設策略，使用此策略可讓信任中心避免引入安全連結金鑰元件，該元件將金鑰保存在快閃記憶體中。
  筆記：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

新文件
600 及更高版本的新 EZSP 使用者指南 UG8.1。

改進

SL_ZIGBEE_KEY_TABLE_SIZE 限制擴展到 254 個條目。
在 Z3Light 中新增了 zigbee_security_link_keys。
將 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 的看門狗計時器均處於停用狀態。amp勒應用程式。未來SDK中將會加入改良的看門狗組件。
筆記：在應用程式中將設定項 SL_LEGACY_HAL_DISABLE_WATCHDOG 設為 0 來啟用看門狗計時器

網路限制和注意事項

此 EmberZNet 版本附帶的預設信任中心應用程式能夠支援網路上的多個裝置。該數字是根據多個因素確定的，包括配置的表大小、NVM 使用情況以及其他生成時間和運行時值。當網路規模超過應用程式所能支援的規模時，尋求創建大型網路的用戶可能會面臨資源問題。對於前amp在文件中，從信任中心請求信任中心連結金鑰的裝置可能會在信任中心觸發 sl_zigbee_af_zigbee_key_builtment_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 堆疊元件中所示
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE，如來源路由元件所示（如果使用來源路由）
根據NVM3使用情況調整NVM3_DEFAULT_NVM_SIZE和NVM3_DEFAULT_CACHE_SIZE
- 例如，大於 65 個節點的網路規模可能需要 3K 的 NVM64 大小。 Silicon Labs Zigbee 中的預設 NVM3 大小amp檔案大小為32K。更頻繁地使用 NVM 的應用程式可能需要將該值調整得更高。
- 多達 65 個節點的大型網路可能需要 3 位元組的 NVM1200 快取大小；增長超過該值的網路可能需要將該值加倍至 2400 位元組。

這些調整僅適用於信任中心

多協議網關和 RCP

新商品
透過 Zigbee + Openthread CMP 啟用 GA SoC 對 BLE DMP 的支持，並在 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 中的無線電優先權配置器工具來配置需要它的堆疊的無線電優先權。

改進
應用說明在具有多協定協處理器的 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 快速入門指南，以了解有關配置開發環境、建置和刷新的說明amp文件應用程式以及指向後續步驟的文件參考。

安裝與使用
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): /Users//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 認證是 filed 發布該版本，並需要幾週時間才能在 CSA 上反映 web地點。如有任何進一步疑問，請聯絡 Silicon Laboratories 支援： http://www.silabs.com/support.

常見問題解答

Q：如何更新SDK中的APS連結密鑰表大小？
答：APS 連結密鑰表大小可以使用 SL_ZIGBEE_KEY_TABLE_SIZE 參數進行設定。在8.1版本中，它已從127個條目擴展到254個條目。

Q：8.1版本有哪些改進？
答：8.1 版本帶來了擴充 APS 連結金鑰表大小、重新命名元件、為 Athe pp Framework 事件佇列新增互斥保護等增強功能。有關改進的詳細列表，請參閱發行說明。

Q：如何處理 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

規格

產品資訊