WS53 1.10.106 发布说明#
WS53 1.10.106 是面向 WS53 Wi-Fi、BLE 和 SLE Combo 芯片的完整软件开发包。SDK 基于 FBB(Family Big Box)统一开发框架,提供操作系统、外设驱动、无线协议、网络服务、存储、低功耗、安全、固件打包和应用示例,支持从工程创建到构建、烧录和调试的完整开发流程。
版本概览#
本版本交付以下完整能力:
Combo 无线连接:支持 Wi-Fi、BLE、SLE 及 SLE CHBA,并提供配网、数据通信、吞吐量和链路管理示例。
统一系统平台:集成 Huawei LiteOS、OSAL、WS53 外设驱动、Kconfig、CMake 和 ROM/RAM 组件组织方式。
网络与设备服务:集成 lwIP、MQTT、HTTP、CoAP、TLS/DTLS、cJSON、AT 和 Syschannel 等网络及设备服务。
存储与产品化支持:提供 NV、Flash 分区、littlefs、FOTA、AB 面升级、启动镜像和固件包生成能力。
低功耗与安全:提供浅睡、深睡、超深睡、密码算法、密钥管理、随机数、安全启动和 Flash 在线解密相关组件。
完整开发工具链:提供 FBB CLI、build.py、配置预设、烧录工具、GDB 调试配置、树外应用工程模板和配套开发文档。
版本信息#
项目 |
内容 |
|---|---|
SDK 版本 |
|
适用芯片 |
|
默认应用目标 |
|
操作系统 |
Huawei LiteOS |
CPU 架构 |
|
构建框架 |
FBB(Family Big Box) |
SDK 包含 src/ 下的源码、公开接口、芯片适配、配套二进制、构建和打包工具,以及 docs/ 下的开发资料。
目标组成#
Target |
用途 |
|---|---|
|
默认 LiteOS 应用目标,面向常规产品应用开发 |
|
LiteOS XTS 测试目标 |
|
WS53 FlashBoot 启动镜像目标,由应用固件打包流程使用 |
芯片与平台能力#
无线能力#
模块 |
平台能力 |
|---|---|
Wi-Fi |
802.11b/g/n/ax,2.4 GHz 1×1;支持 STA、SoftAP 和 STA + SoftAP,SoftAP 最多接入 4 个 STA;支持 WPA/WPA2/WPA3 Personal、WPS 2.0、A-MPDU、A-MSDU、QoS、STBC 和 LDPC |
BLE |
BLE 5.4;支持 1 MHz / 2 MHz 频宽、多路广播和 125 Kbit/s、500 Kbit/s、1 Mbit/s、2 Mbit/s 速率;SDK 提供广播、连接、GATT Server 和配网相关接口 |
SLE |
SLE 1.0;支持 1 MHz / 2 MHz / 4 MHz 频宽,最高 12 Mbps;提供发现、连接、配对、SSAP 服务与属性操作、吞吐量和链路管理接口 |
SLE CHBA |
提供 CHBA 组件、网络适配和应用示例 |
Syschannel |
提供设备侧透传组件和网络通信示例 |
BLE 应用以 Peripheral / GATT Server 为主,SLE Server 和 Client 示例按目标配置分别构建。无线专题资料还包括混杂模式、动态国家码和 CSI,见特性开发说明。
处理器、存储与外设#
类别 |
平台资源 |
|---|---|
处理器 |
双核 32-bit 微处理器,最高工作频率 120 MHz |
存储 |
SRAM 576 KB、ROM 352 KB、Flash 4 MB、eFuse 2 KB |
外设接口 |
1×SPI、1×QSPI、2×I2C、1×I2S、3×UART、1×SDIO 2.0、28×GPIO、7×ADC、8×PWM |
时钟与供电 |
外部 32 MHz 晶体,可选外接 32 kHz 时钟;供电范围 3.0 V~3.6 V,典型值 3.3 V |
封装与温度 |
QFN-52,6 mm × 6 mm;工作温度 -40 ℃~+85 ℃ |
SDK 功能#
操作系统、抽象层与驱动#
LiteOS 与 OSAL:提供任务、内存、中断、消息队列、互斥锁、信号量、事件和软件定时器等应用开发接口。新应用和普通组件通过 OSAL 使用系统资源。
外设驱动:提供 GPIO、PinCtrl、UART、I2C、SPI、I2S、ADC、PWM、DMA、硬件定时器、RTC、Watchdog 和 SFC Flash 等驱动及 WS53 适配。
组件组织:通过 Kconfig 和 CMake 选择应用、驱动及中间件,并通过 ROM/RAM 分离机制集成芯片固定代码与应用侧组件。
网络协议与设备服务#
组件或接口 |
提供内容 |
|---|---|
lwIP |
TCP/IP 协议栈和 Socket 开发基础 |
MQTT |
消息发布、订阅和客户端应用支持 |
HTTP |
HTTP 客户端及相关应用接口 |
CoAP |
面向受限设备的 CoAP 协议集成 |
TLS/DTLS |
Mbed TLS 安全连接、密码算法和相关适配 |
cJSON |
JSON 数据解析和生成 |
AT |
设备控制、配置和调试命令 |
Syschannel |
设备侧透传和网络通信服务 |
开发入口见网络协议指南、TLS/DTLS 指南、cJSON 指南和AT 命令。
存储、启动与固件升级#
NV 存储:配置数据持久化及 NV 镜像生成。
Flash 分区:分区表、镜像布局以及应用、NV 和升级功能所需的访问适配。
littlefs:文件系统源码和 WS53 适配层,可按产品需要加入组件、开启配置并分配 Flash 分区。
FOTA / AB 面升级:提供升级包制作、传输对接、保存和本地升级接口。
启动与固件打包:提供 FlashBoot、启动相关组件以及将启动镜像、应用、NV 和分区参数组织为 .fwpkg 的打包工具。
低功耗#
SDK 提供浅睡、深睡和超深睡管理,以及睡眠投票、唤醒源配置和外设休眠恢复机制。
模式 |
适用方式 |
|---|---|
浅睡 |
结合业务空闲和无线子系统节能策略降低功耗 |
深睡 |
在系统空闲、睡眠投票及无线业务条件满足时进入,并处理外设状态保存与恢复 |
超深睡 |
不保留运行内存和无线连接,唤醒后重新启动;唤醒源需要提前配置 |
系统能否进入睡眠取决于应用任务、定时器、外设和无线连接状态。使用方法见低功耗开发指南。
安全与诊断#
密码与密钥服务:提供 AES、SM4、Hash/HMAC、PKE、TRNG 和密钥管理模块。
启动与存储安全:提供安全启动、Flash 在线解密和 eFuse 相关适配与开发资料。
调试诊断:提供 AT 命令、日志、异常诊断、JLink、HiSparkLinkPro 和 GDB 调试配置。
自带示例#
示例源码位于 src/application/samples/,覆盖从基础外设到 Combo 无线应用的常用场景。
分类 |
示例目录 |
主要用途 |
|---|---|---|
Hello World |
|
验证应用入口、构建和串口输出 |
Wi-Fi 接入 |
|
STA 连接和 SoftAP 热点 |
BLE 配网 |
|
BLE 接收配网数据并完成 Wi-Fi 连接 |
网络通信 |
|
TCP、MQTT 和设备侧透传 |
BLE 基础通信 |
|
GATT 服务、属性读写、通知和吞吐量测试 |
BLE 数据与应用 |
|
串口桥接、传感器上报、网关传感器节点和 HID 按键 |
SLE 基础通信 |
|
发现、连接、属性读写、通知和吞吐量测试,支持通过 |
SLE 数据通信 |
|
串口桥接、设备配置、分片传输和传感器上报 |
SLE 链路管理 |
|
连接参数调优、PHY/MCS 切换和 RSSI 测距 |
SLE CHBA |
|
CHBA 应用参考 |
GPIO 与引脚 |
|
LED 闪烁和引脚复用 |
总线与数据搬运 |
|
串行总线、音频接口和 DMA |
采样与输出 |
|
模拟采样和 PWM 输出 |
定时、存储与系统控制 |
|
定时、计时、看门狗、Flash 和低功耗调用 |
更多接线、配置和操作步骤见参考案例。
组件与开发环境#
主要组件版本#
组件 |
版本 |
用途 |
|---|---|---|
Huawei LiteOS |
|
实时操作系统 |
lwIP |
|
TCP/IP 网络栈 |
Mbed TLS |
|
TLS/DTLS 与密码算法 |
wpa_supplicant |
|
Wi-Fi 认证相关组件 |
libcoap |
|
CoAP 协议 |
cJSON |
|
JSON 解析与生成 |
littlefs |
|
Flash 文件系统 |
7-Zip LZMA SDK |
|
压缩相关处理 |
完整组件与许可证信息见开源软件及许可证说明。
开发环境#
项目 |
要求或入口 |
|---|---|
主机环境 |
|
Python / CMake |
手动配置要求 Python 3.8.0 及以上、CMake 3.14.1 及以上;也可使用 FBB CLI 准备配套环境 |
交叉工具链 |
RISC-V 32-bit musl,HCC |
构建系统 |
|
FBB CLI |
最低版本 |
烧录工具 |
|
IDE 与调试 |
提供 VS Code 开发流程,支持 JLink / HiSparkLinkPro、GDB 调试;日志串口波特率 115200 |
开源组件的版本和许可证见开源软件及许可证说明。
构建、烧录与调试#
构建、烧录、调试和工程创建请参阅:
问题反馈请通过仓库 Issues提交。