WS53指导资料

- hardware
  - SoC Wi-Fi、BLE和SLE Combo芯片 硬件用户指南
    - 前言
    - 封装与管脚
    - 电性能参数
    - 原理图设计建议
    - PCB设计建议
    - 热设计建议
    - 焊接工艺
    - 潮敏参数
    - 接口时序
    - 注意事项
    - 缩略语
  - 单板硬件关键器件选型指导
    - 前言
    - 关键器件选型约束
  - 射频测试 用户指南
    - 前言
    - 测试指令
    - 注意事项
- 软件资料
  - AT命令 使用指南
    - 前言
    - 指令说明
    - Wi-Fi模块AT指令
    - BLE&SLE模块AT指令
    - PLAT模块AT指令
  - BLE BQB认证测试 指导书
    - 前言
    - 蓝牙BQB认证简介
    - BQB协议认证
    - BQB 射频认证
    - WS53特性支持情况
    - 常见问题&测试命令汇总(FAQ)
  - BOOT API开发参考
    - 前言
    - 接口介绍
  - Boot移植应用 开发指南
    - 前言
    - Boot简介
    - RomBoot功能说明
    - LoaderBoot功能说明
    - FlashBoot说明
  - CJSON 开发指南
    - 前言
    - API接口说明
    - 开发指南
  - CoAP 开发指南
    - 前言
    - API接口说明
    - 开发指南
  - EFUSE 使用指南
    - 前言
    - 概述
    - 软件编程接口使用指导
    - Burntool烧写efuse_cfg.bin说明
  - FOTA 开发指南
    - 前言
    - 概述
    - 升级包制作
    - 升级包传输
    - 升级包保存
    - 升级包本地升级
    - AB面升级
    - FAQ
  - HTTP 开发指南
    - 前言
    - 开发指南
  - MQTT 开发指南
    - 前言
    - API接口描述
    - 开发指南
    - 注意事项
  - NV存储 用户指南
    - 前言
    - NV简介
    - NV编译预置
    - NV API指南
    - NV项汇总
  - SAMPLE用例 用户指南
    - 前言
    - SAMPLE简介
    - 外设SAMPLE用例
  - SDK 开发指南
    - 前言
    - 概述
    - 系统接口
  - SDK开发环境搭建 用户指南
    - 前言
    - 开发环境搭建
    - 编译
    - 新建APP
  - Syschannel 使用指南
    - 前言
    - Syschannel 简介
    - Syschannel 使用指南
    - Syschannel 编译指导
    - Syschannel 适配常见问题
  - TLS&DTLS 开发指南
    - 前言
    - API接口说明
    - 开发指南
    - 硬件适配
    - 注意事项
  - WFA认证测试指导书
    - 前言
    - WLAN WFA协议认证介绍
    - WS53 WFA认证
    - 缩略语
  - lwIP 开发指南
    - 前言
    - 概述
    - 功能特性
    - 开发指引
    - 网络安全
    - 常见问题
    - 术语
  - 产测FAQ
    - 前言
    - FAQ
    - 注意事项
    - 版本问题记录
  - 产线工装 用户指南
    - 前言
    - 测试软件准备
    - 单板测试方案
    - TX/RX测试参考
    - WLAN Facility与固件版本
    - 产线生产ESD防护要求
  - 低功耗 开发指南
    - 前言
    - 概述
    - 超深睡模式
    - 深睡模式
    - 浅睡模式
    - 常见问题
  - 单板冒烟 测试指南
    - 前言
    - 概述
    - 单板冒烟测试
  - 安全模块 使用指南
    - 前言
    - 概述
    - 错误码
    - 网络安全注意事项
  - 文件系统 使用指南
    - 前言
    - LFS简介
    - LFS编译预置
    - LFS接口API
  - 星闪认证测试 指导书
    - 前言
    - 星闪认证简介
    - 星闪协议认证
    - 星闪射频认证
    - 星闪特性支持
    - 常见问题&测试命令汇总（FAQ）
  - 特性开发说明书
    - 前言
    - 混杂模式特性说明
    - 动态国家码特性说明
    - BLE配网特性说明
    - 安全启动特性说明
    - FLASH在线解密特性说明
  - 第三方软件 移植指南
    - 前言
    - 移植指引
    - 常见问题
  - 设备驱动 开发指南
    - 前言
    - Pinctrl
    - GPIO
    - UART
    - SPI
    - QSPI
    - I2C
    - ADC
    - DMA
    - PWM
    - WDT
    - Timer
    - Systick
    - TCXO
    - SFC
    - eFuse
    - REBOOT
    - I2S
  - 软件 开发指南
    - 前言
    - 概述
    - Wi-Fi 软件开发指南
    - BLE&SLE 软件开发指南
    - 注意事项
  - 运维手册
    - 前言
    - 系统/平台模块
    - Wi-Fi模块
  - 鸿蒙XTS认证 指导书
    - 前言
    - 概述
    - 准备工作
    - 编译openharmony静态库
    - XTS版本编译和执行

### 该页内容

- 前言
- SAMPLE简介
- 外设SAMPLE用例
  - ADC
    - 编译
    - 运行
  - BLINKY
    - 编译
    - 运行
  - DMA
    - 编译
    - 运行
  - I2C
    - 编译
    - 运行
  - I2S
    - 编译
    - 运行
  - PINCTRL
    - 编译
    - 运行
  - PWM
    - 编译
    - 运行
  - RTC
    - 编译
    - 运行
  - SFC
    - 编译
    - 运行
  - SPI
    - 编译
    - 运行
  - QSPI
    - 编译
    - 运行
  - SYSTICK
    - 编译
    - 运行
  - TCXO
    - 编译
    - 运行
  - TIMER
    - 编译
    - 运行
  - WATCHDOG
    - 编译
    - 运行
  - UART
    - 编译
    - 运行
  - SLE CHBA
    - 编译
    - 运行
  - SLE CHBA&SYSCHANNEL
    - 编译
    - 运行

# 前言

概述

本文档主要针对WS53V100中SAMPLE测试用例的使用进行介绍。用于指导工程人员能够快速使用SAMPLE测试用例进行外设驱动验证。

产品版本

与本文档相对应的产品版本如下。

产品名称 | 产品版本
--- | ---
WS53 | V100

读者对象

本文档主要适用于以下工程师：

- 技术支持工程师

- 软件工程师

符号约定

在本文中可能出现下列标志，它们所代表的含义如下。

符号 | 说明
--- | ---
| 表示如不避免则将会导致死亡或严重伤害的具有高等级风险的危害。
| 表示如不避免则可能导致死亡或严重伤害的具有中等级风险的危害。
| 表示如不避免则可能导致轻微或中度伤害的具有低等级风险的危害。
| 用于传递设备或环境安全警示信息。如不避免则可能会导致设备损坏、数据丢失、设备性能降低或其它不可预知的结果。 “须知”不涉及人身伤害。
| 对正文中重点信息的补充说明。 “说明”不是安全警示信息，不涉及人身、设备及环境伤害信息。

修改记录

文档版本 | 发布日期 | 修改说明
--- | --- | ---
05 | 2025-05-28 | 新增“SLE CHBA”章节内容。 新增“SLE CHBA&SYSCHANNEL”章节内容。
04 | 2025-01-14 | 更新“编译”章节内容。
03 | 2024-11-25 | 更新“编译”章节内容。 新增“UART”章节内容。
02 | 2024-09-13 | 更新“SPI”章节内容。 更新“QSPI”章节内容。
01 | 2024-08-08 | 第一次正式版本发布。

# SAMPLE简介

本模块用于提供其他软件模块验证用的测试SAMPLE。

# 外设SAMPLE用例

- ADC

- BLINKY

- DMA

- I2C

- I2S

- PINCTRL

- PWM

- RTC

- SFC

- SPI

- QSPI

- SYSTICK

- TCXO

- TIMER

- WATCHDOG

- UART

- SLE CHBA

- SLE CHBA&SYSCHANNEL

## ADC

- 编译

- 运行

### 编译

1. 在命令行下执行命令“python build.py ws53_liteos_app menuconfig”，打开menuconfig配置界面。

2. 在menuconfig界面中选择ADC Sample，如图1所示；如果需要修改测试通道，则继续按图2 选择ADC channel选择，选择完成后按“Q”或者“q”选择“y”保存退出。

3. 使用IDE编译版本，编译出的版本包在“output\ws53\fwpkg\pack_all_core\ws53_liteos_app”路径下，如图3所示。

4. 将编译出的版本烧录到单板。

图 1 选择ADC Sample

图 2 选择ADC channel

图 3 编译后的fwpkg

### 运行

ADC单板执行结果如下图1所示。

图 1 ADC运行结果

## BLINKY

- 编译

- 运行

### 编译

1. 在命令行下执行命令“python build.py ws53_liteos_app menuconfig”，打开menuconfig配置界面。

2. 在menuconfig界面中选择BLINKY Sample，如图1所示；如果需要修改测试管脚，则继续按图2 选择BLINKY pin选择，选择完成后按“Q”或者“q”选择“y”保存退出。

3. 使用IDE编译版本，编译出的版本包在“output\ws53\fwpkg\pack_all_core\ws53_liteos_app”路径下，如图3所示。

4. 将编译出的版本烧录到单板。

图 1 选择BLINKY Sample

图 2 选择BLINKY pin

图 3 编译后的fwpkg

### 运行

BLINKY单板执行结果如下图1所示。

图 1 BLINKY运行结果

## DMA

- 编译

- 运行

### 编译

1. 在命令行下执行命令“python build.py ws53_liteos_app menuconfig”，打开menuconfig配置界面。

2. 在menuconfig界面中选择DMA Sample，如图1所示；选择完成后按“Q”或者“q”选择“y”保存退出。

3. 使用IDE编译版本，编译出的版本包在“output\ws53\fwpkg\pack_all_core\ws53_liteos_app”路径下，如图2所示。

4. 将编译出的版本烧录到单板。

图 1 选择DMA Sample

图 2 编译后的fwpkg

### 运行

DMA单板执行结果如下图1所示。

图 1 DMA运行结果

## I2C

- 编译

- 运行

### 编译

1. 在命令行下执行命令“python build.py ws53_liteos_app menuconfig”，打开menuconfig配置界面。

2. 在menuconfig界面中选择I2C Sample，如图1所示；如果需要修改配置参数，则继续按图2 I2C config配置选择，选择完成后按“Q”或者“q”选择“y”保存退出。

3. 使用IDE编译版本，编译出的版本包在“output\ws53\fwpkg\pack_all_core\ws53_liteos_app”路径下，如图3所示。

4. 将编译出的版本烧录到单板。

图 1 选择I2C Sample

图 2 I2C config配置

图 3 编译后的fwpkg

### 运行

I2C单板执行结果：（1）打印结果如图1所示；（2）输出波形如图2所示

图 1 I2C打印结果

图 2 I2C输出波形

## I2S

- 编译

- 运行

### 编译

1. 在命令行下执行命令“python build.py ws53_liteos_app menuconfig”，打开menuconfig配置界面。

2. 在menuconfig界面中选择I2S Sample，如图1所示；如果需要修改配置参数，则继续按图2 I2S config配置选择，选择完成后按“Q”或者“q”选择“y”保存退出。

3. 使用IDE编译版本，编译出的版本包在“output\ws53\fwpkg\pack_all_core\ws53_liteos_app”路径下，如图3所示。

4. 将编译出的版本烧录到单板。

图 1 选择I2S Sample

图 2 I2S config配置

图 3 编译后的fwpkg

### 运行

I2S单板执行结果如下图1所示。

图 1 I2S运行结果

## PINCTRL

- 编译

- 运行

### 编译

1. 在命令行下执行命令“python build.py ws53_liteos_app menuconfig”，打开menuconfig配置界面。

2. 在menuconfig界面中选择PINCTRL Sample，如图1所示；如果需要修改测试管脚，则继续按图2 PINCTRL PIN配置选择，选择完成后按“Q”或者“q”选择“y”保存退出。

3. 使用IDE编译版本，编译出的版本包在“output\ws53\fwpkg\pack_all_core\ws53_liteos_app”路径下，如图3所示。

4. 将编译出的版本烧录到单板。

图 1 选择PINCTRL Sample

图 2 PINCTRL PIN

图 3 编译后的fwpkg

### 运行

PINCTRL单板执行结果如下图1所示。

图 1 PINCTRL运行结果

## PWM

- 编译

- 运行

### 编译

1. 在命令行下执行命令“python build.py ws53_liteos_app menuconfig”，打开menuconfig配置界面。

2. 在menuconfig界面中选择PWM Sample，如图1所示；如果需要修改配置选项，则继续按图2 PWM Config配置选择，选择完成后按“Q”或者“q”选择“y”保存退出。

3. 使用IDE编译版本，编译出的版本包在“output\ws53\fwpkg\pack_all_core\ws53_liteos_app”路径下，如图3所示。

4. 将编译出的版本烧录到单板。

图 1 选择PWM Sample

图 2 PWM Config配置

图 3 编译后的fwpkg

### 运行

PWM单板执行结果如图1所示。

图 1 PWM运行结果

## RTC

- 编译

- 运行

### 编译

1. 在命令行下执行命令“python build.py ws53_liteos_app menuconfig”，打开menuconfig配置界面。

2. 在menuconfig界面中选择RTC Sample，如图1所示，如果需要修改配置选项，则继续按图2选择，选择完成后按“Q”或者“q”选择“y”保存退出。

3. 使用IDE编译版本，编译出的版本包在“output\ws53\fwpkg\pack_all_core\ws53_liteos_app”路径下，如图3所示。

4. 将编译出的版本烧录到单板。

图 1 选择RTC Sample

图 2 RTC config配置

图 3 编译后的fwpkg

### 运行

RTC单板执行结果如下图1所示。

图 1 RTC运行结果

## SFC

- 编译

- 运行

### 编译

1. 在命令行下执行命令“python build.py ws53_liteos_app menuconfig”，打开menuconfig配置界面。

2. 在menuconfig界面中选择SFC Sample，如图1所示；如果需要修改配置选项，则继续按图2 SFC Config配置选择，建议修改地址为预留区，若地址在镜像区或其他区域可能导致程序挂死，需要重新烧录，预留区地址可参考《WS63V100 FOTA 开发指南》<4.2注意事项>；选择完成后按“Q”或者“q”选择“y”保存退出。

3. 使用IDE编译版本，编译出的版本包在“output\ws53\fwpkg\pack_all_core\ws53_liteos_app”路径下，如图3所示。

4. 将编译出的版本烧录到单板。

图 1 选择SFC Sample

图 2 SFC Config配置

图 3 编译后的fwpkg

### 运行

SFC单板执行结果如下图1所示。

图 1 SFC运行结果

## SPI

SPI组件默认未参与编译，使用该外设驱动需要先配置开启：

在命令行下执行命令“python build.py ws53_liteos_app menuconfig”，打开menuconfig配置界面，配置如下：

- 编译

- 运行

### 编译

1. 在命令行下执行命令“python build.py ws53_liteos_app menuconfig”，打开menuconfig配置界面。

2. 在menuconfig界面中选择SPI Sample，如图1所示，进入SPI Sample Configuration后编辑配置选项如图2，配置bus_id为0，其它配置根据pin脚和配置选择，选择完成后按“Q”或者“q”选择“y”保存退出。

3. 使用IDE编译版本，编译出的版本包在“output\ws53\fwpkg\pack_all_core\ws53_liteos_app”路径下，如图3所示。

4. 将编译出的版本烧录到单板。

图 1 选择SPI

图 2 SPI Config

图 3 编译后的fwpkg

### 运行

如下图为SPI做master tx数据波形图

图 1 SPI 发送数据

## QSPI

QSPI与SPI共用一套组件，该组件默认不参与编译，使用该外设驱动需要先配置开启：

在命令行下执行命令“python build.py ws53_liteos_app menuconfig”，打开menuconfig配置界面，配置如下：

- 编译

- 运行

### 编译

1. 在命令行下执行命令“python build.py ws53_liteos_app menuconfig”，打开menuconfig配置界面。

2. 在menuconfig界面中选择SPI Sample，如图1所示，进入SPI Sample Configuration后编辑配置选项如图2，配置bus_id为1和SPI master support QSPI，其它配置根据pin脚和配置选择，选择完成后按“Q”或者“q”选择“y”保存退出。

3. 使用IDE编译版本，编译出的版本包在“output\ws53\fwpkg\pack_all_core\ws53_liteos_app”路径下，如图3所示。

4. 将编译出的版本烧录到单板。

图 1 选择SPI Sample

图 2 编辑QSPI Config

图 3 编译后的fwpkg

### 运行

如图为QSPI写psram器件波形，配置为单线模式发送8位cmd=0x38命令，四线模式模式发送24位addr=0x123，四线模式模式发送数据0x0 0x1 0x2 0x3

图 1 qspi 4线模式写psram

## SYSTICK

- 编译

- 运行

### 编译

1. 在命令行下执行命令“python build.py ws53_liteos_app menuconfig”，打开menuconfig配置界面。

2. 在menuconfig界面中选择SYSTICK Sample，如图1所示，选择完成后按“Q”或者“q”选择“y”保存退出。

3. 使用IDE编译版本，编译出的版本包在“output\ws53\fwpkg\pack_all_core\ws53_liteos_app”路径下，如图2所示。

4. 将编译出的版本烧录到单板。

图 1 选择SYSTICK Sample

图 2 编译后的fwpkg

### 运行

SYSTICK单板执行结果如下图1所示。

图 1 SYSTICK运行结果

## TCXO

- 编译

- 运行

### 编译

1. 在命令行下执行命令“python build.py ws53_liteos_app menuconfig”，打开menuconfig配置界面。

2. 在menuconfig界面中选择TCXO Sample，如图1所示，选择完成后按“Q”或者“q”选择“y”保存退出。

3. 使用IDE编译版本，编译出的版本包在“output\ws53\fwpkg\pack_all_core\ws53_liteos_app”路径下，如图2所示。

4. 将编译出的版本烧录到单板。

图 1 选择TCXO Sample

图 2 编译后的fwpkg

### 运行

TCXO单板执行结果如下图1所示。

图 1 TCXO运行结果

## TIMER

- 编译

- 运行

### 编译

1. 在命令行下执行命令“python build.py ws53_liteos_app menuconfig”，打开menuconfig配置界面。

2. 在menuconfig界面中选择TIMER Sample，如图1所示，选择完成后按“Q”或者“q”选择“y”保存退出。

3. 使用IDE编译版本，编译出的版本包在“output\ws53\fwpkg\pack_all_core\ws53_liteos_app”路径下，如下图2所示。

4. 将编译出的版本烧录到单板。

图 1 选择TIMER Sample

图 2 编译后的fwpkg

### 运行

TIMER单板执行结果如下图1所示。

图 1 TIMER运行结果

## WATCHDOG

- 编译

- 运行

### 编译

1. 在命令行下执行命令“python build.py ws53_liteos_app menuconfig”，打开menuconfig配置界面。

2. 在menuconfig界面中选择WATCHDOG Sample，如图1所示；如果选择超时，则继续按下图2所示选择；如果选择喂狗，则继续按下图3所示选择，选择完成后按“Q”或者“q”选择“y”保存退出。

3. 使用IDE编译版本，编译出的版本包在“output\ws53\fwpkg\pack_all_core\ws53_liteos_app”路径下，如图4所示。

4. 将编译出的版本烧录到单板。

图 1 选择WATCHDOG Sample

图 2 WATCHDOG超时

图 3 WATCHDOG 喂狗

图 4 编译后的fwpkg

### 运行

WATCHDOG单板超时执行结果如下图1所示，喂狗后执行结果如图2所示。

图 1 WATCHDOG超时运行结果

图 2 WATCHDOG喂狗运行结果

## UART

- 编译

- 运行

### 编译

1. 在命令行下执行命令“python build.py ws53_liteos_app menuconfig”，打开menuconfig配置界面。

2. 在menuconfig界面中选择UART Sample，如图1所示；进入UART Sample Configuration后编辑配置选项如图2所示选择，选择完成后按“Q”或者“q”选择“y”保存退出。

3. 使用IDE编译版本，编译出的版本包在“output\ws53\fwpkg\pack_all_core\ws53_liteos_app”路径下，如图3所示。

4. 将编译出的版本烧录到单板。

图 1 选择UART Sample

图 2 选择中断模式

图 3 编译后的fwpkg

### 运行

UART单板执行结果如图1所示。

图 1 UART运行结果

## SLE CHBA

本示例描述了WS53对通W53，星闪接入ip打流的操作方法。

- 编译

- 运行

### 编译

1. 在命令行下执行命令“python build.py ws53_liteos_app menuconfig”，打开menuconfig配置界面。

2. 在menuconfig界面中选择CHBA Sample，如图1所示

3. 使用IDE编译版本，编译出的版本包在“output\ws53\fwpkg\pack_all_core\ws53_liteos_app”路径下，如图2所示。

4. 将编译出的版本烧录到单板。

图 1 选择chba sample

图 2 编译后的fwpkg

### 运行

1. 配置角色，WS53 AP侧下发 AT+NVWRITE=0x2160,0,2,0000，WS53 STA侧下发 AT+NVWRITE=0x2160,0,2,0001，如图1和图2所示，烧写后只需要配置一次，复位后生效。

2. 复位两侧单板，星闪链路自动连接，如图3所示。

3. WS53 AP侧关闭扫描，命令 AT+SLESTOPSCAN，如图4所示，常开扫描是为了接入更多chba设备，但扫描业务会影响打流的速率，建议打流时将扫描关闭。

4. 连接参数更新，任意一侧发起更新都可，命令示例（示例为更新到20slot，修改第二和第三个参数，配置范围16~8000） AT+SLECONNPARUPD=0,20,20,0,500，如图5所示

5. 配置IP，两侧要配置在同一网段下，命令示例 AT+IFCFG=sle,192.168.5.2,netmask,255.255.255.0,gateway,192.168.5.1，如图6和图7所示。

6. iperf打流，WS53 AP侧下发 AT+IPERF=-s,-i,1,-p,5001,-t,30，WS53 STA侧下发AT+IPERF=-c,192.168.5.1,-i,1,-t,30,-p,5001，如图8和图9所示.

图 1 AP侧角色配置

图 2 STA侧角色配置

图 3 星闪建链

图 4 关闭扫描

图 5 连接参数更新

图 6 AP侧 ip配置

图 7 STA侧 ip配置

图 8 AP侧 iperf打流

图 9 STA侧 iperf打流

## SLE CHBA&SYSCHANNEL

本示例描述了主控+WS53对通WS53，星闪接入ip打流的操作方法。

- 编译

- 运行

### 编译

1. 在命令行下执行命令“python build.py ws53_liteos_app menuconfig”，打开menuconfig配置界面。

2. 在menuconfig界面中选择CHBA Sample，如图1所示

3. 使用IDE编译版本，编译出的版本包在“output\ws53\fwpkg\pack_all_core\ws53_liteos_app”路径下，如图2所示。

4. 将编译出的版本烧录到单板。

图 1 选择chba sample

图 2 编译后的fwpkg

### 运行

1. WS53侧配置角色，AP侧下 AT+NVWRITE=0x2160,0,2,0000，STA侧下发 AT+NVWRITE=0x2160,0,2,0001，如图1和图2所示，烧写后只需要配置一次，复位后生效。

2. 复位两侧WS53单板，星闪链路自动连接，如图3所示。

3. WS53 AP侧关闭扫描，命令AT+SLESTOPSCAN，如图4所示，常开扫描是为了接入更多chba设备，但扫描业务会影响打流的速率，建议打流时将扫描关闭。

4. 星闪连接参数更新，任意一侧发起更新都可，命令示例（示例为更新到20slot，修改第二和第三个参数，配置范围16~8000） AT+SLECONNPARUPD=0,20,20,0,500，如图5所示

5. WS53两侧配置IP，要配置在同一网段下。

   WS53 STA侧：

   AT+IFCFG=sle,192.168.5.2,netmask,255.255.255.0,gateway,192.168.5.1

   WS53 AP侧：

   AT+IFCFG=sle,192.168.5.1,netmask,255.255.255.0,gateway,192.168.5.1

6. WS53 STA侧启动syschannel，并绑定SLE。

   AT+SYSCHANNEL

   AT+SYSCHANIF=sle0

7. 主控侧加载syschannel_host.ko 并绑定WS53侧网卡，mac地址与IP地址要与WS53侧一致。

   insmod syschannel_host.ko

   ifconfig wlan0 hw ether 22:22:22:22:22:22

   ifconfig wlan0 192.168.5.2 up

8. 打流测试。

   WS53 AP侧：

   AT+IPERF=-s,-i,1,-p,5001,-t,30

   主控侧：

   iperf -c 192.168.5.1 -i1 -p 5001

图 1 ap侧角色配置

图 2 sta侧角色配置

图 3 星闪建链

图 4 关闭扫描

图 5 连接参数更新