跳转至

自定义 AT 安全与终端命令

自定义-安全管理

PIN操作:+NPIN

命令描述

设置命令用于验证、更改、启用、禁用或解锁PIN。当PIN命令执行完成时,将收到未经请求的结果。

注1:SIM PIN、SIM PUK指UICC上所选应用程序的PIN。例如,在UTRAN上下文中,当前选择的UICC上的选择的应用应该是USIM,并且SIM PIN代表选择的USIM的PIN。有关UICC上应用程序选择的更多详细信息,请参考3GPP TS 31.101 [65]。

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

命令语法

命令

返回结果

示例

+NPIN=<command>,<parameter1>[,< parameter2>]

+NPIN: <npin result>

错误情况:

+CME ERROR: <err>

AT+NPIN=0,29102394

OK

+NPIN: OK

+NPIN=?

+NPIN: (支持的<command>列表)

AT+NPIN=?

+NPIN: (0,1,2,3,4)

OK

参数描述

参数

描述

<command>

command可使用0~4,不同command对应功能如下:

0,<pin>:验证PIN。

1,<old pin>,<new pin>:更改PIN。

2,<pin>:启用PIN。

3,<pin>:禁用PIN。

4,<puk>,<new pin>:解锁PIN。

<pin>,<old pin>,<new pin>

十进制字符串格式,最小长度为4,最大长度为8。<old pin>应与用户设定的密码相同,<new pin> 是新密码。

<puk>

十进制字符串格式,字符串长度为8。

<npin result>

"OK"

"PIN already enabled"

"ERROR PIN disabled"

"ERROR wrong PIN <pin retries remaining>"

"ERROR PIN blocked"

"ERROR wrong PUK <puk retries remaining>"

"ERROR PUK blocked"

"ERROR wrong format"

"ERROR"

<pin retries remaining>

十进制类型,PIN重试剩余次数。如果重试次数用完,则PIN被锁定,需要输入+npin=4,<puk>,<new pin>来解锁PIN。

<puk retries remaining>

十进制类型,PUK重试剩余次数。如果重试次数用完,则PUK被锁定并且SIM卡被完全锁定。

实现说明

PIN操作命令需要在开机状态执行。

配置锁卡密码:+SETHWLOCK

命令描述

该命令主要用于设定SIMLOCK功能解锁密码。

命令语法

命令

返回结果

示例

+SETHWLOCK=<unlock_code>

-

错误情况:

+CME ERROR: <err>

AT+SETHWLOCK=12345678

OK

+SETHWLOCK=?

-

AT+SETHWLOCK=?

OK

参数描述

参数

描述

<unlock_code>

该数据卡的解锁码,长度为8的字符串,由数字[0, 9]组成。

注意: 锁卡密码不允许修改,即只能设置一次。

SIM卡解锁:+CARDLOCK

命令描述

该命令主要用于对MT进行解锁,即如果发现当前使用SIM/USIM卡不是运营商指定SIM/USIM卡,那么要求用户输入unlock_code,否则将不能够使用该数据卡。

在用户输入10次不正确的unlock_code后,将永久锁定该数据卡,即永远不能够使用非运营商指定的SIM/USIM卡,如果为运营商指定的SIM/USIM卡,仍然可以正常使用。

命令语法

命令

返回结果

示例

+CARDLOCK=<unlock_code>

-

错误情况:

+CME ERROR: <err>

AT+CARDLOCK=12345678

OK

+CARDLOCK?

+CARDLOCK: <status>,<times>

AT+CARDLOCK?

+CARDLOCK: 1,8

+CARDLOCK=?

-

AT+CARDLOCK=?

OK

参数描述

参数

描述

<unlock_code>

该数据卡的解锁码,长度为8的字符串,由数字[0, 9]组成。

<status>

整型值,表示当前的数据卡的状态,取值1~4。

1:需要用户提供<unlock_code>;

2:不需要用户提供<unlock_code>;

3:数据卡已经被锁定;

4:SIMLOCK配置错误。

<times>

整型值,范围是[0, 10],表示剩余的可尝试解锁码的次数。最多可尝试次数是10次。

实现说明

需要使用sethwlock设置密码后才能校验。

验证过后,需要重启,生效解除SIMLOCK配置。

SIMLOCK激活和查询:+SIMLOCK

命令描述

该命令用于激活,查询SIMLOCK功能。

命令语法

命令

返回结果

示例

+SIMLOCK=<mode>,<check_len>,<begin>,<end>[[,<check_len>,<begin>,<end>]...[,<check_len>,<begin>,<end>]]

-

错误情况:

+CME ERROR: <err>

AT+SIMLOCK=1,5,46001,46002,6,460010,460020

OK

+SIMLOCK?

+SIMLOCK: <mode>

+SIMLOCK: <intervals_num>

+SIMLOCK: <index>,<check_len>,<begin>,<end>

AT+SIMLOCK?

+SIMLOCK: 1

+SIMLOCK: 2

+SIMLOCK: 1,5,46001,46002

+SIMLOCK: 2,6,460010,460020

+SIMLOCK=?

+SIMLOCK: (支持的<mode>列表)

AT+SIMLOCK=?

+SIMLOCK: (1,2)

OK

参数描述

参数

描述

<mode>

整型:配置模式取值[0,2]。

0:SIMLOCK未使能(AT命令配置时,不可配置为0);

1:黑名单模式;

2:白名单模式。

<intervals_num>

整型:取值[0,20]。

表示配置了几组IMSI,最大支持20组(由于框架限制,AT命令最多可配置10组)。

<index>

号段索引。

<check_len>

整型:检查IMSI的长度取值[1,15]。

<begin>

IMSI开始号段,为0~9数字组成的数组,最长15位。

<end>

IMSI结束号段,为0~9数字组成的数组,最长15位。

自定义-终端管理

UE功能配置:+NCONFIG

命令描述

此命令允许配置UE行为的某些方面。输入一个函数和一个控制该函数操作的值。

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

命令语法

命令

返回结果

示例

+NCONFIG=<function>,<value>

-

错误情况:

+CME ERROR: <err>

AT+NCONFIG=AUTOCONNECT,APP

OK

+NCONFIG?

+NCONFIG: <function>,<value>

[+NCONFIG: <function>,<value>

[..]]

+NCONFIG: AUTOCONNECT,APP

+NCONFIG: NAS_SIM_POWER_SAVING_ENABLE,TRUE

+NCONFIG: RPM,FALSE

+NCONFIG: SYNC_TIME_PERIOD,0

+NCONFIG: IPV6_GET_PREFIX_TIME,65535

+NCONFIG: PCO_IE_TYPE,PCO

+NCONFIG: T3324_T3412_EXT_CHANGE_REPORT,TRUE

+NCONFIG: SUPPORT_SMS,TRUE

+NCONFIG: HPPLMN_SEARCH_ENABLE,TRUE

+NCONFIG: POWER_OFF_GUARD_TIME,0

+NCONFIG: HEAD_COMPRESS,TRUE

+NCONFIG: SEMI_PERSISTENT_SCHEDULING,TRUE

+NCONFIG: CELL_RESELECTION,TRUE

+NCONFIG: AC_BARRING_CHECK_SKIPPING,FALSE

+NCONFIG: CONNECTED_MEASUREMENTS,TRUE

+NCONFIG: DISABLE_PDCP_DISCARD,FALSE

+NCONFIG: SINR_BASED_RESELECTION,TRUE

OK

+NCONFIG=?

+NCONFIG: (<function>,(支持的<value>列表)

[+NCONFIG: (<function>,(支持的<value>列表)

[,...]]

+NCONFIG: (AUTOCONNECT,(NULL,APP,NDIS))

+NCONFIG: (NAS_SIM_POWER_SAVING_ENABLE,(FALSE,TRUE))

+NCONFIG: (RPM,(FALSE,TRUE))

+NCONFIG: (SYNC_TIME_PERIOD,(0-65535))

+NCONFIG: (IPV6_GET_PREFIX_TIME,(0-65535))

+NCONFIG: (PCO_IE_TYPE,(PCO,EPCO))

+NCONFIG: (T3324_T3412_EXT_CHANGE_REPORT,(FALSE,TRUE))

+NCONFIG: (SUPPORT_SMS,(FALSE,TRUE))

+NCONFIG: (HPPLMN_SEARCH_ENABLE,(FALSE,TRUE))

+NCONFIG: (POWER_OFF_GUARD_TIME,(0-5))

+NCONFIG: (HEAD_COMPRESS,(FALSE,TRUE))

+NCONFIG: (SEMI_PERSISTENT_SCHEDULING,(FALSE,TRUE))

+NCONFIG: (CELL_RESELECTION,(FALSE,TRUE))

+NCONFIG: (AC_BARRING_CHECK_SKIPPING,(FALSE,TRUE))

+NCONFIG: (CONNECTED_MEASUREMENTS,(FALSE,TRUE))

+NCONFIG: (DISABLE_PDCP_DISCARD,(FALSE,TRUE))

+NCONFIG: (SINR_BASED_RESELECTION,(FALSE,TRUE))

OK

参数描述

参数

描述

<function>

需要配置的UE功能。

  • AUTOCONNECT:控制平台是否在重启后自动尝试连接网络。启用时,将自动开机,并从SIM卡读取PLMN,且使用cid0的APN(如果定义了的话)启动搜网。

    NULL:关闭自动拨号;

    APP:自动内置拨号;

    NDIS:自动外置NDIS拨号(默认STICK模式,E5模式需要配置NV,请参见《HiDiTingV100 2131E NV 用户指南》“USB”章节)。

  • NAS_SIM_POWER_SAVING_ENABLE:启用/禁用SIM卡省电模式。默认为TRUE,设置为FALSE影响IDLE态功耗。
  • RPM:启用/禁用RPM。
  • SYNC_TIME_PERIOD:从eNB同步的时间周期。单位:min;范围为0~65535。

    0:关闭同步时间。

  • IPV6_GET_PREFIX_TIME:设置内置拨号主动获取IPv6前缀的等待时间。单位:秒,范围为0~65535。

    0:立即主动获取IPv6前缀;

    65535:不主动获取IPv6前缀。

  • PCO_IE_TYPE:PCO IE类型。支持“PCO”和“EPCO”。使用移动卡时,若需要使用域名解析服务,建议将PCO IE类型改为“PCO”。
  • T3324_T3412_EXT_CHANGE_REPORT:当<Active-Time>或<Periodic-TAU>的NAS定时器更改时,启用/禁用显示+CEREG=5对应的AT上报。
  • SUPPORT_SMS:启用/禁用SMS。
  • HPPLMN_SEARCH_ENABLE:启用/禁用HPPLMN搜索。
  • POWER_OFF_GUARD_TIME:设置关机保护时间值,单位:秒。默认值5。
  • HEAD_COMPRESS:启动/禁用报头压缩,不支持配置为TRUE,默认TRUE值不生效。
  • SEMI_PERSISTENT_SCHEDULING:是否支持SPS。
  • CELL_RESELECTION:开启/关闭空闲态测量和小区重选,默认为TRUE。
  • AC_BARRING_CHECK_SKIPPING:是否跳过AC barring检查,默认为FALSE。
  • CONNECTED_MEASUREMENTS:开启/关闭连接态测量和小区切换,默认为TRUE。
  • DISABLE_PDCP_DISCARD:是否忽略丢包定时器配置,将discard period设为infinity,默认为FALSE。
  • SINR_BASED_RESELECTION:是否使用基于信噪比的重选策略覆盖标准重选规则,默认为TRUE。

<value>

配置功能对应的参数值。

实现说明

  • NAS_SIM_POWER_SAVING_ENABLE、SYNC_TIME_PERIOD、PCO_IE_TYPE、SUPPORT_SMS、HPPLMN_SEARCH_ENABLE、HEAD_COMPRESS、SEMI_PERSISTENT_SCHEDULING、AC_BARRING_CHECK_SKIPPING、DISABLE_PDCP_DISCARD、SINR_BASED_RESELECTION只能在关机时配置。
  • 建议在“AUTOCONNECT”为NULL且UE状态为关机时,设置好所有值。
  • CELL_RESELECTION指3GPP TS 36.133和36.304中定义的标准空闲态测量和小区重选行为。CONNECTED_MEASUREMENTS指3GPP TS 36.331中定义的标准连接态测量和小区切换行为。该两项开关可以随时开启/关闭,但关闭小区重选/切换将产生违背协议行为,严重影响UE在空闲态/连接态的移动性。仅在完全静止稳定环境下,可以谨慎考虑关闭。
  • 打开AC_BARRING_CHECK_SKIPPING后,将跳过3GPP TS 36.331中定义的AC barring,EAB,SSAC barring检查。但在显式收到网络拒绝RRCConnectionReject后,定时器T302运行期间上行接入总是不允许,AC_BARRING_CHECK_SKIPPING功能不生效。

    须知: CELL_RESELECTION、CONNECTED_MEASUREMENTS、AC_BARRING_CHECK_SKIPPING、DISABLE_PDCP_DISCARD设置为非默认值时,功能实现与协议要求不符,仅可调试使用,不允许用于量产或者商用。 SINR_BASED_RESELECTION设置为TRUE时,功能实现与协议要求不符,仅可调试使用,不允许用于量产或者商用。

省电模式状态上报:+NPSMR

命令描述

查询当前省电模式和状态,以及设置状态上报方式。

命令语法

命令

返回结果

示例

+NPSMR=<n>

-

错误情况:

+CME ERROR: <err>

AT+NPSMR=0

OK

+NPSMR?

+NPSMR: <n>[,<mode>]

错误情况:

+CME ERROR: <err>

AT+NPSMR?

+NPSMR: 1,1

OK

+NPSMR=?

+NPSMR: (list of supported <n>s)

AT+NPSMR=?

+NPSMR: (0,1)

OK

参数描述

参数

描述

<n>

整型值,主动上报方式,默认值为0。

0:禁止+NPSMR的主动上报;

1:使能+NPSMR: <mode>的主动上报。

<mode>

整型值,MT功耗模式。

0:正常模式;

1:省电模式;

2:增强型省电模式。

设置省电模式:+NPSMSET

命令描述

设置省电模式。

命令语法

命令

返回结果

示例

+NPSMSET=[<mode>]

+NPSMR: <mode>

错误情况:

+CME ERROR: <err>

AT+NPSMSET=1

OK

+NPSMR: 1

+NPSMSET=?

+NPSMSET:(list of supported <mode>s)

OK

AT+NPSMSET=?

+NPSMSET:(1,2)

OK

参数描述

参数

描述

<mode>

整数类型,设置MT的省电模式。

1:省电模式;

2:增强型省电模式。

实现说明

若在WIFISCAN优先业务期间,或者强制写文件业务期间,下发此命令,会返回错误码“+CME ERROR: 3”。

设置支持的波段:+NBAND

命令描述

此命令限制要使用的波段集。对于可能的<err>取值,请参见“错误码”章节。

命令语法

命令

返回结果

示例

+NBAND=n[,n[,n[...]]]

-

错误情况:

+CME ERROR: <err>

AT+NBAND=5,8

OK

+NBAND?

+NBAND: n[,n[,n[...]]]

AT+NBAND?

+NBAND: 5,8,28,3

OK

+NBAND=?

+NBAND: (n[,n[,n[...]]])

AT+NBAND=?

+NBAND: (1,2,3,4,5,7,8,18,19,20,26,28,34,38,39,40,41,66)

OK

参数描述

参数

描述

<n>

十进制的波段。范围为1~255。最多可以设置18个波段。

实现说明

  • AT+NBAND=? 返回支持的波段列表。
  • +NBAND设置只能在MT关机时执行。

指定搜索频率:+NEARFCN

命令描述

锁定UE工作范围到特定E-UTRAN绝对无线载频信道号(EARFCN)和物理小区标识(如果需要),直到解除锁定或重启UE。

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

命令语法

命令

返回结果

示例

+NEARFCN=<lock_mode>[,<earfcn>[,<earfcn_or_pci>[,<earfcn>[,<earfcn>[,<earfcn>[,...]]]]]]

-

错误情况:

+CME ERROR: <err>

  • 锁定一个频点和一个PCI,排他模式

    AT+NEARFCN=2,3600,108

    OK

  • 锁定两个频点,排他模式

    AT+NEARFCN=1,3600,3700

    OK

  • 锁定两个频点,非排他模式

    AT+NEARFCN=3,3600,3700

    OK

  • 清除锁频配置

    AT+NEARFCN=0

    OK

+NEARFCN?

+NEARFCN: <lock_mode>[,<earfcn>[,<earfcn_or_pci>[,<earfcn>[,<earfcn>[,<earfcn>[,...]]]]]]

AT+NEARFCN?

+NEARFCN: 0

OK

+NEARFCN=?

-

AT+NEARFCN=?

+NEARFCN: (0-3),(0-262143),(0-503)/(0-262143)

OK

参数描述

参数

描述

<lock_mode>

锁频模式。

0:清除所有配置,不使用频点或小区锁定模式。

1:排他地锁定一个或多个频点。当锁定了一个频点时,UE仅可以工作在该频点上,可以通过重选或切换等行为移动至同频小区上,但不会移动至任何异频小区上。当锁定了多个频点时,UE可以工作在这些频点上,可以通过重选或切换等行为移动至同频小区或锁定频点内的异频小区上,但不会移动至锁定频点外的异频小区上。

2:排他地锁定一个频点和一个PCI,即锁定到一个指定的小区。UE仅可以工作在该小区上,不会有任何重选或切换等移动行为。

3:非排他地锁定一个或多个频点。UE在初始小区选择或检测到驻留小区丢失后的小区选择中将优先尝试锁定的频点,但如果锁定的频点上搜索不到小区,将执行默认搜网策略寻找其他频点上小区。同时UE也可以通过重选或切换等行为移动至任何其他频点。

<earfcn>

0~262143范围内的数字,代表要搜索的EARFCN,lock_mode非0时有效。

在lock_mode为1或3时最多可以设置10个频点。

在lock_mode为2时只可设置1个频点。

<earfcn_or_pci>

lock_mode为1或3时代表要搜索的EARFCN,取值范围0~262143。

lock_mode为2时代表十进制的EUTRAN物理小区标识,有效范围0~503。

实现说明

NEARFCN设置命令仅可以在CFUN=0下配置,否则将产生+CME ERROR: 551。

NEARFCN设置命令中输入的频点必须在NBAND命令已配置的频段上,否则将产生+CME ERROR: 528。

NEARFCN命令锁频锁小区效果在配置NBAND命令后会失效。

使用排他的锁频模式1或2时,不仅锁定了UE的工作频点或小区,也同时锁定了UE监测的邻区范围,即UE不会对锁定范围以外的小区进行发现或测量。影响+COPS=?、+NUESTATS=CELL、+NUESTATS=NEIGHBOURCELL、+NUESTATS=SURROUNDINGCELL等命令查询结果。

NV项NV_ID_UE_EARFCN_LOCKING_STATUS_STORED_IN_NV控制频点锁定配置是否掉电保存。上述所有描述均为该NV取值默认值FALSE时的行为。如果修改该NV取值为TRUE,则:

  • 锁频配置在UE重启或掉电后依然保存。
  • 该命令取消仅可以在CFUN=0下配置的限制,但是在其他状态下进行的配置无法实时生效,须在下次CFUN=0和CFUN=1后才生效。

温保参数配置:+TEMPPRT

命令描述

支持温保模块设置温保参数,包括温保是否使能,限制最大上行速率,限制最大发射功率。

支持温保模块查询温保参数,使能的支持列表(0,1),限制最大上行速率支持范围:100~5000,最大发射功率的支持范围:10~23。

注:TEMPERATURE_PROTECT宏打开时,且完全适配开启温保功能后,此命令才可正常配置,否则不可用。

命令语法

命令

返回结果

示例

+TEMPPRT=<enable>[<max_ul_rate><max_tx_pwr>]

-

错误情况:

+CME ERROR: <err>

AT+TEMPPRT=1,100,10

+TEMPPRT=?

-

+TEMPPRT=(0-1),(100-5000),(10-23)

AT+TEMPPRT=?

+TEMPPRT=(0-1),(100-5000),(10-23)

OK

+TEMPPRT?

+TEMPPRT=0,5000,23

AT+TEMPPRT?

+TEMPPRT=0,5000,23

OK

参数描述

参数

描述

<enable>

整型值,表示是否启用温保,取值如下:

0:关闭;

1:开启。

<max_ul_rate>

整型值,enable为1时有效,表示限制的最大上行速率,单位:kbit/s,取值范围:100~5000,即限速范围:100kbit/s~5Mbit/s。

<max_tx_pwr>

整型值,enable为1时有效,表示限制的PA最大发射功率,单位:dBm,取值范围:10~23,即限制PA最大发射功率:10dBm~23dBm。

查询当前芯片温度:+MODEMTEMP

命令描述

支持查询当前芯片温度值。

说明: TEMPERATURE_PROTECT宏打开时,且完全适配开启温保功能后,此命令才可正常配置,否则不可用。

命令语法

命令

返回结果

示例

+MODEMTEMP?

+MODEMTEMP:<value>

AT+MODEMTEMP?

+MODEMTEMP:25.6

OK

+MODEMTEMP=?

-

AT+MODEMTEMP=?

OK

参数描述

参数

描述

<value>

芯片当前温度值,单位:℃。

DRX状态查询:+NDRX

命令描述

此查询命令用来返回RRC连接模式和该连接模式的DRX信元(如适用)。仅当<mode>=1或3时,返回DRX信元<drxcycleIDLE>(如可用);当<mode>=2时,返回参数[<drxInactiveTimer>],[<drxRetransmissionTimer>],[<drxStartOffset>],[<longdrxCycle>]和[<onDurationTimer>](如可用)。

参数<drxcycleIDLE>,<drxInactivityTimer>,<drxRetransmissionTimer>,<drxStartOffset>,<longdrxCycle>和<onDurationTimer>仅在可用时提供。

命令语法

命令

返回结果

示例

+NDRX?

当<mode>=1或3时:

+NDRX: <mode>,[<drxcycleIDLE>]

当<mode>=2时:

+NDRX: <mode>,[<drxInactivityTimer>], [<drxRetransmissionTimer>], [<drxStartOffset>], [<longdrxCycle>], [<onDurationTimer>]

AT+NDRX?

+NDRX: 2,3,6,1008,2048,3

OK

+NDRX=?

-

AT+NDRX=?

OK

参数描述

参数

描述

<mode>

整数类型,表示RRC连接模式。

1:空闲模式且驻留在一个小区上;

2:连接模式;

3:空闲模式但脱离覆盖。例如:关机/小区选择进行中/在PSM下。

<drxcycle_IDLE>

整数类型,单位:psf(PDCCH sub-frame)。

表示空闲模式DRX周期,可能取值:32、64、128、256或512个无线帧。

<drxInactiveTimer>

整数类型,单位:psf(PDCCH sub-frame)。

表示连接模式DRX不活动定时器,范围:1~2560psf。

<drxRetransmissionTimer>

整数类型,单位:psf(PDCCH sub-frame)。

表示连接模式DRX重传定时器,范围:1~33psf。

<drxStartOffset>

整数类型。表示连接模式DRX起始偏移子帧值,范围:0~<longdrxCycle>-1。

<longdrxCycle>

整数类型,单位:sf(sub-frame)。

表示连接模式DRX周期,范围:10~10240sf。

<onDurationTimer>

整数类型,单位:psf(PDCCH sub-frame)。

表示连接模式DRX持续时间定时器,范围:1~200psf。

清除存储的频点:+NCSEARFCN

命令描述

此命令清除存储的EARFCN。

命令语法

命令

返回结果

示例

+NCSEARFCN

-

错误情况:

+CME ERROR: <err>

AT+NCSEARFCN

OK

+NCSEARFCN=?

-

AT+NCSEARFCN=?

OK

查询UE统计数据:+NUESTATS

命令描述

此命令获取最新的运行统计数据。对于可能的<err>取值,请参见“错误码”章节。它可使用可选参数来允许显示不同的统计数据集。<type> RADIO提供默认值集。<type>=ALL将打印所有数据。

命令语法

命令

返回结果

示例

+NUESTATS=RADIO

Signal power:<signal power in centibels>

Total power:<total power in centibels>

Cell ID:<last cell ID>

SNR:< last snr value>

EARFCN:< last earfcn value>

PCI:< last pci value>

RSRQ:<rsrq in centibels>

CURRENT BAND:<current band>

AT+NUESTATS=RADIO

+NUESTATS: RADIO,Signal power,-1009

+NUESTATS: RADIO,Total power,-905

+NUESTATS: RADIO,Cell ID,70

+NUESTATS: RADIO,SNR:20

+NUESTATS: RADIO,EARFCN:3553

+NUESTATS: RADIO,PCI:11

+NUESTATS: RADIO,RSRQ:0

+NUESTATS: RADIO,CURRENT BAND:8

OK

+NUESTATS=CELL

+NUESTATS: CELL,<earfcn>,<physical cell id>,<primary cell>,<rsrp>,<rsrq>,<rssi>,<snr>

[...

+NUESTATS: CELL,<earfcn>,<physical cell id>,<primary cell>,<rsrp>,<rsrq>,<rssi>,<snr>]

AT+NUESTATS=CELL

+NUESTATS: CELL,2600,211,1,-931,-108,-904,297

+NUESTATS: CELL,3630,162,0,-933,-108

OK

+NUESTATS=THP

+NUESTATS: THP,<throughput_type>,<throughput>

[...

+NUESTATS: THP,<throughput_type>,<throughput>]

AT+NUESTATS=THP

+NUESTATS: THP,RLC UL,100

+NUESTATS: THP,RLC DL,98

+NUESTATS: THP,MAC UL,103

+NUESTATS: THP,MAC DL,100

OK

+NUESTATS=BLER

+NUESTATS: BLER,<block error rate type>,< block error rate >

[...

+NUESTATS: BLER,<block error rate type>,< block error rate >]

AT+NUESTATS=BLER

+NUESTATS: BLER,RLC UL BLER,10

+NUESTATS: BLER,RLC DL BLER,5

+NUESTATS: BLER,MAC UL BLER,8

+NUESTATS: BLER,MAC DL BLER,3

+NUESTATS: BLER,Total TX bytes,1080

+NUESTATS: BLER,Total RX bytes,900

+NUESTATS: BLER,Total TX blocks,80

+NUESTATS: BLER,Total RX blocks,80

+NUESTATS: BLER,Total RTX blocks,100

+NUESTATS: BLER,Total ACK/NACK RX,100

OK

+NUESTATS=APPMEM

+NUESTATS: APPMEM,Current Allocated,<allocated>

+NUESTATS: APPMEM,Total Free,<free>

+NUESTATS: APPMEM,Max Free,<max free>

+NUESTATS: APPMEM,Num Allocs,<num allocs>

+NUESTATS: APPMEM,Num Frees,<num frees>

+NUESTATS: APPMEM,Fail Count:<fail count>

+NUESTATS: APPMEM,Water Line:<water line>

AT+NUESTATS=APPMEM

+NUESTATS: APPMEM,Current Allocated: 88792

+NUESTATS: APPMEM, Total Free: 210968

+NUESTATS: APPMEM,Max Free: 209888

+NUESTATS: APPMEM,Num Allocs: 212

+NUESTATS: APPMEM,Num Frees: 7

+NUESTATS: APPMEM,Fail Count: 0

+NUESTATS: APPMEM,Water Line: 92480

OK

+NUESTATS=PROTRE

+NUESTATS: PROTRE,Current Allocated,<allocated>

+NUESTATS: PROTRE,Total Free,<free>

+NUESTATS: PROTRE,Max Free,<max free>

+NUESTATS: PROTRE,Num Allocs,<num allocs>

+NUESTATS: PROTRE,Num Frees,<num frees>

+NUESTATS: PROTRE,Fail Count:<fail count>

+NUESTATS: PROTRE,Water Line:<water line>

AT+NUESTATS=PROTRE

+NUESTATS: PROTRE,Current Allocated: 5260

+NUESTATS: PROTRE,Total Free: 9044

+NUESTATS: PROTRE,Max Free: 9044

+NUESTATS: PROTRE,Num Allocs: 29

+NUESTATS: PROTRE,Num Frees: 1

+NUESTATS: PROTRE,Fail Count:0

+NUESTATS: PROTRE,Water Line: 11400

OK

+NUESTATS=TSS

+NUESTATS: THREAD STACK SPACE,<task_name>:<stack high watermark>

[...

+NUESTATS: THREAD STACK SPACE,<task_name>:<stack high watermark>]

AT+NUESTATS=TSS

+NUESTATS: THREAD STACK SPACE,usb: 960

+NUESTATS: THREAD STACK SPACE,at_msg: 2756

+NUESTATS: THREAD STACK SPACE,radio: 596

+NUESTATS: THREAD STACK SPACE,taf: 1488

+NUESTATS: THREAD STACK SPACE,lwip: 996

+NUESTATS: THREAD STACK SPACE,usim: 2016

+NUESTATS: THREAD STACK SPACE,at_uart: 976

+NUESTATS: THREAD STACK SPACE,flash: 656

+NUESTATS: THREAD STACK SPACE,nas: 836

+NUESTATS: THREAD STACK SPACE,rrc: 1332

+NUESTATS: THREAD STACK SPACE,l2_a: 1504

+NUESTATS: THREAD STACK SPACE,log: 1296

+NUESTATS: THREAD STACK SPACE,dfx_msg: 3808

+NUESTATS: THREAD STACK SPACE,rpc_a: 1400

+NUESTATS: THREAD STACK SPACE,l2_c: 1020

+NUESTATS: THREAD STACK SPACE,ll1: 1348

+NUESTATS: THREAD STACK SPACE,rpc_c: 1700

OK

+NUESTATS=SERVINGCELL

+NUESTATS:SERVINGCELL,<state>,LTE,<is_tdd>,<MCC>,<MNC>,<cellID>,<PCI>,<EARFCN>,<freq_band_ind>,<UL_bandwidth>,<DL_bandwidth>,<TAC>,<RSRP>,<RSRQ>,<RSSI>,<SINR>,<srxlev>

AT+NUESTATS=SERVINGCELL

+NUESTATS: SERVINGCELL,SEARCH

OK

AT+NUESTATS=SERVINGCELL

+NUESTATS: SERVINGCELL,NOCONN,LTE,FDD,460,01,5A29C0B,465,1650,3,5,5,DE10,-69,-5,-65,21,51

OK

+NUESTATS=NEIGHBOURCELL,[<ncell_trigger_scan>],[<bw_rpt>]

+NUESTATS:NEIGHBOURCELL,INTRA,LTE,<EARFCN>,<PCI>, <RSRP>,<RSRQ>,<srxlev>,<cell_resel_priority>,<s_non_intra_search>,<thresh_serving_low>,<s_intra_search>,<cellID>,<TAC>,<freqBandIndicator>,<plmns>[,<DL_bandwidth>]

+NUESTATS:NEIGHBOURCELL,INTER,LTE,<EARFCN>,<PCI>, <RSRP>,<RSRQ>,<srxlev>,<threshX_low>,<threshX_high>,<cell_resel_priority>,<cellID>,<TAC>,<freqBandIndicator>,<plmns>[,<DL_bandwidth>]

AT+NUESTATS=NEIGHBOURCELL/AT+NUESTATS=NEIGHBOURCELL,0

+NUESTATS: NEIGHBOURCELL, INTER,LTE,3710,26,-105,-6,22,22,22,5,,,,

+NUESTATS: NEIGHBOURCELL,INTRA,LTE,3590,27,-107,-15,32,5,58,30,58,301B,1F,8,"46001"

OK

须知:<cellID>,<TAC>,<freqBandIndicator>,<plmns>只有曾经读过此earfcn+pci组合的小区的sib1消息才可能上报。复位后、移动到全新区域等情况,容易获取不到这些信息。

AT+NUESTATS=NEIGHBOURCELL, 1

(强制进行邻区发现并获取CGI信息,输入其他命令非reset返回BUSY)

+NUESTATS: NEIGHBOURCELL, INTER,LTE,3710,26,-105,-6,22,22,22,5,301A,1F,8,"46001"

+NUESTATS: NEIGHBOURCELL,INTRA,LTE,3590,27,-107,-15,32,5,58,30,58,301B,1F,8,"46001"

OK

须知:PSM状态下查可能会返回空。

AT+NUESTATS=NEIGHBOURCELL, 1, 1/AT+NUESTATS=NEIGHBOURCELL, 0, 1

(邻区发现时携带带宽信息上报)

+NUESTATS: NEIGHBOURCELL, INTER,LTE,3710,26,-105,-6,22,22,22,5,301A,1F,8,"46001",3

+NUESTATS: NEIGHBOURCELL,INTRA,LTE,3590,27,-107,-15,32,5,58,30,58,301B,1F,8,"46001",5

OK

+NUESTATS=SURROUNDINGCELL

+NUESTATS:SURROUNDINGCELL,<is_tdd>,<EARFCN>,<PCI>,<cellID>,<TAC>,<freqBandIndicator>,<UL_bandwidth>,<DL_bandwidth>,<RSRP>, <RSRQ>,<RSSI>,<SINR>,<srxlev>,<plmns>

+NUESTATS:SURROUNDINGCELL,<is_tdd>,<EARFCN>,<PCI>,<cellID>,<TAC>,<freqBandIndicator>,<UL_bandwidth>,<DL_bandwidth>,<RSRP>, <RSRQ>,<RSSI>,<SINR>,<srxlev>,<plmns>

AT+NUESTATS=SURROUNDINGCELL

+NUESTATS:SURROUNDINGCELL,FDD,1750,253,7C62C0B,E8FA,3,0,5,-72,-4,-39,23,55,"46001,46011"

+NUESTATS:SURROUNDINGCELL,TDD,38400,99,19A970D,182D,39,0,5,-107,-13,-67,1,25,"46000,46015"

OK

须知:最多保存20条记录,按信号强度由高到低排序。其中,信号信息非实时更新,上行带宽固定填充为0。

+NUESTATS=<type>

+NUESTATS: <type>,<name/value>,<value>[,<value[,<value>[...]]]

[...

+NUESTATS: <type>,<name/value>,<value>[,<value[,<value>[...]]]]

-

+NUESTATS=?

+NUESTATS: (支持的<type>列表)

AT+NUESTATS=?

+NUESTATS: (RADIO,BLER,THP,APPMEM,PROTRE,CELL,TSS,SERVINGCELL,NEIGHBOURCELL,SURROUNDINGCELL,ALL)

OK

参数描述

参数

描述

<type>

显示为不带引号的字符串的数据类型。

支持的<type>的值包括:

RADIO:和无线相关的信息;

CELL:前十小区的各个小区信息;

BLER:误块率信息;

THP:吞吐量;

APPMEM:A核的动态内存使用;

PROTRE:C核的动态内存使用;

TSS:线程栈空间信息;

SERVINGCELL:主服务小区信息;

NEIGHBOURCELL:邻居小区信息;

SURROUNDINGCELL: 环境中的小区信息。

ALL:所有信息。

输出的<type>值对于每种数据类型都是正确的。

<type>=RADIO

<signal power in centibels>

信号功率,单位:1/10dB。

<total power in centibels>

总功率,单位:1/10dB。

<last SIB1 cell ID>

上次SIB1小区ID。

<last snr value>

上次信噪比。

<last earfcn value>

上次频点。

<last pci value>

上次物理小区标识。

<rsrq in centibels>

参考信号接收质量,单位:1/10dB。

<current band>

服务小区的频段。

<type>=BLER,误块率。

<rlc_ul_bler>

RLC层误块率(上行)。整数(%)

<rlc_dl_bler>

RLC层误块率(下行)。整数(%)

<mac_ul_bler>

MAC层误块率(上行)。整数(%)

<mac_dl_bler>

MAC层误块率(下行)。整数(%)

<total bytes transmitted>

传输的总字节数

<total bytes received>

接收的总字节数

<transport blocks sent>

发送的传输块数

<transport blocks received>

收到的传输块数

<transport blocks retransmitted>

重传的传输块数

<total nack messages received>

上行发送收到的nack消息总数

<type>=THP,吞吐量。

<rlc_ul>

RLC层吞吐量(上行)。整数(bps)

<rlc_dl>

RLC层吞吐量(下行)。整数(bps)

<mac_ul>

MAC层吞吐量(上行)。整数(bps)

<mac_dl>

MAC层吞吐量(下行)。整数(bps)

<type>=APPMEM,A核的动态内存使用。

<allocated>

内存池中,A核当前分配的总空间(单位:Byte)。

<free>

内存池中,A核自上次重启以来释放的总空间(单位:Byte)。

<max free>

A核释放的最大节点大小(单位:Byte)。

<num allocs>

自上次重启以来A核分配的节点数。

<num frees>

自上次重启以来A核释放的节点数。

<fail count>

内存申请失败次数。

<water line>

内存池内存使用峰值(单位:Byte)。

<type>=PROTRE,C核的动态内存使用。

<allocated>

内存池中,C核当前分配的总空间(单位:Byte)。

<free>

内存池中,C核自上次重启以来释放的总空间(单位:Byte)。

<max free>

C核释放的最大节点大小(单位:Byte)。

<num allocs>

自上次重启以来C核分配的节点数。

<num frees>

自上次重启以来C核释放的节点数。

<fail count>

内存申请失败次数。

<water line>

内存池内存使用峰值(单位:Byte)。

<type>=CELL,前十小区的各个小区信息(邻近小区不会输出<rssi>和<snr>)。

<earfcn>,<physical cell id>,<primary cell>,<rsrp>,<rsrq>[,<rssi>,<snr>]

<earfcn>

频点。

<physical cell id>

小区的物理标识。

<primary cell>

0:搜索到的邻近小区;

1:当前服务小区。

<rsrp>

参考信号接收功率。单位:1/10dB。

<rsrq>

参考信号接收质量。单位:1/10dB。

<rssi>

接收信号强度指示。单位:1/10dB。

<snr>

信噪比。单位:1/10dB。

<type>=TSS,线程栈空间。

<task_name>

线程名称。

<stack high watermark>

栈达到的最高水位线。

<type>=SERVINGCELL。

<state>,LTE,<is_tdd>,<MCC>,<MNC>,<cellID>,<PCI>,<EARFCN>,<freq_band_ind>,<UL_bandwidth>,<DL_bandwidth>,<TAC>,<RSRP>,<RSRQ>,<RSSI>,<SINR>,<srxlev>

<state>

字符串类型,UE状态。

SEARCH:UE正在搜网,但尚未发现合适的4G小区;

LIMSRV:UE驻留在小区中,但尚未在网络上注册;

NOCONN:UE驻留在小区中并已在网络上注册,并且处于空闲模式;

CONNECT:UE驻留在小区中并已在网络上注册,并且已建立连接。

<is_tdd>

字符串类型,通信模式。

TDD:时分双工模式;

FDD:频分双工模式。

<MCC>

整型,移动国家码(PLMN 的第一部分)。

<MNC>

整型,移动网络码(PLMN 的第二部分)。

<cellID>

十六进制格式。小区ID。

<PCI>

整型,物理小区标识。范围:0~503。

<EARFCN>

整型,E-UTRA绝对射频信道号。

<freq_band_ind>

整型,E-UTRA频段(参考3GPP 36.101)。

<UL_bandwidth>

整型,上行带宽。

0:1.4MHz;

1:3MHz;

2:5MHz;

3:10MHz;

4:15MHz;

5:20MHz。

<DL_bandwidth>

整型,下行带宽。

0:1.4MHz;

1:3MHz;

2:5MHz;

3:10MHz;

4:15MHz;

5:20MHz。

<TAC>

十六进制格式。跟踪区域码。(参考3GPP 23.003 第19.4.2.3 章)

<RSRP>

整型,参考信号接收功率。单位:dBm。(参考3GPP 36.214 第5.1.1 章)

<RSRQ>

整型,参考接收质量。单位:dB。(参考3GPP 36.214 第5.1.3 章)

<RSSI>

整型,接收信号强度指示。单位:dBm。

<SINR>

整型,信干噪比。

<srxlev>

整型,小区选择接收电平值。单位:dB。(参考3GPP 25.304/3GPP 36.304)

<type>=NEIGHBOURCELL。

+NUESTATS: NEIGHBOURCELL,INTRA,LTE,<EARFCN>,<PCI>, <RSRP>,<RSRQ>,<srxlev>,<cell_resel_priority>,<s_non_intra_search>,<thresh_serving_low>,<s_intra_search>,<cellID>,<TAC>,<freqBandIndicator>,<plmns>

+NUESTATS: NEIGHBOURCELL,INTER,LTE,<EARFCN>,<PCI>, <RSRP>,<RSRQ>,<srxlev>,<threshX_low>,<threshX_high>,<cell_resel_priority>,<cellID>,<TAC>,<freqBandIndicator>,<plmns>

<EARFCN>

整型,E-UTRA 绝对射频信道号。

<PCI>

整型,物理小区标识。范围:0~503。

<RSRP>

整型,参考信号接收功率。单位:dBm。(参考3GPP 36.214 第5.1.1 章)

<RSRQ>

整型,参考接收质量。单位:dB。(参考3GPP 36.214 第5.1.3 章)

<srxlev>

整型,小区选择接收电平值。单位:dB。(参考3GPP 25.304/3GPP 36.304)

<cell_resel_priority>

整型,小区重选优先级。范围:0~7。

<s_non_intra_search>

整型,用于控制非同频搜索的阈值。

<thresh_serving_low>

整型,当向较低优先级RAT/频率重新选择时,UE在服务小区上使用的<srxlev>阈值;单位:dB。

<s_intra_search>

整型,同频小区重选的测量触发门限。

<threshX_low>

整型,小区重选时参考。评估的低优先级小区的合适接收电平值必须大于该值。

<threshX_high>

整型,小区重选时参考。评估的高优先级小区的合适接收电平值必须大于该值。

<cellID>

十六进制格式。小区ID。

<TAC>

十六进制格式。跟踪区域码。(参考3GPP 23.003 第19.4.2.3 章)

<freqBandIndicator>

整型,频带指示。

<plmns>

字符串。引号括起来的MCC MNC字符串,以逗号分隔。

<ncell_trigger_scan>

可选项,仅作用于<type>=NEIGHBOURCELL。取值0或1,不写按0处理。

0:不触发现场邻区发现和CGI信息获取。如果当前UE没有在进行邻区测量(例如,服务小区信号很好未达到邻区测量启动条件),返回可能为空。

1:强制启动现场邻区发现和CGI信息获取(即使当前服务小区未达到需要启动邻区测量的信号条件)。邻区CGI信息获取最大时长10秒,期间拦截RESET之外的所有AT命令。

<bw_rpt>

可选项,仅作用于<type>=NEIGHBOURCELL。取值0或1,不写按0处理。

0:邻区发现时不携带带宽信息上报;

1:邻区发现时携带带宽信息上报。

<type>=SURROUNDINGCELL。

+NUESTATS:SURROUNDINGCELL,<is_tdd>,<EARFCN>,<PCI>,<cellID>,<TAC>,<freqBandIndicator>,<UL_bandwidth>,<DL_bandwidth>,<RSRP>, <RSRQ>,<RSSI>,<SINR>,<srxlev>,<plmns>

<is_tdd>

字符串类型,通信模式。

TDD:时分双工模式;

FDD:频分双工模式。

<EARFCN>

整型,E-UTRA绝对射频信道号。

<PCI>

整型,物理小区标识。范围:0~503。

<cellID>

十六进制格式。小区ID。

<TAC>

十六进制格式。跟踪区域码。(参考3GPP 23.003 第19.4.2.3 章)

<freqBandIndicator>

整型,频带指示。

<UL_bandwidth>

整型,上行带宽。

0:1.4MHz;

1:3MHz;

2:5MHz;

3:10MHz;

4:15MHz;

5:20MHz。

<DL_bandwidth>

整型,下行带宽。

0:1.4MHz;

1:3MHz;

2:5MHz;

3:10MHz;

4:15MHz;

5:20MHz。

<RSRP>

整型,参考信号接收功率。单位:dBm。(参考3GPP 36.214 第5.1.1 章)

<RSRQ>

整型,参考接收质量。单位:dB。(参考3GPP 36.214 第5.1.3 章)

<RSSI>

整型,接收信号强度指示。单位:dBm。

<SINR>

整型,信干噪比。

<srxlev>

整型,小区选择接收电平值。单位:dB。(参考3GPP 25.304/3GPP 36.304)

<plmns>

字符串。引号括起来的MCC MNC字符串,以逗号分隔。

实现说明

  • 无卡情况可以查询服务小区和邻区信息。无卡状态下发起紧急注册详见“定义PDP上下文:+CGDCONT”章节。
  • NV: NV_ID_UE_UPDATE_TPUT_ENABLED(0x7013)是控制误码率(BLER)和吞吐量(THP)上下文更新的开关,默认值为1(开启)。

    开关开启时,UE会更新误码率和吞吐量上下文,此时可通过NUESTATS=BLER和NUESTATS=THP查询误码率和吞吐量。

    开关关闭时,UE不更新误码率和吞吐量上下文,此时通过NUESTATS=BLER和NUESTATS=THP查询误码率和吞吐量的数据不正确。

    该NV开关手动配置后不会立即生效,可通过上下电或开关机使其生效。

WIFI扫描:+NWIFISCAN

命令描述

NWIFISCAN用于开启WiFi-SCAN功能,开启后结果将异步上报。该如此前已经下发扫描任务,直接返回ERROR。上报内容包含扫到的AP信息索引<index>(如有结果则以1开始。index为0代表扫描结束,此时无后续参数)、两个预留位、RSSI、十六进制BSSID、对应AP的channel_num。

NWIFISCANSTOP则会停止当前的WiFiScan的任务,并且上报扫描结果。如果当前并没有WiFiScan的任务则会返回ERROR。

命令语法

命令

返回结果

示例

+NWIFISCAN

+NWIFISCAN: <index>,<ssid>,,<rssi>,<bssid>,<channel_num>

AT+NWIFISCAN

OK

+NWIFISCAN: 1,HuaWei,,-67,F83E95527B92,1

+NWIFISCAN: 2,HuaWei-Guest,,-68,F83E95527B90,1

+NWIFISCAN: 0

+ NWIFISCAN =<channel_bit_map>,<max_ap>,<round>,<timeout>,<priority>

+NWIFISCAN: <index>,<ssid>,,<rssi>,<bssid>,<channel_num>

错误情况:

+CME ERROR: <err>

AT+NWIFISCAN=3fff,50,3,60,1

OK

+NWIFISCAN: 1,HuaWei,,-67,F83E95527B92,1

+NWIFISCAN: 2,HuaWei-Guest,,-68,F83E95527B90,1

+NWIFISCAN: 0

+NWIFISCANSTOP

+NWIFISCAN: <index>,<ssid>,,<rssi>,<bssid>,<channel_num>

AT+NWIFISCAN=3fff,50,3,60,1

OK

AT+NWIFISCANSTOP

OK

+NWIFISCAN: 1,HuaWei,,-67,F83E95527B92,1

+NWIFISCAN: 2,HuaWei-Guest,,-68,F83E95527B90,1

+NWIFISCAN: 0

参数描述

参数

描述

<channel_bit_map>

14位位图,格式为16进制字符串。只允许输入2或4个字符,取值大于0且不超过0x3FFF。

01:只上报channel_number=1的WiFi信号;

1001:只上报channel_number=13、1的WiFi信号;

3FFF:对channel不做筛选,上报所有WiFi信号。

<max_ap>

最大扫描数量,取值范围为5~50;

如果在扫描的过程中扫到了最大ap数量,则会返回结果;

<round>

扫描轮次,将所有的信道扫描完一次为一轮,取值范围1~10;

<timeout>

扫描的超时时间,单位为秒,取值范围为10~60;

<priority>

扫描优先级。

0:cat1优先,如果当前已经开始入网则会在idle态的时候做WiFiScan的业务,且随时都可以被cat1的业务打断;

1:WiFiScan优先,会强制将当前协议栈挂起,暂停当前的cat1业务,待完成后再恢复cat1业务。

<index>

扫描到的AP信息索引。若有扫描到结果,则从1开始。index为0代表扫描结束,此时无后续参数。

<ssid>

WiFi网络名称。

<rssi>

接收信号强度指标,单位:dBm。

<bssid>

AP MAC地址,16进制字符串。

<channel_num>

对应AP的通道标号。

附:

channel_bit_map映射表:

Bit位

channel的频点/MHz

Bit位

channel的频点/MHz

0

2412

1

2417

2

2422

3

2427

4

2432

5

2437

6

2445

7

2447

8

2452

9

2457

10

2462

11

2467

12

2472

13

2484

实现说明

  • 如果下发的命令是CAT1业务优先,则:

    WiFiScan命令会被任何CAT1业务打断,包含上下行发包等。如果UE发生了开关机切换,那么会立马停止当前的扫描并上报扫描结果。

    若下发WiFiScan命令时,处于CFUN0状态,那么UE会立马开始扫描。

    若下发WiFiScan命令时,处在已开始入网(AT+CFUN=5或AT+CGATT=1)的状态,UE会等到idle态的时候才会开始进行WiFiScan的业务。如果一直未进入idle态或者在idle态中被打断导致扫描未完成,则会等到超时时间后再进行上报。

  • 如果下发的命令是WiFiScan优先,则UE会将协议栈强制进入PSM,此时WiFiScan不会被任何CAT1的业务打断。只有WiFiScan业务完成后或者收到NWIFISCANSTOP时才会退出该状态。在协议栈强制进入PSM期间,需注意:

    • 会拦截上行数据,拦截短信发送,无法收到下行数据。
    • 拦截AT+CFUN命令的下发。
    • 正在搜网/ATTACH状态无法强制进PSM,NWIFISCAN命令会报错。

    此外,协议栈的恢复需要一定的时间,在恢复的过程中再次强制进入PSM可能会引起失败,此时接口将返回错误,且此WiFiScan请求并不会被记录下来。

    需要注意,在AT+CFUN=1状态后,入网前的中间状态是不能够进行WiFiScan命令。

上报说明

上报结果是以rf_at_wifiscan_result_stru的格式上报到AT,用户可以在AT中自定义上报的格式。AT默认的处理函数为at_handle_wifiscan_print_result,该函数已开源,用户可以参考其中的逻辑定制上报格式。

相关结构体定义如表1表2所示。

表 1 rf_at_wifiscan_result_stru

结构体成员名

数据类型

说明

total_size

uint8_t

上报AP的个数。

wifiscan_info_array

rf_at_wifiscan_info_stru *

上报AP的具体信息数组,扫描结果信息格式参考rf_at_wifiscan_info_stru。该指针指向数组的第一个元素,使用完需要释放该指针。注意,当total_size = 0时,该指针为空指针。

表 2 rf_at_wifiscan_info_stru

结构体成员名

数据类型

说明

rssi

int8_t

接收信号强度指标,单位dBm。

ssid

uint8_t[33]

SSID,即服务集标识符,格式为最多为33位(含'\0')字符串。

bssid

uint8_t[6]

AP MAC地址,不包含'\0'。

channel_num

uint8_t

AP的信道编号。

设置backoff定时器上报:+NBACKOFF

命令描述

使用此命令控制是否开启NAS backoff定时器的上报功能,开启上报功能后,在定时器T3346和T3396启动、超时、停止时,会上报定时器相关信息。

命令语法

命令

返回结果

示例

+NBACKOFF=<mode>

OK

错误情况:

+CME ERROR:<err>

AT+NBACKOFF=1

OK

+NBACKOFF: <timer>,<event>,<period>,<remaining>[,<apn>]

+NBACKOFF?

+NBACKOFF:<mode>

错误情况:

+CME ERROR:<err>

AT+NBACKOFF?

+NBACKOFF: 1

OK

+NBACKOFF=?

+NBACKOFF: (支持的<mode>列表)

错误情况:

+CME ERROR:<err>

AT+NBACKOFF=?

+NBACKOFF: (0,1)

参数描述

参数

描述

<mode>

整数类型。

0:不上报backoff定时器信息(默认值);

1:上报backoff定时器信息。

<timer>

字符串类型。

"T3346": 定时器T3346的信息;

"T3396": 定时器T3396的信息。

<event>

整数类型

0:定时器启动;

1:定时器停止;

2:定时器超时。

<period>

整数类型。

定时器时长。

<remaining>

整数类型。

定时器剩余时间。

<apn>

字符串类型。

定时器所关联的apn(仅适用于T3396)。

实现说明

若使用AT+RESET命令停止了定时器,则无法上报。

获取被bar的伪基站小区:+NGSBLACKCELL

命令描述

获取被bar的伪基站小区。对于可能的<err>取值,请参见“错误码”章节。

命令语法

命令

返回结果

示例

+NGSBLACKCELL

+NGSBLACKCELL: [<earfcn>,<pci>[<earfcn>,<pci>[...]]]

AT+NGSBLACKCELL

+NGSBLACKCELL:3600,12,2500,0

OK

+NGSBLACKCELL=?

-

AT+NGSBLACKCELL=?

OK

参数描述

参数

描述

<earfcn>

整型值,频点。

<pci>

整型值,物理小区标识。范围:0~503。

实现说明

关机、复位会清除保存的被bar的伪基站小区。

清除被bar的伪基站小区:+NCSBLACKCELL

命令描述

此命令清除被bar的伪基站小区。对于可能的<err>取值,请参见“错误码”章节。

命令语法

命令

返回结果

示例

+NCSBLACKCELL

成功情况:

OK

错误情况:

+CME ERROR: <err>

AT+NCSBLACKCELL

OK

+NCSBLACKCELL=?

-

AT+NCSBLACKCELL=?

OK

参数描述

参数

描述

查询最近一次TX发射功率:+NTXPOWER

命令描述

支持查询最近一次TX发射功率。

命令语法

命令

返回结果

示例

+NTXPOWER

+NTXPOWER:<value>

AT+NTXPOWER

+NTXPOWER:255

OK

+NTXPOWER=?

-

AT+NTXPOWER=?

OK

参数描述

参数

描述

<value>

最近一次TX的发射功率(单位:cB),有效范围-450~+230,若在设定时间(由NV 0x4007控制,请参见《HiDiTingV100 2131E NV 用户指南》)内查询不到TX发送则返回默认非法值255(0xFF)。

开启或关闭漫游功能:+NROAMING

命令描述

控制开启或关闭漫游。对于可能的<err>取值,请参见“5-错误码”章节。

命令语法

命令

返回结果

示例

+NROAMING=<mode>

成功情况:

OK

错误情况:

+CME ERROR: <err>

AT+NROAMING=1

OK

+NROAMING?

+NROAMING: <mode>

AT+NROAMING?

+NROAMING: 1

+NROAMING=?

+NROAMING: (支持的配置列表)

AT+NROAMING=?

+NROAMING: (0, 1)

参数描述

参数

描述

<mode>

整数类型。

0:关闭漫游;

1:开启漫游(默认值)。

实现说明

  • 仅关机状态下可使用此命令。
  • 配置会存入NV。
  • 无卡使用场景下不受漫游配置约束,即无卡场景会驻留到漫游的PLMN。
  • AT+COPS命令指定PLMN搜网不受漫游配置约束,即可以通过AT+COPS指定搜索漫游的PLMN。

开启或关闭插卡自动入网:+NSIMAC

命令描述

控制开启或关闭插卡自动入网,默认关闭。

拔卡前发起过入网,插卡自动入网功能才会生效。

命令语法

命令

返回结果

示例

+NSIMAC=<value>

OK

错误情况:

+CME ERROR:<err>

AT+NSIMAC=1

OK

+NSIMAC?

+NSIMAC:<mode>

AT+NSIMAC?

+NSIMAC: 1

OK

+NSIMAC=?

+NSIMAC: (支持的<value>列表)

AT+NSIMAC=?

+NSIMAC: (0,1)

参数描述

参数

描述

<value>

整数类型。

0:关闭插卡自动入网(默认值);

1:开启插卡自动入网。

实现说明

  • 仅关机状态下可使用此命令。
  • 配置会存入NV。

开启和关闭USB连接:+NUSBPSM

命令描述

控制开启或断开USB连接,默认开启连接。

命令语法

命令

返回结果

示例

+NUSBPSM=<value>

OK

AT+NUSBPSM=1

OK

+NUSBPSM?

USB VBUS CONNECTED

USB VBUS DISCONNECTED

USB SOFT DISCONNECTED

AT+NUSBPSM?

OK

+NUSBPSM=?

+NUSBPSM: (支持的<value>列表)

AT+NUSBPSM=?

+NUSBPSM: (0,1)

参数描述

参数

描述

<value>

整数类型。

0:恢复USB连接(默认值);

1:断开USB连接。

实现说明

只有在没有NDIS/PPP拨号或者拨号成功时才可以使用AT+NUSBPSM=1断开USB连接,发起拨号或者断开拨号过程中断开USB连接会返回error。

须知:

  • 执行该操作无法在USB PPP拨号、NDIS拨号或者断开拨号期间执行。
  • 每调用一次该接口会在UART口主动上报一次USB状态。
  • 不建议频繁调用USB进入低功耗和退出低功耗。(建议间隔大于5s以上。)
  • 执行完该接口后无法通过USB远程唤醒上位机。

显示文件系统下的目录和文件:+NFLIST

命令描述

显示文件系统下的目录和文件,可以指定某个目录为起始。

命令语法

命令

返回结果

示例

+NFLIST=<path>

{+NFLIST:<fname>,<size>}

{...}

OK

错误情况:

+CME ERROR:<err>

AT+NFLIST="/USR"

+NFLIST: "/USR/TEST"

+NFLIST: "/USR/TEST/3.TXT", 256

OK

+NFLIST

{+NFLIST:<fname>,<size>}

{...}

OK

错误情况:

+CME ERROR:<err>

AT+NFLIST

+NFLIST: "/USR"

+NFLIST: "/USR/TEST"

+NFLIST: "/USR/TEST/3.TXT", 256

+NFLIST: "/ETC"

OK

参数描述

参数

描述

<path>

字符串类型,遍历的起始路径,最大80Byte(包括\0)。仅支持输入绝对路径表示的路径,不支持输入携带相对路径表示的路径。

同时<path>中目录层级之间的分隔符应仅使用一层,否则查询结果可能存在偏差,例如,“/一层目录/二层目录”、“//一层目录//二层目录”实际指向相同但是可能由于字节数长度不一致导致遍历到的文件长度超长,进而发生查询到的文件大小为0的问题,或者出现多遍历一次起始目录的问题。

注意:用户在文件系统创建目录时应注意目录长度的合理性,由于文件名称长度可变,因此目录名称加上文件名称的总长度加上前缀'/'应满足总体小于80,否则可能存在查询异常。

<fname>

字符串类型,文件夹或路径。

<size>

整型,文件大小(字节),如果<size>缺失,<fname>表示目录。

实现说明

查询当前文件系统中的文件和目录。

DRX参数配置:+NDRXS

命令描述

配置DRX参数。

命令语法

命令

返回结果

示例

+NDRXS=<cycle>

OK

错误情况:

+CME ERROR:<err>

AT+NDRXS=32

OK

+NDRXS?

+NDRXS: <cycle>

AT+NDRXS?

+NDRXS: 32

+NDRXS =?

+NDRXS: (支持的配置列表)

AT+NDRXS=?

+NDRXS: (0,32,64,128,256)

or

+NDRXS: (0,32,64,128,256,512)

参数描述

参数

描述

<cycle>

配置的DRX周期,支持配置:0、32、64、128、256、512

其中,512仅在设置为不按照协议标准时支持配置。

实现说明

  • <cycle>为0表示不指定DRX周期,采用网侧默认的DRX周期。
  • 是否按照协议标准参见NV:0x7123。
  • 若按照协议标准(参见3GPP TS 36.304 R14 subclause 7.1 Discontinuous Reception for paging),实际生效的DRX周期为:min(cycle, nw_cycle),其中cycle为此AT命令配置的DRX周期,nw_cycle为网侧默认的DRX周期。
  • 若不按照协议标准,则生效的DRX周期为此AT命令配置的DRX周期。
  • 按照协议标准时,此命令的配置会存入NV。
  • 不按照协议标准时,此命令的配置不存NV,且配置的DRX周期大于网侧的默认DRX周期时,可能会导致收不到寻呼。
  • 此命令的配置不影响“AT+NDRX?”命令的查询结果。

SIB相关配置:+NSIBCFG

命令描述

配置MIB/SIB1读取的最大尝试次数、读ESIB失败BAR小区的时间。

命令语法

命令

返回结果

示例

+NSIBCFG=<cfg>,<value>

OK

错误情况:

+CME ERROR:<err>

AT+NSIBCFG=1,5

OK

AT+NSIBCFG=2,5

OK

AT+NSIBCFG=3,5

OK

AT+NSIBCFG=4,5

OK

+NSIBCFG?

+NSIBCFG: <cfg>,<value>

AT+NSIBCFG?

+NSIBCFG: 1,5

+NSIBCFG: 2,5

+NSIBCFG: 3,5

+NSIBCFG: 4,5

OK

+NSIBCFG=?

+NSIBCFG: (支持的配置及参数范围)

AT+NSIBCFG=?

+NSIBCFG: 1,(1-16)

+NSIBCFG: 2,(1-16)

+NSIBCFG: 3,(0-300)

+NSIBCFG: 4,(1-300)

OK

参数描述

参数

描述

<cfg>

提供的SIB相关配置选项。

1:PCELL的读取MIB/SIB1最大尝试次数;

2:NCELL的读取MIB/SIB1最大尝试次数;

3:读取PCELL的ESIB失败后BAR该小区的时间;

4:读取NCELL的ESIB失败后BAR该小区的时间。

<value>

  • 当<cfg>=1时,取值1~16。默认为5次。
  • 当<cfg>=2时,取值1~16。默认为5次。
  • 当<cfg>=3时,取值0~300,单位:s。默认为5s。
  • 当<cfg>=4时,取值1~300,单位:s。默认为5s。

实现说明

任何时候可配,并实时生效。

获取用户添加的黑名单小区:+NGUBLACKCELL

命令描述

获取NV中存储的用户添加的黑名单小区。

命令语法

命令

返回结果

示例

+NGUBLACKCELL

+NGUBLACKCELL:

[<mdoe>,<earfcn>,<pci>]/

[<mode>,<cellid>,<tac>,<plmn>]

[...]

OK

错误情况:

+CME ERROR:<err>

NV中有存储用户黑名单小区:

AT+NGUBLACKCELL

+NGUBLACKCELL:

1,1700,198

2,0x00003C6,0x0022,46001

OK

NV中为空(所有条目的mode值都无效):

AT+NGUBLACKCELL

OK

+NGUBLACKCELL=?

-

AT+NGUBLACKCELL=?

OK

参数描述

参数

描述

<mode>

黑名单小区信息存储模式,可取值1、2。

当<mode>=1,存储的是earfcn + pci信息。

当<mode>=2,存储的是cellid + tac + plmn信息。

<plmn>

小区SIB1中的PLMN(5位/6位数字格式)。

<tac>

小区SIB1中的TrackingAreaCode(4字符长度的16进制格式,带“0x”前缀)。

<cellid>

小区SIB1中的CellIdentity(7字符长度的16进制格式,带“0x”前缀)。

<pci>

物理小区标识。

<earfcn>

频点。

实现说明

开机前后均可执行该AT命令获取用户添加黑名单小区的信息。

添加用户黑名单小区:+NAUBLACKCELL

命令描述

添加黑名单小区至NV。

命令语法

命令

返回结果

示例

+NAUBLACKCELL=<mode>,<earfcn/cellid>,<pci/tac>[,<plmn>]

OK

错误情况:

+CME ERROR:<err>

AT+NAUBLACKCELL=1,1300,11

OK

AT+NAUBLACKCELL=2,0x20C,0x1,45001

OK

+NAUBLACKCELL=?

-

AT+NAUBLACKCELL=?

OK

参数描述

参数

描述

<mode>

黑名单小区信息存储模式,可取值1、2。

当<mode>=1,存储earfcn + pci信息。

当<mode>=2,存储cellid + tac + plmn信息。

<plmn>

小区SIB1中的PLMN(5位/6位数字格式)。

<tac>

小区SIB1中的TrackingAreaCode(16进制格式,带“0x”前缀)。

<cellid>

小区SIB1中的CellIdentity(16进制格式,带“0x”前缀)(值小于0x0FFFFFFF)。

<pci>

物理小区标识(范围0~503)。

<earfcn>

频点(范围0~262143)。

实现说明

仅开机前可以添加黑名单小区;该AT仅支持一次添加一个黑名单小区信息。

删除用户添加的黑名单小区:+NCUBLACKCELL

命令描述

删除NV中存储的用户添加的黑名单小区。

命令语法

命令

返回结果

示例

+NCUBLACKCELL[=<mode>,<earfcn/cellid>,<pci/tac>[,<plmn>]]

OK

错误情况:

+CME ERROR:<err>

清空所有条目:

AT+NCUBLACKCELL

OK

删除指定单条条目:

AT+NCUBLACKCELL=1,1780,112

OK

AT+NCUBLACKCELL=2,0x10B,0xAB,45002

OK

+NAUBLACKCELL=?

-

AT+NCUBLACKCELL=?

OK

参数描述

参数

描述

<mode>

黑名单小区信息存储模式,可取值1、2。

当<mode>=1,存储earfcn + pci信息。

当<mode>=2,存储cellid + tac + plmn信息。

<plmn>

小区SIB1中的PLMN(5位/6位数字格式)。

<tac>

小区SIB1中的TrackingAreaCode(16进制格式,带“0x”前缀)。

<cellid>

小区SIB1中的CellIdentity(16进制格式,带“0x”前缀)(值小于0x0FFFFFFF)。

<pci>

物理小区标识(范围0~503)。

<earfcn>

频点(范围0~262143)

实现说明

仅开机前可删除。支持删除单条条目,也可清空所有条目。

干扰检测上报AT命令:+INTDET

命令描述

设置命令用于配置干扰检测上报是否使能;查询命令用于查询当前干扰检测上报使能开关;查询命令返回可配置的参数范围。

<n>配置为1,当检测到干扰时,主动上报“+INTERFERENCE_DETECTED”

命令语法

命令

返回结果

示例

+INTDET=<n>

-

AT+INTDET=1

OK

+INTDET?

+INTDET: <n>

AT+INTDET?

+INTDET: 1

OK

+INTDET=?

+INTDET: (支持的<n>列表)

AT+INTDET=?

+INTDET: (0,1)

OK

参数描述

参数

描述

<n>

整数类型。

0:检测到干扰上报不使能;

1:检测到干扰上报使能。

添加用户配置APN:+NAPNA

命令描述

添加用户配置APN,或修改已添加的用户配置APN。

APN自适配功能会使用用户配置APN。

命令语法

命令

返回结果

示例

+NAPNA=<apn>,<prot>,<username>,<password>

OK

错误情况:

+CME ERROR:<err>

AT+ NAPNA="cmnet",1,"123","123"

OK

AT+ NAPNA="ctnet",4

OK

+NAPNA?

+NAPNA: <apn>,<prot>,<username>,<password>

AT+NAPNA?

+NAPNA: "cmnet",1,"123","123"

+NAPNA: "ctnet",4

+NAPNA=?

+NAPNA: (length of supported <apn>s),(list of supported <prot>s),(length of supported <username>s),(length of supported <password>s)

+NAPNA=?

+NAPNA: (1-100),(0,1,2,3,4),(0-32),(0-32)

参数描述

参数

描述

<apn>

字符串类型,指定配置的APN。

<prot>

整形,<username>和<password>的加密方式。

0:优先使用CHAP;

1:PAP;

2:CHAP;

3:优先使用PAP;

4:不加密。

<username>

字符串类型,指定配置的<apn>的username。

<password>

字符串类型,指定配置的<apn>的password。

实现说明

  • 最多配置15个APN,APN长度大于51的APN最多配置4个。
  • <apn>不可为空,最大长度为100个字符。
  • <prot>配置为4时,不可配置<username>和<password>,<prot>配置不为4时,不可不配置<username>和<password>。
  • <username>和<password>的最大长度为32个字符。
  • 配置的<apn>若重复则替换上一次配置的APN,即修改已配置的APN。
  • 仅cfun = 0状态可以配置、修改APN。

说明: 使用15个NV保存配置的APN,配置过程按顺序占用1到15的空闲存储位置,APN长度大于51字符的配置只能存储于最后四个位置

删除用户配置APN:+NAPND

命令描述

删除用户配置的APN。

命令语法

命令

返回结果

示例

+NAPND=<apn>

or

+NAPND

OK

错误情况:

+CME ERROR:<err>

AT+ NAPND="cmnet"

OK

AT+ NAPND

OK

+NAPND=?

+NAPND: (length of supported <apn>s)

+NAPND=?

+NAPND: (1-100)

参数描述

参数

描述

<apn>

字符串类型,指定要删除的APN。

实现说明

  • +NAPND=<apn>命令删除指定的APN。
  • +NAPND命令删除全部APN。
  • 仅cfun = 0状态可以删除用户配置APN。

查询先验APN:+NPAPNR

命令描述

查询入网成功时保存的先验APN。

命令语法

命令

返回结果

示例

+NPAPNR

+NPAPNR: <apn>,<prot>,<username>,<password>

OK

AT+NPAPNR

+NPAPNR: "ctnet",4,"",""

OK

删除先验APN:+NPAPND

命令描述

删除保存的先验APN。

说明: 不建议删除先验APN。

命令语法

命令

返回结果

示例

+NPAPND

OK

AT+NPAPND

OK

实现说明

仅cfun = 0状态可以删除先验APN。

伪基站检测上报AT命令:+NFCELLR

命令描述

设置命令用于配置伪基站检测上报是否使能;查询命令用于查询当前伪基站检测上报使能开关;查询命令返回可配置的参数范围。

<mode>配置为1,当检测到伪基站时,主动上报“+FAKECELL: <is_tdd>,<MCC>,<MNC>,<cellID>,<PCI>,<EARFCN>,<freq_band_ind>,<TAC>,<RSRP>,<RSRQ>,<RSSI>,<SINR>”。

命令语法

命令

返回结果

示例

+NFCELLR=<mode>

OK

AT+NFCELLR=1

OK

+NFCELLR?

+NFCELLR: <mode>

AT+NFCELLR?

+NFCELLR: 1

OK

+NFCELLR=?

+NFCELLR: (支持的<mode>列表)

AT+NFCELLR=?

+NFCELLR: (0,1)

OK

参数描述

参数

描述

<mode>

整数类型。

0:不使能伪基站检测上报;

1:使能伪基站检测上报。