搜索
旺铺助手-功能规范（V1.0）第0页共39页中中中国国国电电电信信信智智智能能能无无无线线线座座座机机机的的的二二二次次次开开开发发发接接接口口口协协协议议议命命命令令令接接接口口口分分分册册册2010-3-22旺铺助手－功能规范V1.0第1页共39页1本规范说明1.1.本规范的内容和适用范围本规范对旺铺助手终端（包括数据卡、USBModem和CDMA手机）与旺铺客户端软件采用的AT命令做出规定，中国电信内部和厂商共同使用，用于在业务及设备开发上为集团公司和省公司提供技术依据；适用于以旺铺助手终端为代表的移动终端产品。1.2.本规范的编写依据本规范主要根据中国电信政企客户市场需求，结合各省市相关产品规范而制订。下列标准所包含的条文，通过在本规范中引用而构成为本规范的条文。凡是注日期的引用标准，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本规范，若其被修订，使用本规范的各方应探讨使用其最新版本的可能性。凡是不注日期的引用标准，其最新版本适用于本规范。[1]ETSIGSM07.07[2]ETSIGSM07.07[3]TIA-EIA-IS-707-A.3[4]ITU-TRecommendationV.25ter[14]CDMAB端需求规范－RevA数据终端AT命令接口分册2参考资料3缩略语缩略语英文全名中文解释3GPPThirdGenerationPartnershipProject第三代伙伴计划BERBiterrorrate误码率CDMACodeDivisionMultipleAccess码分多址CLIPCallLineIdentifierpresentation呼叫号码显示DCEDataCircuitEquipment数据电路设备DCSDatacodingscheme数据编码方案旺铺助手-功能规范（V1.0）第2页共39页DTEDataTerminalEquipment数据终端设备GPRSGeneralPacketRadioService通用分组无线系统GSMGlobalSystemforMobileCommunications全球移动通信HDRHighDataRate高速数据传输技术IMEIInternationalMobileEquipmentIdentity国际移动设备标识ITU-TInternationalTelecommunicationUnion-TelecommunicationStandardizationSector国际电信联盟-电信标准部IWFInterworkingFunction网络互通功能单元MTMobileTerminal移动终端PDPPacketDataProtocol包交换协议PINPersonalIdentityNumber个人身份识别码PLMNPubliclandmobilenetwork公用陆地移动网络PUKPersonalIdentityNumber个人标识码RPLMNRegisteredPLMN注册PLMNRSSIReceivesignalstrengthindicator接收信号强度指示SCASeviceCenterAddress服务中心号码SIMGSMSubscriberIdentityModule用户标识组件SMShortmessage短信TETerminalEquipment终端设备，这里指在PC上运行的统一终端客户端软件UIMUserIdentityModule用户标识模块URCUnsolicitedresultcode主动上报结果码，如振铃上报、短信上报、状态改变上报等。USIMUniversalSubscriberIdentityModule用户业务标识组件旺铺助手-功能规范（V1.0）第3页共39页4命令参数定义一、必选参数必选表明一项特性是强制要求、即终端必须支持的，该特性作为终端入网测试的必选条件，测试时有对应的测试用例。必须参数用“...”表示，...里面参数必须要填写，命令中本身不出现二、可选参数可选表明一项特性是非强制要求、但运营商不关注是否被终端支持的，由终端厂家自行决定是否支持，该特性是终端入网测试的可选条件，测试时有对应的测试用例。可选参数用“[...]”表示，[...]括号中参数为可选项，命令或者响应中[]本身不出现。三、厂家自定义参数厂家自定义参数推荐表明一项特性是非强制要求、且运营商希望终端支持的，但由终端厂家自行决定是否支持。该特性在终端入网测试中不予考虑，测试时没有对应的测试用例。厂家自定义参数参数用“{...}”表示，{...}括号中参数为可选项，命令或者响应中{}本身不出现。四、其他CR命令结束符。LF换行符。旺铺助手-功能规范（V1.0）第4页共39页5AT指令概述T指令接口图8-1如所示：MTTEATcmdsResultcodesInformationtextUSER&APPLICATIONSNetworkNetworkmessagesAT指令接口示意图6AT指令语法可选参数和必配参数必须按照规定的顺序排列，各参数间必须用逗号隔开。举例：AT+CPWD=fac,oldpwd,newpwd该命令用于为设备锁定+CLCK命令所定义的设备锁定功能设置新的密码。如果某参数是字符串（比如：number），该字符串必须放在双引号中。例如：”12345”、”cmnet”双引号中的各项符号可看作是字符串。注意：呼叫或发送短信时使用的电话号码不是普通字符串，不要加引号。命令的可选子参数或TA返回结果的可选部分位于方括号中。不使用双引号时，字符串中各字符间的空格可忽略不计。实际使用中，，[]，{}不必输入。所有AT指令本身不区分大小写。旺铺助手-功能规范（V1.0）第5页共39页7AT指令接口说明要求接口功能内聚。本业务规范中，AT指令应用在PC的USB通信端口和终端设备连接。对所传输的数据包大小做出定义：对于AT指令的发送，除AT两个字符外，最多可以接收1056个字符的长度（包括最后的空字符）。MT主动上报的response消息或者URC，最大长度都限定在1048个字符范围之内。每个命令行中只能包含一条AT指令；对于由MT主动向TE报告的URC指示或者response响应，也要求一行最多有一个，不允许上报的一行中有多条指示或者响应。AT指令以回车作为结尾，响应或上报以回车换行为结尾，原则上不允许用户使用。该原则适用于MT和TE程序的通信。为了增加命令以及响应格式的可读性及规范性，除标准协议原有接口外，所有新增加的接口中，例如：AT^XXX:arg0,arg1之类的命令或者^，冒号以及逗号后都不能含空格，首尾不能包含冗余空格。该原则适用于MT和TE程序的通信。TE在每一条AT指令下发后，必须要等待MT对于这条AT指令响应后，才能再次下发第二条AT指令；否则下发的第二条AT指令将不被执行。对于较长时间才能反馈结果的AT指令，为保证其他事务不被干扰，建议以异步方式上报最终执行结果。若MT需要较长时间以响应TE，则可能存在响应结果被URC打断的情况，这种打断包含两种情况，一种是当命令下发后等待响应过程中有URC上报，则URC上报后，这个命令仍处于等待命令执行结果过程中，执行结果仍旧上报；另一种是当命令下发后等待响应过程中有URC上报时，命令仍旧会被继续执行，此时URC上报的内容和命令响应的内容可能夹杂在一起上报。对于RING这种特殊的URC，在一些特殊的情况下，也会作为命令终结符使用，如下发挂机命令等待响应过程中时，有RING上报，则挂机命令被异常终止。对字符串的定义：由双引号包括起来的，不含引号或逗号的字节流。TE下发命令的字符串中不能出现引号+逗号的组合（会造成参数和字符串旺铺助手-功能规范（V1.0）第6页共39页无法区分的情况）。当前版本中，不支持字符转义。对于UCS2编码的数据格式，以字符格式上报其编码值（如一个汉字的UCS2编码为0x553a，则上报553a）。8AT指令接口准则1.新增接口改动准则对于扩展的接口，AT指令参数后面可以直接添加参数，因此在产品开发后期若发现接口无法适应新的需求，则只允许在原有接口基础之上在后面新增参数。新增的参数不应该对原有功能有影响。2.对于本产品不支持功能的设计原则对于所有当前已经制定的接口，若MT接收到的命令是不能识别的，则上报COMMANDNOTSUPPORT的resultcode；若命令参数多了一个，则可以有两种实现方法，一种是MT上报对应的TOOMANYPARAMETERS的resultcode，命令参数多余的情况不包括等号本身在内。另一种做法是进行容错处理，对多余的参数不进行判断。具体选用那种方法，需要根据该命令是否需要严格限制为依据。3.接口使用的优先顺序接口当中国电信私有接口与标准接口的功能有重复和类似时，TE的调用顺序一般需遵循“优先使用私有接口”的顺序，只有当产品不支持私有接口时，才使用标准接口。4.命令名称中国电信的私有AT指令以“^”开头，且规定：AT^XXX的AT指令名中，X的个数目前暂定不能超过9个。其余AT指令为公共指令。9接口命令旺铺助手-功能规范（V1.0）第7页共39页9.1语言呼叫控制9.1.1摘机命令名称HOOKUP命令说明该指令是MT话机摘机时（手柄/免提），话机发送给TE(上位机软件)的消息。用来给上位机TE显示摘机状态。语法结构命令类型格式返回结果ExecuteCRLF+HOOKUPCRLF参数参数详细说明无示例CDMA商务话机摘机，话机自动发送“+HOOKUP”给旺铺助手软件。9.1.2挂机命令名称HOOKDOWN命令说明该指令是MT（话机）挂机时（手柄/免提），话机发送给TE(上位机软件)的消息。用来给上位机TE显示终端话机挂机状态。旺铺助手-功能规范（V1.0）第8页共39页语法结构命令类型格式返回结果ExecuteCRLF+HOOKDOWNCRLF参数参数详细说明无示例CDMA商务话机挂机，话机自动发送“+HOOKDOWN”给旺铺助手软件。9.1.3MT拨号呼出命令名称CORG命令说明该指令是MT（话机）拨出电话号码时，上报此命令给TE，包含这个呼叫的呼出号码（用于终端界面上同步显示）。语法结构命令类型格式返回结果ExecuteCRLF+CORG:dialstringCRLF参数参数详细说明dialstring类型：string合法的字符仅包括：’0’-‘9’,’*’,’#’,’+’。’+’只能出现在号码的最前面，号码的最大长度不能超过24示例+CORG:18900000000旺铺助手-功能规范（V1.0）第9页共39页9.1.4TE拨号呼出命令名称CALLOUT命令说明该指令是TE（话机）拨出电话号码时，发送给MT的命令。MT接收到此命令以后，向指定的号码发起呼叫。语法结构命令类型格式返回结果ExecuteAT+CALLOUT=dialstringCRCRLFOKCRLF示例AT+CALLOUT=189000000009.1.5终端电话接听命令名称ANSWER命令说明TE需要MT设备接听电话时发送此命令。语法结构命令类型格式返回结果ExecuteAT+ANSWERCRCRLFOKCRLF参数参数详细说明旺铺助手-功能规范（V1.0）第10页共39页9.1.6终端挂断电话命令名称CALLEND命令说明TE要求MT设备挂断电话时发送此命令。语法结构命令类型格式返回结果ExecuteAT+CALLENDCRCRLFOKCRLF参数参数详细说明示例1.1.1获取信号强度命令名称GETRSSI命令说明用于TE获取MT信号强度。语法结构命令类型格式返回结果ExecuteAT+GETRSSICRCRLF+GETRSSI:levCRLF参数参数详细说明lev类型：整型lev0-4旺铺助手-功能规范（V1.0）第11页共39页示例1