中国电信智能无线座机的二次开发接口协议

1、中国电信智能无线座机的二次开发接口协议命令接口分册2010-3-221 本规范说明1.1. 本规范的内容和适用范围本规范对旺铺助手终端（包括数据卡、USB Modem和CDMA手机）与旺铺客户端软件采用的AT命令做出规定，中国电信内部和厂商共同使用，用于在业务及设备开发上为集团公司和省公司提供技术依据；适用于以旺铺助手终端为代表的移动终端产品。1.2. 本规范的编写依据本规范主要根据中国电信政企客户市场需求，结合各省市相关产品规范而制订。下列标准所包含的条文，通过在本规范中引用而构成为本规范的条文。凡是注日期的引用标准，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本规范，若其被修订

2、，使用本规范的各方应探讨使用其最新版本的可能性。凡是不注日期的引用标准，其最新版本适用于本规范。 1 ETSI GSM 07.07 2 ETSI GSM 07.07 3 TIA-EIA-IS-707-A.3 4 ITU-T Recommendation V.25 ter 14 CDMA B端需求规范Rev A数据终端AT命令接口分册2 参考资料3 缩略语缩略语 英文全名 中文解释 3GPP Third Generation Partnership Project 第三代伙伴计划 BER Bit error rate 误码率 CDMA Code Division Multiple Access

3、码分多址 CLIP Call Line Identifier presentation 呼叫号码显示 DCE Data Circuit Equipment 数据电路设备 DCS Data coding scheme 数据编码方案 DTE Data Terminal Equipment 数据终端设备 GPRS General Packet Radio Service 通用分组无线系统 GSM Global System for Mobile Communications 全球移动通信 HDR High Data Rate 高速数据传输技术 IMEI International Mobile Eq

4、uipment Identity 国际移动设备标识 ITU-T International Telecommunication Union-Telecommunication Standardization Sector 国际电信联盟-电信标准部 IWF Interworking Function 网络互通功能单元 MT Mobile Terminal 移动终端 PDP Packet Data Protocol 包交换协议 PIN Personal Identity Number 个人身份识别码 PLMN Public land mobile network 公用陆地移动网络 PUK Pers

5、onal Identity Number 个人标识码 RPLMN Registered PLMN 注册PLMN RSSI Receive signal strength indicator 接收信号强度指示 SCA Sevice Center Address 服务中心号码 SIM GSM Subscriber Identity Module 用户标识组件 SM Short message 短信 TE Terminal Equipment 终端设备，这里指在PC上运行的统一终端客户端软件 UIM User Identity Module 用户标识模块 URC Unsolicited result

6、 code 主动上报结果码，如振铃上报、短信上报、状态改变上报等。 USIM Universal Subscriber Identity Module 用户业务标识组件 4 命令参数定义一、必选参数必选表明一项特性是强制要求、即终端必须支持的，该特性作为终端入网测试的必选条件，测试时有对应的测试用例。必须参数用“”表示， 里面参数必须要填写，命令中本身不出现 二、可选参数可选表明一项特性是非强制要求、但运营商不关注是否被终端支持的，由终端厂家自行决定是否支持，该特性是终端入网测试的可选条件，测试时有对应的测试用例。 可选参数用“.”表示，. 括号中参数为可选项，命令或者响应中本身不出现。三、厂

7、家自定义参数厂家自定义参数推荐表明一项特性是非强制要求、且运营商希望终端支持的，但由终端厂家自行决定是否支持。该特性在终端入网测试中不予考虑，测试时没有对应的测试用例。厂家自定义参数参数用“.”表示，. 括号中参数为可选项，命令或者响应中本身不出现。四、其他 命令结束符。 换行符。5 AT指令概述T指令接口图8-1如所示：AT指令接口示意图6 AT指令语法可选参数和必配参数必须按照规定的顺序排列，各参数间必须用逗号隔开。举例：AT+CPWD=,该命令用于为设备锁定+CLCK 命令所定义的设备锁定功能设置新的密码。如果某参数是字符串（比如：），该字符串必须放在双引号中。例如：”12345”、”c

8、mnet”双引号中的各项符号可看作是字符串。注意：呼叫或发送短信时使用的电话号码不是普通字符串，不要加引号。命令的可选子参数或 TA 返回结果的可选部分位于方括号中。不使用双引号时，字符串中各字符间的空格可忽略不计。实际使用中，不必输入。所有AT指令本身不区分大小写。7 AT指令接口说明要求接口功能内聚。本业务规范中， AT指令应用在PC的USB通信端口和终端设备连接。对所传输的数据包大小做出定义：对于AT指令的发送，除AT两个字符外，最多可以接收1056个字符的长度（包括最后的空字符）。MT主动上报的response消息或者URC，最大长度都限定在1048个字符范围之内。每个命令行中只能包含

9、一条AT指令；对于由MT主动向TE报告的URC指示或者response响应，也要求一行最多有一个，不允许上报的一行中有多条指示或者响应。AT指令以回车作为结尾，响应或上报以回车换行为结尾，原则上不允许用户使用。该原则适用于MT和TE程序的通信。为了增加命令以及响应格式的可读性及规范性，除标准协议原有接口外，所有新增加的接口中，例如：ATXXX:,之类的命令或者，冒号以及逗号后都不能含空格，首尾不能包含冗余空格。该原则适用于MT和TE程序的通信。TE在每一条AT指令下发后，必须要等待MT对于这条AT指令响应后，才能再次下发第二条AT指令；否则下发的第二条AT指令将不被执行。对于较长时间才能反馈结

10、果的AT指令，为保证其他事务不被干扰，建议以异步方式上报最终执行结果。若MT需要较长时间以响应TE，则可能存在响应结果被URC打断的情况，这种打断包含两种情况，一种是当命令下发后等待响应过程中有URC上报，则URC上报后，这个命令仍处于等待命令执行结果过程中，执行结果仍旧上报；另一种是当命令下发后等待响应过程中有URC上报时，命令仍旧会被继续执行，此时URC上报的内容和命令响应的内容可能夹杂在一起上报。对于RING这种特殊的URC，在一些特殊的情况下，也会作为命令终结符使用，如下发挂机命令等待响应过程中时，有RING上报，则挂机命令被异常终止。对字符串的定义：由双引号包括起来的，不含引号或逗号

11、的字节流。TE下发命令的字符串中不能出现引号+逗号的组合（会造成参数和字符串无法区分的情况）。当前版本中，不支持字符转义。对于UCS2编码的数据格式，以字符格式上报其编码值（如一个汉字的UCS2编码为0x553a，则上报553a）。8 AT指令接口准则1. 新增接口改动准则对于扩展的接口， AT指令参数后面可以直接添加参数，因此在产品开发后期若发现接口无法适应新的需求，则只允许在原有接口基础之上在后面新增参数。新增的参数不应该对原有功能有影响。2. 对于本产品不支持功能的设计原则对于所有当前已经制定的接口，若MT接收到的命令是不能识别的，则上报COMMAND NOT SUPPORT的resul

12、t code；若命令参数多了一个，则可以有两种实现方法，一种是MT上报对应的TOO MANY PARAMETERS的result code，命令参数多余的情况不包括等号本身在内。另一种做法是进行容错处理，对多余的参数不进行判断。具体选用那种方法，需要根据该命令是否需要严格限制为依据。3. 接口使用的优先顺序接口当中国电信私有接口与标准接口的功能有重复和类似时，TE的调用顺序一般需遵循“优先使用私有接口”的顺序，只有当产品不支持私有接口时，才使用标准接口。4. 命令名称中国电信的私有AT指令以“”开头，且规定：ATXXX的AT指令名中，X的个数目前暂定不能超过9个。其余AT指令为公共指令。9 接

13、口命令9.1 语言呼叫控制9.1.1 摘机命令名称 HOOKUP 命令说明该指令是MT话机摘机时（手柄/免提），话机发送给TE(上位机软件)的消息。用来给上位机TE显示摘机状态。语法结构命令类型 格式 返回结果Execute+HOOKUP 参数详细说明无示例CDMA商务话机摘机，话机自动发送“+HOOKUP”给旺铺助手软件。9.1.2 挂机命令名称 HOOKDOWN 命令说明该指令是MT（话机）挂机时（手柄/免提），话机发送给TE(上位机软件)的消息。用来给上位机TE显示终端话机挂机状态。语法结构命令类型 格式 返回结果Execute+HOOKDOWN 参数详细说明无示例CDMA商务话机挂机，

14、话机自动发送“+HOOKDOWN”给旺铺助手软件。9.1.3 MT拨号呼出命令名称 CORG 命令说明该指令是MT（话机）拨出电话号码时，上报此命令给TE，包含这个呼叫的呼出号码（用于终端界面上同步显示）。语法结构命令类型 格式 返回结果Execute+ CORG: 参数详细说明类型：string合法的字符仅包括：0-9,*,#,+。+只能出现在号码的最前面，号码的最大长度不能超过24示例+CORG:9.1.4 TE拨号呼出命令名称 CALLOUT 命令说明该指令是TE（话机）拨出电话号码时，发送给MT的命令。MT接收到此命令以后，向指定的号码发起呼叫。语法结构命令类型 格式 返回结果Exec

15、uteAT+ CALLOUT=OK示例AT+CALLOUT=9.1.5 终端电话接听命令名称 ANSWER 命令说明TE需要MT设备接听电话时发送此命令。语法结构命令类型 格式 返回结果ExecuteAT+ANSWEROK 参数详细说明9.1.6 终端挂断电话命令名称 CALLEND 命令说明TE要求MT设备挂断电话时发送此命令。语法结构命令类型 格式 返回结果ExecuteAT+CALLENDOK 参数详细说明示例1.1.1 获取信号强度命令名称 GETRSSI 命令说明用于TE获取MT信号强度。语法结构命令类型 格式 返回结果ExecuteAT+GETRSSI+GETRSSI: 参数详细说

16、明类型：整型 0-4示例1.1.2 获取信号强度DB值命令名称 GETRSSIL 命令说明用于TE获取MT信号强度。语法结构命令类型 格式 返回结果ExecuteAT+GETRSSIL+GETRSSIL: 参数详细说明类型：整型 0255示例9.1.7 电话呼入命令名称 CALLIN 命令说明该指令是当MT终端收到来电（电话呼入），发送此消息给TE。语法结构命令类型 格式 返回结果Execute+ CALLIN: 参数详细说明类型：string合法的字符仅包括：0-9,*,#,+。+只能出现在号码的最前面，号码的最大长度不能超过24示例+CALLIN:MT终端收到来电，来电号码9.1.8 来电

17、振铃命令名称 ALERT 命令说明该指令是当MT终端收到来电（电话呼入），发送此消息给TE。语法结构命令类型 格式 返回结果Execute+ ALERT示例+ ALERT+CALLIN:MT终端收到来电，来电号码，对方在振铃中先挂机。（ALERT的功能和来电振铃重复，可选择使用）9.1.9 终端接听命令名称 CBEGIN 命令说明该指令是当呼叫建立之后（主叫和被叫），MT上报此消息给TE。语法结构命令类型 格式 返回结果Execute+ CBEGIN 参数详细说明无示例+CALLIN:+CBEGINMT终端收到来电并振铃后，用户使用话机手柄或免提摘机接听，应答当前来电，连接建立之后，该消息被M

18、T上报给TE。9.1.10 呼叫建立（此功能未实现）命令名称 CCNT 命令说明该指令是呼出电话被对方接听时，MT上报此命令给TE，表示呼叫双方通话建立成功。TE若支持话机软终端方式，呼入时，需向MT发送此消息。语法结构命令类型 格式 返回结果Execute+ CCNT 参数详细说明无示例+CORG:+CCNTMT拨号呼出的电话被对方接听后，被叫摘机接通，MT向TE设备发送此命令。+CALLOUT:+CCNTTE拨号呼出的电话被对方接听后，被叫摘机接通，MT向TE设备发送此命令。9.1.11 呼叫释放命令名称 CEND 命令说明该指令是当MT检测到呼叫结束时，送此消息给TE。语法结构命令类型

19、格式 返回结果Execute+CEND示例+CEND9.1.12 呼叫等待（此功能未实现）命令名称 CWAIT（未实现） 命令说明该指令需要在交换网络上将用户的号码开通呼叫等待业务。当MT处于使用呼叫等待业务进行通话时，送此消息给TE。语法结构命令类型 格式 返回结果Execute+CWAIT 参数详细说明无示例+CINCOM: +CWAIT该用户号码已签约呼叫等待业务，在通话状态，另外有电话呼入，拍叉簧或按R键后触发呼叫等待业务，MT送此消息给TE（界面显示先前电话呼叫保持中）。9.1.13 通话中来电（此功能未实现）命令名称 CINCOM（未实现） 命令说明该指令是当MT的业务号码支持呼叫

20、等待业务，处于通话状态下有另外一个电话呼入，将此号码消息给TE。语法结构命令类型 格式 返回结果Execute+CINCOM: 参数详细说明类型：string合法的字符仅包括：0-9,*,#,+。+只能出现在号码的最前面，号码的最大长度不能超过24示例+CINCOM: 该用户号码已签约呼叫等待业务，在通话状态，另外有电话呼入，送此消息给TE（界面显示有电话呼入）。9.1.14 未接来电获取命令名称 GETMISS 命令说明该指令是当TE查询未接来电时，发送此命令给MT，MT接收到此命令以后，将存储的未接来电返回给TE。语法结构命令类型 格式 返回结果ExecuteAT+GETMISS+GETM

21、ISS: ,+GETMISS:, 参数详细说明类型：string合法的字符仅包括：0-9,*,#,+。+只能出现在号码的最前面，号码的最大长度不能超过24Date类型：stringyyyymmddTime类型：stringHh:mm示例+GETMISS+GETMISS: ,16:55 +GETMISS: ,7:289.1.15 已拨电话获取命令名称 GETDAIL 命令说明该指令是当TE查询MT上已拨电话号码，发送此命令给MT，MT接收到此命令以后，将存储的去电返回给TE。语法结构命令类型 格式 返回结果ExecuteAT+GETDAIL+GETDAIL: ,+GETDAIL: , 参数详细说

22、明类型：string合法的字符仅包括：0-9,*,#,+。+只能出现在号码的最前面，号码的最大长度不能超过2420个号码为一组, 对于超过20号码的要分多条上报。Date类型：stringyyyymmddTime类型：stringHh:mm示例+GETDAIL+GETDAIL: ,16:559.1.16 已接电话获取命令名称 GETPICK 命令说明该指令是当TE查询MT上已接通电话号码，发送此命令给MT，MT接收到此命令以后，将存储的去电返回给TE。语法结构命令类型 格式 返回结果ExecuteAT+GETPICK+GETPICK: ,+GETPICK: , 参数详细说明类型：string合

23、法的字符仅包括：0-9,*,#,+。+只能出现在号码的最前面，号码的最大长度不能超过2420个号码为一组, 对于超过20号码的要分多条上报。Date类型：stringyyyymmddTime类型：stringHh:mm示例+GETPICK+GETPICK: ,16:559.1.17 呼叫转移设置命令名称 SETFWD 命令说明该指令是TE设置呼叫转移时，发送此命令给MT，MT接收到此命令以后，将执行结果返回给TE。需要用户号码支持交换的呼转业务。语法结构命令类型 格式 返回结果ExecuteAT+SETFWD=,OKTest+SETFWD =？SETFWD: (list of supporte

24、ds),(list of supported s),(list of supported s) OK 参数详细说明类型：整型1为启动0为取消类型：整型0 无条件转移 1 无法接通时转移2 无应答时转移 3 忙线时转移4 所有的呼转（取消时用）类型：string表示所要设置的转移号码合法的字符仅包括：0-9示例AT+SETFWD=1,0,OKAT+SETFWD=1,0,1 TOO MANY PARAMETERS9.1.18 通话状态检查命令名称 QCST 命令说明该指令是当TE需要查询当前通话状态时，发送此命令给MT，MT接收到此命令以后，返回执行结果给TE。语法结构命令类型 格式 返回结果Ex

25、ecuteAT+QCST+QCST: OK 参数详细说明类型：整型通话状态标识0 空闲 1 主叫状态2 被叫状态示例AT+QCST+QCST:09.2 短信相关控制9.2.1 短消息发送命令名称 CMGS 命令说明该指令是当TE需要指定的电话号发送短信时，发送此命令给MT，MT接收到此命令以后，向指定的号码发送短信。语法结构命令类型 格式 返回结果ExecuteAT+CMGS=, OK 参数详细说明类型：string短消息发送目标号码，合法的字符仅包括：0-9，号码的最大长度不能超过24 短消息内容编码说明：1、 长短信内容在TE已被拆分，按单条短信的内容140个字节内的标准（ASCII编码的

26、160个字，UCS2编码的70个字的方式），向同一个号码分成多条分别发送；全部使用UCS2编码。2、 短信发送的回执状态，由ID原因值从网络侧接收;3、 短信编码转换在TE侧完成；示例AT+CMGS=, 60A8597DOK发送短信内容“您好”给用户，“您好”的UCS2编码是60A8597D9.2.2 短信到达通知命令名称 CMGI 命令说明该指令是MT终端接收到新短信后，发送该命令给TE，通知TE可以读取该短信。语法结构命令类型 格式 返回结果Execute+CMGI: “”,无 参数详细说明类型：string“UIM” 短信存储在UIM短信存储器中“MT” 短信存储在MT的内存中类型：整型

27、短消息存储位置索引示例+CMGI:MT,10表示收到一条新短信，存储在话机内存上，索引号是109.2.3 短信接收命令名称 CMGR 命令说明该指令是TE向MT读取单条短信的内容，包括对方号码，短信内容，短信接收到时间等信息。语法结构命令类型 格式 返回结果ExecuteAT+CMGR= ,+CMGR:, 参数详细说明类型：stringUIM 短信存储在UIM短信存储器中MT 短信存储在MT的内存中类型：整型短消息存储位置索引类型：string号码的最大长度不能超过24类型：stringyyyymmdd hh:mm类型：string短消息内容，采用UCS2编码。示例9.2.4 短信删除命令名称

28、 CMGD 命令说明该指令是用TE发给MT，用来删除指定短消息。MT在收到该命令后删除设备中存储的指定短消息。语法结构命令类型 格式 返回结果ExecuteAT+CMGD= , OK 参数详细说明类型：stringUIM 短信存储在UIM短信存储器中MT 短信存储在MT的内存中类型：整型短消息存储位置索引类型：整型0 删除由指定的短信。1 删除所有已读短信，保留未读短信、已发送短信和未发送电流。2 删除所有已读短信和已发送短信，保留未读短信和未发送短信。3 删除所有的已读短信、已发送短信和未发送短信，保留未读短信。4 删除所有短信，包括未读短信。示例AT+CMGD=UIM,10表示删除存储在U

29、IM卡内存上，索引号是10的短信。执行结果成功。9.2.5 短信列表处理命令名称 CMGL 命令说明该指令是用TE发给MT，用来从MT中读取收件箱，发件箱，草稿箱的短信条数。语法结构命令类型 格式 返回结果ExecuteAT+CMGL OK+CMGL:, 参数详细说明类型：整型收件箱短信条数类型：整型发件箱短信条数类型：整型草稿箱短信条数示例9.2.6 接收特定位置短信命令名称 CMMR 命令说明该指令是用TE发给MT，用来从MT中特定位置读取短信,读出后便于统计该位置中短信数量。语法结构命令类型 格式 返回结果ExecuteAT+CMMR= , +CMGR: ,” OK 参数详细说明类型：s

30、tring“UIM” 短信存储在UIM短信存储器中“MT” 短信存储在MT的内存中类型：整型短消息存储空间位置0 已读短信1 未读短信2 收件箱3 发件箱4 草稿箱类型：string号码的最大长度不能超过24类型：stringYyyymmdd hh:mm类型：string短消息内容，采用UCS2编码。示例9.2.7 短信满命令名称 CMGF 命令说明该指令是用MT发给TE，告诉TE固定台中存储的短信已经达到最大条数。9.2.8 短信传送状态命令名称 CMS 命令说明该指令是用MT发给TE，告诉TE刚才发送的短信是否成功传递到网络侧。语法结构命令类型 格式 返回结果Execute+CMS: 无

31、参数详细说明整型10代表短信发送失败；11代表短信发送成功。示例AT+CMGS=,OK (这个OK代表AT+CMGS这条命令成功传递到固定台)+CMS:11（收到这个AT消息才代表本条短信成功传递到网络）9.3 传真控制（暂不用实现）9.4 通讯检测9.4.1 链接检测命令名称 ATI 命令说明该指令是TE向MT发送检测消息，如果MT能正确回应，表示链接已经建立；如果TE在超时时间没有响应此命令，说明连接失败（超时无响应由TE向界面输出错误结果）。语法结构命令类型 格式 返回结果ExecuteAT+ATI成功：+ATIOK失败：无 参数详细说明无示例TE发送：AT+ATIMT返回：+ATIOK

32、9.4.2 通讯检测命令名称 COMU 命令说明该指令是TE向MT发起，用于检查MT当前的状态。语法结构命令类型 格式 返回结果ExecuteAT+COMU+COMU: 参数详细说明类型：整数0 MT 占用中1 MT 空闲示例9.4.3 录音设置命令名称 RECORD 命令说明该指令是TE对通话过程，是否需要MT话机配合录音进行设置。语法结构命令类型 格式 返回结果ExecuteAT+RECORD= , 参数详细说明类型：整数开关标识0 关闭录音1 开启录音类型：整数1 所有电话2 来电录音3 去电录音示例9.4.4 录音状态查询（此功能未实现）命令名称 QRCRD（未实现） 命令说明该指令是

33、TE需要对MT上配合的通话录音状态，进行查询。语法结构命令类型 格式 返回结果ExecuteAT+QRCRD+QRCRD: , 参数详细说明类型：整数开关标识0 关闭录音1 开启录音类型：整数1 所有电话2 来电录音3 去电录音示例9.4.5 获取IMSI命令名称 GETIMSI 命令说明该指令是TE需要查询MT设备的IMSI。语法结构命令类型 格式 返回结果ExecuteAT+GETIMSIOK+GETIMSI:IMSI 参数详细说明类型：字符串MT的IMSI9.4.6 获取ICCID命令名称 GETICCID 命令说明该指令是TE需要查询MT设备的ICCID。语法结构命令类型 格式 返回结

34、果ExecuteAT+GETICCIDOK+GETICCID:ICCID 参数详细说明类型：字符串卡的ICCID9.4.7 获取ESN命令名称 GETESN 命令说明该指令是TE需要查询MT设备的ESN。这个ESN是当前使用的ESN，如果插入卡片，则为卡片的UIMID；如果未插入卡片，则为终端的ESN。语法结构命令类型 格式 返回结果ExecuteAT+GETESNOK+GETESN: ESN 参数详细说明类型：字符串如果是机卡合一，则此字段为终端的ESN；如果是机卡分离，则此字段为卡片的UIMID。9.4.8 获取MEID命令名称 GETMEID 命令说明该指令是TE查询标识移动终端的唯一设备识别号。MT接收到此命令以后，将读取MT终端本身（包括机卡分离、机卡一体机）的MEID号(移动终端设备识别号)返回给T