中国移动 短信接口 CMPP30协议.docx

1、中国移动 短信接口 CMPP30协议QB-GF-028-2003中国移动通信企业标准前 言本规范规定了移动梦网短信业务开展过程中各网元（包括ISMG、GNS和SP）之间的消息类型和定义。根据业务的发展，规范中的信令操作和参数将会做进一步的调整和增加。本标准由中移技2003397号印发。本标准由中国移动通信集团公司技术部提出并归口。本标准起草单位：中国移动通信集团公司研发中心。本标准主要起草人：党京、孙若雯、于蓉蓉、袁向阳。本标准解释单位：同提出单位。1范围本规范规定了以下三方面的内容：1）业务提供商与互联网短信网关之间的接口协议；2）互联网短信网关之间的接口协议；3）互联网短信网关与汇接网关之

2、间的接口协议。本规范适用于各SP和ISMG、GNS的开发厂商。互联网短信网关（ISMG）是外部信息资源站实体（SP）与移动网内短信中心之间的中介实体，互联网短信网关一方面负责接收SP发送给移动用户的信息和提交给短信中心。另一方面，移动用户点播SP业务的信息将由短信中心通过互联网短信网关发给SP。另外，为了减轻短信中心的信令负荷，互联网短信网关还应根据路由原则将SP提交的信息转发到相应的互联网短信网关。互联网短信网关通过向汇接网关（GNS）查询的方式获得网关间的转发路由信息。2引用标准下列标准所包含的条文，通过在本标准中引用而成为本标准的条文。本标准出版时，所示版本均为有效。所有标准都会被修订，

3、使用本标准的各方应探讨使用下列标准最新版本的可能性。SMPP移动梦网短信业务技术方案3术语和定义英文缩写英文全称说明ISMGIntenet Short Message Gateway互联网短信网关DSMPData Service Manage Platform数据业务管理平台SMPPShort Message Peer to Peer短消息点对点协议CMPPChina Mobile Peer to Peer中国移动点对点协议SMSCShort Message Service Center短消息中心GNSGateway Name Server网关名称服务器（汇接网关）SPService Prov

4、ider业务提供者ISMG_Id网关代码：0XYZ010XYZ99，其中XYZ为省会区号，位数不足时左补零，如北京编号为1的网关代码为001001，江西编号为1的网关代码为079101，依此类推SP_IdSP的企业代码：网络中SP地址和身份的标识、地址翻译、计费、结算等均以企业代码为依据。企业代码以数字表示，共6位，从“9XY000”至“9XY999”，其中“XY”为各移动公司代码SP_CodeSP的服务代码：服务代码是在使用短信方式的上行类业务中，提供给用户使用的服务提供商代码。服务代码以数字表示，全国业务服务代码长度为4位，即“1000”“9999”；本地业务服务代码长度统一为5位，即“0

5、1000”“09999”；信产部对新的SP的服务代码分配提出了新的要求，要求以“1061”“1069”作为前缀，目前中国移动进行了如下分配：1062：用于省内SP服务代码1066：用于全国SP服务代码其它号段保留。Service_IdSP业务类型，数字、字母和符号的组合，由SP自定，如图片传情可定为TPCQ，股票查询可定义为114网络结构图1互联网短信网关组网结构如图1所示，互联网短信网关（ISMG）是业务提供商（SP）与移动网内短信中心之间的中介实体，互联网短信网关一方面负责接收SP发送给移动用户的信息和提交给短信中心。另一方面，移动用户点播SP业务的信息将由短信中心通过互联网短信网关发给S

6、P。另外，为了减轻短信中心的信令负荷，互联网短信网关还应根据路由原则将SP提交的信息转发到相应的互联网短信网关。互联网短信网关通过向汇接网关（GNS）查询的方式获得网关间的转发路由信息。另外，ISMG还必须与数据业务管理平台DSMP进行连接，在业务流程中对用户、业务以及定购关系等进行鉴权并对业务进行批价。5CMPP功能概述 SMPPCMPP协议主要提供以下两类业务操作：（1）短信发送（Short Message Mobile Originate，SM MO）详细的流程请参考移动梦网短信业务信令流程规范V3.0.0；（2） 短信接收（Short Message Mobile Terminated

7、，SM MT）详细的流程请参考移动梦网短信业务信令流程规范V3.0.0；6协议栈CMPP协议以TCP/IP作为底层通信承载，具体结构由图4所示：图2CMPP协议栈7通信方式各网元之间共有两种连接方式：长连接和短连接。所谓长连接，指在一个TCP连接上可以连续发送多个数据包，在TCP连接保持期间，如果没有数据包发送，需要双方发链路检测包以维持此连接。短连接是指通信双方有数据交互时，就建立一个TCP连接，数据发送完成后，则断开此TCP连接，即每次TCP连接只完成一对CMPP消息的发送。现阶段，要求ISMG之间必须采用长连接的通信方式，建议SP与ISMG之间采用长连接的通信方式。7.1长连接通信双方以

8、客户-服务器方式建立TCP连接，用于双方信息的相互提交。当信道上没有数据传输时，通信双方应每隔时间C发送链路检测包以维持此连接，当链路检测包发出超过时间T后未收到响应，应立即再发送链路检测包，再连续发送N-1次后仍未得到响应则断开此连接。参数C、T、N原则上应可配置，现阶段建议取值为：C=3分钟，T=60秒，N=3。网关与SP之间、网关之间的消息发送后等待T秒后未收到响应，应立即重发，再连续发送N-1次后仍未得到响应则停发。现阶段建议取值为：T=60秒，N=3。消息采用并发方式发送，加以滑动窗口流量控制，窗口大小参数W可配置，现阶段建议为16，即接收方在应答前一次收到的消息最多不超过16条。长

9、连接的操作流程举例如图5所示：图3长连接操作流程7.2短连接通信双方以客户-服务器方式建立TCP连接，应答与请求在同一个连接中完成。系统采用客户/服务器模式，操作以客户端驱动方式发起连接请求，完成一次操作后关闭此连接。网关与SP之间、网关之间的消息发送后等待T秒后未收到响应，应立即重发，再连续发送N-1次后仍未得到响应则停发。现阶段建议取值为：T=60秒，N=3。短连接的操作流程举例如图6所示：图4短连接操作流程7.3本协议涉及的端口号端口号应用7890长连接（SP与网关间）7900短连接（SP与网关间）7930长连接（网关之间）9168短连接（短信网关与汇接网关之间）7.4交互过程中的应答方

10、式在SP与ISMG之间、SMSC与ISMG之间及ISMG之间的交互过程中均采用异步方式，即任一个网元在收到请求消息后应立即回送响应消息。举例如图7所示：图5异步交互方式示意图8消息定义8.1基本数据类型Unsigned Integer 无符号整数Integer整数，可为正整数、负整数或零Octet String定长字符串，位数不足时，如果左补0则补ASCII表示的零以填充，如果右补0则补二进制的零以表示字符串的结束符8.2消息结构项目说明Message Header消息头(所有消息公共包头)Message Body消息体8.3消息头格式（Message Header）字段名字节数类型描述Tot

11、al_Length 4Unsigned Integer消息总长度(含消息头及消息体)Command_Id4Unsigned Integer命令或响应类型Sequence_Id4Unsigned Integer消息流水号,顺序累加,步长为1,循环使用（一对请求和应答消息的流水号必须相同）8.4业务提供商(SP)与互联网短信网关(ISMG)间的消息定义SP为客户端，向作为服务器端的ISMG发起连接请求，在通过身份验证之后SP与ISMG之间方可进行数据传输。8.4.1SP请求连接到ISMG（CMPP_CONNECT）操作CMPP_CONNECT操作的目的是SP向ISMG注册作为一个合法SP身份，若注

12、册成功后即建立了应用层的连接，此后SP可以通过此ISMG接收和发送短信。ISMG以CMPP_CONNECT_RESP消息响应SP的请求。8.4.1.1CMPP_CONNECT消息定义（SPISMG）字段名字节数属性描述Source_Addr 6Octet String源地址，此处为SP_Id，即SP的企业代码。AuthenticatorSource16Octet String用于鉴别源地址。其值通过单向MD5 hash计算得出，表示如下：AuthenticatorSource =MD5（Source_Addr+9 字节的0 +shared secret+timestamp）Shared sec

13、ret 由中国移动与源地址实体事先商定，timestamp格式为：MMDDHHMMSS，即月日时分秒，10位。Version1Unsigned Integer双方协商的版本号(高位4bit表示主版本号,低位4bit表示次版本号)，对于3.0的版本，高4bit为3，低4位为0Timestamp4Unsigned Integer时间戳的明文,由客户端产生,格式为MMDDHHMMSS，即月日时分秒，10位数字的整型，右对齐 。8.4.1.2CMPP_CONNECT_RESP消息定义（ISMG SP）字段名字节数属性描述Status4Unsigned Integer状态0：正确1：消息结构错 2：非法

14、源地址 3：认证错 4：版本太高 5 ：其他错误AuthenticatorISMG16Octet StringISMG认证码，用于鉴别ISMG。其值通过单向MD5 hash计算得出，表示如下：AuthenticatorISMG =MD5（Status+AuthenticatorSource+shared secret），Shared secret 由中国移动与源地址实体事先商定，AuthenticatorSource为源地址实体发送给ISMG的对应消息CMPP_Connect中的值。 认证出错时，此项为空。Version1Unsigned Integer服务器支持的最高版本号，对于3.0的版本

15、，高4bit为3，低4位为08.4.2SP或ISMG请求拆除连接（CMPP_TERMINATE）操作CMPP_TERMINATE操作的目的是SP或ISMG基于某些原因决定拆除当前的应用层连接而发起的操作。此操作完成后SP与ISMG之间的应用层连接被释放，此后SP若再要与ISMG通信时应发起CMPP_CONNECT操作。ISMG或SP以CMPP_TERMINATE_RESP消息响应请求。8.4.2.1CMPP_TERMINATE消息定义（SP ISMG或ISMG SP）无消息体。8.4.2.2CMPP_TERMINATE_RESP消息定义（SP ISMG或ISMG SP）无消息体。8.4.3SP

16、向ISMG提交短信（CMPP_SUBMIT）操作CMPP_SUBMIT操作的目的是SP在与ISMG建立应用层连接后向ISMG提交短信。ISMG以CMPP_SUBMIT_RESP消息响应。8.4.3.1CMPP_SUBMIT消息定义（SP ISMG）字段名字节数属性描述Msg_Id8Unsigned Integer信息标识。Pk_total1Unsigned Integer相同Msg_Id的信息总条数，从1开始。Pk_number1Unsigned Integer相同Msg_Id的信息序号，从1开始。Registered_Delivery1Unsigned Integer是否要求返回状态确认报告

17、：0：不需要；1：需要。Msg_level1Unsigned Integer信息级别。Service_Id10Octet String业务标识，是数字、字母和符号的组合。Fee_UserType1Unsigned Integer计费用户类型字段：0：对目的终端MSISDN计费；1：对源终端MSISDN计费；2：对SP计费；3：表示本字段无效，对谁计费参见Fee_terminal_Id字段。Fee_terminal_Id32Octet String被计费用户的号码，当Fee_UserType为3时该值有效，当Fee_UserType为0、1、2时该值无意义。Fee_terminal_type1U

18、nsigned Integer被计费用户的号码类型，0：真实号码；1：伪码。TP_pId1Unsigned IntegerGSM协议类型。详细是解释请参考GSM03.40中的9.2.3.9。TP_udhi1Unsigned IntegerGSM协议类型。详细是解释请参考GSM03.40中的9.2.3.23,仅使用1位，右对齐。Msg_Fmt1Unsigned Integer信息格式：0：ASCII串；3：短信写卡操作；4：二进制信息；8：UCS2编码；15：含GB汉字。Msg_src6Octet String信息内容来源(SP_Id)。FeeType2Octet String资费类别：01：对

19、“计费用户号码”免费；02：对“计费用户号码”按条计信息费；03：对“计费用户号码”按包月收取信息费。FeeCode6Octet String资费（以分为单位）。ValId_Time17Octet String存活有效期，格式遵循SMPP3.3协议。At_Time17Octet String定时发送时间，格式遵循SMPP3.3协议。Src_Id21Octet String源号码。SP的服务代码或前缀为服务代码的长号码, 网关将该号码完整的填到SMPP协议Submit_SM消息相应的source_addr字段，该号码最终在用户手机上显示为短消息的主叫号码。DestUsr_tl1Unsigned

20、Integer接收信息的用户数量(小于100个用户)。Dest_terminal_Id32*DestUsr_tlOctet String接收短信的MSISDN号码。Dest_terminal_type1Unsigned Integer接收短信的用户的号码类型，0：真实号码；1：伪码。Msg_Length1Unsigned Integer信息长度(Msg_Fmt值为0时：160个字节；其它=140个字节)，取值大于或等于0。Msg_ContentMsg_lengthOctet String信息内容。LinkID20Octet String点播业务使用的LinkID，非点播类业务的MT流程不使用该

21、字段。系统应该支持短信的群发功能，关于短信群发功能的实现请参阅“附录1 短信群发功能的实现”。8.4.3.2CMPP_SUBMIT_RESP消息定义（ISMG SP）字段名字节数属性描述Msg_Id8Unsigned Integer信息标识，生成算法如下：采用64位（8字节）的整数：（1）时间（格式为MMDDHHMMSS，即月日时分秒）：bit64bit39，其中bit64bit61：月份的二进制表示；bit60bit56：日的二进制表示；bit55bit51：小时的二进制表示；bit50bit45：分的二进制表示；bit44bit39：秒的二进制表示；（2）短信网关代码：bit38bit17

22、，把短信网关的代码转换为整数填写到该字段中；（3）序列号：bit16bit1，顺序增加，步长为1，循环使用。各部分如不能填满，左补零，右对齐。（SP根据请求和应答消息的Sequence_Id一致性就可得到CMPP_Submit消息的Msg_Id）Result4Unsigned Integer结果：0：正确；1：消息结构错； 2：命令字错； 3：消息序号重复；4：消息长度错；5：资费错；6：超过最大信息长；7：业务代码错；8：流量控制错；9：本网关不负责服务此计费号码；10：Src_Id错误；11：Msg_src错误；12：Fee_terminal_Id错误；13：Dest_terminal_I

23、d错误；8.4.4SP向ISMG查询发送短信状态（CMPP_QUERY）操作CMPP_QUERY操作的目的是SP向ISMG查询某时间的业务统计情况，可以按总数或按业务代码查询。ISMG以CMPP_QUERY_RESP应答。8.4.4.1CMPP_QUERY消息的定义（SP ISMG）字段名字节数属性描述Time8Octet String时间YYYYMMDD(精确至日)。Query_Type1Unsigned Integer查询类别：0：总数查询；1：按业务类型查询。Query_Code10Octet String查询码。当Query_Type为0时，此项无效；当Query_Type为1时，此项

24、填写业务类型Service_Id.。Reserve8Octet String保留。8.4.4.2CMPP_QUERY_RESP消息的定义（ISMG SP）字段名字节数属性描述Time8Octet String时间(精确至日)。Query_Type1Unsigned Integer查询类别：0：总数查询；1：按业务类型查询。Query_Code10Octet String查询码。MT_TLMsg4Unsigned Integer从SP接收信息总数。MT_Tlusr4Unsigned Integer从SP接收用户总数。MT_Scs4Unsigned Integer成功转发数量。MT_WT4Unsi

25、gned Integer待转发数量。MT_FL4Unsigned Integer转发失败数量。MO_Scs4Unsigned Integer向SP成功送达数量。MO_WT4Unsigned Integer向SP待送达数量。MO_FL4Unsigned Integer向SP送达失败数量。8.4.5ISMG向SP送交短信（CMPP_DELIVER）操作CMPP_DELIVER操作的目的是ISMG把从短信中心或其它ISMG转发来的短信送交SP，SP以CMPP_DELIVER_RESP消息回应。8.4.5.1CMPP_DELIVER消息定义（ISMG SP）字段名字节数属性描述Msg_Id8Unsig

26、ned Integer信息标识。生成算法如下：采用64位（8字节）的整数：（1）时间（格式为MMDDHHMMSS，即月日时分秒）：bit64bit39，其中bit64bit61：月份的二进制表示；bit60bit56：日的二进制表示；bit55bit51：小时的二进制表示；bit50bit45：分的二进制表示；bit44bit39：秒的二进制表示；（2）短信网关代码：bit38bit17，把短信网关的代码转换为整数填写到该字段中；（3）序列号：bit16bit1，顺序增加，步长为1，循环使用。各部分如不能填满，左补零，右对齐。Dest_Id21Octet String目的号码。SP的服务代码，

27、或者是前缀为服务代码的长号码；该号码是手机用户短消息的被叫号码。Service_Id10Octet String业务标识，是数字、字母和符号的组合。TP_pid1Unsigned IntegerGSM协议类型。详细解释请参考GSM03.40中的9.2.3.9。TP_udhi1Unsigned IntegerGSM协议类型。详细解释请参考GSM03.40中的9.2.3.23，仅使用1位，右对齐。Msg_Fmt1Unsigned Integer信息格式：0：ASCII串；3：短信写卡操作；4：二进制信息；8：UCS2编码；15：含GB汉字。Src_terminal_Id32Octet String

28、源终端MSISDN号码（状态报告时填为CMPP_SUBMIT消息的目的终端号码）。Src_terminal_type1Unsigned Integer源终端号码类型，0：真实号码；1：伪码。Registered_Delivery1Unsigned Integer是否为状态报告：0：非状态报告；1：状态报告。Msg_Length1Unsigned Integer消息长度，取值大于或等于0。Msg_ContentMsg_lengthOctet String消息内容。LinkID20Octet String点播业务使用的LinkID，非点播类业务的MT流程不使用该字段。当ISMG向SP送交状态报告时

29、，信息内容字段（Msg_Content）格式定义如下：字段名字节数属性描述Msg_Id8Unsigned Integer信息标识。SP提交短信（CMPP_SUBMIT）操作时，与SP相连的ISMG产生的Msg_Id。Stat7Octet String发送短信的应答结果，含义详见表一。SP根据该字段确定CMPP_SUBMIT消息的处理状态。Submit_time10Octet StringYYMMDDHHMM（YY为年的后两位00-99，MM：01-12，DD：01-31，HH：00-23，MM：00-59）。Done_time10Octet StringYYMMDDHHMM。Dest_terminal_Id32Octet String目的终端MSISDN号码(SP发送CMPP_SUBMIT消息的目标终端)。SMSC_sequenc