SILICON LABS Z-Wave 和 Z-Wave Long Range 800 SDK
规格
- Z-Wave 和 Z-Wave Long Range 800 SDK 7.22.4
- Simplicity SDK Suite 2024.6.3 23 年 2025 月 XNUMX 日
- 互操作性：与所有 Z-Wave 生态系统产品 100% 互操作
- 安全：采用 Z-Wave 的 Security 2 (S2) 框架，实现一流的安全性
- 安装：SmartStart Easy Installation，简化设置
- 向后兼容性：Z-Wave 认证要求向后兼容
- 兼容的编译器：Simplicity Studio 附带的 GCC 版本 12.2.1
描述
Z-Wave 和 Z-Wave Long Range 800 旨在满足未来智能家居的需求，未来对更多传感器和电池供电设备的需求日益增长，这要求它们兼具长距离和低功耗。情境感知环境是智能家居市场的下一个发展方向，需要专门针对这些应用进行优化的技术。
- 100% 可互操作：Z-Wave 生态系统中的所有产品均可与其他所有产品兼容，无论其类型、品牌、制造商或版本如何。任何其他智能家居/物联网协议都无法做到这一点。
- 一流的安全性：Z-Wave 的 Security 2 (S2) 框架为智能家居设备和控制器提供端到端加密和最先进的安全保障。配备 S2 Z-Wave 设备的家庭几乎不会被黑客入侵。
- SmartStart 简易安装SmartStart 通过二维码扫描实现统一、无故障的安装，彻底简化了智能设备的安装流程。设备和系统可预先配置，显著简化部署。
- 向后兼容：Z-Wave 认证要求向后兼容。市场上首批 Z-Wave 设备已有十多年历史，在采用最新 Z-Wave 技术的网络中仍能正常运行。
有关 Z-Wave 和 Z-Wave Long Range 800 SDK v7.22.4.0 OSR 认证状态的更多信息，请参阅第 9 节“产品生命周期和认证”。
这些发行说明涵盖了 SDK 版本：
- 23 年 2025 月 XNUMX 日发布
- OSR 于 13 年 2024 月 XNUMX 日发布
- GA 于 18 年 2024 月 XNUMX 日发布
- GA 于 24 年 2024 月 XNUMX 日发布
- 正式版将于 5 年 2024 月 XNUMX 日发布
兼容性和使用声明
有关安全更新和通知的更多信息，请参阅随此 SDK 安装的平台发行说明中的“安全”章节，或在 Silicon Labs 发行说明页面Silicon Labs 还强烈建议您订阅安全公告以获取最新信息。如需相关说明，或者如果您是 Z-Wave 800 SDK 新手，请参阅第 8 节“使用此版本”。
兼容的编译器
GCC（GNU 编译器集合）版本 12.2.1，随 Simplicity Studio 提供。
主要特色
- 7.22.x 及未来更新支持 800 系列平台
- 700 系列平台将在即将发布的 7.21.x 版本中继续获得支持
- 在 FUNC_ID_SERIAL_API_STARTED 有效负载中添加有关重置原因的附加信息
支持的无线电板
本节分别介绍 800 系列经过认证和预认证的应用程序支持的无线电板。
表 1-1。支持的无线电板
|
系列 |
收音机 木板 |
描述 |
Z-Wave 远程 | Tx 力量 | 安全保险柜 |
| 800 | BRD2603A | ZGM230SB：SiP | 是的 | 14 分贝毫瓦 | 高的 |
| 800 | BRD2705A | EFR32ZG28B：SoC | 是的 | 14 分贝毫瓦 | 高的 |
| 800 | BRD4204A | EFR32ZG23A：SoC | 是的 | 14 分贝毫瓦 | 中 |
| 800 | BRD4204B | EFR32ZG23A：SoC | 是的 | 14 分贝毫瓦 | 中 |
| 800 | BRD4204C | EFR32ZG23B：SoC | 是的 | 14 分贝毫瓦 | 高的 |
| 800 | BRD4204D | EFR32ZG23B：SoC | 是的 | 14 分贝毫瓦 | 高的 |
| 800 | BRD4205A | ZGM230SA：系统级封装 | 是的 | 14 分贝毫瓦 | 中 |
| 800 | BRD4205B | ZGM230SB：SiP | 是的 | 14 分贝毫瓦 | 高的 |
| 800 | BRD4210A | EFR32ZG23B：SoC | 是的 | 20 分贝毫瓦 | 高的 |
| 800 | BRD4400B | EFR32ZG28B：SoC | 是的 | 14 分贝毫瓦 | 高的 |
| 800 | BRD4400C | EFR32ZG28B：SoC | 是的 | 14 分贝毫瓦 | 高的 |
| 800 | BRD4401B | EFR32ZG28B：SoC | 是的 | 20 分贝毫瓦 | 高的 |
| 800 | BRD4401C | EFR32ZG28B：SoC | 是的 | 20 分贝毫瓦 | 高的 |
上表中的应用需要将无线电板与 BRD4002A – 无线入门套件主板 (WSTK) 和 BRD8029A – 按钮和 LED 扩展板结合使用。请注意，BRD4002A 与即将弃用的旧版 BRD4001A 主板兼容。上表中的串行 API 只需要一个无线电板和一个 BRD4002A – 无线入门套件主板 (WSTK)。参考 INS14278：如何使用经过认证的应用程序 和 INS14816：如何使用预先认证的应用程序，以获取详细信息。
ZW-LR 表示无线电板同时支持 Z-Wave 和 Z-Wave Long Range。 14/20 dBm表示射频板的发射功率。 Secure Vault 是一套业界领先的最先进的安全功能，可应对不断升级的物联网 (IoT) 威胁。
表 1-2。 无线电委员会与 OPN。
| 系列 | 无线电板 | OPN 描述 |
| 800 | BRD2603A | ZGM230SB27HGN3 |
| 800 | BRD2705A | EFR32ZG28B312F1024IM48-A |
| 800 | BRD4204A | EFR32ZG23A010F512GM48 |
| 800 | BRD4204B | EFR32ZG23A010F512GM48 |
| 800 | BRD4204C | EFR32ZG23B010F512IM48 |
| 800 | BRD4204D | EFR32ZG23B010F512IM48 |
| 800 | BRD4205A | ZGM230SA27HNN0 |
| 800 | BRD4205B | ZGM230SB27HGN2 |
| 800 | BRD4210A | EFR32ZG23B020F512IM48 |
| 800 | BRD2603A | ZGM230SB27HGN3 |
| 800 | BRD4400C | EFR32ZG28B312F1024IM68-A |
| 800 | BRD4401B | EFR32ZG28B322F1024IM68-A |
| 800 | BRD4401C | EFR32ZG28B322F1024IM68-A |
上表显示了无线电板和 OPN 的关系。此表可用于阐明 Simplicity SDK 中提供的预构建二进制文件的兼容性。预构建二进制文件是针对电路板而非 OPN 构建的。可用的 OPN 比上面列出的要多。对于那些 OPN，预构建二进制文件将不起作用。所需的应用程序必须针对特定的 OPN 构建。
Z-Wave 协议
请注意，基于 SDK v800.x 的 7.17 产品不支持无线 (OTA) 升级安全元件固件。但是，存在一个迁移路径，可以同时升级主引导加载程序和安全元件固件以支持此功能。有关升级路径，请参阅 INS14895：如何使用 Tiny App 的说明。基于 800 的 SDK v7.18.x 支持无线 (OTA) 升级安全元件固件。Z-Wave 协议 NVM8 的 3 kB 容量缩减 file 在部署于 800 及更早版本上的基于 7.17.2 系列的应用程序上进行 OTA 固件更新时，系统会产生影响。要将固件从 7.17.2 更新到 7.18.1/2，需要修改 7.18.1/2 版本，使其 NVM3 协议大小与 7.17.2 版本相同。这可以在构建 3/7.18.1 版本时通过定义 NVM2_DEFAULT_NVM_SIZE 进行配置。请注意，由于 800 系列引入了安全密钥存储，因此不再支持外部提供的密钥对。为确保安全性不受影响，密钥在首次启动时在内部生成，并且私钥仅存储在安全存储中。公钥和二维码可以在生产环境中读取。
新品
已在 7.22.4 GA 版本中添加
| ID ＃ | 描述 |
| 1439232 | 修改了看门狗配置，并删除了 Z-Wave 堆栈禁用看门狗的步骤。默认看门狗已更改为在 8 秒无供电后重置设备。 |
| 1434642 | 提升了 CCA（空闲信道评估）的可靠性。此前，该功能仅使用最新测量的 RSSI 值，而非 RX 窗口中的最高值。 |
- 添加新的串行 API 命令来检索支持的区域列表。
已在 7.22.1 GA 版本中添加
| ID ＃ | 描述 |
| 1246332 | 现在每个设备系列都有一个 ZPAL 库。 |
| 1271456 | 合并无线电板 RF 配置 files（参见zw_config_rf.h）。 |
| 1242395 | ZAF_BUILD_NO、SDK_VERSION_[MAJOR|MINOR|PATCH]、ZAF_VERSION_[MAJOR|MINOR|PATCH] 都不是
应用程序中不再可用。它们已被“ZAF_version.h”中定义的几个访问器函数取代。 |
| 1196450 | zpal_reset_reason_t 取代 EResetReason_t 枚举。 |
- 在 FUNC_ID_SERIAL_API_STARTED 有效负载中添加有关重置原因的附加信息。
改进
在版本 7.22.4 GA 中进行了改进
| ID ＃ | 描述 |
| 1439232 | 修改了看门狗配置，并删除了 Z-Wave 堆栈禁用看门狗的步骤。默认看门狗已更改为在 8 秒无供电后重置设备。 |
| 1434642 | 提升了 CCA（空闲信道评估）的可靠性。此前，该功能仅使用最新测量的 RSSI 值，而非 RX 窗口中的最高值。 |
在版本 7.22.0 GA 中进行了改进
| ID ＃ | 描述 |
| 1246332 | 现在每个设备系列都有一个 ZPAL 库。 |
| 1271456 | 合并无线电板 RF 配置 files（参见zw_config_rf.h）。 |
| 1242395 | ZAF_BUILD_NO、SDK_VERSION_[MAJOR|MINOR|PATCH]、ZAF_VERSION_[MAJOR|MINOR|PATCH] 都不是
应用程序中不再可用。它们已被“ZAF_version.h”中定义的几个访问器函数取代。 |
| 1196450 | zpal_reset_reason_t 取代 EResetReason_t 枚举。 |
修正问题
已在 7.22.4 版中修复
| ID ＃ | 描述 |
| 1363469 | 修复了 RAIL 处理问题，该问题导致多个 TX 和 RX 无线电事件可能属于同一回调，从而导致状态机混乱。这会导致堆栈处于无法接收数据包的状态。 |
| 1397177 | 修复了 REMOVE_NODE_FROM_NETWORK SAPI 命令中的一个行为：如果目标节点 ID 在移除器的网络中共享，则该命令将失败。 |
| 1439197 | 修复了串行 API 控制器应用程序中无法配置高于 +14 dBM 的 TX 输出功率的问题。 |
| 1330168 | 修复了控制器端从 7.18（或更早版本）到 7.21 或更新版本的 NVM 迁移路径问题。迁移期间未更新应用程序数据。 |
| 1439269 | 修复了堆栈尝试通过无线方式发送超大数据包的情况。 |
| 1385589 | 修复了“永不监听”设备每分钟都会无意中唤醒的问题。 |
| 1374874 | Z-Wave 长距离终端设备在软重置后可能会出现发射功率输出降低的情况。此问题已修复。 |
已在 7.22.3 OSR 版本中修复
| ID ＃ | 描述 |
| 1367428 | 修复了与 LBT 机制相关的问题，其中终端设备无法切换到空闲频道并响应传入的请求。 |
已在版本 7.22.2 GA 中修复
| ID ＃ | 描述 |
| 1346170/
1295158 |
SerialAPI 终端设备应用程序是固定的，可以与 CTT 代理一起使用。 |
已在版本 7.22.1 GA 中修复
| ID ＃ | 描述 |
| 1321606 | 修复了导致控制器锁定在恒定光束模式的问题。此行为是由于在控制器 NVM 中输入了错误的配置导致的。 |
| 1325749 | 修复可防止在高流量负载下 ZAF 应用程序队列和传输队列之间发生自锁。 |
| 1325746 | 修复了终端设备在拥挤的射频环境中会软重置的情况。 |
| 1302749 | 修复了在 Z-Wave 长距离模式下配置的控制器可能进入与 TX 数据包关联的 CRC 错误状态的问题。此问题在嘈杂环境中触发，包括 FLiRS 设备。 |
| 1313883 | 修复了控制器未将 EU_LR 报告为长距离区域的问题。 |
已在版本 7.22.0 GA 中修复
| ID ＃ | 描述 |
| 1062482 | 修复了影响 OTA 的一个问题，当触发计时器中断时它会卡住。 |
| 1266899 | 修复了影响从 7.17 到较新的 NCP 串行 API 控制器的迁移过程的控制器迁移问题。 |
| 1271456 | BRD4401C 无线电板（EFR32ZG28 + 20 dBm 输出功率）配置错误，导致 TX 输出功率低。此问题已得到解决。 |
| 1273430 | 修复影响网络范围包含和排除的高优先级数据包管理。 |
| 1289422 | 修复了以高频率轮询终端设备时导致重置的问题。 |
| 1238611 | TX 队列重构解决影响控制器稳定性的竞争条件。 |
| 1285197 | 控制器极少会遇到导致不受管理的状态 (RAIL_EVENT_RX_FIFO_OVERFLOW)。控制器现在会触发软重置。 |
当前版本中的已知问题
自上一版本以来添加了粗体问题。 如果您错过了某个版本，请访问最近的版本说明 Silicon Labs 发行说明页面.
| ID ＃ | 描述 | 解决方法 |
| 1227385 | 虽然 Z-Wave Classic 中的控制器稳定性已经得到了很大改善，但仍然建议在主机端实施变通方法。 | 主机可以缓解这种发生率较低的问题。当控制器锁定并回复状态 TRANSMIT_COMPLETE_FAIL 时，主机应重置控制器。 |
| 1247775 | 当应用程序需要频繁中断时，RTOS 时钟节拍可以停止。RTOS 时钟节拍不会增加，并停止 Z-Wave 堆栈和其他任务。 | 在 sli_schedule_wakeup_timer_expire_handler() 函数中，替换
/* 增加 RTOS 滴答。 */ 当（（current_tick_count - last_update_lftick）> lfticks_per_os_ticks）{ sched |= xTaskIncrementTick(); last_update_lftick + = lfticks_per_os_ticks; } By /* 增加 RTOS 滴答。 */ while（（当前滴答计数 – 上次更新滴答次数） >= lfticks_per_os_ticks) { sched |= xTaskIncrementTick(); last_update_lftick + = lfticks_per_os_ticks; } |
| 1300414 | 终端设备在排除后确认数据包。 | 没有解决方法。 |
| 1295158 | 与 CTT 代理一起使用时，模拟终端设备包含会失败。 | 建议测试人员使用另一个版本的模拟终端设备。 |
| 753756 | 基于 500 个应用程序的网络广泛包含 (NWI) 无法通过 700/800 中继器工作。 | NWI 在第二次尝试时起作用。 |
弃用的项目
自 7.22.0 堆栈版本发布以来，Simplicity SDK 不再支持 700 平台。700 平台将通过 7.21.x 版本流进行维护。
已移除商品
在版本 7.22.0 GA 中删除
- 没有任何。
Z-Wave Plus V2 应用程序框架
新品
添加了用户凭证命令类的 Beta 实现。请注意，即将发布的 2024A Z-Wave 规范中，预计会对此命令类规范进行更多更新，而此早期实现并未实现所有这些更改。该命令类将在未来的补丁版本中根据 2024A 规范进行调整。门锁键盘的新版本amp新增应用程序：“带 U3C Beta 版的门锁键盘”，支持用户凭证命令类。新增 CLI 支持ample 应用程序。对于 FL 和 NL 应用程序，CLI 默认处于禁用状态，因为它会阻止应用程序进入睡眠模式。有关为这些睡眠应用程序启用 CLI 的说明，请参阅应用程序的自述文件 files.
改进
有关使用 Z-Wave Plus V2 框架进行应用程序开发的详细说明，请参阅 INS14259：Z-Wave Plus V2 应用程序框架 GSDK对于希望迁移到 800 平台的客户，我们还提供了一份移植指南。该指南包含详细的示例amp该文件介绍了如何将非组件/基于 700 的开关应用程序 (7.16.3) 移植到基于组件/800 的开关应用程序 (7.17.0)。 请参阅 APL14836：移植 Z-Wave 应用程序的应用说明。 软件从 700 到 800 个硬件。
修正问题
已在版本 7.22.2 GA 中修复
| ID ＃ | 描述 |
| 1332325 | 修复了使用 Bootloader – SoC 内部存储项目时 OTA 失败 0x05 的问题。 |
已在版本 7.22.1 GA 中修复
| ID ＃ | 描述 |
| 1301405 | Z-Wave 版本配置 SLC 组件的输入字段默认设置为 1.0.0，但 0 超出了允许范围。在 0 个输入字段的情况下，zw_version_config.h 中的版本设置不正确。 |
| 1304174 | Simplicity Studio 中缺少 Z-Wave 引导加载程序演示的质量级别。 |
已在版本 7.22.0 GA 中修复
| ID ＃ | 描述 |
| 1243767 | Simplicity Studio 中缺少 ZG28 OTA 和 OTW 演示引导加载程序。 |
当前版本中的已知问题
粗体显示的问题是自上一版本以来添加的。如果您错过了某个版本，可以在以下位置找到最新的版本说明： Silicon Labs 发行说明页面
| ID ＃ | 描述 | 解决方法 |
| 369430 | 无论是否预期响应，所有 S2 多播帧都使用经过验证的交付 S2_TXOPTION_VERIFY_DELIVERY 发送。 | 根据发送的帧更改源代码。 |
| 1172849 | 在 800 系列上，睡眠将不再需要 advantage EM1P 电流节省。 | 当前不可用。 |
| 1257690 | sl_storage_config.h 不处理自定义 OTA 插槽大小。 | 当前不可用。 |
| 1347089 | CC 配置器无法创建多级传感器端点。 | 当前不可用。 |
弃用的项目
由于删除了 Assert 组件，已知问题 ID 为 1080416 的问题已被弃用。
已移除商品
已在 7.22.0.GA 版本中删除
- 没有任何。
Samp应用程序
7.22.0 SDK 版本中的门锁键盘、电源板、传感器 PIR 和墙壁控制器应用程序已根据已批准的 2023B Z-Wave 规范测试套件获得官方认证。7.22.0 传感器 PIRample 应用程序包含一个 CTT 问题；针对 1322043 问题描述了解决方法。amp基于 7.22.1 SDK 版本的应用程序已通过 Silicon Labs 基于已批准的 2023B Z-Wave 规范测试套件的自我认证，且没有任何问题。7.21.1 SDK 版本新增了适用于 BRD2603A 和 BRD2705A 开发板的串行 API 终端设备演示固件。
修正问题
已在版本 7.22.2 GA 中修复
| ID ＃ | 描述 |
| 1327637 | 修复了 Doorlock 应用程序使用 CLI 组件编译的错误。 |
已在版本 7.22.1 GA 中修复
| ID ＃ | 描述 |
| 1303548 | 修复了 set_new_user_code CLI 命令仅采用 PIN 码的前 4 位数字的问题。 |
| 1303546 | 修复了 enter_user_code CLI 命令无法打开门的问题。 |
当前版本中的已知问题
| ID ＃ | 描述 | 解决方法 |
| 1245554 | DoorLock 应用程序不适用于用户 ID 超过 163 的情况。 | 当前不可用。 |
带 U3C Beta 的门锁键盘
这是门锁键盘的新变体amp支持用户凭证命令类的应用程序，是 Beta 版。由于尚未进行自我认证，该应用程序包含已知问题，并将根据 2024A Z-Wave 规范中预期的变化进行调整。
修正问题
已在版本 7.22.2 GA 中修复
| ID ＃ | 描述 |
| 1297891 | 修复了仅在凭证关联成功的情况下才会收到用户凭证关联报告的问题。 |
| 1308210 | 修复了凭证学习状态报告发送多个重复帧的问题。 |
已在版本 7.22.1 GA 中修复
| ID ＃ | 描述 |
| 1297891 | 仅当凭证关联成功时才会收到用户凭证关联报告。 |
| 1297667 | 凭证设置错误包含错误数据。 |
| 1297614 | 删除用户后不会删除用户凭证。 |
| 1297611 | 下一个凭证值未保持升序。 |
| 1297370 | 多个凭证删除不起作用。 |
| 1297352 | 邮政编码应该只存储数字，而不是任何字符。 |
| 1297175 | 凭证功能报告中的凭证最大长度错误。 |
| 1296879 | 删除用户并不保证删除所有相关凭证。 |
| 1296863 | 可以添加不受支持的用户类型。 |
| 1296859 | 缺少 USER_NOTIFICATION_REPORT 命令。 |
| 1296854 | 缺少 USER_SET_ERROR_REPORT 命令。 |
当前版本中的已知问题
| ID ＃ | 描述 | 解决方法 |
| 1297831 | Credential Learn 不适用于 BTN2。 | 当前不可用。 |
| 1347581 | 用户和凭证报告被错误地仅发送到相关的较低安全节点。 | 当前不可用。 |
| 1346581 | 默认用户密码仅包含连续的数字。 | 将用户 PIN 码更改为允许的 PIN 码。 |
修正问题
已在版本 7.22.1 GA 中修复
| ID ＃ | 描述 |
| 1274235 | 启用用户任务的传感器 PIR 最终陷入硬故障。
这启用了传感器 PIR 中的用户任务ample app（通过在 app.c 中将 CREATE_USER_TASK 宏从 0 设置为 1），导致 Hard Fault。 |
| 1231755 | 缺少传感器 PIR 开启至关闭运动警报通知。 |
| 1087508 | 在 S2 引导之前，通知 CC 状态值通过注入的 SET 命令发生了改变。 |
当前版本中的已知问题
| ID ＃ | 描述 | 解决方法 |
| 1256505 | 由于这些 GPIO 不支持从 EM0 唤醒，因此在使用 BRD1C 和 BRD4400C 无线电板的扩展板上按下 BTN4401 和 BTN4 按钮时，传感器 PIR 不会唤醒。 | 将按钮重新映射到支持从 EM4 唤醒的 GPIO。 |
7.22.0 GA 版本中的已知问题
| ID ＃ | 描述 | 解决方法 |
| 1322043 | SensorPIR 中缺少第一个生命线报告，导致 CTT 测试用例 CCM_AssociationCmdClass_Rev01 CTT 失败。 | 在该表下方找到该问题的修复方法。 |
Samp应用程序
修复已知问题 1322043：
修正问题
| ID ＃ | 描述 |
| 1274235 | 启用用户任务的传感器 PIR 最终陷入硬故障。
这启用了传感器 PIR 中的用户任务ample app（通过在 app.c 中将 CREATE_USER_TASK 宏从 0 设置为 1），导致 Hard Fault。 |
| 1231755 | 缺少传感器 PIR 开启至关闭运动警报通知。 |
| 1087508 | 在 S2 引导之前，通知 CC 状态值通过注入的 SET 命令发生了改变。 |
- 没有任何。
当前版本中的已知问题
| ID ＃ | 描述 | 解决方法 |
| 1256505 | 由于这些 GPIO 不支持从 EM0 唤醒，因此在使用 BRD1C 和 BRD4400C 无线电板的扩展板上按下 BTN4401 和 BTN4 按钮时，传感器 PIR 不会唤醒。 | 将按钮重新映射到支持从 EM4 唤醒的 GPIO。 |
串行API应用程序
从版本 7.16 开始，当通过 FUNC_ID_NVM_BACKUP_RESTORE 备份和恢复串行 API 端节点时，串行 API 端节点将自动将协议非易失性存储器 (NVM) 升级到最新版本。任何由 7.16 或更高版本的串行 API 端节点制作的备份都可以恢复到其原始版本或更高版本的串行 API 端节点，而无需手动升级协议 NVM。版本 8 中的串行接口保持不变。从 SDK 版本 7.18.x 开始，串行 API 端节点可用作源代码和二进制文件。这为构建具有不同引脚配置或额外硬件利用率的自定义版本的串行 API 端节点提供了可能性。一个用例可能是使用 SPI 而不是 UART 进行串行通信。Simplicity SDK 中没有使用串行 API 终端设备的应用程序。
重要变更
从 7.19 版本开始，API 重大变更已记录在 Simplicity SDK 中的“Important_changes.md”文件中。请查看该文件，了解最新版本中引入的变更的详细说明。HTML 文档已添加到 Simplicity SDK 中，可在以下位置找到： https://docs.silabs.com/z-wave/7.22.2/zwave-api/ 以及 Simplicity Studio 文档部分的“Z-Wave 压缩 doxygen 文档”。该文档位于/protocol/z-wave/docs_public/z-wave-html-docs.zip。
开源软件
Z-Wave 使用 FreeRTOS 作为底层操作系统，它基于 FreeRTOS Kernel V10.4.3。
使用此版本
此版本包含以下内容：
- Z-Wave Plus V2 应用程序框架
- 适用于各种智能家居应用的 Z-Wave 认证应用
- Z-Wave 协议和串行 API 应用程序
如果您是首次使用，Z-Wave 文档会随 SDK 一起安装。看 INS14280：终端设备 Z-Wave 入门, INS14278：如何在 Z-Wave 中使用经过认证的应用程序， 和 INS14281：控制器设备的 Z-Wave 入门 请参阅相关说明。此 SDK 依赖于 Simplicity SDK 平台。Simplicity SDK 平台代码提供支持协议的功能 plugins 驱动程序和其他底层功能形式的 API，可直接与 Silicon Labs 芯片和模块交互。 Gecko 平台组件包括 EMLIB、EMDRV、RAIL 库、NVM3、PSA 和 mbedTLS。 Gecko 平台发行说明可通过 Simplicity Studio 的 Launcher Perspective 获取。
安装和使用
订购 Z-Wave 无线入门套件。该套件提供最简单、最快捷的方式来评估和开发您自己的 Z-Wave 网状网络应用。它为终端设备和网关提供了一个全球通用的开发套件，其中包含多个无线电板，开发人员可以使用它创建网状网络并评估 Z-Wave 模块。Z-Wave 和 Z-Wave Long Range 800 SDK 是 Simplicity SDK（Silicon Labs SDK 套件）的一部分。要快速开始使用 Simplicity SDK，请安装 简单工作室 5，它将设置您的开发环境并指导您完成 Simplicity SDK 的安装。Simplicity Studio 5 包含使用 Silicon Labs 设备进行物联网产品开发所需的一切，包括资源和项目启动器、软件配置工具、带有 GNU 工具链的完整 IDE 以及分析工具。在线安装说明 Simplicity Studio 5 用户指南。或者，可以通过从 GitHub 下载或克隆最新版本来手动安装 Simplicity SDK。请参阅 https://github.com/Sil-iconLabs/simplicity_sdk 了解更多信息。
Simplicity Studio 默认将 SDK 安装在：
- (Windows)：C:\用户\ \SimplicityStudio\SDKs\simplicity_sdk
- （MacOS）：/用户/ /SimplicityStudio/SDKs/simplicity_sdk
为了实现特定的应用程序，Silicon Labs 建议从具有所需角色类型的现有自认证应用程序之一开始。
安全信息
安全保管库集成
此版本的堆栈使用安全保管库接口对非对称密钥 (ECC Curve 25519) 和对称密钥 (AES) 进行密钥管理。
安全建议
要订阅安全公告，请登录 Silicon Labs 客户门户，然后选择“帐户主页”。点击“主页”转到门户主页，然后点击“管理通知”磁贴。请确保已勾选“软件/安全公告通知和产品变更通知 (PCN)”，并且至少已订阅您平台和协议的相应版本。点击“保存”以保存所有更改。
支持
开发套件客户有资格获得培训和技术支持。 请参阅支持资源并联系 Silicon Laboratories 支持，网址为 https://www.silabs.com/support.
产品生命周期和认证
Silicon Labs 将根据市场需求添加新功能，并持续改进 Z-Wave 协议，以更好地定位 Z-Wave 生态系统。Z-Wave 协议生命周期是一个为 Z-Wave 合作伙伴提供快速创新、新功能和稳定成熟协议发布的过程。Z-Wave 协议生命周期定义了 Z-Wave 协议各代的成熟过程，包含三个阶段，分为五个生命周期阶段：tages.用于特定设备的 Z-Wave SDK 的更改确实需要重新认证；然而，所需的认证类型、所需的测试量以及相关费用取决于变更的范围。请参阅 Z-Wave 联盟主页 https://z-wavealliance.org/ 了解详情。
表 9-1。 Z-Wave SDK 发布历史记录
| 系列 | SDK版本 | 发布日期 [日-月-年] |
| 800 | 7.22.3 OSR | 13 年 2024 月 XNUMX 日 |
| 800 | 十八 GA | 18-SEP-2024 |
| 800 | 十八 GA | 24 年 2024 月 XNUMX 日 |
| 800 | 十八 GA | 06 年 2024 月 XNUMX 日 |
| 700/800 | 十八 GA | 14 年 2024 月 XNUMX 日 |
| 700/800 | 十八 GA | 02 年 2024 月 XNUMX 日 |
| 700/800 | 十八 GA | 10 年 2024 月 XNUMX 日 |
| 700/800 | 十八 GA | 14 年 2024 月 XNUMX 日 |
| 700/800 | 十八 GA | 15年2023月XNUMX日 |
| 700/800 | 十八 GA | 13 年 2024 月 XNUMX 日 |
| 700/800 | 十八 GA | 9 年 2023 月 XNUMX 日 |
| 700/800 | 十八 GA | 26 年 2023 月 XNUMX 日 |
| 700/800 | 7.20.0 预认证 GA | 07 年 2023 月 XNUMX 日 |
| 700/800 | 十八 GA | 03 年 2024 月 XNUMX 日 |
| 700/800 | 十八 GA | 24 年 2024 月 XNUMX 日 |
| 700/800 | 十八 GA | 16 年 2023 月 XNUMX 日 |
| 700/800 | 十八 GA | 03 年 2023 月 XNUMX 日 |
| 700/800 | 十八 GA | 08 年 2023 月 XNUMX 日 |
| 700/800 | 十八 GA | 01 年 2023 月 XNUMX 日 |
| 700/800 | 7.19.0 预认证 GA | 14年2022月XNUMX日 |
| 700/800 | 十八 GA | 13-SEP-2023 |
| 700/800 | 十八 GA | 28 年 2023 月 XNUMX 日 |
| 700/800 | 十八 GA | 18 年 2023 月 XNUMX 日 |
| 700/800 | 十八 GA | 19 年 2022 月 XNUMX 日 |
| 700/800 | 十八 GA | 28-SEP-2022 |
| 700/800 | 十八 GA | 17 年 2022 月 XNUMX 日 |
| 700/800 | 7.18.0 预认证 GA | 08 年 2022 月 XNUMX 日 |
| 700/800 | 十八 GA | 09 年 2022 月 XNUMX 日 |
| 700/800 | 7.17.1 预认证 GA | 28 年 2022 月 XNUMX 日 |
| 700/800 | 7.17.0 预认证 GA | 08年2021月XNUMX日 |
| 700 | 十八 GA | 13 年 2021 月 XNUMX 日 |
| 700 | 十八 GA | 08-SEP-2021 |
| 700 | 十八 GA | 21 年 2021 月 XNUMX 日 |
| 系列 | SDK版本 | 发布日期 [日-月-年] |
| 700 | 7.16.0 预认证 GA | 16 年 2021 月 XNUMX 日 |
| 700 | 十八 GA | 07 年 2021 月 XNUMX 日 |
| 700 | 7.15.2 预认证 GA | 27 年 2021 月 XNUMX 日 |
| 700 | 7.15.1 预认证 GA | 09年2020月XNUMX日 |
| 700 | 十八 GA | 14 年 2020 月 XNUMX 日 |
| 700 | 十八 GA | 09年2020月XNUMX日 |
| 700 | 十八 GA | 29 年 2020 月 XNUMX 日 |
| 700 | 7.14.0 测试版 | 24 年 2020 月 XNUMX 日 |
| 700 | 十八 GA | 21-SEP-2023 |
| 700 | 十八 GA | 02 年 2022 月 XNUMX 日 |
| 700 | 十八 GA | 18 年 2021 月 XNUMX 日 |
| 700 | 十八 GA | 03 年 2021 月 XNUMX 日 |
| 700 | 十八 GA | 26 年 2019 月 XNUMX 日 |
| 700 | 十八 GA | 20-SEP-2019 |
简单工作室
一键访问 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 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 的注册商标。本文提及的所有其他产品或品牌名称均为其各自所有者的商标。
Silicon Laboratories Inc. 400 West Cesar Chavez Austin, TX 78701 美国 www.silabs.com
常见问题解答
问：哪些编译器与 Z-Wave 和 Z-Wave Long Range 800 SDK 兼容？
答：Simplicity Studio 提供的 GCC 版本 12.2.1 与 Z-Wave SDK 兼容。
问：如何确保我的 Z-Wave 设备的安全？
答：使用 Z-Wave 提供的 Security 2 (S2) 框架实现端到端加密和增强的安全功能。
问：我可以将新的 Z-Wave 设备集成到我现有的设置中吗？
答：是的，Z-Wave 生态系统中的每款产品都设计为可互操作，让您可以无缝集成新设备。
文件/资源
 |
SILICON LABS Z-Wave 和 Z-Wave Long Range 800 SDK [pdf] 用户手册 7.22.4.0、2024.6.3、Z-Wave 和 Z-Wave 长距离 800 SDK、Z-Wave 长距离 800 SDK、长距离 800 SDK、范围 800 SDK、800 SDK、SDK |