Wi-Fi 通用固件版本说明

更新时间:2025-10-22 02:45:27下载pdf

概述

Wi-Fi 模组通用固件实现了模组配网、数据通讯等功能,基于串口通讯协议,可以快速实现产品的智能化。为了持续提升通用固件的能力,满足安全合规最新要求,通用固件会进行迭代升级,开发者可根据实际产品需要,选择匹配的模组和固件进行产品开发。

WBR 系列模组

  • WBRx 系列模组主要包括 WBR1、WBR2、WBR3、WBR1-IPEX、WBRU 等。

  • 通用固件:keyjkajwawthq4f5

版本说明

版本号 发布日期 Building 发布状态 版本说明
v3.1.69 2025 年 07 月 09 日 OS 已上架
  • 支持欧盟 RED 认证
  • 稳定性提升
  • 取消快连模式(EZ)配网
v3.1.23 2024 年 12 月 05 日 OS 已上架
  • OS 架构下首个正式发布版本
  • 支持欧盟 RED 认证
  • 取消快连模式配网
v2.7.29 2025 年 07 月 17 日 CI 已上架
  • 支持欧盟 RED 认证
  • 稳定性提升
  • 支持快连模式配网
v2.7.7 2023 年 11 月 20 日 CI 已下架
  • 不支持欧盟 RED 认证
  • 支持快连模式配网

注意事项

  • v2.x.x 固件是基于 CI 框架开发,MCU 校验较宽松。
  • v3.x.x 固件是基于 OS 框架开发,MCU 校验更严格,故而跨架构 OTA 升级需要谨慎评估,非必要不考虑跨架构升级。
  • 如遇特殊情况客户需要从 v2.x.x 向 v3.x.x 升级,需要做完整的测试,包括配网、控制、OTA、产测等,过程中可以参考相应的说明文档。

CB 系列模组

  • CB 系列模组主要包括 CBU、CB3S、WT3、TCS905-3S、TCS905-U 等。

  • 固件 Key:83r5jq9qqeaxt

版本说明

版本号 发布日期 Building 发布状态 版本说明
v3.1.42 2025 年 08 月 15 日 OS 已上架
  • 关闭局域网 OTA
  • 支持欧盟 RED 认证
  • 稳定性提升
  • 取消快连模式配网
v3.1.28 2025 年 01 月 09 日 OS 已上架
  • 支持欧盟 RED 认证
  • 稳定性提升
  • 取消快连模式配网
v3.1.17 2024 年 07 月 09 日 OS 已下架
  • 不支持欧盟 RED 认证
  • 取消快连模式配网
v2.1.35 2025 年 08 月 22 日 CI 已上架
  • 稳定性提升
  • 不支持欧盟 RED 认证
  • 支持快连模式配网
v2.1.33 2025 年 04 月 14 日 CI 已下架
  • Wi-Fi 离线问题修复

注意事项

  • v2.x.x 固件是基于 CI 框架开发,MCU 校验更宽松。
  • v3.x.x 固件是基于 OS 框架开发,MCU 校验更严格,故而跨架构 OTA 升级需要谨慎评估,非必要不考虑跨架构升级。
  • 如遇特殊情况客户需要从 v2.x.x 向 v3.x.x 升级,需要做完整的测试,包括配网、控制、OTA、产测等,过程中可以参考相应说明文档。

双频系列模组

  • 双频系列模组主要包括 WBR3D、WBR2D、WBR1D、WBR1D-PEX 等。
  • 通用固件:keyukmh93ew3retr

版本说明

版本号 发布日期 Building 发布状态 版本说明
v3.0.30 2025 年 01 月 09 日 OS 已上架
  • 支持欧盟 RED 认证
  • 稳定性提升
  • 取消快连模式配网
v1.1.11 2022 年 10 月 11 日 CI 已下架
  • Wi-Fi 离线问题修复
  • 不支持欧盟 RED 认证
  • 支持快连模式配网

注意事项

  • v2.x.x 固件是基于 CI 框架开发,MCU 校验较宽松。
  • v3.x.x 固件是基于 OS 框架开发,MCU 校验更严格,故而跨架构 OTA 升级需要谨慎评估,非必要不考虑跨架构升级。
  • 如遇特殊情况客户需要从 v2.x.x 向 v3.x.x 升级,需要做完整的测试,包括配网、控制、OTA、产测等,过程中可以参考相应说明文档。

技术架构说明

新 Building 架构 OS 与原 Building 架构 CI 的 MCU 通用固件的主要区别是增加了 IO 合法性校验,能够保障初始化成功率。例如:

  • 查询工作模式(0x02)中模组自处理:Wi-Fi 状态指示 GPIO 序号、Wi-Fi 重置按键 GPIO 序号、Bluetooth LE 状态指示 GPIO 序号。
  • 查询产品信息(0x01)中的红外 IR 的 IO 序号。
  • 主动发送指令需要在模组初始化完成(0x00 -> 0x01 -> 0x02 -> [0x03])之后发送。
  • 快连模式功能关闭。

MCU 串口通讯注意事项

  • 禁止重置之后主动发送心跳指令,否则模组会进入产测导致无法重置。
  • 禁止心跳包一直发送首包心跳回复 0x00,否则触发其它指令主动发送会导致异常。
  • 波特率探测时,收到心跳探测帧后须要在 500 ms 内回复,否则无法锁定波特率。