WS53 1.10.106 发布说明#

WS53 1.10.106 是面向 WS53 Wi-Fi、BLE 和 SLE Combo 芯片的完整软件开发包。SDK 基于 FBB(Family Big Box)统一开发框架,提供操作系统、外设驱动、无线协议、网络服务、存储、低功耗、安全、固件打包和应用示例,支持从工程创建到构建、烧录和调试的完整开发流程。

版本概览#

本版本交付以下完整能力:

  1. Combo 无线连接:支持 Wi-Fi、BLE、SLE 及 SLE CHBA,并提供配网、数据通信、吞吐量和链路管理示例。

  2. 统一系统平台:集成 Huawei LiteOS、OSAL、WS53 外设驱动、Kconfig、CMake 和 ROM/RAM 组件组织方式。

  3. 网络与设备服务:集成 lwIP、MQTT、HTTP、CoAP、TLS/DTLS、cJSON、AT 和 Syschannel 等网络及设备服务。

  4. 存储与产品化支持:提供 NV、Flash 分区、littlefs、FOTA、AB 面升级、启动镜像和固件包生成能力。

  5. 低功耗与安全:提供浅睡、深睡、超深睡、密码算法、密钥管理、随机数、安全启动和 Flash 在线解密相关组件。

  6. 完整开发工具链:提供 FBB CLI、build.py、配置预设、烧录工具、GDB 调试配置、树外应用工程模板和配套开发文档。

版本信息#

项目

内容

SDK 版本

1.10.106

适用芯片

WS53

默认应用目标

ws53_liteos_app

操作系统

Huawei LiteOS v208.5.0

CPU 架构

RISC-V 32-bit

构建框架

FBB(Family Big Box)

SDK 包含 src/ 下的源码、公开接口、芯片适配、配套二进制、构建和打包工具,以及 docs/ 下的开发资料。

目标组成#

Target

用途

ws53_liteos_app

默认 LiteOS 应用目标,面向常规产品应用开发

ws53_liteos_xts

LiteOS XTS 测试目标

ws53-flashboot

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 ℃

完整管脚、电气和硬件设计信息见硬件资料和WS53 芯片简介。

SDK 功能#

操作系统、抽象层与驱动#

  • LiteOS 与 OSAL:提供任务、内存、中断、消息队列、互斥锁、信号量、事件和软件定时器等应用开发接口。新应用和普通组件通过 OSAL 使用系统资源。

  • 外设驱动:提供 GPIO、PinCtrl、UART、I2C、SPI、I2S、ADC、PWM、DMA、硬件定时器、RTC、Watchdog 和 SFC Flash 等驱动及 WS53 适配。

  • 组件组织:通过 Kconfig 和 CMake 选择应用、驱动及中间件,并通过 ROM/RAM 分离机制集成芯片固定代码与应用侧组件。

详细说明见整体架构、SDK 开发指南、外设案例和API 参考。

网络协议与设备服务#

组件或接口

提供内容

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 的打包工具。

对应资料见NV、文件系统、FOTA、Flash 分区和Boot。

低功耗#

SDK 提供浅睡、深睡和超深睡管理,以及睡眠投票、唤醒源配置和外设休眠恢复机制。

模式

适用方式

浅睡

结合业务空闲和无线子系统节能策略降低功耗

深睡

在系统空闲、睡眠投票及无线业务条件满足时进入,并处理外设状态保存与恢复

超深睡

不保留运行内存和无线连接,唤醒后重新启动;唤醒源需要提前配置

系统能否进入睡眠取决于应用任务、定时器、外设和无线连接状态。使用方法见低功耗开发指南。

安全与诊断#

  • 密码与密钥服务:提供 AES、SM4、Hash/HMAC、PKE、TRNG 和密钥管理模块。

  • 启动与存储安全:提供安全启动、Flash 在线解密和 eFuse 相关适配与开发资料。

  • 调试诊断:提供 AT 命令、日志、异常诊断、JLink、HiSparkLinkPro 和 GDB 调试配置。

参考安全开发指南、AT 命令和故障排查。

自带示例#

示例源码位于 src/application/samples/,覆盖从基础外设到 Combo 无线应用的常用场景。

分类

示例目录

主要用途

Hello World

peripheral/helloworld

验证应用入口、构建和串口输出

Wi-Fi 接入

wifi/sta_sample、wifi/softap_sample

STA 连接和 SoftAP 热点

BLE 配网

bt/ble/ble_wifi_cfg_server、wifi/ble_wifi_cfg_sample

BLE 接收配网数据并完成 Wi-Fi 连接

网络通信

wifi/tcp_sample、wifi/mqtt_sample、wifi/syschannel_dev

TCP、MQTT 和设备侧透传

BLE 基础通信

bt/ble/ble_hello、bt/ble/ble_speed_server

GATT 服务、属性读写、通知和吞吐量测试

BLE 数据与应用

bt/ble/ble_uart_bridge、bt/ble/ble_sensor_report、bt/ble/ble_gateway、bt/ble/ble_hid_btn

串口桥接、传感器上报、网关传感器节点和 HID 按键

SLE 基础通信

bt/sle/sle_hello、bt/sle/sle_speed_server、bt/sle/sle_speed_client

发现、连接、属性读写、通知和吞吐量测试,支持通过 sle_hello 手机互联案例 进行手机互联

SLE 数据通信

bt/sle/sle_uart、bt/sle/sle_device_config、bt/sle/sle_fragmentation、bt/sle/sle_sensor_report

串口桥接、设备配置、分片传输和传感器上报

SLE 链路管理

bt/sle/sle_conn_param_tuning、bt/sle/sle_phy_mcs_switch、bt/sle/sle_rssi_ranging

连接参数调优、PHY/MCS 切换和 RSSI 测距

SLE CHBA

bt/sle_chba

CHBA 应用参考

GPIO 与引脚

peripheral/blinky、peripheral/pinctrl

LED 闪烁和引脚复用

总线与数据搬运

peripheral/uart、peripheral/i2c、peripheral/spi、peripheral/i2s、peripheral/dma

串行总线、音频接口和 DMA

采样与输出

peripheral/adc、peripheral/pwm

模拟采样和 PWM 输出

定时、存储与系统控制

peripheral/timer、peripheral/rtc、peripheral/systick、peripheral/tcxo、peripheral/watchdog、peripheral/sfc、peripheral/lpc

定时、计时、看门狗、Flash 和低功耗调用

更多接线、配置和操作步骤见参考案例。

组件与开发环境#

主要组件版本#

组件

版本

用途

Huawei LiteOS

v208.5.0

实时操作系统

lwIP

2.1.3

TCP/IP 网络栈

Mbed TLS

3.6.0

TLS/DTLS 与密码算法

wpa_supplicant

2.10

Wi-Fi 认证相关组件

libcoap

4.3.4

CoAP 协议

cJSON

1.7.15

JSON 解析与生成

littlefs

v2.8.0

Flash 文件系统

7-Zip LZMA SDK

22.00

压缩相关处理

完整组件与许可证信息见开源软件及许可证说明。

开发环境#

项目

要求或入口

主机环境

提供 Linux、Windows 和 WSL 配置指南

Python / CMake

手动配置要求 Python 3.8.0 及以上、CMake 3.14.1 及以上;也可使用 FBB CLI 准备配套环境

交叉工具链

RISC-V 32-bit musl,HCC 7.3.0-20240618;SDK 工具目录为 cc_riscv32_musl_b010

构建系统

build.py、CMake、Make / Ninja 和 Kconfig,支持 FBB CLI 与树外应用工程

FBB CLI

最低版本 1.1.0

烧录工具

hs-flash 26.07.1,默认烧录波特率 921600

IDE 与调试

提供 VS Code 开发流程,支持 JLink / HiSparkLinkPro、GDB 调试;日志串口波特率 115200

开源组件的版本和许可证见开源软件及许可证说明。

构建、烧录与调试#

构建、烧录、调试和工程创建请参阅:

问题反馈请通过仓库 Issues提交。