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版本编译和执行

### 该页内容

- 前言
- 概述
- 单板冒烟测试
  - WiFi AP模式冒烟测试
    - 概述
    - 测试流程
  - WiFi STA模式冒烟测试
    - 概述
    - 测试流程
  - BLE冒烟测试
    - 概述
    - 测试流程
  - SLE冒烟测试
    - 概述
    - 测试流程

# 前言

概述

本文档详细描述了WS53V100单板冒烟测试的过程，用于帮助用户快速实现产品的基本功能并进行相关的验证。

产品版本

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

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

读者对象

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

- 技术支持工程师

- 软件开发工程师

- 软件测试工程师

符号约定

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

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

修改记录

文档版本 | 发布日期 | 修改说明
--- | --- | ---
02 | 2025-01-14 | 更新“BLE冒烟测试”小节内容。 更新“测试流程”小节内容。
01 | 2024-08-08 | 第一次正式版本发布。 更新“测试流程”小节内容。 更新“测试流程”小节内容。
00B01 | 2024-01-31 | 第一次临时版本发布。

# 概述

冒烟测试

冒烟测试是在软件开发过程中的一种针对软件版本包的基本功能快速验证策略，是对软件基本功能进行确认验证的手段，并非对软件版本包的深入测试。冒烟测试也是针对软件版本包进行详细测试之前的预测试，执行冒烟测试的主要目的是快速验证软件基本功能是否有缺陷；硬件组网、连线请参考《WS53V100 模组 使用指南》。

ping

ping（Packet Internet Groper，包探索器）用于测试网络连接量的程序 。ping用于确定本地主机是否能与另一台主机成功交换（发送与接收）数据包，再根据返回的信息推断TCP/IP参数是否设置正确，以及运行是否正常、网络是否通畅等。

Iperf

Iperf 是一个网络性能测试工具。Iperf可以测试最大TCP和UDP带宽性能，具有多种参数，可以根据需要调整，可以报告带宽、延迟抖动和数据包丢失。

> 说明： ping指令功能正常、Iperf工具流量测试正常即视为单板冒烟测试成功。

# 单板冒烟测试

WS53V100冒烟测试包括四部分：

- WiFi AP模式冒烟测试

- WiFi STA模式冒烟测试

- BLE冒烟测试

- SLE冒烟测试

> 说明：

> - 单板冒烟测试使用AT指令请参见《WS53V100 AT命令 使用指南》。

> - 本文iperf测试使用两块单板，一块作为STA设备使用，另一块做AP设备使用。AP模式单板配置IP为192.168.49.1，STA模式单板自动获取IP为192.168.49.2，用户可以根据实际情况更改；也可以只使用一块单板，先完成STA测试，再完成AP测试。

- WiFi AP模式冒烟测试

- WiFi STA模式冒烟测试

- BLE冒烟测试

- SLE冒烟测试

## WiFi AP模式冒烟测试

- 概述

- 测试流程

### 概述

无线AP（Access Point，无线接入点）用于无线网络的无线交换机，也是无线网络的核心。WS53V100是一块标准无线网卡，通过驱动程序使其提供与AP一样的无线信号转接、路由等功能（即：Soft-AP），其他便携式设备可以通过802.11协议与其互连。

### 测试流程

1. 复位单板(AT+RST)

2. 设置单板的MAC地址。初始化阶段软件会按照 读flash nv > 读efuse>随机生成，这样的优先级生成一个mac地址放在全局变量中，系统启动后，业务启动之前，可以调用AT+MAC修改这个全局变量mac地址，业务启动时，会调用平台接口按照获取mac地址。sta直接返回这个全局变量的mac，softap 时会将这个全局mac地址倒数第二位加1返回。AT+MAC只会改变系统的保存的这个全局变量，不会改写NV和efuse。

3. 开启AP模式(AT+STARTAP="my_ap",13,2,"12345678"),下发命令后，WS53模组会创建WiFi无线网络，ssid名称为"my_ap"，工作信道为13，认证方式为WPA2_PSK，密码为"12345678"。

4. 设置IP地址和网关（AT+IFCFG=ap0,192.168.49.1,netmask,255.255.255.0,gateway,192.168.49.1）

5. 启动DHCP服务器(AT+DHCPS=ap0,1)

6. 查看AP配置信息(AT+IFCFG)

7. 单板AP ping STA测试(AT+PING=<STA ip addr>)。前置条件是WiFi STA已连接到 WS53模组创建的无线网络上。

8. Iperf测试。iperf命令要AP&STA成对输入。

   - udp接收吞吐量测试(AT+IPERF=-s,-u,-i,1),STA执行“udp发送吞吐量测试命令”。

   - udp发送吞吐量测试(AT+IPERF=-c,<STA ip addr>,-u,-b,10M,-t,5,-i,1),STA提前执行"udp接收吞吐量测试命令"。

   - tcp接收吞吐量测试(AT+IPERF=-s,-i,1),STA执行"tcp发送吞吐量测试命令"

   - tcp发送吞吐量测试(AT+IPERF=-c,<STA ip addr>,-t,5,-i,1),STA提前执行"tcp接收吞吐量测试命令"

经上述测试，AP模式单板基本功能正常。

## WiFi STA模式冒烟测试

- 概述

- 测试流程

### 概述

任何一个接入无线AP的设备都可以称为一个站点（STA，Station）。STA模式冒烟测试即实现与AP设备连接并能进行数据通信。

### 测试流程

1. 复位单板(AT+RST)

2. 设置单板的MAC地址(AT+MAC=xx:xx:xx:xx:xx:xx)。两块单板（AP和STA） 的MAC 要设置的不一样。

3. 开启STA模式（AT+STARTSTA）

4. 扫描可连接的网络(AT+SCAN)

5. 导出扫描结果，查询可连接的网络(AT+SCANRESULT)。

6. 连接网络(AT+CONN="my_ap",,"12345678"),连接ssid为"my_wifi",密码为"12345678"的AP。

7. 启动DHCP客户端，获取STA设备的IP(AT+DHCP=wlan0,1)

8. 查看STA配置信息(AT+IFCFG)

9. ping测试（AT+PING=<AP ip addr>）

10. Iperf吞吐量测试。

    - udp接收吞吐量测试(AT+IPERF=-s,-u,-i,1),AP执行“udp发送吞吐量测试命令”。

    - udp发送吞吐量测试(AT+IPERF=-c,192.168.49.1,-u,-b,10M,-t,5,-i,1),AP提前执行"udp接收吞吐量测试命令"。

    - tcp接收吞吐量测试(AT+IPERF=-s,-i,1),AP执行“tcp发送吞吐测试命令”。

    - tcp发送吞吐量测试(AT+IPERF=-c,192.168.49.1,-t,5,-i,1),AP提前执行"tcp接收吞吐量测试命令"。

经上述测试，STA模式单板基本功能正常。

## BLE冒烟测试

- 概述

- 测试流程

### 概述

BLE冒烟测试是一种针对BLE协议栈的快速基本功能验证策略，旨在确认软件BLE基本功能是否正常。

BLE单板连接手机，然后进行数传。

### 测试流程

1. 单板连接手机。

2. 使能BLE (AT+BLEENABLE)：

3. 设置蓝牙名称 (AT+BLESETNAME)：

4. 设置蓝牙地址 (AT+BLESETADDR)：

5. 设置广播数据 (AT+BLESETADVDATA)：

6. 设置广播参数 (AT+BLESETADVPAR)：

7. 起广播 (AT+BLESTARTADV)：

8. 手机测搜索并连接单板

经上述测试，单板BLE基本功能正常。

## SLE冒烟测试

- 概述

- 测试流程

### 概述

星闪（SLE）冒烟测试主要验证server端与client端的SSAP接口以及服务发现管理的基本功能，以下冒烟功能包括配对连接和服务管理。

### 测试流程

配对连接

1. server端与client端启动SLE（AT+SLEENABLE）。

2. server端设置广播（AT+SLESETADV）。

3. server端起广播（AT+SLEENABLEADV=1）。

4. client连接server端（AT+SLECONNADDR=0,0x000000000000）。

   client成功连接到server端。

   server端收到client的连接请求，并成功配对连接。

服务管理

server端

1. 启动SLE（AT+SLEENABLE），截图同配对连接。

2. 注册server（AT+SLEADDSERVER=0x1234）。

3. 添加服务（AT+SLEADDSERVICE=0x2222,1）。

4. 添加属性（AT+SLEADDPROPERTY=1,0x2323,5,5,2,0x1234）。

5. 添加属性描述符（AT+SLEADDDESCRIPTOR=1,2,0x3333,5,5,2,2,0x0200）。

6. 调起服务(AT+SLESTARTSERVICE=1)。

7. 注册服务端回调函数（AT+SLESSAPSERREGISTER）。

8. 设置广播参数（AT+SLESETADVPAR=1,3,200,200,0,000000000000,0,000000000000）。

9. 设置广播数据（AT+SLESETADVDATA=1,10,4,aabbccddeeff11223344,11224455）。

10. 根据设置的参数起广播（AT+SLEENADVBYPAR=1）。

client端

1. 启动SLE（AT+SLEENABLE），截图同配对连接。

2. 注册SSAPC回调（AT+SLESSAPCENREGISTER）。

3. 连接对端（AT+SLECONNADDR=0,0x000000000000）。

4. 按照uuid发现service（AT+SLEDISCOVERYSERVICES=0,0,1）。

5. client端向server端写入数据（AT+SLESSAPCENWRITE=0,0,2,0,2,0x8899）。

   Server端会同时收到对端写入的数据。

6. 客户端读取服务端属性数据（AT+SLESSAPCENREAD=0,0,2,0）。

经上述测试，单板星闪基本功能正常。