前言

概述

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

产品版本

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

产品名称

产品版本

WS53

V100

读者对象

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

  • 技术支持工程师

  • 软件工程师

符号约定

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

符号

说明

表示如不避免则将会导致死亡或严重伤害的具有高等级风险的危害。

表示如不避免则可能导致死亡或严重伤害的具有中等级风险的危害。

表示如不避免则可能导致轻微或中度伤害的具有低等级风险的危害。

用于传递设备或环境安全警示信息。如不避免则可能会导致设备损坏、数据丢失、设备性能降低或其它不可预知的结果。

“须知”不涉及人身伤害。

对正文中重点信息的补充说明。

“说明”不是安全警示信息，不涉及人身、设备及环境伤害信息。

修改记录

文档版本

发布日期

修改说明

05

2025-05-28

04

2025-01-14

更新“编译”章节内容。

03

2024-11-25
  • 更新“编译”章节内容。
  • 新增“UART”章节内容。

02

2024-09-13
  • 更新“SPI”章节内容。
  • 更新“QSPI”章节内容。

01

2024-08-08

第一次正式版本发布。

SAMPLE简介

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

外设SAMPLE用例

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 连接参数更新