前言

概述

本文档主要介绍BS2XV100的射频非信令相关的测试指令和指令的组包示例，测试前务必阅读注意事项。

产品版本

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

产品名称	产品版本
BS2X	V100

读者对象

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

• 技术支持工程师。

• 软件开发工程师。

符号约定

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

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

修改记录

文档版本	发布日期	修改说明
04	2025-05-30	更新“常发指令”小节内容。 更新“常收指令”小节内容。 更新“常发指令”小节内容。 更新“常收指令”小节内容。 更新“常发常收停止指令”小节内容。
03	2025-01-14	更新“常发指令”小节内容。
02	2024-08-29	更新“射频测试相关AT指令一览表”、“射频单音”、“CTRIM校准值写入EFUSE / FLASH指令”、“CFO动态校准上报（可选）”小节内容。 更新“AT指令组包示例”小节内容。 更新“部分指令返回值为十六进制”、“串口回复说明”、“星闪协议频点表”小节内容。
01	2024-05-24	第一次正式版本发布。 更新“射频测试相关AT指令一览表”小节内容。 新增“RT201 FEM使能（可选）”小节内容。
00B05	2024-03-29	更新“BLE业务使能”小节内容。
00B04	2024-03-15	更新“射频测试相关AT指令一览表”小节内容。 更新“BLE射频测试相关AT指令描述”小节内容。 更新“SLE射频测试相关AT指令描述”小节内容。
00B03	2024-01-18	更新“AT指令组包示例”章节内容。
00B02	2023-12-28	更新“常发指令”小节内容。
00B01	2023-11-01	第一次临时版本发布。

射频测试AT指令

射频测试相关AT指令一览表

指令	描述
a testsuite_sw_at	从testsuite进入AT模式（最新版本删除）。
AT+TESTSUITE	退出AT模式。（最新版本删除）
AT+BLEENABLE	BLE业务使能
AT+BLEFACCALLBACK	注册BLE命令上报回调（没有相应退出操作）。
AT+BLETX	BLE常发指令。
AT+BLERX	BLE常收指令。
AT+BLETRXEND	BLE常发、常收停止指令。
AT+BLERST	BLE软件复位指令。
AT+SLEENABLE	SLE使能指令（没有相应退出操作）。
AT+SLEFACCALLBACK	注册SLE命令上报回调（没有相应退出操作）。
AT+SLETX	SLE常发指令。
AT+SLERX	SLE常收指令。
AT+SLETRXEND	SLE常发、常收停止指令。
AT+SLERST	SLE软件复位指令。
AT+BTRFCALI	射频自校准指令。
AT+BTTXLO	射频单音指令。
AT+XOREGVAL	读取当前校准寄存器配置指令。
AT+XOCALI	晶体频偏校准指令。
AT+XOSETEFUSE	频偏校准值写EFUSE指令。
AT+XOSETFLASH	频偏校准值写FLASH指令。
AT+FEMENABLE	RT201 FEM配置使能（重启生效）。
AT+SLECFORPT	SLE测试模式对通场景cfo上报指令。
AT+SLECFORSSI	设置SLE测试模式对通场景cfo上报的rssi门限。

通用AT指令

说明： 若当前软件版本同时支持testsuite模式和AT模式，则两种模式串口复用，需要通过以下两条指令相互切换，如果当前版本只支持其中一种模式，则忽略本章节。

进入AT模式

格式	a testsuite_sw_at
响应	[TEST_PASSED!] 成功：OK 失败：[TEST_FAILED : ERROR CODE]
示例	a testsuite_sw_at
注意	上电时如果默认为testsuite模式，需要由testsuite模式切换到AT模式，测试AT指令的前置条件。

退出AT模式

格式	AT+TESTSUITE
响应	成功：OK 失败：ERROR
示例	AT+TESTSUITE
注意	由AT模式切到testsuite模式。

BLE射频测试相关AT指令描述

BLE测试建议流程

图 1 BLE产测AT测试流程

BLE业务使能

格式	AT+BLEENABLE
响应	[ACore] ble enable cbk in, result:0 ble enable 成功：OK 失败：ERROR
示例	AT+BLEENABLE 回复： OK
注意	在进行BLE所有指令前，必须先执行BLE使能指令，使能BLE相关业务接口。 本使能指令没有相应退出操作，测试BLE指令的前置条件之一。 上电后发一次即可，重复发易出现问题。

BLE注册回调

格式	AT+BLEFACCALLBACK
响应	成功：OK 失败：ERROR
示例	AT+BLEFACCALLBACK
注意	BLE测试前先注册上报回调，否则业务指令没有上报状态打印。没有相应退出操作，测试BLE指令的前置条件，上电后发一次即可，重复发易出现问题。

常发指令

格式	AT+BLETX=<freq>,<payload_len>,<payload_type>,<phy>
响应	成功：OK status：0x0 注意：status为非0值表示该指令执行出错。 失败：ERROR ERROR原因：指令不支持或格式错误。
参数说明	<freq>：发送频点 发送频率范围是（2N+2402）MHz，其中N即freq，范围0～39，频率有效范围为2402MHz～2480MHz。 <payload_len>：包长度 37～255 Byte，蓝牙Core_v5.3协议定义，如图1所示。 <payload_type>：发包模式 0：PRBS9 1：11110000 2：10101010 3：PRBS15 4：11111111 5：00000000 6：00001111 7：01010101 <phy>：PHY类型 1：1M PHY 2：2M PHY 3：Coded PHY with S=8 data coding 4：Coded PHY with S=2 data coding
示例	AT+BLETX=0,255,0,1
注意	参数为十进制,中间“,”不可省略。

图 1 BLE 非编码测试包结构

常收指令

格式	AT+BLERX=<freq>,<phy>,<modulation_index>
响应	成功：OK status：0x0 注意：status为非0值表示该指令执行出错。 失败：ERROR ERROR原因：指令不支持或格式错误。
参数说明	<freq>：发送频点 发送频率范围是（2N+2402）MHz，其中N即freq，范围0～39，频率有效范围2402MHz～2480MHz。 <phy>：PHY类型 1:1M PHY 2:2M PHY 3:Coded PHY with S=8 data coding 4:Coded PHY with S=2 data coding < modulation_index >：调制指数 0:Assume transmitter will have a standard modulation index 1:Assume transmitter will have a stable modulation index 2～256:Reserved
示例	AT+BLERX=0,1,0
注意	参数为十进制,中间“,”不可省略。

常发常收停止指令

格式	AT+BLETRXEND
响应	成功：OK status：0x0, num_packets:0x3e8 失败：ERROR
示例	AT+BLETRXEND 回复： OK status:0x0, num_packets:0x3e8 说明：在RX结束后发送收包指令得到回复num_packets:0x3e8说明收到1000包。
注意	停止RX时保证在仪表发完包后执行。 num_packet在RX结束后关注， num_packet：收包数。 为避免丢包，停止RX时要保证在仪表完成发包后执行。

BLE 复位指令

格式	AT+BLERST
响应	成功：OK status：0x0 失败：ERROR
示例	AT+BLERST
注意	BLE软件复位指令，在进行BLE RF测试前先发BLE复位指令恢复软件状态。

SLE射频测试相关AT指令描述

SLE测试建议流程

图 1 SLE产测AT测试流程

SLE使能指令

格式	AT+SLEENABLE
响应	[ACore] sle enable cbk in, result:0 [ACore] sle device discovery in, action:0 sle enable 成功：OK 失败：ERROR
示例	AT+SLEENABLE 回复： OK
注意	在进行SLE所有指令前，必须先执行SLE使能指令。 本使能指令没有相应退出操作，测试SLE指令的前置条件之一。 上电后发一次即可，重复发易出现问题。

SLE注册回调

格式	AT+SLEFACCALLBACK
响应	[AT] sle factory register cbks. 成功：OK 失败：ERROR
示例	AT+SLEFACCALLBACK
注意	SLE测试前先注册回调，没有相应退出操作，测试SLE指令的前置条件之一。 上电后发一次即可，重复发易出现问题。

常发指令

格式	AT+SLETX=<freq>,<pwr>,<payload_len>,<payload_type>,<phy>,<format>,<TX_rate>,<pilot>,<polar>,<interval>
响应	成功：OK general event report opcode[04] status：0 注意：status为非0值表示该指令执行出错。 常见场景，重复发送（不生效）status：b 失败：ERROR ERROR原因：指令不支持或格式错误。
参数说明	<freq>：发送频点 0～78：射频信道号依次对应对应2402MHz～2480MHz，详见图1和图2。 <pwr>: 发送功率 GFSK： 0：-4dBm 1：-2dBm 2：0dBm 3：2dBm 4：4dBm 5：6dBm QPSK/8PSK： 0：-8dBm 1：-6dBm 2：-4dBm 3：-2dBm 4：0dBm 5：2dBm <payload_len>：包长度 根据星闪协议，包长范围是0～255Byte <payload_type>：发包模式 0：PRBS9 1：11110000 2：10101010 3：PRBS15 4：11111111 5：00000000 6：00001111 7：01010101 <phy>：PHY类型 0: 1M 1: 2M 4: 4M <format>：帧类型 0：无线帧类型1 2：无线帧类型2 说明：无线帧类型1对应GFSK速率，无线帧类型2对应PSK速率 <TX_rate>：速率 0：GFSK 2：QPSK 3：8PSK <pilot>：导频 0：无导频 1：8:1 2：4:1 3：16:1 <polar>: 编码 0：无编码 2：3/4 <interval>: 间隔 经验证间隔需要[6,255] （单位125μs）, payload length为255Byte时，建议interval设置为50。
示例	AT+SLETX=0,5,255,0,1,2,2,0,0,50
注意	参数均为十进制,中间“,”不可省略。

常收指令

格式	AT+SLERX=<freq>,<phy>,<format>,<pilot>,<interval>
响应	成功：OK status：0 注意：status为非0值表示该指令执行出错。 常见场景，重复发送（不生效）status：b 失败：ERROR
参数说明	<freq>：发送频点 0～78：射频信道号依次对应对应2402～2480 MHz，详见图1和图2 <phy>：PHY类型 0: 1M 1: 2M 4: 4M <format>：帧类型 0：无线帧类型1 2：无线帧类型2 说明：无线帧类型1对应GFSK速率，无线帧类型2对应PSK速率 <pilot>：导频 0：无导频 1：1:1 2：4:1 3：16:1 <interval>：间隔 经验证间隔需要[6,255] （单位125μs）, payload length为255Byte时，建议interval设置为50。
示例	AT+SLERX=0,0,0,0,50
注意	参数为十进制,中间“,”不可省略。

常发常收停止指令

格式	AT+SLETRXEND
响应	成功：OK general event report opcode[06] status：0,num_packet:3e8,rssi:81 注意：status为非0值表示该指令执行出错。 常见场景，重复发送（不生效）status：b 失败：ERROR
示例	AT+SLETRXEND 回复： OK sle radio frequency tx|rx end status:0x0,num_packet:0x3e8,rssi:0x81 说明：如仪表发1000包后发结束指令，测试RX的收报数为1000包（0x3e8），测试RX的接收能量rssi为-127dbm（0x81） 如果发TX后执行结束指令，则收报数为0， rssi为0。
注意	此指令在执行SLE RF TX、RX后需要停止时执行。 rssi和num_packet在RX结束后关注。 rssi：接收能量值； num_packet：收包数。 为避免丢包，停止RX指令发送前要保证仪表已经完成发包

SLE 复位指令

格式	AT+SLERST
响应	成功：OK general event report opcode[07] status:0 失败：ERROR
示例	AT+SLERST
注意	软件复位指令。

射频单音

格式	AT+BTTXLO=<freq>,<mode>
响应	成功：OK 失败：ERROR
参数说明	<freq>: 频点 0～78：射频信道号依次对应对应2402～2480 MHz，详见图1和图2 <mode>：开关 0：发单音； 255：停止单音； 其他值无效。
示例	AT+BTTXLO=4,0 说明：在（2402+4）MHz发单音。 AT+BTTXLO=4,255 说明：在（2402+4）MHz停止单音。
注意	1. 发单音后不会自动停止，测试TRX性能前需要发指令AT+BTTXLO=0,255停止单音，避免影响。 2. 最新版本单音不再打印status：0，且不再依赖BLE使能，不与BLE业务耦合，单SLE版本也可以使用发单音和停止单音指令。

XO 32M校准（可选）

执行CTRIM校准指令

格式	AT+ XOCALI=<increase>,<step_num>
响应	xo_ctrim_reg_val:0x0 成功：OK 失败：ERROR
参数说明	< increase >: 增加或减小电容值 1：增加 0：减小 < step_num >: 电容值调整步进 取值范围[0,255]，默认0（十进制）
示例	AT+ XOCALI=1,10 返回值： xo_ctrim_reg_val:0x10 OK 说明：给电容增加10steps，具体效果通过发送单音或调制信号观测 AT+ XOCALI=0,20 返回值： xo_ctrim_reg_val:0x0 OK 说明：电容在第一步增加10后减少20，超出范围，默认减为最小值0。
注意	超出[0,255]的步进无效，默认按照最大/最小配置寄存器，校准时无特殊环境约束。 步进和电容变化非严格线性变化，需要上位机程序使用二分法调整步进，通常常温频偏门限为±24kHz。

CTRIM校准值写入EFUSE / FLASH指令

格式	AT+ XOSETEFUSE
响应	efuse_val: 0x0 成功：OK 失败：ERROR
示例	AT+ XOSETEFUSE 返回值： efuse_val: 0x2 说明：当前寄存器配置的电容步进为2，写入EFUSE成功后回读EFUSE值为0x2。
注意	由于EFUSE只能写入一次,根据回报值“efuse_val: 0x2“判断是否写入成功。

格式	AT+ XOSETFLASH
响应	flash_val: 0x2 成功：OK 失败：ERROR
示例	AT+ XOSETFLASH 返回值： flash_val: 0x2 说明：当前寄存器配置的电容步进为2，写入FLASH成功后回读FLASH值为0x2。
注意	根据回报值“flash_val: 0x2“判断是否写入成功。

读取当前CTRIM寄存器配置

格式	AT+ XOREGVAL
响应	reg_val: 0x0 成功：OK 失败：ERROR
示例	AT+ XOREGVAL 返回值： reg_val: 0x0 OK 说明：当前XO_CORE_CTRIM寄存器值为0x0。
注意	上电后默认从EFUSE中读出校准值应用到寄存器，若EFUSE为空，寄存器默认值为0x0。

CFO动态校准上报（可选）

说明： “XO 32M校准（可选）”中ctrim校准时需要用蓝牙综测仪或频谱仪观测定频信号的频谱，通过调整ctrim电容值来改变XO 32M频偏；如果没有仪表，则可以考虑本小节中CF0动态上报的校准方式，通过将DUT与一块golden板对通实现，具体流程见《BS2XV100 产测指导书》。

格式	AT+SLECFORPT
响应	[AT]sle CFO report:6 成功：OK 失败：ERROR
示例	AT+SLECFORPT [AT]sle CFO report:6 OK 注意："6"为十进制数，代表当前DUT比golden板频偏相差6*3.9kHz = 23.4kHz
注意	1. AT+SLEENABLE 2. AT+SLEFACCALLBACK 3. AT+SLERX=0,0,0,0,50 (2402MHz 1M GFSK) 测试前先通过以上3条指令使得DUT处于RX常收状态，然后通过CFO上报指令查看当前CFO值，上报值为十进制有符号数，校准门限为CFO∈[-6,6], 即±24kHz。

指令串口示例：

格式	AT+SLECFORSSI=<rssi>
响应	[AT]sle CFO rssi limit:-60 成功：OK 失败：ERROR
示例	AT+SLECFORSSI=-60 [AT]sle CFO rssi limit:-60 OK 注意："-60"为十进制有符号数，代表当前DUT接收能量大于-60的信号作为cfo上报的依据，小于-60dBm的信号将被视为干扰信号。
注意	1. AT+SLEENABLE 2. AT+SLEFACCALLBACK 3. AT+SLERX=0,0,0,0,50 (2402MHz 1M GFSK) 测试前先通过以上3条指令使得DUT处于RX常收状态，然后通过CFO rssi 门限设置指令配置信号过滤门限，防止干扰信号影响上报结果。

指令串口示例：

RT201 FEM使能（可选）

说明： 本章仅供前端使用RT201型号的FEM模组的产品参考。

格式	AT+ FEMENABLE=<fem_switch>
响应	成功：OK 失败：ERROR
参数说明	<fem_switch>：发送频点 0：关闭fem配置； 1：使能fem配置。
示例	AT+ FEMENABLE=1 返回值： OK AT+ FEMENABLE=0 返回值： OK 说明：入参写1使能fem配置，写0去使能，重启上下电后生效。
注意	使能fem的版本，由于fem器件限制输入功率，不能通过NV过指令自定义修改最大功率。

AT指令组包示例

以下为AT常发常收指令的组包示例

表 1 SLE TX 组包

调制速率	信道	指令组包
1M GFSK	2402	AT+SLETX=0,5,255,0,0,0,0,0,0,50
	2440	AT+SLETX=38,5,255,0,0,0,0,0,0,50
	2480	AT+SLETX=78,5,255,0,0,0,0,0,0,50
2M GFSK	2404	AT+SLETX=2,5,255,0,1,0,0,0,0,50
	2440	AT+SLETX=38,5,255,0,1,0,0,0,0,50
	2478	AT+SLETX=76,5,255,0,1,0,0,0,0,50
4M GFSK	2405	AT+SLETX=3,5,255,0,4,0,0,0,0,50
	2441	AT+SLETX=39,5,255,0,4,0,0,0,0,50
	2477	AT+SLETX=75,5,255,0,4,0,0,0,0,50
1M QPSK	2402	AT+SLETX=0,5,255,0,0,2,2,3,2,50
	2440	AT+SLETX=38,5,255,0,0,2,2,3,2,50
	2480	AT+SLETX=78,5,255,0,0,2,2,3,2,50
2M QPSK	2404	AT+SLETX=2,5,255,0,1,2,2,3,2,50
	2440	AT+SLETX=38,5,255,0,1,2,2,3,2,50
	2478	AT+SLETX=76,5,255,0,1,2,2,3,2,50
4M QPSK	2405	AT+SLETX=3,5,255,0,4,2,2,3,2,50
	2441	AT+SLETX=38,5,255,0,4,2,2,3,2,50
	2477	AT+SLETX=75,5,255,0,4,2,2,3,2,50
1M 8PSK	2402	AT+SLETX=0,5,255,0,0,2,3,3,2,50
	2440	AT+SLETX=38,5,255,0,0,2,3,3,2,50
	2480	AT+SLETX=78,5,255,0,0,2,3,3,2,50
2M 8PSK	2404	AT+SLETX=2,5,255,0,1,2,3,3,2,50
	2440	AT+SLETX=38,5,255,0,1,2,3,3,2,50
	2478	AT+SLETX=76,5,255,0,1,2,3,3,2,50
4M 8PSK	2405	AT+SLETX=3,5,255,0,4,2,3,3,2,50
	2441	AT+SLETX=39,5,255,0,4,2,3,3,2,50
	2477	AT+SLETX=75,5,255,0,4,2,3,3,2,50

表 2 SLE RX 组包

调制速率	信道	指令组包
1M GFSK	2402	AT+SLERX=0,0,0,0,19
	2440	AT+SLERX=38,0,0,0,19
	2480	AT+SLERX=78,0,0,0,19
2M GFSK	2404	AT+SLERX=2,1,0,0,10
	2440	AT+SLERX=38,0,0,0,10
	2478	AT+SLERX=76,1,0,0,10
4M GFSK	2405	AT+SLERX=3,4,0,0,6
	2441	AT+SLERX=39,4,0,0,6
	2477	AT+SLERX=75,4,0,0,6
1M QPSK	2402	AT+SLERX=0,0,2,3,14
	2440	AT+SLERX=38,0,2,3,14
	2480	AT+SLERX=78,0,2,3,14
2M QPSK	2404	AT+SLERX=2,1,2,3,8
	2440	AT+SLERX=38,1,2,3,8
	2478	AT+SLERX=76,1,2,3,8
4M QPSK	2405	AT+SLERX=3,4,2,3,6
	2441	AT+SLERX=39,4,2,3,6
	2477	AT+SLERX=75,4,2,3,6
1M 8PSK	2402	AT+SLERX=0,0,2,3,10
	2440	AT+SLERX=38,0,2,3,10
	2480	AT+SLERX=78,0,2,3,10
2M 8PSK	2404	AT+SLERX=2,1,2,3,6
	2440	AT+SLERX=38,1,2,3,6
	2478	AT+SLERX=76,1,2,3,6
4M 8PSK	2405	AT+SLERX=3,4,2,3,6
	2441	AT+SLERX=39,4,2,3,6
	2477	AT+SLERX=75,4,2,3,6

注意事项

所有指令的参数输入格式必须为十进制

例如当包长0xFF需输入255时：

• 正确示例： AT+SLETX=0,5,255,0,1,2,2,0,0,50

• 错误示例： AT+SLETX=0,5,FF,0,1,2,2,0,0,50

说明： 参数必须是十进制。

部分指令返回值为十六进制

发送：

AT+SLETRXEND

回复：

OK

status:0x0, num_packet:0x3e8, rssi:0x81

说明： 测试RX的收报数为1000包（0x3e8)，RX的当前接收rssi为0x81，即-127dbm。

所有参数的间隔符逗号为英文字符","

示例如下：

• 正确示例：AT+SLETX=0,5,255,0,1,2,2,0,0,50

• 错误示例：AT+SLETX=0，5，55,0,1,2,2,0,0,50

  说明： 不识别中文字符逗号。

串口回复说明

图 1 串口回复示例1

图 2 串口回复示例2

说明：

• TRX射频指令测试时，串口回复重点关注“status:0“、“num_packets:3e8“、“rssi:81“等字样。

• 由于指令执行时序异步，“OK“和其他业务上报打印的先后顺序不是固定的，且涉及BLE/SLE TRX业务的指令，回复”OK”不代表指令正常执行。

星闪协议频点表

星闪协议拼点如图1和图2所示。

图 1 2400MHz频段不同带宽信道对应的射频信道中心频率和射频信道号1

图 2 2400MHz频段不同带宽信道对应的射频信道中心频率和射频信道号2

说明： 注意不同带宽的射频测试项需要测的频点不同，例如SLE 4M GFSK指令，测试低频的频点为2405MHz，而不是2402MHz。