SILICON LABS 藍牙 Mesh SDK 嵌入式軟體
產品規格
- 產品名稱： 簡單 SDK 套件
- 版本： 2024.6.0
- 發布日期： 5 年 2024 月 XNUMX 日
- 藍牙網狀網路規格版本： 1.1
產品使用說明
藍牙網狀網路是一種適用於低功耗藍牙 (LE) 裝置的新拓撲，可實現多對多 (m:m) 通訊。它針對創建大型設備網路進行了最佳化，非常適合樓宇自動化、感測器網路和資產追蹤。我們的藍牙開發軟體和 SDK 支援藍牙 Mesh 和藍牙功能。開發人員可以將網狀網路通訊新增至 LE 設備，例如連網燈、家庭自動化和資產追蹤系統。該軟體還支援藍牙信標、信標掃描和 GATT 連接，因此藍牙網狀網路可以連接到智慧型手機、平板電腦和其他藍牙 LE 裝置。此版本包含藍牙網狀網路規格版本 1.1 支援的功能。
這些發行說明涵蓋 SDK 版本：
7.0.0.0 於 5 年 2024 月 XNUMX 日發布
兼容性和使用注意事項
有關安全更新和通知的更多信息，請參閱隨該 SDK 一起安裝的平台發行說明的安全章節或 Silicon Labs 發行說明頁面上的安全章節。 Silicon Labs 也強烈建議您訂閱安全公告以獲取最新資訊。有關說明，或者如果您是 Silicon Labs 藍牙網狀 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 是一個嵌入式軟體開發平台，用於建立基於我們的系列 2 和系列 3 無線和 MCU 設備的物聯網產品。它整合了無線協議棧、中間件、外設驅動程式、引導程式和應用程式擴展amples – 用於建立功耗優化且安全的物聯網設備的可靠框架。 Simplicity SDK具有超低功耗、強大的網路可靠性、支援海量節點、抽像多協定、預認證等複雜需求等強大功能。此外，Silicon Labs 還提供無線 (OTA) 軟體和安全性更新，以遠端更新設備、最大限度地降低維護成本並增強最終用戶的產品體驗。 Simplicity SDK 是我們廣受歡迎的 Gecko SDK 的後續產品，它將繼續為我們的 Series 0 和 Series 1 設備提供長期支援。
有關係列 0 和系列 1 設備的更多信息，請參考： 系列 0 和系列 1 EFM32/EZR32/EFR32 裝置（silabs.com).
新功能
在版本 7.0.0.0 中添加
新增了對時鐘管理器的支援。堆疊元件不再使用 device_init() 進行時脈初始化。相反，應用程式專案現在必須包含進行時鐘初始化的clock_manager 元件。新增了對通用記憶體管理器的支援。
新 API
在版本 7.0.0.0 中新增 無。
改進
- 新增了節點 BGAPI 類別命令 sl_btmesh_node_test_identity，用於檢查節點身分廣告來源。
- 感測器伺服器 ex 中新增了低功耗節點功能amp萊斯。
- 感測器伺服器客戶端ex添加好友功能amp勒。
在版本 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.0.0 版中修復
- 如果僅使用 PB-GATT 設定節點，請避免啟動廣告承載。
- 改進了過載設備上的配置事件報告。
- 改進了過載設備上的 DFU 事件報告。
- 如果節點上的 Blob 傳輸配置不足以支援 DFU 分發器和獨立更新程式模型，則新增錯誤報告。
- 修正了使用 sl_btmesh_node_power_off() API 時將重播保護儲存到 NVM3 的問題。
| ID ＃ | 描述 |
| 356148 | 如果僅使用 PB-GATT 設定節點，則避免啟動廣告承載。 |
| 1250461 | 使配置事件報告在過載設備上更加可靠。 |
| 1258654 | 使 DFU 事件報告在過載設備上更加可靠。 |
| 1274632 | 如果節點上的 Blob 傳輸配置不充分，DFU 分發器和獨立更新器模型現在將報告錯誤。 |
| 1284204 | 修正了當應用程式使用 sl_btmesh_node_power_off() API 時將重播保護儲存到 NVM3 的問題。 |
當前版本中的已知問題
粗體顯示的問題是自上一版本以來添加的。
- 沒有分段訊息處理失敗的 BGAPI 事件。
- 金鑰刷新狀態變更事件可能導致 NCP 佇列氾濫。
- 與 1.5 版本相比，往返延遲測試中的效能略有下降。
- 如果所有連線均處於活動狀態並且正在使用 GATT 代理，則重新建立可連線廣告會出現問題。
- 透過 GATT 承載的分段訊息傳輸效能較差。
| ID ＃ | 描述 | 解決方法 |
| 401550 | 沒有分段訊息處理失敗的 BGAPI 事件。 | 應用程式需要從超時/缺少應用層回應來推斷失敗；對於供應商模型，已提供 API。 |
| 454059 | KR過程結束時會產生大量的金鑰刷新狀態變化事件，這可能會淹沒NCP隊列。 | 增加專案中的 NCP 佇列長度。 |
| 454061 | 與往返延遲測試中的 1.5 相比，觀察到效能略有下降。 | |
| 624514 | 如果所有連線均處於活動狀態且 GATT 代理正在使用，則重新建立可連線廣告時會出現問題。 | 多分配一個比需要的連接。 |
| 841360 | 透過 GATT 承載的分段訊息傳輸效能較差。 | 確保底層BLE連線的Connection間隔較短；確保 ATT MTU 足夠大以適合全網狀 PDU；調整最小連線事件長度以允許每個連線事件傳輸多個 LL 資料包。 |
| 1121605 | 舍入錯誤可能會導致計劃的事件在與預期稍有不同的時間觸發。 | |
| 1226127 | 主機配置者前amp當開始配置第二個節點時，檔案可能會被卡住。 | 在配置第二個節點之前重新啟動主機配置程式應用程式。 |
| 1204017 | 分發伺服器無法處理並行的自我韌體更新和韌體上傳。 | 不要並行運行韌體自我更新和韌體上傳。 |
| 1301325 | 調度程序操作未正確儲存到持久性儲存。 | |
| 1305041 | 從主機到 EFR32 的 NCP 通訊可能會逾時。 | 可以編輯 sl_simple_com_usart.c 以更正逾時值。 |
| 1305928 | 在 SoC 分發器應用程式上設定 10 個或更多更新節點作為 DFU 接收器可能會失敗。 |
已棄用的項目
在版本 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 作為 Simplicity SDK (GSDK)（Silicon Labs SDK 套件）的一部分提供。要快速開始使用 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 安裝在：
- 視窗：
- C:\使用者\ \SimplicityStudio\SDKs\simplicity_sdk
- 蘋果系統： /使用者/ /SimplicityStudio/SDKs/simplicity_sdk
特定於 SDK 版本的文檔隨 SDK 安裝。 通常可以在知識庫文章 (KBA) 中找到其他信息。 有關此版本和早期版本的 API 參考和其他信息可在 https://docs.silabs.com/.
安全資訊
| 鑰匙 | 節點上的可導出性 | Provisioner 上的可導出性 | 筆記 |
| 網路金鑰 | 可出口 | 可出口 | 網路金鑰的派生僅存在於 RAM 中，而網路金鑰則儲存在快閃記憶體中 |
| 應用密鑰 | 不可出口 | 可出口 | |
| 裝置金鑰 | 不可出口 | 可出口 | 在 Provisioner 的情況下，應用於 Provisionerr 自己的裝置金鑰以及其他裝置的金鑰 |
安全保管庫集成
此版本的堆疊與 Secure Vault 金鑰管理整合。部署到 Secure Vault High 設備時，網狀加密金鑰將使用 Secure Vault 金鑰管理功能進行保護。下表顯示了受保護的金鑰及其儲存保護特性。
- 標記為「不可匯出」的金鑰可以使用，但不能 view在運行時編輯或共享。
- 標記為「可匯出」的金鑰可以在運行時使用或共享，但在儲存在快閃記憶體中時保持加密狀態。
- 有關 Secure Vault 金鑰管理功能的更多信息， 參見 AN1271： 安全密鑰儲存。
安全公告
要訂閱安全公告，請登錄 Silicon Labs 客戶門戶，然後選擇帳戶主頁。 單擊“主頁”轉到門戶主頁，然後單擊“管理通知”磁貼。 確保選中“軟件/安全諮詢通知和產品變更通知 (PCN)”，並且您至少訂閱了您的平台和協議。 單擊保存以保存任何更改。
支援
開發套件客戶有資格獲得培訓和技術支援。使用 Silicon Labs 藍牙網狀網絡 web 頁面以獲取有關所有 Silicon Labs 藍牙產品和服務的信息，並註冊產品支持。
聯絡 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、EZLink®、EZRadio®、EZRadioPRO®、Gecko®、Gecko OS、Gecko OS Studio、Precision32®、Simplicity Studio®、Telegesis、Teleelegesis Logo®、USBXpress®、Zentri、Zentri 標誌和Zentri DMS、Z-Wave® 等是Silicon Labs 的商標或註冊商標。 ARM、CORTEX、Cortex-M3 和 THUMB 是 ARM Holdings 的商標或註冊商標。 Keil 是 ARM Limited 的註冊商標。 Wi-Fi 是 Wi-Fi 聯盟的註冊商標。本文提及的所有其他產品或品牌名稱均為其各自所有者的商標。
常見問題 (FAQ)
Q：在哪裡可以找到有關安全更新的更多資訊？
答：請參閱平台發行說明的安全章節或造訪 Silicon Labs 發行說明頁面以了解詳細的安全性更新。
Q：如何包含 Clock_manager 元件來進行時脈初始化？
答：若要包含用於時脈初始化的clock_manager元件，請確保按照使用者手冊中提供的說明相應地更新您的應用程式專案。
矽實驗室公司
400 西塞薩爾查韋斯
奧斯汀, 德州 78701
美國
www.silabs.com
物聯網產品組合
www.silabs.com/物聯網
軟件/硬件
www.silabs.com/simplicity
支持與社區
www.silabs.com/community
文件/資源
 |
SILICON LABS 藍牙 Mesh SDK 嵌入式軟體 [pdf] 使用者指南 藍牙 Mesh SDK 嵌入式軟體、Mesh SDK 嵌入式軟體、SDK 嵌入式軟體、嵌入式軟體、軟體 |