SILICON LABS SDK 7.4.1.0 GA Zigbee 協定堆疊軟體
產品資訊
規格
- Zigbee EmberZNet SDK 版本： 7.4.1.0
- Gecko SDK 套件版本： 4.4 – 14 年 2024 月 XNUMX 日
- 小販： 矽實驗室
- 主要特點： SoC 上的多協定 Zigbee 和 OpenThread 支持
- 兼容的編譯器： 海灣合作委員會版本 12.2.1
- EZSP協定版本： 0x0D
產品使用說明
兼容性和使用注意事項
- 如需安全性更新和通知，請參閱與此 SDK 一起安裝的 Gecko 平台發行說明的安全章節，或存取 Silicon Labs 上的技術文件標籤 web地點。
- 透過訂閱安全公告來保持更新。
常問問題
- 問題： 如何驗證是否正確 file是否與相容的編譯器一起使用？
- 答： 您可以驗證是否正確 file透過檢查 Simplicity Studio 提供的 GCC 版本 12.2.1 來使用。
- 問題： 在哪裡可以找到有關安全性更新和通知的資訊？
- 答： 如需安全性更新和通知，請參閱 Gecko 平台發行說明的安全章節或存取 Silicon Labs 上的技術文件標籤 web地點。
Silicon Labs 是 OEM 廠商在其產品中開發 Zigbee 網路的首選供應商。 Silicon Labs Zigbee 平台是目前整合度最高、最完整且功能最豐富的 Zigbee 解決方案。
Silicon Labs EmberZNet SDK 包含 Silicon Labs 對 Zigbee 堆疊規範的實作。
- 這些發行說明涵蓋 SDK 版本：
- 7.4.1.0 於 14 年 2024 月 XNUMX 日發布
- 7.4.0.0 於 13 年 2023 月 XNUMX 日發布
主要特點
紫蜂
- Zigbee R23 合規性
- Zigbee 智慧能源 1.4a 合規性 – 生產
- Zigbee GP 1.1.2 合規性 – Alpha
- MG27 支援 – 生產
- 改進了對 Secure Vault 部件的支持
- NCP SPI（非 CPC）應用程式的 Sleepy 支援 – Alpha
多協議
- 並發聆聽支援 (RCP) – MG21 和 MG24
- 並發多協定 (CMP) Zigbee NCP + OpenThread RCP – 生產
- SoC 上的動態多協定藍牙 + 並發多協定 (CMP) Zigbee 和 OpenThread 支持
兼容性和使用注意事項
有關安全更新和通知的信息，請參閱與此 SDK 一起安裝的 Gecko 平台發行說明的安全章節或位於以下位置的技術文件選項卡： https://www.silabs.com/developers/zigbee-emberznet。 Silicon Labs 也強烈建議您訂閱安全公告以獲取最新資訊。有關說明，或如果您是 Zigbee EmberZNet SDK 的新手，請參閱使用此版本。
相容的編譯器
- IAR Embedded Workbench for ARM (IAR-EWARM) 版本 9.40.1。
- 在 macOS 或 Linux 上使用 Wine 透過 IarBuild.exe 命令列實用程式或 IAR Embedded Workbench GUI 進行建置可能會導致錯誤 file由於 Wine 的雜湊演算法中用於產生短訊息的衝突而使用 s file 名稱。
- 建議 macOS 或 Linux 上的客戶不要在 Simplicity Studio 之外使用 IAR 進行建置。這樣做的客戶應仔細核實是否正確 file正在使用。
GCC（GNU 編譯器集合）版本 12.2.1，隨 Simplicity Studio 提供。
此版本的 EZSP 協定版本是 0x0D。
新商品
此版本的 Gecko SDK (GSDK) 將是最後一個版本，綜合支援所有 EFM 和 EFR 裝置（根據需要對此版本進行修補除外）。從 2024 年中期開始，我們將引入單獨的 SDK：
- 現有的 Gecko SDK 將繼續支援系列 0 和 1 設備。
- 新的 SDK 將專門針對系列 2 和系列 3 裝置。
Gecko SDK 將繼續支援所有系列 0 和 1 設備，並且我們的軟體政策下提供的長期支援、維護、品質和回應能力不會改變。
新的 SDK 將從 Gecko SDK 分支出來，並開始提供新功能，幫助開發者獲得優勢tag我們的 2 和 3 系列產品的先進功能。
這項決定與客戶的回饋一致，反映了我們對提高品質、確保穩定性和增強效能的承諾，以在我們的軟體 SDK 中提供卓越的使用者體驗。
新組件
新品發布中
- 新增了「zigbee_direct_security_p256」和「zigbee_direct_security_curve25519」元件，以便使用者可以設定特定的 Zigbee Direct 安全性選項。
- 使用者可以在 Zigbee 直接設備 (ZDD) 應用程式上啟用多個「zigbee_direct_security」元件。在這種情況下，實際的安全選項取決於 Zigbee 虛擬設備 (ZVD) 配置。
新 API
新品發布中
- 新增了新的 API sl_zigbee_token_factory_reset 以將 Zigbee NVM3 令牌重設為其預設值。
- 新增了 API bool sl_zigbee_sec_man_link_key_slot_available(EmberEUI64 eui)，如果連結金鑰表可以使用該位址新增或更新條目（表未滿），則傳回 true。
- 新增了新的 API bool sl_zb_sec_man_compare_key_to_value (sl_zb_sec_man_context_t* context, sl_zb_sec_man_key_t* key)，如果上下文引用的鍵與參數中提供的鍵具有相同的值，則傳回 true。
新平台支援
新品發布中
- 此版本中新增了對以下新零件的 Zigbee 堆疊支援：EFR32MG24A010F768IM40 和 EFR32MG24A020F768IM40。
新文件
7.4.0.0 版本中的新增功能
- 更新了 Zigbee 安全金鑰儲存元件的描述，以反映新增了 Zigbee 安全金鑰儲存升級（增加了與現有專案的向後相容性）。
- 新增了與 Zigbee 安全管理器元件群組互動的新應用說明（AN1412：Zigbee 安全管理器）。
預期行為
請注意，Zigbee 不同步 CSL 傳輸會受到無線電調度器協定搶佔的影響。在 SleepyToSleepy 應用程式中，BLE 可以並將搶佔 Zigbee CSL 傳輸，這將終止傳輸。考慮到可能使用可能很長的喚醒幀序列，調度程序搶佔對於不同步的 CSL 來說更為常見。希望調整傳輸優先順序的使用者可以使用 DMP 調整和測試元件來執行此操作。使用者也可以查閱UG305：動態多協定使用者指南以取得更多資訊。
改進
發佈時已更改
emberCounterHandler API 文件更改
在先前的版本中，有關封包RX 和TX 的MAC 和APS 層EmberCounterTypes 的計數器處理程序回呼未傳遞正確的目標節點ID 或資料參數，並且有關使用這些參數的某些計數器的行為的API 文件不清楚或具有誤導性。
雖然 emberCounterHandler() 的簽名沒有改變，但其參數的填充方式略有改變。
- 為了清楚起見，已擴展了 ember-types.h 中有關 EmberCounterType 枚舉的註解。
- TX 相關計數器的計數器處理程序的節點 ID 參數現在會在使用之前檢查目標位址模式是否指示有效的短 ID。 （如果沒有，則不會填入目標位址，而是使用佔位符值 EMBER_UNKNOWN_NODE_ID。）
- RX 相關計數器的計數器處理程序的節點 ID 參數現在反映來源節點 ID，而不是目標節點 ID。
- 重試計數*不*作為 EMBER_COUNTER_MAC_TX_UNICAST_ SUCCESS/FAILED 計數器的資料參數傳遞，如 ember-types 中所述。 h 在先前的版本中，但在先前發布的版本中從未正確填充，因此它在先前版本中的值始終為 0。但是，APS 層重試的重試計數繼續填入 EMBER_COUNTER_APS_TX_UNICAST_SUCCESS/FAILED 計數器類型的資料參數中，以與先前的版本保持一致。
- 填入回調的節點 ID 或資料參數的所有計數器都經過審核，以確保它們傳遞預期的資料、位址或 EMBER_UNKNOWN_NODE_ID（如果需要節點 ID 但無法從資料包中取得），如修訂版 ember- 中所述types. h 文檔。
- EMBER_COUNTER_MAC_TX_UNICAST_RETRY 的計數器處理程序現在可以正確反映 MAC 層目標節點 ID 以及其目標節點 ID 和資料參數中的多次重試。
- EMBER_COUNTER_PHY_CCA_FAIL_COUNT 的計數器處理程序現在透過節點 ID 參數提供傳輸失敗的訊息的預期 MAC 層目標的目標節點 ID 資訊。
更新的綠色電源規範
Green Power 伺服器程式碼已更新，進行了多項改進，包括：
- 在 GP 伺服器上接收時，為具有無效端點的傳入命令添加了更多驗證代碼。
- 新增了程式碼來處理沒有更多空間來建立綠色電源訊息的情況。
- 現在，根據規範第 A.3.5.2.4.1 節，在某些情況下，接收器會透過刪除配對操作來刪除配對配置。
- 現在，在使用擴充操作處理配對配置時，接收器會先儲存條目的現有群組列表，然後再將其刪除。
- 當翻譯表為空或索引大於表中的多個項目時，翻譯查詢指令將傳回「NOT FOUND」作為錯誤代碼。
- 將某些應用程式中 GP 端點的版本從 1 變更為 0。
在 GPDF 傳送功能中使用 CSMA 受到限制，因為綠色電源元件是最小能源元件，並且在大多數設計中不使用 CSMA。相反，首選設計是使用相同的能量預算發送多個資料包。
刪除了 Green Power Server 外掛程式選項中隱藏端點的使用。請改用應用程式端點之一。
網路密鑰更新插件程式碼改進
- 將定期網路金鑰更新周期改為長達1年。
重構了一些API以避免不必要的金鑰導出
進行了更改以支援使用關鍵上下文而不是純文字關鍵資料。
- sl_zigbee_send_security_challenge_request 現在採用 sl_zb_sec_man_context_t 參數取代 EmberKeyData。
- sl_zb_sec_man_driven_key_type 枚舉的值現在是 16 位元位元掩碼，以直接支援組合多個派生類型的某些金鑰派生。
已解決的問題
已在發行版中修復
| ID ＃ | 描述 |
| 1036893 | 修正了導致 OTA 叢集元件將舊引導程式介面元件安裝為依賴項的問題。 |
| 1114905 | Zigbee Direct：改進了離開網路特徵的處理。 |
| 1180937 | 修正了將 Zigbee Direct ZDD 連接到第 3 方 ZVD 時 WDT 重設的問題。 |
| 1223904 | 修復了導致終端設備在非常繁忙的環境中無法正常工作的問題。 |
| 1224393 | 更新了綠色電源接收器表請求處理程序代碼以更新回應目標位址。 |
| 1228808 | 修正了 gp-types.h 文件中巨集定義的顯示問題。 |
| 1232297 | 修正了 emberSetOutgoingNwkFrameCounter 和 emberSetOutgoingApsFrameCounter 在 64 位元主機應用程式上不起作用的問題（傳回 EMBER_BAD_ARGUMENT）。 |
| 1232359 | 修正了 green power 用戶端指令處理中的 gppTunnelingDelay 參數計算。 |
| 1240392 | 根據 Zigbee 規範，因存取/權限原因而拒絕的 ZDO 綁定/取消綁定請求應傳回 EMBER_ZDP_NOT_AUTHORIZED 狀態，而不是 EMBER_ZDP_NOT_PERMITTED 狀態。 |
| 1243523 | Zigbee Direct：提高了 BLE 與 ZVD 連線的穩定性。 |
| 1249455 | 修正了導致休眠終端設備在接收確認之前接收廣播時進入休眠狀態的問題。 |
| 1252295 | 修復元件目錄巨集 SL_CATALOG_ZIGBEE_OTA_STORAGE_COMMON_PRESENT 中的拼字錯誤。 |
已在發行版中修復
| ID ＃ | 描述 |
| 1019348 | 修正了 Zigbee ZCL Cli 元件的依賴關係要求，以便在不需要時可以刪除。 |
| 1024246 | 更新了 emberHaveLinkKey() 和 sl_zb_sec_man_have_link_key() 的函式描述。 |
| 1036503 | 新增了推薦使用 DMP 的 Micrium 核心的說明amp樂應用程式。 |
| 1037661 | 阻止應用程式安裝 Pro Stack 或 Leaf Stack 的問題已修復。 |
| 1078136 | 修正了從中斷上下文修改事件時的間歇性崩潰 |
|
1081548 | 請注意，Zigbee 不同步 CSL 傳輸會受到無線電調度器協定搶佔的影響。在 SleepyToSleepy 應用程式中，BLE 可以並將搶佔 Zigbee CSL 傳輸，這將終止傳輸。考慮到可能使用可能很長的喚醒幀序列，調度程序搶佔對於不同步的 CSL 來說更為常見。希望調整傳輸優先順序的使用者可以使用 DMP 調整和測試元件來執行此操作。使用者也可以查閱UG305：動態多協定使用者指南以取得更多資訊。 CSL 中修正了一個問題，即在前一個有效負載訊框之後立即接收到的新喚醒幀序列將無法正確記錄。這將導致丟失有效負載幀。 |
| 1084111 | 作為此版本的一部分，對基於 MG24 的主機板的初始休眠 SPI-NCP 支援進行了更新。 |
| 1104056 | 添加了對網路轉向的支持，以便在多網路情況下在輔助網路上運行 |
| 1120515 | 修正了使用 mfglib set-channel 指令時頻道未變更的問題。 |
| 1141109 | 修復了導致生成 s 的問題ample 應用程式 ncp-uart-gp-multi-rail 遺失一些標頭 file使用帶有 -cp 選項的綠色電源適配器組件時。 |
| 1144316 | 更新了 gp-types.h 文件中一些資料結構類型的描述。 |
| 1144884 | 修正了沒有資料掛起時設定的虛假幀掛起位。 |
| 1152512 | 修正了在 ISR 上下文中修改事件時 low-mac-rail 中潛在的崩潰問題。 |
| ID ＃ | 描述 |
| 1154616 | 新增了「將角色從休眠終端設備切換到非休眠終端設備」情況下初始化網路的條件的例外。 |
| 1157289 | 修正了可能導致 BDB 測試失敗 DN-TLM-TC-02B 的問題。 |
| 1157426 | 修正了使用 green_power_adapter 元件建置 zigbee_simple_app 時的建置問題。 |
| 1157932 | 新增了一個條件來檢查「轉換時間」欄位是否缺失，並為此缺失欄位設定預設值 0xFFFF。 |
| 1166340 | 修正了導致 emberAfGpdfSend 無法傳送預期重複傳輸次數的問題。 |
| 1167807 | 修正了每次新裝置加入時，在分散式網路中充當信任中心的裝置會錯誤地清除其臨時連結金鑰的問題。 |
| 1169504 | 修正了導致休眠設備在強制喚醒時重置的問題。 |
| 1169966 | 修正了緩衝區分配代碼中缺少傳回值驗證的問題。 |
| 1171477, 172270 | 使用 mfglib start 1 沒有發送但接收訊息，因此顯示的終端訊息「mfglib sendcomplete」是錯誤的，並更改為「RXed %d packet in the last %d ms」。 |
| 1171935 | 將定期網路金鑰更新周期改為長達1年。 |
| 1172778 | 新增了對 Green Power 伺服器缺少的 emberAfPluginGreenPowerServerUpdateAliasCallback 呼叫。 |
| 1174288 | 修正了導致網路引導程序在呼叫停止正在進行的掃描的呼叫時斷言的問題。 |
| 1178393 | 更新了文檔錯誤。 |
| 1180445 | 在智慧能源中，如果協調器達到有限任務週期，OTA 現在會繼續下載。 |
| 1185509 | 修正了 CSL 中無法正確記錄在前一個有效負載訊框之後立即接收到的新喚醒幀序列的問題。這將導致丟失有效負載幀。 |
| 1186107 | 修正了導致接收到的 GPDF 解密失敗以替換 gp 調試通知中傳入的 GPDF 的問題。 |
| 1188397 | 修正了啟用擴充報告表大小時導致編譯錯誤的問題。 |
| 1194090 | 修正了接收器偵錯模式命令的預設回應中的故障狀態 - 遵循第 3.3.4.8.2 節 |
| 1194963 | 修正了在呼叫使用者回呼 emberAfGreenPowerServerPairingStatusCallback 之前 memsetcommissioningGpd 結構的問題。 |
| 1194966 | 修正了未使用退出偵錯操作設定端點和 proxiesInvolved 欄位的問題。 |
| 1196698 | 修正了當沒有資料掛起時設定的虛假幀掛起位。 |
| 1199958 | 新增了程式碼來處理沒有更多空間來建立綠色電源訊息的情況。 |
| 1202034 | 修正了 sl_zb_sec_man_context_t 堆疊變數未正確初始化，導致連接安裝程式碼失敗的問題。 |
| 1206040 | 在終端設備嘗試安全重新加入期間呼叫 emberRemoveChild() 可能會導致子計數額外減少，從而可能導致子計數為 -1 (255)，從而由於指示的缺失而阻止終端設備加入/重新加入信標中的容量。 |
| 1207580 | 堆疊中的子表搜尋函數在使用 0x0000 與 0xFFFF 作為表示無效/空條目的節點 ID 傳回值時不一致，導致在檢查 emberRemoveChild() 等 API 中未使用的條目時出現問題。 |
| 1210706 | 作為 emberCounterHandler() 一部分的 EmberExtraCounterInfo 結構中提供的目標和 PHY 索引對於 MAC TX 單播計數器類別可能不正確。 |
| 1211610 1212525 | 修正了啟用安全金鑰儲存升級元件後動態多協定應用程式崩潰的問題。 |
| 1211847 | 雖然 emberCounterHandler() 的簽名沒有改變，但其參數的填充方式略有改變。上面第 2 節解釋了圍繞此 API 的變更。 |
| 1212449 | MAC 層錯誤地對傳出信標進行了分類，導致 emberCounterHandler() 無法使用 EMBER_COUNTER_MAC_TX_BROADCAST 計數器類型捕獲這些資料包，而是使用 EMBER_COUNTER_MAC_TX_UNICAST_SUCCESS 計數器類型對信標進行計數。這可能會導致傳遞給 EmberCounterInfo 結構的 dest EmberNodeId 參數的值不可靠 |
| ID ＃ | 描述 |
| 1214866 | 在某些高流量配置中傳送資料輪詢資料包可能會導致匯流排故障。 |
| 1216552 | 修復了在繁忙流量條件下導致斷言的問題。 |
| 1216613 | 修正了導致代理表中群組投射半徑值不正確的問題。 |
| 1222509 | 路由器/協調器向非子輪詢終端設備發送離開和重新加入請求，但 MAC 目標是 0xFFFF，而不是匹配 NWK 目標位址。 |
| 1223842 | 修正了產生 sl_component_catalog.h 時留下不需要的程式碼導致編譯失敗的問題。 |
| 756628 | 將應用程式回呼 emberAfMacFilterMatchMessageCallback 的呼叫變更為僅針對堆疊驗證的 ZLL 訊息呼叫。 |
| 816088 | 將 EMBER 設定從 zigbeed_configuration.h 移至 zigbeed。 slcp。 |
| 829508 | 為了避免競爭條件，在 emberSetLogicalAndRadioChannel 中新增了額外的驗證，以便在較低層繁忙或未處於更改通道的狀態時返回不成功。 |
當前版本中的已知問題
粗體顯示的問題是自上一版本以來新增的。如果您錯過了某個版本，可以在以下位置找到最新的版本說明： https://www.si-labs.com/developers/zigbee-emberznet 在技術文檔選項卡中。
| ID ＃ | 描述 | 解決方法 |
| 不適用 | ·此版本不支援以下應用程式/元件：EM4 支持 | 該功能將在後續版本中啟用。 |
| 193492 | emberAfFillCommandGlobalServerToClientConfigureRe 移植巨集已損壞。緩衝區的填入會產生錯誤的命令封包。 | 使用“zcl global send-me-a-report”CLI 指令而不是 API。 |
| 278063 | 智慧能源隧道 plugins 地址表索引的處理/使用有衝突。 | 沒有已知的解決方法 |
|
289569 |
網路創建器組件功率等級選項清單不提供 EFR32 的完整支援值 | 編輯 EMBER_AF_PLUGIN_NETWORK_CREATOR_RADIO_P 的 CMSIS 註解中指定的範圍 <-8..20> OWER 在 /protocol/ZigBee/app/framework/plugin/network-creator/config/network-creator-config.h file。對於前ample，改為 。 |
| 295498 | 在 Zigbee+BLE 動態多協定用例中，UART 接收有時會在重負載下遺失位元組。 | 使用硬體流控製或降低波特率。 |
|
312291 | EMHAL：Linux 主機上的 halCommonGetIntxxMillisecondTick 函數目前使用取得 meofday 函數，該函數無法保證單調。如果系統時間發生變化，可能會導致堆疊計時問題。 | 修改這些函數以將clock_gettime 與CLOCK_MONOTONIC 來源結合使用。 |
| 338151 | 使用低資料包緩衝區計數值初始化 NCP 可能會導致資料包損壞。 | 使用 0xFF 保留值作為資料包緩衝區計數以避免預設值過低 |
| 387750 | 終端設備上的路由表請求格式有問題。 | 在調查中 |
| 400418 | touchlink 啟動器無法連結到非出廠新的終端設備目標。 | 沒有已知的解決方法。 |
| 424355 | 非出廠新的休眠終端設備支援觸控線目標的發起方在某些情況下無法接收裝置資訊回應。 | 在調查中 |
| 465180 | 共存無線電攔截器最佳化項目「啟用運行時控制」可能會阻止正確的 Zigbee 操作。 | 攔截器優化的可選「Wi-Fi 選擇」控制應保留為「停用」。 |
|
480550 | OTA集群有其內建的分片方法，因此不應該使用APS分片。不過，如果啟用了 APS 加密，它會將 ImageBlockResponses 的有效負載增加到啟動 APS 碎片的大小。這可能會導致 OTA 流程失敗。 |
沒有已知的解決方法 |
|
481128 | 當啟用診斷插件和虛擬 UART 週邊裝置時，預設應透過 NCP 平台上的虛擬 UART（序列 0）提供詳細的重設原因和崩潰詳細資訊。 | 由於 Serial 0 已在 NCP 中初始化，因此客戶可以在 Zigbee NCP Framework 中啟用 emberAfNcpInitCallback，並在此回調中調用相應的診斷函數（halGetExtendedResetInfo、halGetExtendedResetString、halPrintCrashSummary、halPrintCrashDetails 和 halPrintCrashC）以列印此資料將 halDingary、halPrintCrash” view網路分析儀擷取日誌中的資訊。 對於前任amp有關如何使用這些函數的信息，請參閱定義 EXTENDED_RESET_INFO 時 a-main-soc.c 的 emberAfMainInit() 中包含的程式碼。 |
| ID ＃ | 描述 | 解決方法 |
|
486369 | 如果形成新網路的 DynamicMultiProtocolLightSoc 具有其已離開的網路中剩餘的子節點，則 emberAfGetChildTableSize 在 startIdentifyOnAllChildNodes 中傳回非零值，從而在尋址「幽靈」子節點時導致 Tx 66 錯誤訊息。 | 如果可能，請在建立新網路之前批次擦除該部分，或在離開網路後以程式設計方式檢查子表，並在形成新網路之前使用 emberRemoveChild 刪除所有子表。 |
| 495563 | 加入 SPI NCP Sleepy End Device Sample App 不進行短輪詢，因此在更新 TC Link Key 狀態下加入嘗試失敗。 | 希望加入的設備在嘗試加入之前應處於短輪詢模式。終端設備支援插件可以強制此模式。 |
|
497832 | 在網路分析器中，驗證金鑰請求幀的 Zigbee 應用程式支援命令分解錯誤地引用了將幀來源位址指示為目標位址的有效負載部分。 |
沒有已知的解決方法 |
| 519905 521782 | Spi-NCP 很少會無法使用 ota-client 外掛程式的「bootload」CLI 指令啟動引導程式通訊。 | 重新啟動引導程序 |
| 620596 | NCP SPI 防爆ampBRD4181A (EFR32xGMG21) 的文件 nWake 預設定義的引腳不能用作喚醒引腳。 | 在 NCP-SPI 插件中將 nWake 的預設引腳從 PD03 變更為 EM2/3 喚醒啟用引腳。 |
| 631713 | 如果使用插件“Zigbee PRO Stack Library”而不是“Zigbee PRO Leaf Library”，Zigbee 終端設備將重複報告位址衝突。 | 使用“Zigbee PRO Leaf Library”而不是“Zigbee PRO Stack Library”插件。 |
| 670702 | 報告插件中的低效率可能會導致基於資料寫入頻率和表大小的顯著延遲，這可能會幹擾客戶應用程式程式碼，包括事件計時。 | 如果頻繁寫入，請考慮檢查報告條件並手動發送報告，而不是使用外掛程式。 |
| 708258 | groups-server.c 中透過 addEntryToGroupTable() 的未初始化值可能會建立虛假綁定並導致發送組播報告訊息。 | 新增“binding.clusterId = EMBER_AF_INVALID_CLUSTER_ID;”在「綁定.類型」之後 = EMBER_MULTICAST_BINDING;” |
|
757775 | 所有 EFR32 部件都具有獨特的 RSSI 偏移。此外，電路板設計、天線和外殼也會影響 RSSI。 | 建立新專案時，安裝 RAIL Utility、RSSI 元件。此功能包括為每個部件測量的預設 RSSI 偏移 Silabs。在對整個產品進行 RF 測試後，如有必要，可以修改此偏移量。 |
|
758965 | ZCL 叢集元件和 ZCL 指令發現表不同步。因此，當啟用或停用 ZCL 叢集元件時，已實現的命令將不會在對應的 ZCL 進階配置器命令標籤中啟用/停用。 | 在 ZCL 進階配置器中手動啟用/停用所需 ZCL 命令的發現。 |
| 765735 | 在啟用頁面要求的休眠終端設備上，OTA 更新失敗。 | 使用區塊請求而不是頁面請求。 |
| 845649 | 刪除 CLI：核心元件不會消除對 sl_cli.h 的 EEPROM cli 呼叫。 | 刪除 eeprom-cli.c file 呼叫 sl_cli.h。此外，可以註解掉 ota-storage-simple-eeprom 中對 sl_cli.h 和 sl_cli_command_arg_t 的呼叫。 |
| 857200 | ias 區域伺服器。 c 允許使用「0000000000000000」CIE 位址建立綁定，且以後不允許進一步綁定。 | 沒有已知的解決方法 |
| 1019961 | 生成的 Z3Gateway makefile 將“gcc”硬編碼為 CC | 沒有已知的解決方法 |
| ID ＃ | 描述 | 解決方法 |
|
1039767 |
多執行緒 RTOS 使用案例中的 Zigbee 路由器網路重試佇列溢位問題。 | Zigbee 堆疊不是線程安全的。因此，作業系統環境不支援從另一個任務呼叫 Zigbee 堆疊 API，並且可能會使堆疊進入「非工作」狀態。有關詳細資訊和使用事件處理程序的解決方法，請參閱以下應用說明。 https://www.silabs.com/documents/public/application- 筆記/an1322-動態多協定-藍牙-zigbee-sdk- 7x.pdf . |
| 1064370 | Z3Switch 的amp預設情況下，該應用程式僅啟用一個按鈕（實例：btn1），這會導致專案中的按鈕描述不匹配 file. | 解決方法：在 Z0Switch 專案建立期間手動安裝 btn3 實例。 |
| 1161063 | Z3Light 和可能的其他應用程式會報告不正確的叢集修訂值。 | 手動將集群修訂版屬性更新為其適當的修訂版。 |
| 1164768, 1171478, 1171479 | 錯誤：在 mfglib 接收模式期間重複報告 ezspErrorHandler 0x34 | 若要減少列印的錯誤訊息，請設定 EMBER_AF_PLUGIN_GATEWAY_MAX_WAIT_FOR_EV 將主機應用程式上的 ENT_TIMEOUT_MS 設為 100，以便更快釋放回呼佇列。 |
| 1252460 | 啟動時運行的 SimEEPROM 恢復例程（適用於 v1 和 v2）可能會執行未對齊的閃存頁面擦除調用，從而在 em_msc 期間產生斷言。 c 的 MSC_ErasePage 程式。 | 解決方法：將下列程式碼行放在 em_msc.c 中 MSC_ErasePage() 函數的頂部：起始位址 = (uint32_t*)((uint32_t)startAddress & ~(FLASH_PAGE_SIZE-1)); |
已棄用的項目
發布中已棄用
在 GSDK 7.4.0.0 及更高版本（包括此修補程式）中，Z3Gateway 中用於 Linux 主機應用程式建立連接埠 4900 或 4901 的 telnet 介面的「-v」選項已被棄用。建立 telnet 介面的替代建議方法是使用 Linux 實用程序，例如“socat”。
發布中已棄用
刪除了以下已棄用的安全性 API：
- emberGetKey()
- emberGetKeyTableEntry()
- emberSetKeyTableEntry()
- emberHaveLinkKey()
- emberAddOrUpdateKeyTableEntry()
- emberAddTransientLinkKey()
- emberGetTransientKeyTableEntry()
- emberGetTransientLinkKey()
- emberHmacAesHash()
使用 Zigbee 安全管理器提供的 API 來存取金鑰儲存和 HMAC 雜湊。
刪除的項目
在發布中刪除
- 刪除了公共標頭中重複的公共 API file gp-types.h。
- zigbee_end_device_bind 元件已被刪除。此元件用於協調器代理終端設備的綁定請求。此選用功能已從 Zigbee 核心規範的 R22 中刪除。
- 刪除了 af-host.c 中的 setPacketBufferCount() 和 command-handlers.c 中無用的檢查情況 EZSP_CONFIG_PACKET_BUFFER_COUNT:。
- 刪除了記憶體分配參數，因為初始化 NCP 時無需分為兩個階段。
- 刪除了 se14-comms-hub、se14-ihd 和 se14-meter-gas 的 app.c 中的 emberAfNcpInitCallback()。
- 在 ncp-configuration.c 中的 ncp 初始化期間刪除了設定 EZSP_CONFIG_RETRY_QUEUE_SIZE 值
多協議網關和 RCP
新商品
新增到版本中
- 發布了並發偵聽，即使用 EFR802.15.4xG32 或 xG24 RCP 時 Zigbee 和 OpenThread 堆疊在獨立 21 通道上運行的能力。
- 並發監聽不適用於 802.15.4 RCP/藍牙 RCP 組合、Zigbee NCP/OpenThread RCP 組合或 Zigbee/OpenThread 系統單晶片 (SoC)。它將在未來版本中添加到這些產品中。
- OpenThread CLI 供應商擴充功能已新增至多協定容器的 OpenThread 主機應用程式。這包括 coex cli 命令。
改進
發佈時已更改
- Zigbee NCP/OpenThread RCP 多協議組合現已達到生產品質。
已解決的問題
已在發行版中修復
| ID ＃ | 描述 |
| 1213701 | 如果 MAC 間接佇列已經有該子項目的待處理數據，zigbeed 不允許為該子項建立來源比對表條目。此行為可能會導致子設備與其他某些設備之間的應用程式層事務因缺乏 APS Ack 或應用程式層回應而失敗，最明顯的是針對子設備的 ZCL OTA 升級的中斷和意外終止。 |
| 1244461 | 儘管訊息未決，但子項目的來源符合表條目可能會被刪除。 |
已在發行版中修復
| ID ＃ | 描述 |
| 1081828 | 基於 FreeRTOS 的 Zigbee/BLE DMP 的吞吐量問題amp應用程序。 |
| 1090921 | Z3GatewayCpc 在吵雜的環境中組成網路時遇到困難。 |
| 1153055 | 從 zigbee_ncp-ble_ncp-uart 讀取 NCP 版本時發生通訊故障，導致主機上出現斷言amp樂應用程序。 |
| 1155676 | 如果多個 802.15.4 介面共用相同的 15.4 位元節點 ID，16 RCP 會丟棄所有收到的單播封包（MAC 確認後）。 |
| 1173178 | 主機錯誤地報告了在 Host-RCP 設定中使用 mfglib 接收的數百個資料包。 |
| 1190859 | 在 Host-RCP 設定中傳送 mfglib 隨機資料包時出現 EZSP 錯誤。 |
| 1199706 | 來自被遺忘的終端設備子項的資料輪詢未在 RCP 上正確設定掛起幀，以將離開並重新加入命令排隊到前一個子項。 |
| 1207967 | 「mfglib send random」指令在 Zigbeed 上發送額外的資料包。 |
| 1208012 | 在 RCP 上接收時，mfglib rx 模式未正確更新資料包資訊。 |
| 1214359 | 當 80 個或更多路由器嘗試同時加入 Host-RCP 設定時，協調器節點崩潰。 |
| 1216470 | 在中繼位址遮罩 0xFFFF 的廣播後，充當父設備的 Zigbee RCP 將為每個子設備留下待處理的資料標誌集。這導致每個孩子在每次輪詢後都保持清醒狀態，等待數據，並且需要每個終端設備進行一些其他待處理的數據事務以最終清除此狀態。 |
當前版本中的已知問題
粗體顯示的問題是自上一版本以來新增的。 如果您錯過了某個版本，可以在以下位置找到最新的版本說明： https://www.si-labs.com/developers/gecko-software-development-kit.
| ID ＃ | 描述 | 解決方法 |
| 811732 | 使用 Zigbeed 時自定義令牌支持不可用。 | 計劃在未來的版本中提供支持。 |
| 937562 | Bluetoothctl 'advertise on' 命令在 Raspberry Pi OS 802154 上使用 rcp-uart-11-blehci 應用程序失敗。 | 使用 btmgmt 應用程序而不是 bluetoothctl。 |
| 1022972 | Coex 不適用於 ZB NCP + OT RCP。 | 計劃在未來版本中提供支援。 |
| 1074205 | CMP RCP 不支持同一 PAN id 上的兩個網絡。 | 為每個網絡使用不同的 PAN id。 計劃在未來的版本中提供支持。 |
| 1122723 | 在繁忙的環境中，z3-light_ot-ftd_soc 應用程式中的 CLI 可能會變得無回應。 | 沒有已知的解決方法。 |
| 1124140 | z3-light_ot-ftd_soc samp如果 OT 網路已經啟動，則應用程式無法形成 Zigbee 網路。 | 先啟動 Zigbee 網絡，然後啟動 OT 網路。 |
| 1170052 | CMP Zigbee NCP + OT RCP 和 DMP Zigbee NCP + BLE NCP 可能不適合目前版本中的 64KB 及更低 RAM 零件。 | 這些應用程式目前不支援 64KB 部分。 |
| 1209958 | Bobcat 和 Bobcat Lite 上的 ZB/OT/BLE RCP 在運行所有三個協定時可能會在幾分鐘後停止工作 | 將在未來版本中解決 |
| 1221299 | RCP 和 NCP 之間的 Mfglib RSSI 讀數不同。 | 將在未來版本中解決。 |
| 1231021 | 當 80 多個 zigbee 設備同時加入時，OTBR 可以發出斷言。 | 新增了可以解決該問題的修復程式。將在未來版本中全面解決。 |
已棄用的項目
- 沒有任何
刪除的項目
在發布中刪除
- “NONCOMPLIANT_ACK_TIMING_WORKAROUND”巨集已被刪除。現在，所有 RCP 應用程式預設支援非增強型 ack 的 192 微秒週轉時間，同時仍使用 CSL 所需的增強型 ack 的 256 微秒週轉時間。
使用此版本
此版本包含以下內容：
- Zigbee堆疊
- Zigbee應用框架
- 紫蜂Samp應用程序
有關 Zigbee 和 EmberZNet SDK 的更多信息，請參閱 UG103.02：Zigbee 基礎知識。
如果您是首次使用，請參閱 QSG180：SDK 7.0 及更高版本的 Zigbee EmberZNet 快速入門指南，以了解有關配置開發環境、建置和刷新的說明amp文件應用程式以及指向後續步驟的文件參考。
安裝與使用
Zigbee EmberZNet SDK 作為 Gecko SDK (GSDK)（Silicon Labs SDK 套件）的一部分提供。要快速開始使用 GSDK，請安裝 Simplicity Studio 5，它將設定您的開發環境並引導您完成 GSDK 安裝。 Simplicity Studio 5 包含使用 Silicon Labs 設備開發物聯網產品所需的一切，包括資源和專案啟動器、軟體設定工具、具有 GNU 工具鏈的完整 IDE 以及分析工具。在線上 Simplicity Studio 5 使用者指南中提供了安裝說明。
或者，可以通過從 GitHub 下載或克隆最新版本來手動安裝 Gecko SDK。 看 https://github.com/Sili-conLabs/gecko_sdk 了解更多。
Simplicity Studio 默認將 GSDK 安裝在：
- (Windows): C:\用戶\ \SimplicityStudio\SDKs\gecko_sdk
- (MacOS): /用戶/ /SimplicityStudio/SDKs/gecko_sdk
特定於 SDK 版本的文檔隨 SDK 安裝。 通常可以在知識庫文章 (KBA) 中找到其他信息。 有關此版本和早期版本的 API 參考和其他信息可在 https://docs.silabs.com/.
安全資訊
安全保管庫集成
對於選擇使用 Secure Vault-High 元件上的安全金鑰儲存元件安全儲存金鑰的應用程序，下表顯示了 Zigbee 安全管理器元件管理的受保護金鑰及其儲存保護特性。
| 包裝鑰匙 | 可出口/不可出口 | 筆記 |
| 網路金鑰 | 可出口 | |
| 信任中心連結密鑰 | 可出口 | |
| 瞬態連結密鑰 | 可出口 | 索引鍵表，儲存為易失性鍵 |
| 應用程式連結密鑰 | 可出口 | 索引鍵表 |
| 安全 EZSP 金鑰 | 可出口 | |
| ZLL 加密金鑰 | 可出口 | |
| ZLL 預先配置金鑰 | 可出口 | |
| GPD 代理金鑰 | 可出口 | 索引鍵表 |
| GPD 接收器金鑰 | 可出口 | 索引鍵表 |
| 內部/佔位符鍵 | 可出口 | Zigbee 安全管理器使用的內部金鑰 |
- 可以使用但不能使用標記為“不可導出”的包裝密鑰 view在運行時編輯或共享。
- 標記為“可導出”的包裝密鑰可以在運行時使用或共享，但在存儲在閃存中時仍保持加密狀態。
- 用戶應用程式永遠不需要與這些鍵中的大多數進行互動。用於管理連結金鑰表金鑰或臨時金鑰的現有 API 仍然可供使用者應用程式使用，現在可以透過 Zigbee 安全管理器元件進行路由。
- 其中一些密鑰將來可能無法匯出到用戶應用程式。除非絕對必要，否則鼓勵用戶應用程式不要依賴密鑰的導出。
- 有關安全保管庫密鑰管理功能的更多信息，請參閱 AN1271：安全密鑰存儲。
安全公告
要訂閱安全公告，請登錄 Silicon Labs 客戶門戶，然後選擇帳戶主頁。 單擊“主頁”轉到門戶主頁，然後單擊“管理通知”磁貼。 確保選中“軟件/安全諮詢通知和產品變更通知 (PCN)”，並且您至少訂閱了您的平台和協議。 單擊保存以保存任何更改。
支援
開發套件客戶有資格獲得培訓和技術支援。使用 Silicon Laboratories Zigbee web 頁面可取得有關所有 Silicon Labs Zigbee 產品和服務的信息，並註冊獲得產品支援。
您可以通過以下方式聯繫 Silicon Laboratories 支持 http://www.silabs.com/support.
簡約工作室
一鍵訪問 MCU 和無線工具、文檔、軟件、源代碼庫等。 適用於 Windows、Mac 和 Linux！
免責聲明
Silicon Labs 旨在為客戶提供最新、準確且深入的所有周邊設備和模組的文檔，供使用或打算使用 Silicon Labs 產品的系統和軟體實施者使用。特性資料、可用模組和周邊裝置、記憶體大小和記憶體位址涉及每個特定裝置，並且提供的「典型」參數在不同的應用中可能並且確實有所不同。應用前amp此處描述的文件僅用於說明目的。 Silicon Labs 保留對此處的產品信息、規格和描述進行更改的權利，恕不另行通知，並且不對所含信息的準確性或完整性提供保證。 出於安全或可靠性原因，Silicon Labs 可能會在製造過程中更新產品固件，恕不另行通知。 此類更改不會改變產品的規格或性能。 Silicon Labs 對使用本文檔中提供的信息的後果不承擔任何責任。 本文檔不暗示或明確授予設計或製造任何集成電路的任何許可。 未經 Silicon Labs 明確書面同意，產品未設計或授權用於任何 FDA III 類設備、需要 FDA 上市前批准的應用或生命支持系統。 “生命支持系統”是任何旨在支持或維持生命和/或健康的產品或系統，如果它發生故障，可以合理地預期會導致重大人身傷害或死亡。 Silicon Labs 產品未設計或授權用於軍事應用。 Silicon Labs 產品在任何情況下都不得用於大規模殺傷性武器，包括（但不限於）核武器、生物武器或化學武器，或能夠運載此類武器的導彈。 Silicon Labs 否認所有明示和暗示的保證，並且不對與在此類未經授權的應用程序中使用 Silicon Labs 產品相關的任何傷害或損害負責。
筆記： 此內容可能包含現已過時的攻擊性術語。 Silicon Labs 正在盡可能用包容性語言替換這些術語。 欲了解更多信息，請訪問 www.silabs.com/about-us/inclusive-lexicon-project.
商標資訊
Silicon Laboratories Inc.®、Silicon Laboratories®、Silicon Labs®、SiLabs® 和 Silicon Labs 標誌®、Bluegiga®、Bluegiga Logo®、EFM®、EFM32®、EFR、Ember®、Energy Micro、Energy Micro 標誌及其組合、 「全球最節能的微控制器」、Redpine Signals®、WiSeConnect、n-Link、ThreadArch®、EZLink®、EZRadio®、EZRadioPRO®、Gecko®、Gecko OS、Gecko OS Studio、Precision32®、Simplicity Studio®、 Telegesis 、Telegesis Logo®、USBXpress®、Zentri、Zentri 標誌和 Zentri DMS、Z-Wave® 等是 Silicon Labs 的商標或註冊商標。 ARM、CORTEX、Cortex-M3 和 THUMB 是 ARM Holdings 的商標或註冊商標。 Keil 是 ARM Limited 的註冊商標。 Wi-Fi 是 Wi-Fi 聯盟的註冊商標。本文提及的所有其他產品或品牌名稱均為其各自所有者的商標。
接觸
- 矽實驗室公司
- 400 西塞薩爾查韋斯
- 奧斯汀, 德州 78701
- 美國
- www.silabs.com
文件/資源
 | SILICON LABS SDK 7.4.1.0 GA Zigbee 協定堆疊軟體 [pdf] 使用者指南 SDK 7.4.1.0 GA Zigbee 協定堆疊軟體、SDK 7.4.1.0 GA、Zigbee 協定堆疊軟體、協定堆疊軟體、協定堆疊軟體 |