自定义 AT 数传与产测命令

自定义-数传相关

NDIS拨号：+NDISDUP

命令描述

发起NDIS拨号的命令。

命令语法

命令

返回结果

示例

+NDISDUP=<cid>,<connect>

拨号成功：

+NDISSTAT: <cid>,<stat>,<PDP_type>

拨号失败或者断开拨号：

+NDISDUP:<cid>,<error code>

AT+NDISDUP=1,1

OK

拨号成功：

+NDISSTAT: 1,1,"IPV4"

拨号失败：

+NDISDUP:1,0

+NDISDUP=?

+NDISDUP: (list of supported <cid>s),(list of supported <connect>s)

AT+NDISDUP=?

+NDISDUP: (0-10),(0-1)

OK

参数描述

参数

描述

<cid>

整数类型；PDP上下文标识符，取值范围0～10。

若核心网仅支持单栈模式，配置IPv4v6类型的承载，IPv6承载会使用第二路cid激活，cid范围为21～30。

整型值，设置连接状态。取值如下：

0：断开连接；

1：建立连接。

NDIS拨号失败原因值。

1：EMS承载激活失败或者已去激活。

E5模式下，内置拨号成功后（如果是IPv6，则必须拿到网侧分配前缀），使用与内置拨号相同cid发起NDIS拨号，会把内置拨号自动转为NDIS E5拨号；转换失败则会在串口上报+HANDOVER NDIS E5 FAIL。

NDIS拨号STICK模式主动上报：+NDISSTAT

命令描述

当NDIS拨号成功时，MT主动上报此指示给TE，只有当NDIS拨号成功才会有此上报，拨号失败会上报+NDISDUP：<cid>,<error code>。

命令语法

命令	返回结果	示例
-	+NDISSTAT: <cid>,<stat>,<PDP_type>	+NDISSTAT: 1,1,"IPV4"

参数描述

参数

描述

<cid>

整数类型；PDP上下文标识符，取值范围：0～10。

若核心网仅支持单栈模式，配置IPv4v6类型的承载，IPv6承载会使用第二路cid激活，cid范围为21～30。

<stat>

整型值，连接状态。

0：连接断开；

1：已连接；

<PDP_type>

取值为字符串。

"IPV4"

"IPV6"

NDIS拨号E5模式主动上报：+NDISE5STAT

命令描述

当NDIS拨号成功时，MT主动上报此指示给TE，只有当NDIS拨号成功才会有此上报，拨号失败会上报+NDISDUP：<cid>,<error code>。

命令语法

命令	返回结果	示例
-	+NDISE5STAT: <cid>,<stat>,<PDP_type>	+NDISE5STAT: 1,1,"IPV4"

参数描述

参数

描述

<cid>

整数类型；PDP上下文标识符，取值范围：0～10。

若核心网仅支持单栈模式，配置IPv4v6类型的承载，IPv6承载会使用第二路cid激活，cid范围为21～30。

<stat>

整型值，连接状态。

0：连接断开；

1：已连接；

<PDP_type>

取值为字符串。

"IPV4"

"IPV6"

获取数传状态：+NDATATRAN

命令描述

查询当前数传状态。

命令语法

命令

返回结果

示例

+NDATATRAN?

+NDATATRAN: <n>

AT+NDATATRAN?

+NDATATRAN: 1

OK

+NDATATRAN=?

-

AT+NDATATRAN=?

OK

参数描述

参数	描述
<n>	整型值。 0：表示数传未进行； 1：表示数传进行中。

Modem保活：+NKEEPALIVE

命令描述

发起Modem保活的命令。开启保活功能后，模组会根据AT命令设置的参数定期给远端发送TCP/UDP数据包。

命令语法

命令

返回结果

示例

+NKEEPALIVE=<mode>,[<remote ip address>[,<remote port>[,<type>[,<timer>[,<length>[,<data>]]]]

-

错误情况：

+CME ERROR: <err>

AT+NKEEPALIVE=1,192.158.5.1,5680,DGRAM

OK

+NKEEPALIVE=?

+NKEEPALIVE: (支持的<mode>列表),(支持的<remote ip address>列表),(支持的<remote port>范围),(支持的<type>列表),(支持的<timer>列表),(支持的<length>列表),(支持的<data>列表)

AT+NKEEPALIVE=?

+NKEEPALIVE: (0,1),,(0-65535),("DGRAM","STREAM"),(1-60),(1-500),,

OK

参数描述

参数	描述
<mode>	整型值，取值如下： 0：关闭Modem保活； 1：打开Modem保活。
<remote ip address>	连接到的远程IP地址。
<remote port>	0～65535范围内的数字，这是接收消息的远程端口。
<type>	socket类型。DGRAM用于UDP，STREAM用于TCP，默认UDP。
<timer>	周期发送时间，单位：分钟，范围：1～60，默认5分钟。
<length>	要发送的数据的十进制长度，范围：1～500，默认长度32Byte。
<data>	以十六进制字符串格式或带引号的字符串格式传输的数据，默认随机值。

获取上下行速率：+NDATARATE

命令描述

获取设定时间内的平均每秒传输字节。

命令语法

命令

返回结果

示例

+NDATARATE=<mode>,<time>

返回速率查询结果（上报设定时间内平均每秒的传输字节数）

+NDATARATE_UL: <result>

+NDATARATE_DL: <result>

错误情况：

+CME ERROR: <err>

AT+NDATARATE=2,10

OK

+NDATARATE_UL: 254822

+NDATARATE_DL: 668045

错误情况：

+NDATARATE: FAIL

+NDATARATE=?

+NDATARATE: (支持的<mode>列表)(支持的<time>范围)

AT+NDATARATE=?

+NDATARATE: (0,1,2),(1-3600)

OK

参数描述

参数

描述

<mode>

整型值，取值如下：

0：获取上行速率；

1：获取下行速率；

2：获取上下行速率。

<time>

1～3600范围内的数字，需要统计速率的时间（单位：秒）。

设定时间内平均每秒的传输字节数（单位：Byte）。

实现说明

如果在查询过程中关机或重启，不会上报速率。

智能选卡：+NIPCSET

命令描述

分别在主副卡进行开机入网后根据对应小区的参数预估上行速率，选择上行速率相对高的卡进行入网。

选卡后入网成功，会启动迟滞定时器，定时器超时后会上报“迟滞定时器超时主动上报切卡建议：+NIPCSUGGEST”章节中的切卡建议。

说明： 需同时打开宏SUPPORT_IPC_AUTO_SWITCH_CARD 和 SUPPORT_SIM1_HOT_PLUG

命令语法

命令

返回结果

示例

+NIPCSET

+NIPCSET: <select_card_id>,<usim0_presence>,<usim0_duplex_mode>,<ul_thp_level_0>,< usim1_presence >,<usim0_duplex_mode>,< ul_thp_level_1>

OK

错误情况：

+CME ERROR: <err>

AT+NIPCSET

+NIPCSET: 0,1,0,1,1,0,1

OK

错误情况：

AT+NIPCSET

+CME ERROR: 30

+NIPCSET: 0,1,0,0,1,0,0

AT+NIPCSET

+NIPCSET: 0,0,0,0,1,0,0

+CME ERROR: 10

参数描述

参数	描述
<select_card_id>	整型值，选择卡槽ID。 0：卡槽0； 1：卡槽1。
<usim0_presence>	整型值，卡0在位情况。 0：不在位； 1：在位。
<usim0_duplex_mode>	整型值，卡0小区制式。 0：fdd； 1：tdd。
<ul_thp_level_0>	整型值，卡0上行预估速率档位。有效值1～5，档位越高预估速率越高。无效值为0，此时小区制式也无效。
<usim1_presence>	整型值，卡1在位情况。 0：不在位； 1：在位。
<usim1_duplex_mode>	整型值，卡1小区制式。 0：fdd； 1：tdd。
<ul_thp_level_1>	整型值，卡1上行预估速率档位。有效值为1～5，档位越高预估速率越高。无效值为0，此时小区制式也无效。

实现说明

仅支持在attach之前执行该命令。
如果小区信号较差入网时间可能较长，时长可配，请参见“控制IPC智能选卡中最长搜网时长配置：+NIPCREGTIME”章节。
如果两个卡槽都没有卡或者没有注册成功的卡，则不会启动迟滞定时器。
如果“控制迟滞定时器开关时长及预估速率折算系数配置：+NIPCLEN”章节中定时器配置关闭，则不会启动迟滞定时器。

查询主副卡上行预估速率：+NULTHP

命令描述

查询当前主卡驻留服务小区的预估上行速率和副卡上行预估速率历史值

说明： 若未同时打开宏SUPPORT_IPC_AUTO_SWITCH_CARD和SUPPORT_SIM1_HOT_PLUG，仅显示主卡信息。

命令语法

命令

返回结果

示例

+NULTHP?

+NULTHP: <primary_card_bandwidth>,<primary_card_duplex_mode>,<primary_ul_thp_level>,<secondary_card_bandwidth>,<secondary_card_duplex_mode>,< secondary_ul_thp_level>,<buffer_ratio>

同时打开以上两个宏的场景下：

AT+NULTHP?

+NULTHP: 5,0,5,5,0,4,85

未同时打开以上两个宏的场景下：

AT+NULTHP?

+NULTHP: 5,0,5,,,,85

参数描述

参数	描述
<primary_card_bandwidth>	整型值，主卡服务小区带宽，单位：MHz。未注册成功时查询为0。
<primary_card_duplex_mode>	整型值，主卡服务小区制式。 0：fdd； 1：tdd。
<primary_ul_thp_level>	整型值，主卡服务小区预估速率档位。有效值为1～5，档位越高预估速率越高。无效值为0，此时小区制式也无效。
<secondary_card_bandwidth>	整型值，副卡历史驻留小区带宽，单位：MHz。副卡之前未注册成功查询为0。
<secondary_card_duplex_mode>	整型值，副卡历史驻留小区制式。 0：fdd； 1：tdd。
< secondary_ul_thp_leve>	整型值，副卡历史驻留小区预估速率档位。有效值为1～5，档位越高预估速率越高。无效值为0，此时小区制式也无效。
<buffer_ratio>	整型值，主卡服务小区上行缓存比例（上行使用缓存/上行丢包门限×100）。有效值1~100。

实现说明

主卡是根据当前小区参数实时计算的预估值，副卡是本次硬上电之后上次使用副卡驻留的预估值。

迟滞定时器超时主动上报切卡建议：+NIPCSUGGEST

命令描述

迟滞定时器超时时，根据主副卡速率对比结果上报切卡建议；如果速率对比适合切卡，则上报建议切卡，否则上报不建议切卡。

说明： 需同时打开宏SUPPORT_IPC_AUTO_SWITCH_CARD 和 SUPPORT_SIM1_HOT_PLUG。

命令语法

命令

返回结果

示例

-

+NIPCSUGGEST: <is_switch>,[<usim_id>],[<error_reason>]

+NIPCSUGGEST: 1,1,

+NIPCSUGGEST: 0,,1

参数描述

参数

描述

<is_switch >

整型值，建议是否切卡。

0：建议不切卡；

1：建议切卡。

<usim_id >

整型值，当<is_switch >为1时有效，为另一个卡槽的id。<is_switch >为0时为空。

0：卡槽0；

1：卡槽1。

<error_reason>（原因值可添加）

整型值，当<is_switch >为0时有效，当<is_switch >为1时为空。

1：当前主卡速率平稳，不建议切卡。

控制迟滞定时器开关时长及预估速率折算系数配置：+NIPCLEN

命令描述

控制（启动、重启或关闭）迟滞定时器，并可设置迟滞定时器时长及预估速率折算比例系数。

说明： 需同时打开宏SUPPORT_IPC_AUTO_SWITCH_CARD 和 SUPPORT_SIM1_HOT_PLUG。

命令语法

命令

返回结果

示例

+NIPCLEN=<time_len>[,<net_convert>]

OK

错误情况：

+CME ERROR: <err>

AT+NIPCLEN=5,9

OK

+NIPCLEN?

+NIPCLEN: <time_len>,<net_convert>

错误情况：

+CME ERROR: <err>

AT+NIPCLEN?

+NIPCLEN: 5,9

OK

+NIPCLEN=?

+NIPCLEN: (list of supported <time_len>),(list of supported<net_convert>)

错误情况：

+CME ERROR: <err>

AT+NIPCLEN=?

+NIPCLEN: (0-1440),(1-10)

OK

+NIPCLEN

OK

错误情况：

+CME ERROR: <err>

AT+NIPCLEN

OK

参数描述

参数

描述

<time_len>

整型值，迟滞定时器时长及周期检测开关，默认：60，取值范围：0～1440，单位：min。

0：表示关闭定时器。

≥1：表示启动定时器，数字大小表示定时器时长。

<net_convert>

整型值，预估速率折算配比系数，默认值：10，取值范围：1～10。

n表示折算比为n×10%。

实现说明

当定时器时长设置为0时，则停止迟滞定时器，并且不再启动迟滞定时器。
当定时器时长不为0时，设置定时器时长，并重启定时器。
AT+NIPCLEN，是用配置的时长启动/重启定时器。
折算配比系数，按照折算比例为0.1×n对当前计算的小区预估速率进折算，默认为10，即不进行折算。
配置不写NV。

控制IPC智能选卡中最长搜网时长配置：+NIPCREGTIME

命令描述

设置IPC选卡过程中发起注册后到等待注册结果的定时器时长。

说明： 需同时打开宏SUPPORT_IPC_AUTO_SWITCH_CARD和SUPPORT_SIM1_HOT_PLUG。

命令语法

命令

返回结果

示例

+NIPCREGTIME=<time_len>

OK

错误情况：

+CME ERROR: <err>

AT+NIPCREGTIME=5

OK

+NIPCREGTIME?

+NIPCREGTIME: <time_len>

错误情况：

+CME ERROR: <err>

AT+NIPCREGTIME?

+NIPCREGTIME: 5

OK

+NIPCREGTIME=?

+NIPCREGTIME: (list of supported <time_len>)

错误情况：

+CME ERROR: <err>

AT+NIPCREGTIME=?

+NIPCLEN: (1-3600)

OK

参数描述

参数	描述
<time_len>	整型值，发起注册后到等待注册结果的最长时间，默认值：30 ，取值范围：1～3600，单位：s。

实现说明

定时器超时就认为当前正在注册的卡入网失败。

配置不写NV。

SPI网卡拨号：+SPINIC

说明： SPI网卡拨号需打开宏SUPPORT_SPI_NIC，SPI网卡拨号与PPP E5拨号和RNDIS E5拨号互斥。

命令描述

SPI网卡承载上下文激活/去激活。

该命令支持<cid>0~10对应的PDP上下文激活，支持SPINIC激活的PDP上下文去激活，支持SPINIC激活的PDP上下文查询状态。

命令语法

命令

返回结果

示例

+SPINIC=<state>,<cid>

-

错误情况：

+CME ERROR: <err>

AT+SPINIC=0,1

OK

+SPINIC?

[+SPINIC:<cid>,<state>]

[<CR><LF>+SPINIC:<cid>,<state>

[...]]

+CME ERROR: <err>

AT+SPINIC?

+SPINIC: 1,1

OK

+SPINIC=?

+SPINIC: (list of supported <state>s)

+CME ERROR:<err>

AT+SPINIC=?

+SPINIC: (0,1)

OK

参数描述

参数

描述

<state>

整数类型；表示PDP上下文激活的状态。默认值为制造商特定。

0：去激活；

1：激活。

<cid>

整数类型；PDP上下文标识符，set命令只支持激活激活<cid>0～10对应的承载，支持去激活<cid>0～17对应的承载，查询命令可查询到<cid>0~17的状态。

实现说明

最多支持激活8路承载（参见3GPP TS 36.331 R14 subclause 11.1 UE capability related constraints中DRB数量的定义）

设置速率模式：+NRATEMODE

命令描述

设置速率模式。

说明： 设置速率模式时，当effective_type等于0或缺省时需重新启动芯片生效。

命令语法

命令

返回结果

示例

+NRATEMODE=<mode>[,<effective_type>]

OK

错误情况：

+CME ERROR: <err>

AT+NRATEMODE=1

OK

+NRATEMODE?

+NRATEMODE: <mode>

错误情况：

+CME ERROR: <err>

AT+NRATEMODE?

+NRATEMODE: 1

OK

+NRATEMODE=?

+NRATEMODE: (list of supported <mode>)

错误情况：

+CME ERROR: <err>

AT+NRATEMODE=?

+NRATEMODE: (0,1)

OK

参数描述

参数

描述

<mode>

取值范围：0～1。

0：高速模式；

1：低速模式。

低速模式下当业务速率超规格时，可能会出现由于申请内存失败而导致的系统自愈复位，请严格按照规格使用。

<effective_type>

配置生效类型：0~1。

0：该参数为0时，配置写入到NV中，需要重启芯片生效；

1：该参数为1时，配置不写入NV，该命令只能在CFUN=0时执行，否则返回错误；芯片重启后使用NV中的mode配置值生效。

该参数缺省时，配置默认写入NV。

设置上行内存流控门限：+NFCMEMBYTE

命令描述

设置上行内存流控门限，触发流控后会丢弃上行数据包。

命令语法

命令

返回结果

示例

+NFCMEMBYTE=<byte>

OK

错误情况：

+CME ERROR: <err>

AT+NFCMEMBYTE=110

OK

+NFCMEMBYTE?

+NFCMEMBYTE: <byte>

错误情况：

+CME ERROR: <err>

AT+NFCMEMBYTE?

+NFCMEMBYTE: 110

OK

+NFCMEMBYTE=?

+NFCMEMBYTE: (list of supported <byte>)

错误情况：

+CME ERROR: <err>

AT+NFCMEMBYTE=?

+NFCMEMBYTE: (90-110)

OK

参数描述

参数

描述

<byte>

取值范围：90～110，单位：KB，默认90。

配置命令只能用于高速模式，必须在开机状态下配置，配置后立刻生效。

上行预估速率上报：+NRATEADAPT

命令描述

支持周期性上报上行预估速率，单位为Byte/s。由码率自适应宏SUPPORT_RATE_ADAPT控制。

命令语法

命令	返回结果	示例
+NRATEADAPT=<time_len>	OK	AT+NRATEADAPT=0 OK
+NRATEADAPT?	+NRATEADAPT: <time_len> OK	AT+NRATEADAPT? +NRATEADAPT: 0 OK
+NRATEADAPT=?	+NRATEADAPT: (list of supported <time_len>) OK	AT+NRATEADAPT=? +NRATEADAPT: (0-5s) OK
+NRATEADAPT	+NRATEADAPTULTHP: <next_ul_thp>（单位Byte/s） OK	AT+NRATEADAPT +NRATEADAPTULTHP: 1000 OK

参数描述

参数

描述

<time_len>

取值范围：0～5，单位：s，默认0。

配置为1～5时，按配置值周期性上报预估速率；配置为0时，不周期上报预估速率。

<next_ul_thp>

预估速率，单位：Byte/s。

码率自适应参数配置：+NRATEADAPTPARA

命令描述

支持码率自适应相关参数的配置、查询。由码率自适应宏SUPPORT_RATE_ADAPT控制。

命令语法

命令

返回结果

示例

+NRATEADAPTPARA=[<filter_factor>,<buffer_ratio_coeff>,<buffer_size>,<query_time>]

OK

AT+NRATEADAPTPARA=80,13,100,4

OK

+NRATEADAPTPARA?

+NRATEADAPTPARA: <filter_factor>,<buffer_ratio_coeff>,<buffer_size>,<query_time>

OK

AT+NRATEADAPTPARA?

+NRATEADAPTPARA: 80,13,100,4

OK

+NRATEADAPTPARA=?

+NRATEADAPTPARA: (list of supported <filter_factor>,<buffer_ratio_coeff>,<buffer_size>,<query_time>)

OK

AT+NRATEADAPTPARA=?

+NRATEADAPTPARA: (0-100), (0-100), (0-100), (1-20)

OK

参数描述

参数	描述
<filter_factor>	滤波因子，取值范围0～100；默认值0.8（扩大100倍取整数后为80）。
<buffer_ratio_coeff>	缓存比例系数，取值范围0～100；默认取值为0.13（扩大100倍取整数后为13）。
<buffer_size>	缓存大小，取值范围0～100；默认取值为1（扩大100倍取整数后为100）。
<query_time>	速率统计周期，单位：s，取值范围0～20s；默认取值为4s。

主动释放连接：+NNMPSD

命令描述

执行命令发送释放连接命令,该命令表示MT上的应用程序不期望进行数据交换

对于可能的<err>取值，请参见“错误码”章节。

命令语法

命令

返回结果

示例

+NNMPSD=<mode>

-

错误情况：

+CME ERROR: <err>

AT+NNMPSD=1

OK

+NNMPSD=?

-

AT+NNMPSD=?

+NNMPSD:(1,2)

OK

参数描述

参数

描述

<mode>

整数类型，表示释放方式。

1：本地释放；

2：协商释放。

实现说明

明确后续没有业务后执行该命令。
命令发送结果可以使用+CSCON?来确认。

产测 AT 命令

读取芯片类型：+NCHIPTYPE

命令描述

该命令用来读取芯片的类型。它定义了产品形态。此efuse用于指示标记ID，并被SW用于定义不同的产品形态。

对于可能的<err>取值，请参见“错误码”章节。

命令语法

命令

返回结果

示例

+NCHIPTYPE

+NCHIPTYPE: <chip_type>

+CME ERROR: <err>

+NCHIPTYPE: 0

OK

参数描述

参数

描述

<chip_type>

返回数值表示芯片类型。

0：CAT1；

1：reserve；

2：CAT1-TTS。

NV备份：&W

命令描述

设置命令用来将当前所有NV配置保存到备份区。

该命令用于备份密钥，以防密钥意外损坏。

该命令不应反复使用，例如，使用后很快再次使用。

最大备份次数为255次，全擦除模式下修改版本后，备份次数会被重置。

命令语法

命令

返回结果

示例

&W[<n>]

-

错误情况：

+CME ERROR: <err>

AT&W0

OK

参数描述

参数	描述↵
<n>	整数类型。 0：配置文件编号。用于存储当前的AT命令设置。

NV恢复：&F

命令描述

设置命令用来将备份区的所有初始配置恢复到NV区。该命令只能在AT&W命令执行成功后才能使用，否则会恢复为空。此命令将覆盖所有密钥，即使是永久密钥。

命令语法

命令

返回结果

示例

&F[<value>]

-

错误情况：

+CME ERROR: <err>

AT&F0

REBOOT_CAUSE_GLOBAL_RESTORE_DEFAULTS

OK

参数描述

参数

描述↵

<value>

整数类型。

0：将AT设置命令重置为出厂设置。

显示部分AT命令配置：&V

命令描述

该命令用来显示一些AT命令参数的当前设置。

命令语法

命令

返回结果

示例

&V

-

错误情况：

+CME ERROR: <err>

AT&V

OK

实现说明

当前支持显示的AT命令：AT&F、AT&W、ATE。
AT&V执行仅显示单板启动后已执行AT命令的配置，且单板复位后不保留记录。

执行无线测试命令：+NRDTEST

命令描述

该命令用来传递二进制编码的无线电测试命令到协议核用以执行，该命令仅在产线校准综测脚本中自动调用，不适用于研发手动配置。

命令语法

命令

返回结果

示例

+NRDTEST=<len>,<data>

错误情况:

+CME ERROR: <err>

AT+NRDTEST=8,0000400213020000

OK

+NRDTEST=?

-

AT+NRDTEST=?

OK

参数描述

参数	描述
<length>	发送数据的十进制长度，单位：Byte。
<data>	发送的数据，格式为由data转换成的十六进制字符串。
<response length>	二进制数据的响应长度，单位：Byte。
<response>	返回的数据，格式为十六进制字符串。

实现说明

不能与AT命令结合使用。
只能在MT关机时设置，确保在发送AT+CFUN=0后设置。

说明： NRDTEST命令中的data参数均为十六进制的小端序存储格式，需要将其转换为大端序后，再将其转换为10进制则为实际参数值。

LL1_ACTIVATE_REQ

LL1激活请求
AT+NRDTEST=8,0000400314030000

消息	字节数
message_id：54525952	uint32
src：20	uint8
dst：3	uint8
data_size：0	uint16

LL1_DEACTIVATE_REQ

LL1去激活请求
AT+NRDTEST=8,0100400314030000

消息	字节数
message_id：54525953	uint32
src：20	uint8
dst：3	uint8
data_size：0	uint16

LL1_RADIO_TEST_MODE_ENABLE

综测模式使能
AT+NRDTEST=8,0600400314030000

消息	字节数
message_id：54525958	uint32
src：20	uint8
dst：3	uint8
data_size：0	uint16

LL1_RADIO_TEST_MODE_DISABLE

综测模式去使能
AT+NRDTEST=8,0d00400314030000

消息	字节数
message_id：54525965	uint32
src：20	uint8
dst：3	uint8
data_size：0	uint16

LL1_RADIO_TEST_PDSCH_RX

PDSCH RX测试
AT+NRDTEST=436,070040031403ac010000000000000400640064006c00d3ff18000000010000000000000069000000b94600005c00000000000000000000002900000005000000007800000000001800000000000000000000000064640100300030000000000002a6c80a4004020040004000200001001501000000000000000000007b000c000900f3000100100000000000020002080600010000000000e200a00001000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000101010100015c00040000000000000000000000000906060000010003040000dd0d000030060000cc0c0000300600000008000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000029001b0400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000a050020bf0200

消息	字节数
message_id：54525959	uint32
src：20	uint8
dst：3	uint8
data_size：428	uint16
cell_mode：0（FDD=0；TDD=1；unknown=2）	uint8
cp_mode：0（normal=0；extended=1；unknown=2）	uint8
num_antenna_ports：0（1port=0；2ports=1；4ports=2）	uint8
ul_rb_num：100	uint16
p_max：24	uint32
p_min：1	uint32
dl_earfcn：105	uint32
ul_earfcn：18105	uint32

RADIO_TEST_PDSCH_RX返回值
['20,280000000000000028000000c6fb96ff3fffffff', '', 'OK']

消息	字节数
num_crc_ok：40	uint32
num_crc_fail：0	uint32
num_total：40	uint32
rsrp：-1082(单位：0.1dB)	int16
rsrq：-106(单位：0.1dB)	int16
ppbi：-193(频偏，单位1/10^-9)	int32

LL1_RADIO_TEST_PUSCH_TX

PUSCH TX测试
AT+NRDTEST=496,080040031403e8010000000000000400640064006c00d3ff1800000001000000000000002c0100007c4700005c0000000000000000000000ffffffff05000000007800000000001800000000000000000000000064640100300030000000000002a6c80a4004020040004000200001001501000000000000000000007b000c000900f3000100100000000000020002080600010000000000e200a00001000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000101010100015c00040000000000000000000000000906060000010003040000dd0d000030060000cc0c0000300600000008000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000029001b0400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000a050020bf0200026e3d0200000000e8110000000000000000000000000000000000000000000000000000000000000000000000000000004006000000000000000000

消息	字节数
message_id：54525960	uint32
src：20	uint8
dst：3	uint8
data_size：488	uint16
cell_mode：0（FDD=0；TDD=1；unknown=2）	uint8
cp_mode：0（normal=0；extended=1；unknown=2）	uint8
num_antenna_ports：0（1port=0；2ports=1；4ports=2）	uint8
ul_rb_num：100	uint16
tx_power_dbm：-45（初始发射功率-45dB，通过AT+NRDSET=TX APC调整发射功率，AT命令参考“射频配置命令集：+NRDSET”。）	sint16
p_max：24	uint32
p_min：1	uint32
dl_earfcn：300	uint32
ul_earfcn：18300	uint32
mcs：2	uint8
tb_size：573	uint16

射频配置控制命令：+NRDCTRL

命令描述

该命令用于进入无线测试模式。

命令语法

命令

返回结果

示例

+NRDCTRL=<state>

错误情况:

+CME ERROR: <err>

AT+NRDCTRL=1

OK

enter radio test

参数描述

参数

描述

<state>

整数类型，选择radio test的状态。

0：关闭；

1：激活。

字符串，无线测试状态返回。

进入测试：“enter radio test”

退出测试：“quit radio test”

实现说明

如果在”OK”后打印信息“enter radio test”，则表示进入无线测试成功，否则进入失败。
只能在关机时设置，确保在发送AT+CFUN=0后设置。

射频配置命令集：+NRDSET

命令描述

该命令用于发送不同的射频控制命令。

命令语法

命令	返回结果	示例	命令功能
+NRDSET=RX START,band,freq,bw,agc,0	0 done	AT+NRDSET=RX START,8,942500,0,7,0 OK 0 done	打开RX通路
+NRDSET=WBRSSI READ,agc_gain,times	0 rpt: rssi: done	AT+NRDSET=WBRSSI READ,7,100 OK rpt:98 rssi:-95.34 done	根据AGC档位测量RSSI
+NRDSET=TX START,band,freq,bw,power,0	0 done	AT+NRDSET=TX START,8,897500,3,23,0 OK 0 done	打开TX通路
+NRDSET=TX TONE,type,freq_offset,scale	0 done	AT+NRDSET=TX TONE,1,1500000,770 OK 0 done	发送单音
+NRDSET=TX HW SEND START,rb_num,mcs,start_rb,tb_size,dbbgain	0 done	AT+NRDSET=TX HW SEND START,6,12,0,1192,0 OK 0 done	发送调制信号
AT+NRDSET=TX APC,rf_gain,if_gain,pa_mode	0 done	AT+NRDSET=TX APC,0,19,0 OK 0 done	根据参数调整APC档位
AT+NRDSET=TX STOP	0 done	AT+NRDSET=TX STOP OK 0 done	关闭TX通路
AT+NRDSET=RX STOP	0 done	AT+NRDSET=RX STOP OK 0 done	关闭RX通路
AT+NRDSET=MIPI READ,address	0 addr:address->data:value done	AT+NRDSET=MIPI READ,30 OK 0 addr:1e->data:3d done	根据地址读取MIPI
AT+NRDSET=MIPI WRITE,address,value	0 done	AT+NRDSET=MIPI WRITE,30,10 OK 0 done	根据地址写入MIPI

参数描述

参数	描述
band	频段，可选band为1、3、5、8、34、38、39、40、41。
freq	中心频率，单位为kHz。
bw	带宽指示。 0：1.4M 1：3M 2：5M 3：10M 4：15M 5：20M
agc	AGC档位，取值为0~7。范围从18dB到60dB，步长为6dB。
agc_gain	读RSSI的AGC档位，取值为0~7。
times	测量的次数，RSSI结果取其平均值。
rpt	信号检测强度水平指示。
rssi	接收信号强度值，单位dBm，校准过后且rpt值在180~220之间可信。
power	TX 功率，单位dBm，取值-45~23。
type	单音类型。 0：关闭单音 1：发送单音 2：发送双音
freq_offset	单音频率，距离中心频点的偏移，单位Hz，必须是60kHz的整数倍。
scale	单音幅度，取值范围0~770，满幅为770。
rb_num	RB个数，不超过该带宽下的满RB。
mcs	调制等级指示，配置可参考推荐配置表。
start_rb	起始RB位置。
tb_size	TB size，需要按照RB个数和mcs查协议表格计算。
dbbgain	数字增益，一般为0，取值范围可参考推荐配置表，取值越大，调制信号功率越大，单位：1/16dB。
rf_gain	取值范围0~19，0为最大档位，19为最小档位。
if_gain	中频增益，取值范围10~26，码字越大，增益越高。
pa_mode	PA模式 0：HPM 1：MPM 2：LPM
address	读或写入的地址，格式8位无符号整数，使用时需要将地址转换成10进制。
value	写入的值，格式8位无符号整数，使用时需要将值转换成10进制。

实现说明

命令返回OK后返回0和done说明控制成功，仅有OK控制失败。
发送单音或调制信号前，都需要先发送TX START打开TX通道；测量RSSI前也需要先发送RX START。

发送单音示例如下：

AT+NRDCTRL=1

AT+NRDSET=TX START,8,897500,3,23,0

AT+NRDSET=TX TONE,1,1500000,770

发送调制信号示例如下：

AT+NRDCTRL=1

AT+NRDSET=TX START,8,897500,3,23,0

AT+NRDSET=TX HW SEND START,6,12,0,1192,0

开启RX测RSSI示例如下：

AT+NRDCTRL=1

AT+NRDSET=RX START,8,942500,0,7,0

AT+NRDEXEC=RX DC CALI(校准DC)

AT+NRDSET=WBRSSI READ,7,100

发送单音或调制信号后，可调APC功率，以单音为例：

AT+NRDCTRL=1

AT+NRDSET=TX START,8,897500,3,23,0

AT+NRDSET=TX TONE,1,1500000,770

AT+NRDSET=TX APC,0,19,0

mcs推荐配置如下表：

配置	1.4M	3M	5M	10M	15M	20M
rb_num	6	10	25	50	75	100
mcs	12	22	12	6	3	2
tb_size	1192	4584	4968	5160	4392	4584
dbbgain	0～93	0～80	0～96	0～96	0～76	0～96

射频配置执行命令：+NRDEXEC

命令描述

该命令用于执行各项校准命令，该命令仅在产线校准综测脚本中自动调用，不适用于研发手动配置。

命令语法

命令

返回结果

示例

+NRDEXEC=<cmd>,<list>

错误情况:

+CME ERROR: <err>

AT+NRDEXEC= RX DC CALI

参数描述

参数	描述
<cmd>	字符串，用于选择不同校准项的执行命令。
<list>	十六进制字符串，可选参数。

更新Radioconfig数据：+NRCUPD

命令描述

该命令用来更新设备上的“radioconfig.tlv”文件。

命令语法

命令

返回结果

示例

+NRCUPD=<cmd>[,<len>,<data>]

错误情况:

+CME ERROR: <err>

擦除Rdioconfig数据
AT+NRCUPD=0

OK

erase radioconfig file ok

写入2字节Rdioconfig数据
AT+NRCUPD=1,2,1A0B

OK

参数描述

参数	描述
<cmd>	整数类型。 0：擦除radioconifg数据； 1：写入radioconfig数据。 2：重新加载radioconfig。
<len>	表示数据长度，单位：Byte。最大长度1024。
<data>	传输的数据，格式为十六进制字符串。
<result>	字符串，擦除/写入操作结果上报。擦除成功上报："erase radioconfig file ok" 擦除失败上报："erase radioconfig file fail" 写入成功上报："update radioconfig file success, curr size:当前已写入字节数!" 写入失败上报："update radioconfig file fail" 重新加载成功上报："SUCCESSFULLY RELOAD" 重新加载上报失败："FAILED RELOAD"

实现说明

该命令仅适用于radioconfig数据回写过程。已经整合入生成线的calibrate_tools脚本中。请不要在其他场景下使用，否则会有“radioconfig.tlv”文件被损坏的风险。
确保在执行AT+NRCUPD=0成功后再使用写入命令更新radioconfig数据。

如果在“OK”后打印信息“update radioconfig file success,curr size:xxx”，则表示数据写入成功，否则写入失败。

金板数据读写命令: +NGOLD

命令描述

该命令用于执行各项校准命令，该命令仅在产线校准综测脚本中自动调用，不适用于研发手动配置。

命令语法

命令

返回结果

示例

+NGOLD=<data>

OK

错误情况:

+CME ERROR: <err>

AT+NGOLD=00

OK

+NGOLD?

<data>

AT+NGOLD?

<data>

OK

AT+NGOLD?

NO DATA SAVED.

OK

参数描述

参数	描述
<data>	十六进制字符串，长度为2的倍数。

按照log所属模块控制log输出：+NLOGMODFT

命令描述

该命令用来按照log等级进行过滤log。

命令语法

命令

返回结果

示例

+NLOGMODFT=<module>,<is_dest_module>,<enable>

-

错误情况：

+CME ERROR: <err>

AT+NLOGMODFT=27,1,0

OK

参数描述

参数

描述

模块ID。

<is_dest_module>

标记是源模块或目的模块。

0：源模块；

1：目标模块。

是否使能输出。

0：去使能；

1：使能。

表 1 module id对应表

module id	module	module id	module	module id	module	module id	module	module id	module
0	LAYER_INVALID	6	LAYER_RLC_UL	12	LAYER_EMM	18	LAYER_LPP	24	LAYER_PROTO
1	LAYER_CBB	7	LAYER_RLC_DL	13	LAYER_ESM	19	LAYER_SMS	25	LAYER_NAS
2	LAYER_CBB_TPU	8	LAYER_L2_UL	14	LAYER_MMC	20	LAYER_AT	26	LAYER_APP
3	LAYER_PHY	9	LAYER_L2_DL	15	LAYER_TAF	21	RESERVE	27	LAYER_UICC
4	LAYER_MAC_UL	10	LAYER_PDCP	16	LAYER_LWIP	22	RESERVE	28	LAYER_ROHC
5	LAYER_MAC_DL	11	LAYER_RRC	17	LAYER_USIM	23	LAYER_LOG	29	LAYER_UE

实现说明

module id有效值为0～29。