SILICON LABS 藍牙 SDK Mesh 說明

內容隱藏

1 SILICON LABS 藍牙 SDK 網狀網絡

2 新商品

SILICON LABS 藍牙 SDK 網狀網絡

藍牙網狀網路是一種適用於低功耗藍牙 (LE) 裝置的新拓撲，可實現多對多 (m:m) 通訊。它針對創建大型設備網路進行了最佳化，非常適合樓宇自動化、感測器網路和資產追蹤。我們的藍牙開發軟體和 SDK 支援藍牙 Mesh 和藍牙 5.2 功能。開發人員可以將網狀網路通訊新增至 LE 設備，例如連網燈、家庭自動化和資產追蹤系統。該軟體還支援藍牙信標、信標掃描和 GATT 連接，因此藍牙網狀網路可以連接到智慧型手機、平板電腦和其他藍牙 LE 裝置。

這些發行說明涵蓋 SDK 版本：

2.1.10.0 於 25 年 2023 月 32 日發布（支援 EFR22xGXNUMX，修訂版 D）
2.1.9.0 年 5 月 2023 日發布 XNUMX（僅底層平台變更）
2.1.8.0 年 13 月 2023 日發布的 32（支援 EFR21xGXNUMX、修訂版 C 及更高版本）

2.1.6.0 於 29 年 2023 月 XNUMX 日發布（搶先體驗部分支援）
2.1.5.0 於 11 年 2023 月 XNUMX 日發布（僅底層平台變更）
2.1.4.0 於 13 年 2021 月 XNUMX 日發布
2.1.3.0 於 24 年 2021 月 XNUMX 日發布（僅底層藍牙更改）
2.1.2.0 於 8 年 2021 月 XNUMX 日發布
2.1.1.0 於 21 年 2021 月 XNUMX 日發布
2.1.0.0 於 16 年 2021 月 XNUMX 日發布

兼容性和使用注意事項

有關安全更新和通知的更多信息，請參閱隨此 SDK 一起安裝的 Gecko 平台發行說明的安全章節或 Silicon Labs 發行說明頁面上的安全章節。 Silicon Labs 也強烈建議您訂閱安全公告以獲取最新資訊。有關說明，或者如果您是 Silicon Labs 藍牙網狀 SDK 的新手，請參閱使用此版本。

相容的編譯器
IAR Embedded Workbench for ARM (IAR-EWARM) 版本 8.50.9

在 macOS 或 Linux 上使用 wine 通過 IarBuild.exe 命令行實用程序或 IAR Embedded Workbench GUI 構建可能會導致不正確 file由於 wine 生成 short 的散列算法中的衝突，s 被使用 file 名稱。
建議使用 macOS 或 Linux 的客戶不要在 Simplicity Studio 之外使用 IAR 進行構建。這樣做的客戶應該仔細核實正確的 file正在使用 GCC（GNU 編譯器集合）版本 10.2.0，隨 Simplicity Studio 提供。 GCC 的連結時最佳化功能已停用，導致影像大小略有增加

新商品

新功能

在版本 2.1.0.0 中新增安全保管庫集成
從版本 2.1.0.0 開始，藍牙 Mesh SDK 使用 Secure Vault 金鑰管理功能在使用 Secure Vault High 裝置時儲存網格加密金鑰。客戶可以透過多種方式在系列 2 設備上看到 Secure Vault 整合：

加密金鑰及其相關元資料的 NVM3 資料佈局發生變化。為使用 SDK 2.0 或更早版本建立的專案提供了關鍵遷移功能。當裝置上的韌體更新時，需要完成一次性金鑰遷移。

常規網格節點上的關鍵資料可見性受到有意限制。常規網格節點上的應用程式不允許 view 使用 sl_btmesh_node_get_key() BGAPI 命令取得應用程式或裝置金鑰數據，同時允許嵌入式 Provisioner 節點上的應用程式這樣做。

有關 Secure Vault 中密鑰存儲的更多信息，請參閱 AN1271：安全密鑰存儲。

編譯器支持
支援的編譯器已更新至 GCC 版本 10.2.0 和 IAR 版本 8.50.9。

新前任amp應用程序
福勝利照明有限公司amp新增了 .le（藍牙 Mesh - SoC HSL Light）以演示可透過 HSL 伺服器模型控制的輕節點。為 Pro 開發套件（SLWRB4104A、SLWRB4181A、SLWRB4181B、SLWRB4182A）中的無線電板新增了 IOP 演示（藍牙 Mesh – IOP 測試 – *）。這些演示允許測試與手機的互通性。該測試需要四個前amp萊斯，每個前任amp代表 Mesh 功能之一的文件：代理、中繼、友元和 LPN。

新組件

新增了 HSL 伺服器元件。
新增了對動態 GATT 資料庫（藍牙 LE 功能）的支援。

版本 2.1.4.0 中新增了新 API

時間伺服器模型 API 中新增了明確時間狀態訊息傳送函數 sl_btmesh_time_server_status() 和對應的明確發布函數 sl_btmesh_time_server_publish()。

在版本 2.1.2.0 中添加
預設情況下，非 Provisioner 的普通 Mesh 裝置無法透過 BGAPI 匯出安全金鑰資料。如果此類裝置需要匯出金鑰，則應在節點上建立任何金鑰之前使用新的 BGAPI 命令 sl_btmesh_node_set_exportable_keys()。這包括在設備配置期間建立的密鑰。新增了通知應用程式規劃場景變更的診斷事件 sl_btmesh_scheduler_server_scene_changed()。

在版本 2.1.1.0 中添加
為了優化場景模型的緩衝區使用，新增了一個可選 API 以啟用壓縮場景呼叫事件（參考問題 ID 706555）。當節點擁有大量模型，或節點預期聽到的網路流量很高時，建議使用新的 API。若要啟動新 API，請使用 BGAPI 指令 sl_btmesh_scene_server_enable_compact_recall_events()。之後，sl_btmesh_evt_scene_server_compact_recall_events 將發出場景呼叫請求訊號。若要在場景呼叫請求後檢索快取的模型狀態，請使用指令 sl_btmesh_generic_server_get_cached_state()。

在版本 2.1.0.0 中添加
由於 Secure Vault 集成，第 2 系列裝置上儲存加密金鑰及其相關元資料的詳細資訊已發生變更。因此，新增了一個新的 BGAPI 類，用於在系列 2 裝置上進行韌體更新後遷移加密金鑰和嵌入式 Provisioner 的裝置資料庫。它有以下命令：

sl_btmesh_migration_migrate_keys
sl_btmesh_migration_migrate_ddb

改進

更改的 API

在版本 2.1.2.0 中更改
sl_btmesh_time_server_get_datetime() 中的時區參數已修正為帶符號的 16 位元整數。時脈精確度參數 sl_btmesh_lpn_clock_accuracy 已加入 LPN 配置。當裝置上的時鐘漂移會導致 LPN 錯過其輪詢逾時時，此參數可用於調整 LPN 睡眠行為。

在版本 2.1.1.0 中更改
現在，當配置客戶端在友誼處於活動狀態時停用節點的好友功能時，將產生事件 sl_btmesh_evt_friend_friendship_termerated。以前，在這種情況下，友誼的終止是由 sl_btmesh_evt_node_config_set 事件隱式發出的。（參考問題 ID 627811）

在版本 2.1.0.0 中更改
prov 類別中的以下 BGAPI 命令現在在參數驗證後返回，並且實際請求的操作在給出 BGAPI 回應後發生。請求操作的完成由對應的 BGAPI 事件發出訊號：

sl_btmesh_prov_add_ddb_entry() – 新增完成由 sl_btmesh_evt_prov_add_ddb_entry_complete 發出訊號
sl_btmesh_prov_delete_ddb_entry() – 刪除完成由 sl_btmesh_evt_prov_delete_ddb_entry_complete 發出訊號 prov 類別中的下列 BGAPI 指令有一個在呼叫後可能會產生的附加事件：
sl_btmesh_prov_init – 除了 sl_btmesh_evt_prov_initialized 之外，也可能產生 sl_btmesh_evt_prov_initialization_failed。 BGAPI 指令已新增至通用客戶端模型 BGAPI：

mesh_generic_client_init_hsl()
在通用伺服器模型 BGAPI 中新增了 BGAPI 指令：

mesh_generic_server_init_hsl()

已解決的問題

已在 2.1.4.0 版中修復

ID ＃	描述
729116	修正了向專案新增元素時無意的時間伺服器模型乘法的問題
735569	修正了友節點傳送到低功耗節點的分段多播訊息的處理

已在 2.1.2.0 版中修復

ID ＃	描述
627811	當本地請求終止時產生友誼終止事件
676798	LPN 輪詢喚醒時序考慮時鐘誤差
683518	收到好友清除訊息時立即產生好友終止事件
703974	修復了心跳資格測試問題
709948	提供 API 來控制網格節點上安全金鑰的可導出性
724511	修正了透過 0x1F 註冊供應商操作碼的問題
730273	修復了負時區偏移處理的問題
731713	修復了設備內存不足時發送分段訊息時潛在的內存洩漏
734034	修正了 TTL 為零時好友與 LPN 的通信
734858	修正了 PSA 結構處理中潛在的堆疊變數問題
736054	修正了模型應用程式鍵綁定的資格測試問題

已在 2.1.1.0 版中修復

ID ＃	描述
692961	修正了在重負載下啟用中繼重傳時節點變得無回應的問題
713152	修復了計算精度有限導致 Light Lightness Actual 和 Light Lightness Linear 綁定時出現捨入誤差的問題

已在 2.1.0.0 版中修復

ID ＃	描述
3878	應用程式應忽略網格特徵的 GATT 事件
342521	數學庫不會不必要地增加圖像的大小
358019	更正了當請求具有友誼憑證的模型發布但不支援友誼時給出的更正結果代碼
404070	修正了在非配置者設備上呼叫建立網路金鑰的配置者命令時給出的結果代碼
454332	LE GAP API 應用於裝置本機名稱廣告
464907	當設定客戶端在節點上停用心跳時，刪除了不必要的「心跳已啟動」BGAPI 事件
653405	開箱即用的開關amp應用程式電流消耗現在處於預期水平
654477	網路分析儀正確解碼 DCD
660048	Button Press UC 組件不需要 IO Stream 組件
687105	BT Mesh 指令與 NCP Target ex 搭配使用ample 和 NCP 指揮官
690803	修正了程式碼產生器中重複的供應商模型 ID
690862	SoC空前ample 現在開始在 xG22 硬體上設定信標
707497	更正了 PSA 加密上下文分配
707524	修復了 IV 恢復保護計時器的回歸，不允許太快再次恢復

ID ＃	描述
710381	修正了設定對應模型的非預設範圍時的照明預設狀態處理
711359	修復了配置會話創建 BGAPI 呼叫的參數檢查

當前版本中的已知問題

粗體顯示的問題是自上一版本以來添加的。

ID ＃	描述	解決方法
401550	沒有分段訊息處理失敗的 BGAPI 事件	應用程式需要從超時/缺乏應用層回應來推斷失敗
418636	mesh_test 本機設定狀態 API 的問題（節點身分、中繼、網路重傳）
454059	KR流程結束時會產生大量按鍵刷新狀態變更事件，可能導致NCP佇列氾濫	增加專案中的 NCP 佇列長度
454061	與往返延遲測試中的 1.5 相比，觀察到效能略有下降
624514	如果所有連線均處於活動狀態並且正在使用 GATT 代理，則重新建立可連線廣告時會出現問題	多分配一個比需要的連接
650825	定期發布模型時出現重傳問題	在模型狀態中設定重傳並透過應用程式計時器觸發定期發布

已棄用的項目

節點類別中的以下 BGAPI 指令已被棄用： sl_btmesh_node_erase_mesh_nvm() – 請改用 sl_btmesh_node_reset()。

刪除的項目

沒有任何

使用此版本

此版本包含以下內容

Silicon Labs 藍牙網狀網路堆疊庫
藍牙amp應用程序

如果您是首次使用，請參閱 QSG176：Silicon Labs 藍牙 Mesh SDK v2.x 快速入門指南。

安裝與使用
需要在 Silicon Labs 註冊帳戶才能下載 Silicon Labs 藍牙 SDK。您可以在 https://sili-conlabs.force.com/apex/SL_CommunitiesSelfReg?form=short。 QSG176：Silicon Labs 藍牙 Mesh SDK v2.x 快速入門指南中介紹了堆疊安裝說明。將藍牙網狀網路 SDK 與 Silicon Labs Simplicity Studio V4 開發平台結合使用。 Simplicity Studio 確保大多數軟體和工具相容性得到正確管理。收到通知後立即安裝軟體和板韌體更新。特定於 SDK 版本的文件隨 SDK 一起安裝。通常可以在知識庫文章 (KBA) 中找到其他資訊。有關此版本和早期版本的 API 參考和其他資訊可在 https://docs.silabs.com/.

安全資訊安全保管庫集成
此版本的堆疊與 Secure Vault 金鑰管理整合。部署到 Secure Vault High 裝置時，網狀加密金鑰將使用 Secure Vault 金鑰管理功能進行保護。下表顯示了受保護的金鑰及其儲存保護特性。

鑰匙	節點上的可導出性	Provisioner 上的可導出性	筆記
網路金鑰	可出口	可出口	網路金鑰的派生僅存在於 RAM 中，而網路金鑰則儲存在快閃記憶體中
應用密鑰	不可出口	可出口
裝置金鑰	不可出口	可出口	在 Provisioner 的情況下，應用於 Provisionerr 自己的裝置金鑰以及其他裝置的金鑰

標記為「不可匯出」的金鑰可以使用，但不能 view在運行時編輯或共享。標記為「可匯出」的金鑰可以在運行時使用或共享，但在儲存在快閃記憶體中時保持加密狀態。有關 Secure Vault 金鑰管理功能的更多信息，請參閱 AN1271：安全金鑰存儲

安全公告
要訂閱安全公告，請登錄 Silicon Labs 客戶門戶，然後選擇帳戶主頁。單擊“主頁”轉到門戶主頁，然後單擊“管理通知”磁貼。確保選中“軟件/安全諮詢通知和產品變更通知 (PCN)”，並且您至少訂閱了您的平台和協議。單擊保存以保存任何更改。

支援
開發套件客戶有資格獲得培訓和技術支援。使用 Silicon Labs 藍牙網狀網絡 web 頁面以獲取有關所有 Silicon Labs 藍牙產品和服務的信息，並註冊產品支援。聯絡 Silicon Laboratories 支援人員： http://www.silabs.com/support.

簡約工作室
一鍵訪問 MCU 和無線工具、文檔、軟件、源代碼庫等。適用於 Windows、Mac 和 Linux！

物聯網產品組合
- www.silabs.com/物聯網
軟件/硬件
- www.silabs.com/simplicity
品質
- www.silabs.com/quality
支持與社區
- www.silabs.com/community

免責聲明
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 聯盟的註冊商標。本文提及的所有其他產品或品牌名稱均為其各自所有者的商標。

Silicon Laboratories Inc. 400 West Cesar Chavez Austin, TX 78701 美國