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	修复了计算精度有限导致 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 徽标®、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 徽标®、USBXpress®、Zentri、Zentri 徽标和 Zentri DMS、Z-Wave® 等是 Silicon Labs 的商标或注册商标。ARM、CORTEX、Cortex-M3 和 THUMB 是 ARM Holdings 的商标或注册商标。Keil 是 ARM Limited 的注册商标。 Wi-Fi 是 Wi-Fi Alliance 的注册商标。本文提及的所有其他产品或品牌名称均为其各自所有者的商标。

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