SILICON LABS 蓝牙网状网络 SDK 嵌入式软件
产品规格
- 产品名称: Simplicity SDK 套件
- 版本: 2024.6.0
- 发布日期: 5 年 2024 月 XNUMX 日
- 蓝牙网状网络规范版本: 1.1
产品使用说明
蓝牙网状网络是一种适用于低功耗蓝牙 (LE) 设备的新拓扑,可实现多对多 (m:m) 通信。它针对创建大规模设备网络进行了优化,非常适合楼宇自动化、传感器网络和资产跟踪。我们用于蓝牙开发的软件和 SDK 支持蓝牙网状网络和蓝牙功能。开发人员可以将网状网络通信添加到 LE 设备,例如联网灯、家庭自动化和资产跟踪系统。该软件还支持蓝牙信标、信标扫描和 GATT 连接,因此蓝牙网状网络可以连接到智能手机、平板电脑和其他低功耗蓝牙设备。此版本包括蓝牙网状网络规范版本 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 – 一个用于构建功耗优化且安全的 IoT 设备的可靠框架。Simplicity SDK 提供强大的功能,例如超低功耗、强大的网络可靠性、对大量节点的支持以及对多协议和预认证等复杂要求的抽象。此外,Silicon Labs 还提供无线 (OTA) 软件和安全更新,以远程更新设备、最大限度地降低维护成本并增强最终用户的产品体验。Simplicity SDK 是我们广受欢迎的 Gecko SDK 的后续产品,它将继续提供,为我们的 0 系列和 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 中已添加低功耗节点功能amples(btmesh_soc_sensor_thermometer、btmesh_soc_nlc_sensor_oc-cupancy btmesh_soc_nlc_sensor_ambient_light)和 Friend 功能已添加到传感器服务器客户端 example(btmesh_soc_sen-sor_client)。
修正问题
已在 7.0.0.0 版中修复
- 如果仅使用 PB-GATT 配置节点,则避免启动广告承载者。
- 改进了过载设备上的配置事件报告。
- 改进了过载设备上的 DFU 事件报告。
- 如果节点上的 Blob Transfer 配置不足以满足 DFU Distributor 和 Standalone Updater 模型的要求,则添加错误报告。
- 修复了使用 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 中删除
此版本已删除对 Series 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 安装在:
- 视窗:
- 目录:\用户\ \SimplicityStudio\SDKs\simplicity_sdk
- MacOS: /用户/ /SimplicityStudio/SDK/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 徽标®、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、Telegesis 徽标®、USBXpress®、Zentri、Zentri 徽标和 Zentri DMS、Z-Wave® 等是 Silicon Labs 的商标或注册商标。ARM、CORTEX、Cortex-M3 和 THUMB 是 ARM Holdings 的商标或注册商标。Keil 是 ARM Limited 的注册商标。Wi-Fi 是 Wi-Fi Alliance 的注册商标。本文提及的所有其他产品或品牌名称均为其各自所有者的商标。
常见问题 (FAQ)
问:在哪里可以找到有关安全更新的更多信息?
答:请参阅平台发行说明的安全章节或访问 Silicon Labs 发行说明页面,了解详细的安全更新。
问:如何包含clock_manager组件进行时钟初始化?
答:要包含用于时钟初始化的clock_manager组件,请确保按照用户手册中提供的说明相应地更新您的应用程序项目。
硅实验室公司
400 西塞萨尔查韦斯
德克萨斯州奥斯汀 78701
美国
www.silabs.com
物联网产品组合
www.silabs.com/物联网
软件/硬件
www.silabs.com/simplicity
支持与社区
www.silabs.com/community
文件/资源
![]() |
SILICON LABS 蓝牙网状网络 SDK 嵌入式软件 [pdf] 用户指南 蓝牙 Mesh SDK 嵌入式软件、Mesh SDK 嵌入式软件、SDK 嵌入式软件、嵌入式软件、软件 |