跳转至

协议标准 AT 通用、USIM 与安全命令

本文档集中提供 2131E 的协议标准 AT 命令、模组自定义 AT 命令、产测命令、错误码和重置原因。命令的参数范围、返回值和示例均以本清单为准。

阅读说明: 2131E 原生 AT 命令由模组固件解析,具体可用集合随模组固件版本和配置变化。建议在设备上执行 AT+CLAC 获取实际支持的命令列表。

命令快速索引

协议标准 AT 命令

AT 命令 功能说明 详细参数与示例
AT+CLAC 列出可用命令 详情
AT+CMEE 移动终端错误上报 详情
AT+CGMI 请求制造商标识 详情
AT+CGMM 请求制造商型号 详情
AT+CGMR 请求制造商版本 详情
AT+CGSN 请求产品序列号 详情
AT+CIMI 查询IMSI 详情
AT+CGLA 通用UICC逻辑信道访问 详情
AT+CRSM 受限(U)SIM访问 详情
AT+CSIM 通用UICC 基本信道访问 详情
AT+CCHO 打开逻辑通道 详情
AT+CCHC 关闭逻辑通道 详情
AT+CPIN PIN码验证和解锁 详情
AT+CLCK 设备锁定 详情
AT+CPWD 修改密码 详情
AT+CPINR 查询PIN/PUK剩余可尝试次数 详情
AT+CGEQOS 定义EPS QoS参数 详情
AT+CGEQOSRDP 读取EPS QoS参数 详情
AT+CGCONTRDP 读取EPS缺省承载参数 详情
AT+CGTFT 设置TFT 详情
AT+CGTFTRDP 读取TFT参数 详情
AT+CGDCONT 定义PDP上下文 详情
AT+CGDSCONT 定义二次PDP上下文 详情
AT+CGACT PDP上下文激活/去激活 详情
AT+CGCMOD 修改PDP上下文 详情
AT+CGAUTH 定义PDP上下文鉴权参数 详情
AT+CGPADDR 查询PDP地址 详情
AT+CEER 查询PS域错误码 详情
AT+CFUN 设置MT功能模式 详情
AT+CSQ 查询信号强度 详情
AT+COPS 选择PLMN 详情
AT+CGATT 设置PS域附着 详情
AT+CTZU 时间更新模式设置 详情
AT+CTZR 设置是否允许时区上报 详情
AT+CCLK 设置时间信息 详情
AT+CEREG 设置EPS注册状态上报方式 详情
AT+CREG 网络注册上报方式 详情
AT+CGREG 设置GPRS上报方式 详情
AT+CPLS 选择优先网络列表 详情
AT+CPOL 优选PLMN列表 详情
AT+COPN 获取运营商名称 详情
AT+CNEC 网络错误码上报设置 详情
AT+CPSMS 省电模式设置 详情
AT+CSCON 连接状态上报 详情
AT+CMGS 发送短信 详情
AT+CSCA 设置短信中心地址 详情
AT+CNMI 新短信通知 详情
AT+CMMS 控制短信链路 详情
AT+CMGF 设置短信格式 详情
AT+CSMP 设置文本模式参数 详情
AT+CMGR 按照索引读取短信 详情
AT+CMGD 删除短信命令 详情
AT+CMGW 存储短信命令 详情
AT+CPMS 设置短信存储器命令 详情
AT+CMGL 按照状态读取短信命令 详情
AT+CSCS 设置TE字符集 详情
AT+CMSS 从存储器中发送短信 详情
AT+CSDH 文本模式下参数显示 详情
ATE 命令回显 详情
ATD PPP拨号 详情
ATH 挂断PPP拨号 详情
ATS0 设置自动接听 详情

自定义 AT 命令

AT 命令 功能说明 详细参数与示例
AT+NTSETID 设置ID 详情
AT+NTPERMID 设置永久标识 详情
AT+NATSPEED 配置AT UART波特率 详情
AT+RESET 重启 详情
AT+NLOGLEVEL 配置输出log等级 详情
AT+NFWUPD 固件更新 详情
AT+NDSDELAY 延迟深睡模式 详情
AT+NCRASHINFO 崩溃信息 详情
AT+NPOWD 软关机 详情
AT+NQSTATE 芯片状态信息查询 详情
AT+NSQ 信号强度自动上报 详情
AT+NVETOSUPERDS 配置深睡投票 详情
AT+NBANKD 配置BANKD电平 详情
AT+NVER 请求组件版本 详情
AT+TTSAMOUNT 播放支付金额 详情
AT+TTSBATLV 播放电池电量 详情
AT+TTSPRESET 播放固定语音 详情
AT+RECONNDEL 删除日志工具重连信息 详情
AT+USIMSEL 切换SIM卡槽 详情
AT+USIMHOTPLUG 热插拔配置 详情
AT+NUICC 设置UICC开关 详情
AT+NSIMSRS SIM卡状态上报控制 详情
AT+ICCID 查询SIM卡识别码 详情
AT+PHONENUM 查询本机号码 详情
AT+CLEARFPLMN 清除FPLMN列表 详情
AT+USIMRETRYTIMES 配置救卡次数 详情
AT+NPIN PIN操作 详情
AT+SETHWLOCK 配置锁卡密码 详情
AT+CARDLOCK SIM卡解锁 详情
AT+SIMLOCK SIMLOCK激活和查询 详情
AT+NCONFIG UE功能配置 详情
AT+NPSMR 省电模式状态上报 详情
AT+NPSMSET 设置省电模式 详情
AT+NBAND 设置支持的波段 详情
AT+NEARFCN 指定搜索频率 详情
AT+TEMPPRT 温保参数配置 详情
AT+MODEMTEMP 查询当前芯片温度 详情
AT+NDRX DRX状态查询 详情
AT+NCSEARFCN 清除存储的频点 详情
AT+NUESTATS 查询UE统计数据 详情
AT+NWIFISCAN WIFI扫描 详情
AT+NBACKOFF 设置backoff定时器上报 详情
AT+NGSBLACKCELL 获取被bar的伪基站小区 详情
AT+NCSBLACKCELL 清除被bar的伪基站小区 详情
AT+NTXPOWER 查询最近一次TX发射功率 详情
AT+NROAMING 开启或关闭漫游功能 详情
AT+NSIMAC 开启或关闭插卡自动入网 详情
AT+NUSBPSM 开启和关闭USB连接 详情
AT+NFLIST 显示文件系统下的目录和文件 详情
AT+NDRXS DRX参数配置 详情
AT+NSIBCFG SIB相关配置 详情
AT+NGUBLACKCELL 获取用户添加的黑名单小区 详情
AT+NAUBLACKCELL 添加用户黑名单小区 详情
AT+NCUBLACKCELL 删除用户添加的黑名单小区 详情
AT+INTDET 干扰检测上报AT命令 详情
AT+NAPNA 添加用户配置APN 详情
AT+NAPND 删除用户配置APN 详情
AT+NPAPNR 查询先验APN 详情
AT+NPAPND 删除先验APN 详情
AT+NFCELLR 伪基站检测上报AT命令 详情
AT+NDISDUP NDIS拨号 详情
AT+NDISSTAT NDIS拨号STICK模式主动上报 详情
AT+NDISE5STAT NDIS拨号E5模式主动上报 详情
AT+NDATATRAN 获取数传状态 详情
AT+NKEEPALIVE Modem保活 详情
AT+NDATARATE 获取上下行速率 详情
AT+NIPCSET 智能选卡 详情
AT+NULTHP 查询主副卡上行预估速率 详情
AT+NIPCSUGGEST 迟滞定时器超时主动上报切卡建议 详情
AT+NIPCLEN 控制迟滞定时器开关时长及预估速率折算系数配置 详情
AT+NIPCREGTIME 控制IPC智能选卡中最长搜网时长配置 详情
AT+SPINIC SPI网卡拨号 详情
AT+NRATEMODE 设置速率模式 详情
AT+NFCMEMBYTE 设置上行内存流控门限 详情
AT+NRATEADAPT 上行预估速率上报 详情
AT+NRATEADAPTPARA 码率自适应参数配置 详情
AT+NNMPSD 主动释放连接 详情

产测 AT 命令

AT 命令 功能说明 详细参数与示例
AT+NCHIPTYPE 读取芯片类型 详情
AT&W NV备份 详情
AT&F NV恢复 详情
AT&V 显示部分AT命令配置 详情
AT+NRDTEST 执行无线测试命令 详情
LL1_ACTIVATE_REQ 详情
LL1_DEACTIVATE_REQ 详情
LL1_RADIO_TEST_MODE_ENABLE 详情
LL1_RADIO_TEST_MODE_DISABLE 详情
LL1_RADIO_TEST_PDSCH_RX 详情
LL1_RADIO_TEST_PUSCH_TX 详情
AT+NRDCTRL 射频配置控制命令 详情
AT+NRDSET 射频配置命令集 详情
AT+NRDEXEC 射频配置执行命令 详情
AT+NRCUPD 更新Radioconfig数据 详情
AT+NGOLD 金板数据读写命令 详情
AT+NLOGMODFT 按照log所属模块控制log输出 详情

协议标准 AT 命令

通用操作AT命令

列出可用命令:+CLAC

命令描述

执行命令使MT返回一行或多行AT命令。对于可能的<err>取值,请参见“错误码”章节。

命令语法

命令

返回结果

示例

+CLAC

<AT Command>

[<CR><LF><AT Command>

[...]]

错误情况:

+CME ERROR: <err>

AT+CLAC

AT+CMEE

AT+CGMI

...

AT+CGSN

OK

+CLAC=?

+CME ERROR: <err>

AT+CLAC=?

OK

参数描述

参数

描述

<AT Command>

定义包含AT前缀的AT命令。文本不得包含序列0<CR>或OK<CR>。

移动终端错误上报:+CMEE

命令描述

设置命令可以禁用或启用最终结果码+CME ERROR: <err>作为与MT功能相关的错误指示。如果启用,当MT相关错误发生时,会返回+CME ERROR: <err>的最终结果码,而不只是常规的ERROR结果码。

查询命令返回<n>的当前设置,测试命令以复合值的形式返回支持的参数值范围。

命令语法

命令

返回结果

示例

+CMEE=<n>

-

AT+CMEE=1

OK

+CMEE?

+CMEE: <n>

AT+CMEE?

+CMEE: 1

OK

+CMEE=?

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

AT+CMEE=?

+CMEE: (0,1)

OK

参数描述

参数

描述

<n>

整数类型。

0:禁用+CME ERROR: <err> 结果码,使用ERROR结果码。

1:启用+CME ERROR: <err>结果码,并使用numeric <err>值。(对于可能的<err>取值,请参见“错误码”章节。)

2:启用+CME ERROR: <err>结果码,并使用verbose <err>值。(不支持)

实现说明

仅支持n=0和n=1。

请求制造商标识:+CGMI

命令描述

此命令返回制造商信息。对于可能的<err>取值,请参见“错误码”章节

命令语法

命令

返回结果

示例

+CGMI

<manufacturer>

错误情况:

+CME ERROR: <err>

AT+CGMI

xxxx

OK

+CGMI=?

-

AT+CGMI=?

OK

参数说明

参数

描述

<manufacturer>

信息文本中的字符总数(包括行结束符),不得超过40个字符。

文本不得包含序列0<CR>或OK<CR>。

请求制造商型号:+CGMM

命令描述

此命令返回制造商型号信息。默认将在标准平台上返回“CAT1”。对于可能的<err>取值,请参见“错误码”章节。

命令语法

命令

返回结果

示例

+CGMM

<model>

错误情况:

+CME ERROR: <err>

AT+CGMM

CAT1

OK

+CGMM=?

-

AT+CGMM=?

OK

参数描述

参数

描述

<model>

信息文本中的字符总数(包括行结束符),不得超过40个字符。

文本不得包含序列0<CR>或OK<CR>。

请求制造商版本:+CGMR

命令描述

此命令返回制造商版本,为人类可读的文本,而非用于微控制器解析。

默认返回固件版本,即发布和构建版本。

命令语法

命令

返回结果

示例

+CGMR

<revision>

错误情况:

+CME ERROR: <err>

AT+CGMR

APPLICATION,XXX

PROTOCOL,XXX

FLASH_BOOT_A,XXX

RFCONFIG,RF_XXX

OK

+CGMR=?

-

AT+CGMR=?

OK

参数描述

参数

描述

<revision>

字符串,软件本版本信息。每一项信息文本中的字符总数(包括行结束符),不得超过40个字符。

文本不得包含序列0<CR>或OK<CR>。

请求产品序列号:+CGSN

命令描述

执行命令返回IMEI(国际移动台设备识别码)和相关信息。

测试命令以复合值的形式返回值。对于不支持<snt>的AT命令,只返回OK。对于可能的<err>取值,请参见“错误码”章节。

命令语法

命令

返回结果

示例

+CGSN[=<snt>]

当<snt>=0(或省略)且命令成功时:<sn>;

当<snt>=1且命令成功时:+CGSN: <imei>;

当<snt>=2且命令成功时:+CGSN: <imeisv>;

当<snt>=3且命令成功时:+CGSN: <svn>;

错误情况:

+CME ERROR: <err>

AT+CGSN=0

33333333-3333-3333-3333-333333333333

OK

AT+CGSN=1

+CGSN: 123456789012347

OK

+CGSN=?

当TE支持<snt>且命令成功时:+CGSN:(支持的<snt>列表)

AT+CGSN=?

+CGSN: (0,1,2,3)

OK

参数描述

参数

描述

<snt>

整数类型,表示请求的序列号类型。

0:返回<sn>;

1:返回IMEI(国际移动台设备标识);

2:返回IMEISV(国际移动台设备标识和软件版本号);

3:返回SVN(软件版本号)。

<sn>

UE的128位UUID。信息文本中的字符总数(包括行结束符),不得超过2048个字符。文本不得包含序列0<CR>或OK<CR>。

<imei/imei1>

字符串类型,十进制,表示IMEI。返回imei还是imei1由+USIMSEL决定。

<imeisv>

字符串类型,十进制,表示IMEISV。

<svn>

字符串类型,十进制,表示当前SVN,它是IMEISV的一部分。

USIM相关AT命令

查询IMSI:+CIMI

命令描述

查询(U)SIM卡的IMSI。

命令语法

命令

返回结果

示例

+CIMI

<IMSI>

错误情况:

+CME ERROR: <err>

AT+CIMI

460001357924680

OK

+CIMI=?

-

AT+CIMI=?

OK

参数描述

参数

描述

<IMSI>

国际移动用户标识(不带双引号的字符串)。

通用UICC逻辑信道访问:+CGLA

命令描述

在指定的UICC逻辑通道上下发<command>命令。

执行此命令前需打开UICC“AT+NUICC=1”,执行完成关闭UICC“AT+NUICC=0”以节省功耗。

说明: 需要先获取想要操作的逻辑通道号。

命令语法

命令

返回结果

示例

+CGLA=<sessionid>,<length>,<command>

+CGLA: <length>,<response>

错误情况:

+CME ERROR: <err>

打开逻辑通道(参考命令+CCHO)

AT+CCHO=a0000000871002ff86ffff89ffffffff

1

OK

下发<command>命令

AT+CGLA=1,10,81d00000ff

+CGLA: 4,6d00

OK

+CGLA=?

-

AT+CGLA=?

OK

参数描述

参数

描述

<sessionid>

整数类型;这是用于向UICC发送APDU命令的会话的标识符。

<length>

整数类型;<command>或<response>中发送给TE的字符长度(命令或响应实际长度的两倍)。

<command>

发送给UICC的命令,参考3GPP TS 31.101 [65](十六进制字符格式)。

<response>

UICC对命令的响应。

受限(U)SIM访问:+CRSM

命令描述

该命令用于访问(U)SIM卡。<fileid>存在的时候<pathid>一定要存在。

SIM卡,请参见“3GPP 51.011”的“9.2 Coding of the commands”对于命令的编码。

USIM卡,请参见“ETSI TS 102.221”的“11 Commands”对于命令的编码。

执行此命令前需打开UICC“AT+NUICC=1”,执行完成关闭UICC“AT+NUICC=0”以节省功耗。

本命令遵从3GPP TS 27.007协议

命令语法

命令

返回结果

示例

+CRSM=<command>[,<fileid>[,<P1>,<P2>,<P3>[,<data>[,<pathid>]]]]

+CRSM: <sw1>,<sw2>[,<response>]

错误情况:

+CME ERROR: <err>

更新二进制文件:

AT+CRSM=214,28643,0,0,18,000000000000000000000000000000000000

+CRSM: 144,0

OK

读取二进制文件:

at+crsm=176,28643,0,0,18

+CRSM: 144,0,000000000000000000000000000000000000

OK

+CRSM=?

-

AT+CRSM=?

OK

参数描述

参数

描述

<command>

整型值,SIM访问命令:

176:读取二进制文件;

178:读取记录内容;

192:获取响应;

214:更新二进制文件;

220:更新记录内容;

242:状态查询。

<fileid>

整型值,EF文件ID,除状态查询以外的命令均必须下发该参数。

<P1>,<P2>,<P3>

整型值,除了状态查询命令,这些参数必须指定,最大255。参见3GPP TS 51.011 9.2 Coding of the commands。

<data>

要写入SIM的信息(十六进制格式字符)。字节数和<P3>一致。

<pathid>

包含ETSI TS 102 221 [60]中定义的十六进制格式的SIM/UICC上基本文件的路径(例如,SIM和UICC下的“7F205F70”)。除状态查询以外的命令均必须下发该参数。

<sw1>,<sw2>

整型值,命令执行后SIM卡返回的响应。

<response>

携带命令执行成功后返回的数据,对于二进制更新和记录更新命令,<response>不返回。

通用UICC 基本信道访问:+CSIM

命令描述

设置命令将<command>发送到MT,然后它将按原样发送到SIM。同样,SIM <response>应由MT原样发回TA。

执行此命令前需打开UICC“AT+NUICC=1”,执行完成关闭UICC“AT+NUICC=0”以节省功耗。

命令语法

命令

返回结果

示例

+CSIM=<length>,<command>

+CSIM: <length>,<response>

错误情况:

+CME ERROR: <err>

AT+CSIM=8,00123000

+CSIM: 4,6e00

OK

+CSIM=?

-

AT+CSIM=?

OK

参数描述

参数

描述

<length>

整数类型;<command>或<response>中发送给TE的字符长度(命令或响应实际长度的两倍)。

<command>

MT通过3GPP TS 51.011 [28]中的格式向SIM卡传递的命令(十六进制字符格式)。

<response>

SIM卡通过3GPP TS 51.011 [28]中的格式传递给MT的命令的响应(十六进制字符格式)。

打开逻辑通道:+CCHO

命令描述

打开逻辑通道。

命令语法

命令

返回结果

示例

+CCHO=<dfname>

<sessionid>

错误情况:

+CME ERROR: <err>

AT+CCHO=a0000000871002ff86ffff89ffffffff

1

OK

+CCHO=?

-

AT+CCHO=?

OK

参数描述

参数

描述

<dfname>

整型值,应用名称,长度1Byte~16Byte。

UICC卡中所有可以被选择的应用都有一个对应的DF名称。

<sessionid>

整型值,逻辑通道号。

关闭逻辑通道:+CCHC

命令描述

关闭逻辑通道。

命令语法

命令

返回结果

示例

+CCHC=<sessionid>

-

错误情况:

+CME ERROR: <err>

AT+CCHC=1

OK

+CCHC=?

-

AT+CCHC=?

OK

参数描述

参数

描述

<sessionid>

整型值,逻辑通道号。

安全管理AT命令

PIN码验证和解锁:+CPIN

命令描述

PIN码验证和解锁。

验证时<pin>输入的是PIN码,<newpin>不用输入。

解锁时<pin>输入的是PUK码,<newpin>是替换旧PIN码的新PIN码(解锁锁网锁卡时无需此参数)。

查询命令返回PIN码的当前状态。

未开启热插拔开关时,可主动进行卡在位检测。

命令语法

命令

返回结果

示例

+CPIN=<pin>[,<newpin>]

-

错误情况:

+CME ERROR: <err>

AT+CPIN=1234

OK

+CPIN?

+CPIN: <code>

错误情况:

+CME ERROR: <err>

AT+CPIN?

+CPIN: READY

OK

+CPIN=?

-

AT+CPIN=?

OK

参数描述

参数

描述

<pin>,<newpin>

字符串类型,长度4~8。

<code>

字符串参数(不带双引号)。

READY:MT无密码输入请求;

SIM PIN:(U)SIM PIN密码请求;

SIM PUK:(U)SIM PUK密码请求;

SIM PUK BLOCKED:SIM PUK被阻止(如果输入错误的PUK 10次后SIM卡被锁定)。

实现说明

  • 设置和查询命令只能在开机时执行。
  • <code>值仅支持READY、SIM PIN、SIM PUK以及SIM PUK BLOCKED。
  • 未开启热插拔时,使用查询命令可向USIM发消息主动发起卡在位检查,若卡不在位上报卡移除,并返回CME ERROR:10。
  • 未开启热插拔时,已经了上报卡移除,再使用查询命令,则不会发消息去检查,直接返回CME ERROR:10。

设备锁定:+CLCK

命令描述

加锁、解锁MT或者网络功能,以及查询锁定状态。

命令语法

命令

返回结果

示例

+CLCK=<fac>,<mode>[,<passwd>[,<class>]]

-

when <mode>=2 and command successful:

+CLCK: <status>[,<class1>

[<CR><LF>+CLCK: <status>,<class2>

[...]]

错误情况:

+CME ERROR: <err>

AT+CLCK=SC,0,1234

OK

+CLCK=?

+CLCK: (list of supported <fac>s)

错误情况:

+CME ERROR: <err>

AT+CLCK=?

+CLCK: ("SC")

OK

参数描述

参数

描述

<fac>

字符串类型,指定该命令操作的对象(当前只支持“SC”)。

SC:SIM PIN。

<mode>

整型值,操作模式。

0:解锁;

1:锁定;

2:查询状态。

<passwd>

十进制数字字符串类型;与修改密码命令+CPWD所设定的密码相同(长度4~8)。

<status>

整型值,锁定状态。

0:设备未锁定;

1:设备锁定。

<class>

当前不支持该参数。

修改密码:+CPWD

命令描述

用于修改+CLCK定义的设备锁定密码。

命令语法

命令

返回结果

示例

+CPWD=<fac>,<oldpwd>,<newpwd>

-

错误情况:

+CME ERROR: <err>

AT+CPWD=SC,1234,12345

OK

+CPWD=?

+CPWD: list of supported (<fac>,<pwdlength>)s

错误情况:

+CME ERROR: <err>

AT+CPWD=?

+CPWD: ("SC",4-8)

OK

参数描述

参数

描述

<fac>

字符串类型,指定该命令操作的对象(当前只支持“SC”)。

SC:SIM PIN1。

<oldpwd>, <newpwd>

十进制数字字符串类型,旧密码和新密码(长度4~8)。

查询PIN/PUK剩余可尝试次数:+CPINR

命令描述

用于查询剩余PIN/PUK重试次数。

命令语法

命令

返回结果

示例

+CPINR[=<sel_code>]

+CPINR: <sel_code>,<retries>,<default_retries>

错误情况:

+CME ERROR: <err>

AT+CPINR

+CPINR: SIM PIN,3,3

+CPINR: SIM PUK,10,10

OK

AT+CPINR=SIM PIN

+CPINR: SIM PIN,3,3

OK

+CPINR=?

-

AT+CPINR=?

OK

参数描述

参数

描述

<sel_code>

字符串类型,指定该命令查询的对象。

"SIM PIN":PIN。

"SIM PUK":PUK。

<retries>

整数类型,剩余重试次数。

<default_retries>

整数类型,默认/初始重试次数。