SILICON LABS 藍牙網狀網路 SDK 使用手冊

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

這些發行說明涵蓋 SDK 版本

7.0.3.0 於 23 年 2025 月 XNUMX 日發布（僅限底層平台變更）
7.0.2.0 於 18 年 2024 月 XNUMX 日發布
7.0.1.0 於 24 年 2024 月 XNUMX 日發布
7.0.0.0 於 5 年 2024 月 XNUMX 日發布

兼容性和使用注意事項
有關安全更新和通知的更多信息，請參閱隨此 SDK 安裝的平台發行說明中的“安全”章節或 Silicon Labs 發行說明頁面。 Silicon Labs 也強烈建議您訂閱安全公告以獲取最新資訊。有關說明，或如果您是 Silicon Labs Bluetooth Mesh SDK 的新用戶，請參閱使用此版本。

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

在 macos 或 Linux 上使用 Wine 和 IarBuild.exe 命令列實用程式或 IAR Embedded Workbench GUI 進行建置可能會導致錯誤 file由於 wine 生成 short 的散列算法中的衝突，s 被使用 file 名稱。

建議使用 macos 或 Linux 的客戶不要在 Simplicity Studio 之外使用 IAR 進行建置。這樣做的客戶應仔細核實正確的 file正在使用。
GCC（GNU 編譯器集合）版本 12.2.1，隨 Simplicity Studio 提供。

GCC 的連結時最佳化功能已停用，導致影像大小略有增加。

主要特點

遷移到 Simplicity SDK 套件
刪除了對系列 0/1 的支持
支援增量壓縮韌體更新

新商品

新功能

在版本 7.0.1.0 中添加
已新增對 Mesh 設備韌體更新 (DFU) 的支持，該更新利用基於識別兩個韌體版本之間差異的有效增量壓縮。此功能需要使用支援分析 ELF 二進位差異的 Commander 工具版本，以及使用支援應用壓縮韌體更新的引導程式。

在版本 7.0.0.0 中添加
已新增對時鐘管理器的支援。堆疊元件不再使用 device_init() 進行時脈初始化。相反，應用程式專案現在必須包含執行時鐘初始化的clock_manager元件。
已新增對通用記憶體管理器的支援。

新 API

在版本 7.0.0.0 中添加

改進

在版本 7.0.0.0 中更改

BGAPI 變更
已新增節點 BGAPI 類別命令 sl_btmesh_node_test_identity，用於檢查接收到的節點身分通告是否來自給定節點。

Examp應用程式變更
感測器伺服器 ex 中新增了低功耗節點功能amp檔案（btmesh_soc_sensor_thermometer、btmesh_soc_nlc_sensor_oc-cupancy btmesh_soc_nlc_sensor_ambient_light）和好友功能已新增至感測器伺服器客戶端 examp文件（btmesh_soc_sen-sor_client）。

已解決的問題

已在 7.0.2.0 版中修復

ID ＃	描述
1331888, 1334927, 1338088, 1338090	修復了幾個未處理的記憶體分配失敗，當設備流量過載時，這些失敗可能會導致崩潰。
1345827	修正了節點刪除時遺失資訊性 DFU 分發器 BGAPI 事件的問題。
1301401	修正了接收帶有轉換時間的照明伺服器設定請求時照明伺服器狀態更新錯誤。
1345411	修復了 sl_memory_realloc() 洩漏內存，導致 DFU 分配器 example 堆記憶體不足。

已在 7.0.1.0 版中修復

ID ＃	描述
1301325	修復了儲存調度程序模型操作的問題。
1305041	修正了從主機到 EFR32 的 NCP 通訊逾時問題。
1305928	修正了實施事件遺失修復 1258654 後 DFU 事件中正確接收器清單資料遺失的問題。
1319326	修正了輸入和輸出 OOB 驗證位元枚舉的錯誤值。
1325194	修正了實施事件遺失修復 1258654 後不必要的 DFU 分發器用戶端接收器狀態事件重複。
1310377	修復了 IOP Relay 應用程式中的一個問題。此前，它僅使用 GATT 進行傳輸。

已在 7.0.0.0 版中修復

ID ＃	描述
356148	如果僅使用 PB-GATT 設定節點，則避免啟動廣告承載。
1250461	使配置事件報告在過載設備上更加可靠。
1258654	使 DFU 事件報告在過載設備上更加可靠。
1274632	如果節點上的 Blob 傳輸配置不足，DFU 分發器和獨立更新程式模型現在將報告錯誤。
1284204	修正了當應用程式使用 sl_btmesh_node_power_off() API 時將重播保護儲存到 NVM3 的問題。

當前版本中的已知問題

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

ID ＃	描述	解決方法
401550	沒有分段訊息處理失敗的 BGAPI 事件。	應用程式需要從超時/缺乏應用層回應來推斷失敗；對於供應商模型，已提供 API。
454059	KR過程結束時會產生大量的金鑰刷新狀態變化事件，這可能會淹沒NCP隊列。	增加項目中的NCP隊列長度。
454061	與往返延遲測試中的 1.5 相比，觀察到效能略有下降。
624514	如果所有連線都處於活動狀態且 GATT 代理正在使用中，則會出現重新建立可連線廣告的問題。	多分配一個比需要的連接。
841360	透過 GATT 承載的分段訊息傳輸效能較差。	確保底層BLE連線的Connection間隔較短；確保 ATT MTU 足夠大以適合全網狀 PDU；調整最小連線事件長度以允許每個連線事件傳輸多個 LL 資料包。
1121605	舍入錯誤可能會導致計劃的事件在與預期稍有不同的時間觸發。
1226127	主機配置者前amp當它開始配置第二個節點時，le 可能會卡住。	在配置第二個節點之前重新啟動主機配置程式應用程式。
1204017	經銷商無法處理並行的自我 FW 更新和 FW 上傳。	不要並行運行韌體自我更新和韌體上傳。

已棄用的項目

在版本 7.0.0.0 中已棄用
BGAPI 指令 sl_btmesh_prov_test_identity 已棄用。請改用 sl_btmesh_node_test_identity。

刪除的項目

在版本 7.0.0.0 中刪除

此版本中刪除了對系列 1 硬體（xG12 和 xG13）的支援。

使用此版本

此版本包含以下內容

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

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

安裝與使用

藍牙網狀網路 SDK 是 Silicon Labs SDK 套件 Simplicity SDK (GSDK) 的一部分。
要快速開始使用 Simplicity SDK，請安裝 Simplicity Studio 5，它將設定您的開發環境並引導您完成 Simplicity SDK 的安裝。

Simplicity Studio 5 包含使用 Silicon Labs 設備進行物聯網產品開發所需的一切，包括資源和專案啟動器、軟體設定工具、具有 GNU 工具鏈的完整 IDE 和分析工具。
在線上 Simplicity Studio 5 使用者指南中提供了安裝說明。

或者，可以透過從 GitHub 下載或複製最新版本來手動安裝 Simplicity SDK。看 https://github.com/Sili-conLabs/simplicity_sdk 了解更多信息。
Simplicity Studio 預設將 Simplicity SDK 安裝在：
- Windows：C:\使用者\ \SimplicityStudio\SDKs\simplicity_sdk
- MacOS：/用戶/ /SimplicityStudio/SDKs/simplicity_sdk

特定於 SDK 版本的文檔隨 SDK 安裝。通常可以在知識庫文章 (KBA) 中找到其他信息。有關此版本和早期版本的 API 參考和其他信息可在 https://docs.silabs.com/.

安全資訊

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

鑰匙	節點上的可導出性	Provisioner 上的可導出性	筆記
網路金鑰	可出口	可出口	網路金鑰的派生僅存在於 RAM 中，而網路金鑰則儲存在快閃記憶體中。
應用密鑰	不可出口	可出口
裝置金鑰	不可出口	可出口	對於 Provisioner 來說，它適用於 Provisioner 的裝置金鑰以及其他裝置的金鑰。

標記為「不可匯出」的金鑰可以使用，但不能 view在運行時編輯或共享。
標記為「可匯出」的金鑰可以在運行時使用或共享，但在儲存在快閃記憶體中時仍保持加密狀態。

有關安全保險庫金鑰管理功能的更多信息，請參閱 AN1271 安全金鑰儲存。

安全公告
若要訂閱安全公告，請登入 Silicon Labs 客戶門戶，然後選擇「帳戶主頁」。按一下「首頁」前往入口網站主頁，然後按一下「管理通知」圖塊。確保選取“軟體/安全公告和產品變更通知 (PCNS)”，並且至少訂閱了您的平台和協定。點擊“儲存”以儲存所有變更。

下圖是examp樂

支援
開發套件客戶有資格獲得培訓和技術支援。使用 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 致力於為客戶提供所有周邊和模組的最新、準確和深入的文檔，供使用或打算使用 SiliconLabs 產品的系統和軟體實施者使用。特性資料、可用的模組和周邊、記憶體大小和記憶體位址指的是每個特定的設備，所提供的「典型」參數在不同的應用場合可能會有所不同。
應用前amp此處描述的文件僅用於說明目的。
Silicon Labs 保留對本文中的產品資訊、規格和描述進行更改的權利，恕不另行通知，並且不對所包含資訊的準確性或完整性提供保證。

出於安全性或可靠性原因，Silicon Labs 可能會在製造過程中更新產品韌體，而無需事先通知。此類變化不會改變產品的規格或性能。 Silicon Labs 對於使用本文檔中提供的資訊所造成的後果不承擔任何責任。
本文件並不暗示或明確授予設計或製造任何積體電路的任何許可。
未經 Silicon Labs 的明確書面同意，該產品未被設計或授權用於任何 FDA III 類設備、需要 FDA 上市前批准的應用或生命維持系統。
「生命維持系統」是指任何用於支持或維持生命和/或健康的產品或系統，如果其發生故障，可以合理預期會導致嚴重的人身傷害或死亡。
Silicon Labs 的產品並未設計或授權用於軍事應用。 Silicon Labs 產品在任何情況下均不得用於大規模毀滅性武器，包括（但不限於）核武、生物武器或化學武器，或能夠運載此類武器的飛彈。
Silicon Labs 不承擔所有明示或暗示的保證，並且對於在未經授權的應用中使用 Silicon Labs 產品而造成的任何傷害或損害，不承擔任何責任。

商標資訊
Silicon Laboratories Inc.®、Silicon Laboratories®、Silicon Labs®、SiLabs® 和 Silicon Labs 標誌®、Bluegiga®、Bluegiga 標誌®、EFM®、EFM32®、EFR、Ember®、Energy Micro、Energy Micro 標誌及其組合、「世界上最節能的微型控制器」 Signals®、WiSeConnect、n-Link、EZLink®、EZRadio®、EZRadioPRO®、Gecko®、Gecko OS、Gecko OS Studio、Precision32®、Simplicity Studio®、Telegesis、Telegesis 商標®、USBXpress® Zentri、Zentri 商標或商標。 ARM、CORTEX、Cortex-M3 和 THUMB 是 ARM Holdings 的商標或註冊商標。 Keil是ARM Limited的註冊商標。 Wi-Fi是Wi-Fi聯盟的註冊商標。本文提及的所有其他產品或品牌名稱均為其各自所有者的商標。

矽實驗室公司
美國德州奧斯汀西凱撒查韋斯大道 400 號，郵編 78701
www.silabs.com

常見問題解答

Q：在哪裡可以找到有關安全更新的更多資訊？
A: 請參閱平台發行說明的安全章節或造訪 Silicon Labs 發行說明頁面以取得詳細的安全更新資訊。

Q：如何訂閱安全公告？
A: Silicon Labs 建議訂閱安全公告以獲取最新資訊。請按照文件中提供的說明進行操作或聯絡 Silicon Labs 支援。

文件/資源

SILICON LABS 藍牙網狀網路 SDK [pdf] 使用者手冊
7.0.3.0、7.0.2.0、7.0.1.0、7.0.0.0、藍牙 Mesh SDK、Mesh SDK、SDK

參考

使用者手冊

SILICON LABS 藍牙網狀網路 SDK

規格

產品使用說明

新商品

改進