前言¶

概述

本文档详细的介绍了WS63V100系列模组的射频非信令测试指南和注意事项。

读者对象

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

单板硬件开发工程师
软件工程师
技术支持工程师

符号约定

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

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

修改记录

文档版本	发布日期	修改说明
05	2025-02-28	更新“射频测试相关指令描述”小节内容。
04	2024-09-29	更新“射频测试相关指令描述”小节内容。
03	2024-07-01	更新“射频测试相关指令描述”小节中WiF常发命令参数说明。更新 "示例”小节中WiF常发常收命令。
02	2024-05-08	更新“射频测试相关指令描述”小节内容。
01	2024-04-10	第一次正式版本发布。更新“射频测试相关指令描述”小节内容。更新“常发单音指令示例”小节内容。
00B06	2024-03-14	更新“射频测试相关指令描述”小节中常发命令参数说明。
00B05	2024-02-29	更新“射频测试相关指令描述”小节中常发命令参数说明。
00B04	2024-02-22	更新“射频测试相关指令描述”小节中常发命令参数说明。
00B03	2024-01-15	更新“射频测试相关指令描述”小节中WiFi常发指令与示例，以及BLE/SLE相关命令。更新 "示例”小节中BLE/SLE常发常收命令。
00B02	2023-12-18	更新“射频测试相关指令描述”小节中常发命令内容.
00B01	2023-11-24	第一次临时版本发布。

测试指令¶

射频测试相关指令描述¶

序号	测试命令	命令说明
1	初始化WiFi	命令格式： AT+STARTSTA
2	WiFi常发命令	配置协议模式命令格式 AT+CCPRIV=wlan0,mode,<mode> 参数说明：11b、11g2g20、11n2g20、11n2g40、11ax2g20 设置信道命令格式 AT+CCPRIV=wlan0,freq,<freq> 参数说明：信道1~14，只有11b有信道14。当协议模式是11N 40M上偏/下偏时，实际信道会上偏/下偏2个信道；如设置1信道上偏，仪器3信道才能测出信号，设置9信道下偏，仪器7信道才能测出信号。配置常发命令格式 AT+ALTX=<control> 参数说明 <control>：使能开关 0：关闭 1：打开 2：固定速率常发命令格式 AT+CCPRIV=wlan0,al_tx_ccpriv,<flag>,<payload>,<len>,<tpc_code>,<duty_ratio> 参数说明 <flag>： 0：关闭常发 1：打开常发 <payload>： 0：全0 1：全1 2：全1010 3：随机值 <len>：payload长度：0-4000 <tpc_code>（可选参数）：11g/n/ax 是0~73，11b是74~146，tpc_code越小，功率越大，初始值 23dBm，每档下调0.5dBm；255表示使用功率表中的功率值。 <duty_ratio> (可选参数) ：常发占空比，取值范围1~10，分别对应占空比10%~100%，缺省值为7，对应占空比70%。要配置duty_ratio必须配置tpc_code，不需要配置duty_ratio则tpc_code可选。
3	WiFi常收命令	关闭常收命令格式 AT+ALRX=0 设置常收命令格式 AT+ALRX=<flag>,<协议模式>,<带宽>,<frep>,<保留位> 参数说明 <flag>： 0：关闭常收 1：开启常收 2：修改速率（修改为广播） <协议模式>： 0：802.11n 1：802.11g 2：802.11b 3：802.11ax 5：11n40plus 6：11n40minus <带宽>： 20M：20 40M：40 < freq >：频点，信道号协议模式0~3：信道号取值范围：1~14 ，只有11b有信道14 协议模式5：信道号取值范围：1~9 协议模式6：信道号取值范围：5~13 < 保留位>： 0/1均可查询接收包数统计命令格式 AT+RXINFO 响应 +RXINFO::rx succ num[mpdu,ampdu]:[45713,975] fail num:47959 rssi:-69 示例说明：接收成功45713个MPDU报文、975个AMPDU报文，接收失败47959个报文。注意事项在设置常收命令后执行查询，在Host侧查看打印结果。
4	开启WiFi单音	配置单音命令格式 AT+CALTONE=<sw>, <tone_freq> 参数说明 <sw>：开关，1: 开启 0: 关闭。 <tone_freq>:单音偏移频率，单位kHz 响应成功：OK 失败：ERROR 示例开启单音，单音频移中心频率2.5MHz AT+CALTONE=1, 2500 关闭单音 AT+CALTONE=0, 0 注意事项单音功能的命令在WIFI常发后使用。
5	开启BLE	命令格式 AT+BLEENABLE 响应 OK或ERROR 说明在进行BLE测试和产线校准前，先运行本条命令，开启BLE协议栈。
6	注册BLE回调	命令格式 AT+BLEFACCALLBACK 响应 OK或ERROR 说明在进行BLE测试和BLE/SLE产线校准前，先运行本条命令，注册消息回显。
7	BLE常发	命令格式 AT+BLETX=<channel>,<data_len>,<payload_type>.<phy> 参数说明 channel：0~39，对应BLE的40个channel。 data_len：37~255，表示发送测试包的长度，单位：Byte。 payload_type：0~7，表示发送测试包携带的内容。 0：PRBS9 1：'11110000' 2：'10101010' 3：PRBS15 4：'11111111' 5：'00000000' 6：'00001111' 7：'01010101' phy：表示发送测试包使用的物理调试链路。 1：LE 1MPhy 2：LE 2MPhy 3：LE CodedPhy (S=8) 4：LE CodedPhy (S=2) 响应 OK status：<value> value：返回状态，0表示成功，其他值表示错误。
8	BLE常收	命令格式 AT+BLERX=<channel>,<phy>,<modulation> 参数说明 channel：0~39，对应BLE的40个channel。 phy：监听的物理调试链路。 1：LE 1MPhy 2：LE 2MPhy 3：LE CodedPhy modulation： 0：standard 1：stable 响应 OK status：<value> value：返回状态，0表示成功，其他值表示错误。
9	结束BLE常发/常收	命令格式 AT+BLETRXEND 响应 OK status：<value1>，num_packets：<value2> value1：返回状态，0表示成功，其他值表示错误； value2：收包数，16进制表示，仅在结束BLE常收时有效。
10	BLE Reset	命令格式 AT+BLERST 响应 OK status：<value> value：返回状态，0表示成功，其他值表示错误。
11	BLE/SLE单音命令	命令格式 AT+BTTXLO=<freq> <mode> 参数说明 freq：频点，取值范围：0~78，表示（2402+freq）Mhz。 mode：模式和开关， 0：发数字LE 1M调制； 1：发LO单音； 255：停止。响应 OK status：<value1> value1：命令执行状态。 00：OK 其他：FAIL。命令说明单音命令，执行的前置条件是：已经执行AT+BLEENABLE命令使能BLE。SLE单音与BLE单音共用。
12	开启SLE	命令格式 AT+SLEENABLE 响应 OK或ERROR 说明在进行SLE测试前，先运行本条命令，开启SLE。
13	注册SLE event回调	命令格式 AT+SLEFACCALLBACK 响应 OK或ERROR 说明在进行SLE测试前，在运行使能SLE命令后，先运行本条命令，注册SLE的消息回显回调。
14	SLE常发	命令格式 AT+SLETX=<channel>,<power>,<data_len>,<payload_type>,<phy>,<format>,<rate>,<pilot_ratio>,<polar>,<interval> 参数说明 channel：0~78，表示信道（2402+channel）MHz。 power：发送功率档位，最高2个档位(06，07)只在GFSK调制信号时有效。 0：-6dBm 1：-2dBm 2：2dBm 3：6dBm 4：10dBm 5：14dBm 6：16dBm 7：20dBm data_len：37~255，包长度，单位：Byte。 payload_type：包类型 0：PRBS9 1：'11110000' 2：'10101010' 3：PRBS15 4：'11111111' 5：'00000000' 6：'00001111' 7：'01010101' phy：表示发送测试包使用的物理链路 0：1M PHY 1：2M PHY 4：4M PHY format：帧格式 0：GFSK 2：短帧（short frame） rate：调制方式 0：GFSK 2：QPSK 3：8PSK pilot_ratio：导频密度 0：no 1：1:1 2：4:1 3：16:1 polar：编码方式，针对format取值含义不同 0：no 2：3/4 interval：两个packet之间的发送时间间隔，单位：125μs，大小范围：4~65535。根据桢长度选择适当的参数值，当包长度为255时，建议填50，即50*125=6250μs。响应 OK status：<value> value：status，返回状态，0表示成功，其他值表示错误。
15	SLE常收	命令格式 AT+SLERX=<channel>,<phy>,<format>,<pilot_ratio>,<interval> 参数说明 channel：0～78，对应SLE的79个信道，频点：（2402+channel）MHz phy：表示发送测试包使用的物理链路 0：1M PHY 1：2M PHY 4：4M PHY format：帧格式 0：GFSK 2：短帧（short frame） pilot_ratio：导频密度，长帧必须插入导频，接收时该字段不生效 0：no 1：1:1 2：4:1 3：16:1 interval：表示两个packet之间的发送时间间隔，单位：125μs，大小范围：4~65535。和TX端的帧间隔设置为一致。响应 OK status：<value> value：status，返回状态，0表示成功，其他值表示错误。
16	结束SLE常发/常收	命令格式 AT+SLETRXEND 响应 OK status：<value1>，num_packet：<value2>，rssi：<value3> value1：status，返回状态，0表示成功，其他值表示错误; value2：num_packet，16进制表示。结束SLE TX时，表示发包数；结束SLE RX时，表示收包数； value3：rssi，表示接收信号强度，16进制表示。
17	SLE Reset	命令格式 AT+SLERST 响应 OK status：<value> value：返回状态，0表示成功，其他值表示错误。

示例¶

常发指令示例¶

说明： 默认发射功率为目标功率，误差在±2dB。

例如：发射11n/20M带宽/信道7/mcs4，PSDU升1500，功率18dBm(=23-0.5*10)的常发指令：

开启WiFi常发（固定速率）：
1)    AT+STARTSTA
2)    AT+ALTX=2          // 2：固定速率常发
3)    AT+TRC=0           // 0：固定速率，1：自动速率
4)    AT+SETRATE=36      // 参数说明见"[图1](#fig1225071435516)"，例如：36表示11n, 20MHz频宽,mcs4
5)    AT+CCPRIV=wlan0,mode,11n2g20 // 设置协议模式
6)    AT+CCPRIV=wlan0,freq,7 // 设置信道
7）   AT+CCPRIV=wlan0,al_tx_ccpriv,1,2,1500,10,7 // 1表示开启常发，2表示payload 是1010，payload长度为1500，功率是18dBm(=23-0.5*10)，常发占空比是70%。
停止WiFi常发
8)    AT+ALTX=0

图 1 WiFi常发固定速率表

例如：BLE常发

开启BLE常发

AT+BLEENABLE           // 开启BLE，只执行一次
AT+BLEFACCALLBACK      // 注册BLE回显回调，只执行一次
AT+BLERST              // BLE软复位，每次BLE常发开始前执行
AT+BLETX=0,255,0,1     // BLE常发命令

表示在channel0，1M Phy发送长度255，包内容为PRBS9序列的包。

停止BLE常发

AT+BLETRXEND           // 停止BLE常发

例如：SLE常发

开启SLE常发
```
AT+SLEENABLE           // 开启SLE，只执行一次
AT+SLEFACCALLBACK      // 注册SLE回显回调，只执行一次
AT+SLERST              // SLE软复位，每次SLE常发开始前执行
```
```
AT+SLETX=0,7,255,0,0,0,0,0,0,50   // SLE常发命令
```
表示在0号信道，功率档位为7，发送包长度为255字节（说明：参数中的ff00为发送数据长度，小端字节序表示，即0x00ff，转换成十进制表示为255），发送包类型PRBS9，1M Phy，GFSK的format和调制方式，无导频无编码，发包间隔6250μs（说明：SLE的1个slot为125μs，因此时间间隔为50*125=6250μs）。

停止SLE常发
```
AT+SLETRXEND          // 停止SLE常发
```

常收指令示例¶

例如：11n 20M信道7的常收指令
```
AT+STARTSTA
AT+ALRX=1,0,20,7,0
```

在每轮常收后输入下面的这条命令读取解析到的包数。

AT+RXINFO

例如：BLE常收

开启BLE常收

AT+BLEENABLE           // 开启BLE，只执行一次
AT+BLEFACCALLBACK      // 注册BLE回显回调，只执行一次
AT+BLERST              // BLE软复位，每次BLE常发开始前执行

AT+BLERX=0,1,0         // 开启BL常收

表示在channel0，1MPhy的物理调制链路，用标准调试方式来监听测试包.

停止BLE常收

AT+BLETRXEND           // 停止BLE常收

例如：SLE常收

开启SLE常收

AT+SLEENABLE           // 开启SLE，只执行一次
AT+SLEFACCALLBACK      // 注册SLE回显回调，只执行一次
AT+SLERST              // SLE软复位，每次SLE常收开始前执行

AT+SLERX=0,0,0,0,50    // 开启SLE常收

表示在0号信道接收1M PHY、GFSK帧格式的包，包间隔6250μs（说明：SLE的1个slot为125μs，因此时间间隔为50*125=6250μs）

停止SLE常收

AT+SLETRXEND // 停止SLE常收

说明：

11b灵敏度指标基于1024 octet PSDU的8%PER；11g灵敏度指标基于1024 octet PSDU的10%PER；11n灵敏度指标基于4096 octet PSDU的10%PER。

常发单音指令示例¶

例如：WiFi常发偏移+2.5M 单音测试命令，
```
AT+CALTONE=1, 2500
```
例如：关闭WiFi单音
```
AT+CALTONE=0, 0
```
例如：BLE单音测试，在2402M上发送单载波
```
AT+BTTXLO=0 1
```
例如：关闭BLE单音
```
AT+BTTXLO=0 255
```

注意事项¶

上电前，务必保证DUT的射频口接有50Ω负载，否则功率会偏高或偏低较多。