前言

概述

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

读者对象

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

  • 单板硬件开发工程师

  • 软件工程师

  • 技术支持工程师

符号约定

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

符号

说明

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

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

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

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

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

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

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

修改记录

文档版本

发布日期

修改说明

03

2025-05-28

更新“射频测试相关指令描述”小节内容。

02

2024-09-13

更新“射频测试相关指令描述”小节内容。

01

2024-08-08

第一次正式版本发布。

00B02

2024-06-12

更新“射频测试相关指令描述”小节内容。

00B01

2024-01-31

第一次临时版本发布。

测试指令

射频测试相关指令描述

序号

测试命令

命令说明

1

初始化Wi-Fi

命令格式：

AT+STARTSTA

2

常发命令

配置协议模式

  • 命令格式

    AT+CCPRIV=wlan0,mode,<mode>

  • 参数说明：11b、11g2g20、11n2g20、11n2g40、11ax2g20

设置信道

  • 命令格式

    AT+CCPRIV=wlan0,freq,<freq>

  • 参数说明：信道1~14，只有11b有信道14。

配置常发

  • 命令格式

    AT+ALTX=<control>[,<protocol_mode>,<bw>,<chn>]

  • 参数说明

    <control>：使能开关

    0：关闭

    1：打开

    2：固定速率常发

    <protocol_mode>：协议类型

    0：802.11n

    1：802.11g

    2：802.11b

    3：802.11ax

    5：11n 40plus

    6：11n 40minus

    <bw>：带宽

    20：20MHz带宽

    40：40MHz带宽

    <chn>：信道号，取值范围1～14

  • 命令格式

    AT+CCPRIV=wlan0,al_tx_ccpriv,<flag>,<payload>,<len>,<tpc_code>

  • 参数说明

    <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表示使用功率表中的功率值。

    TPC code，与配置功率的对应关系为:（23dBm-配置功率）×2。

    11b的档位计算为：11b的档位=（23dBm-配置功率）×2+74。

3

WIFI切换单音指令
  • AT+CALTONE=sw,freq
  • 参数说明：
  • sw：设置单音开关

    0：关闭

    1：开启

  • freq：设置单音频率
    1. 范围（，40000），单位：KHz，表示基于中心频率的偏移频率

注：单音指令在常发后使用

4

常收命令

关闭常收

  • 命令格式

    AT+ALRX=0

设置常收

  • 命令格式

    AT+ALRX=<flag>,<协议模式>,<带宽>,<frep>,<保留位>

  • 参数说明
    • <flag>：

      0：关闭常收

      1：开启常收

      2：修改速率（修改为广播）

    • <协议模式>：

      0：11n2g20

      1：11g2g20

      2：11b

      3：11ax2g20

      5：11n2g40

    • <带宽>：

      20M：20

      40M：40

    • < freq >：频点，信道号，2.4G为1~14.

    只有11b有信道14

    • < 保留位>：

    0/1均可

查询接收包数统计

  • 命令格式

    AT+RXINFO

  • 响应

    +RXINFO::rx succ num[mpdu,ampdu]:[45713,975] fail num:47959 rssi:-69

  • 示例

    说明：接收成功45713个MPDU报文、975个AMPDU报文，接收失败47959个报文。

  • 注意事项

    在设置常收命令后执行查询，在Host侧查看打印结果。

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表示成功，其他值表示错误。

    注意：

    认证边带降功率：

    2402信道GFSK降11dB

    2480信道GFSK降2dB

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

开启SLE
  • 命令格式

    AT+SLEENABLE

  • 响应

    OK或ERROR

  • 说明

    在进行SLE测试前，先运行本条命令，开启SLE。

12

注册SLE event回调
  • 命令格式

    AT+SLEFACCALLBACK

  • 响应

    OK或ERROR

  • 说明

    在进行SLE测试前，在运行使能SLE命令后，先运行本条命令，注册SLE的消息回显回调。

13

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：-14dBm

      1：-10dBm

      2：-6dBm

      3：-2dBm

      4：2dBm

      5：6dBm

      6：10dBm

      7：14dBm

      注意：

      默认配置下：

      GFSK = [-14, -10, -6, -2, 2, 6, 10, 14]dBm

      PSK = [-17, -13, -9, -5, -1, 5, 7, 11]dBm

      认证边带降功率：

      2402信道GFSK降11dB

      2477信道4M 8PSK降8.5dB,QPSK降4dB

      2480信道GFSK降2dB

    • 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表示成功，其他值表示错误。

14

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表示成功，其他值表示错误。

15

结束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进制表示。

16

BSLE切换单音
  • 命令格式
    AT+BTTXLO=<freq> <mode>
  • 参数说明
    • freq：频点，取值范围：0~78，表示（2402+freq）Mhz。
    • mode：模式和开关，

      0：发LO单音；

  • 响应

    OK

    status：<value1>

    • value1：命令执行状态。

      00：OK

      其他：FAIL。

  • 命令说明

    单音命令，执行的前置条件是：已经执行AT+BLEENABLE命令使能BLE。SLE单音与BLE单音共用。

17

SLE Reset
  • 命令格式

    AT+SLERST

  • 响应

    OK

    status：<value>

    value：返回状态，0表示成功，其他值表示错误。

示例

常发指令示例

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

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

开启常发（固定速率）：
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 // 1表示开启常发，2表示payload 是1010，payload长度为1500，功率是18dBm(=23-0.5*10)
停止常发
8)    AT+ALTX=0

图 1 常发固定速率表

  • 例如：BLE常发

    AT+BLETX=0,255,0,1

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

  • 例如：SLE常发

    AT+SLETX=0,7,255,0,0,0,0,0,0,50

    表示在0号信道，功率档位为7，发送包长度为255Byte（说明：参数中的ff00为发送数据长度，小端字节序表示，即0x00ff，转换成十进制表示为255），发送包类型PRBS9，1M Phy，GFSK的format和调制方式，无导频无编码，发包间隔6250μs（说明：SLE的1个slot为125μs，因此时间间隔为50*125=6250μs）。

常收指令示例

  • 例如：11n 20M信道7的常收指令

    AT+STARTSTA
AT+ALRX=1,0,20,7,0

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

AT+RXINFO

  • 例如：BLE常收

    AT+BLERX=0,1,0

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

  • 例如：SLE常收

    AT+SLERX=0,0,0,0,50

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

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

注意事项

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