cmpp20.docx

1、cmpp20中国移动通信互联网短信网关接口协议(China Mobile Peer to Peer, CMPP)（V2.0）中国移动通信集团公司2002年4月目 录前 言 41 范围 52 缩略语 53网络结构 64CMPP功能概述 65. 协议栈 86. 通信方式 86.1 长连接 96.2 短连接 116.3 本协议中涉及的端口号 126.4 交互过程中的应答方式 127消息定义 127.1基本数据类型 127.2消息结构 137.3 消息头格式（Message Header） 137.4信息资源站实体(SP)与互联网短信网关(ISMG)间的消息定义 137.4.1 SP请求连接到ISMG

2、（CMPP_CONNECT）操作 137.4.1.1 CMPP_CONNECT消息定义（SPISMG） 137.4.1.2 CMPP_CONNECT_RESP消息定义（ISMG SP） 147.4.2 SP或ISMG请求拆除连接（CMPP_TERMINATE）操作 147.4.2.1 CMPP_TERMINATE消息定义（SPISMG或ISMG SP） 147.4.2.2 CMPP_TERMINATE_RESP消息定义（SPISMG或ISMG SP） 147.4.3 SP向ISMG提交短信（CMPP_SUBMIT）操作 157.4.3.1 CMPP_SUBMIT消息定义（SPISMG） 157

3、.4.3.2 CMPP_SUBMIT_RESP消息定义（ISMG SP） 167.4.4 SP向ISMG查询发送短信状态（CMPP_QUERY）操作 177.4.4.1 CMPP_QUERY消息的定义（SPISMG） 177.4.4.2 CMPP_QUERY_RESP消息的定义（ISMG SP） 177.4.5 ISMG向SP送交短信（CMPP_DELIVER）操作 187.4.5.1 CMPP_DELIVER消息定义（ISMGSP） 187.4.5.2 CMPP_DELIVER_RESP消息定义（SP ISMG） 207.4.6 SP向ISMG发起删除短信（CMPP_CANCEL）操作 20

4、7.4.6.1 CMPP_CANCEL消息定义（SP ISMG） 207.4.6.2 CMPP_CANCEL_RESP消息定义（ISMG SP） 207.4.7 链路检测（CMPP_ACTIVE_TEST）操作 217.4.7.1 CMPP_ACTIVE_TEST定义（SP ISMG或ISMGSP） 217.4.7.2 CMPP_ACTIVE_TEST_RESP定义（SP ISMG或ISMGSP） 217.5互联网短信网关(ISMG)之间的消息定义 217.5.1 源ISMG请求连接到目的ISMG（CMPP_CONNECT）操作 217.5.2 源ISMG请求拆除到目的ISMG的连接（CMPP

5、_TERMINATE）操作 217.5.3链路检测（CMPP_ACTIVE_TEST）操作 217.5.4 源ISMG向目的ISMG转发短信（CMPP_FWD）操作 217.5.4.1 CMPP_FWD定义（ISMG ISMG） 217.5.4.2 CMPP_FWD_RESP定义（ISMG ISMG） 257.6互联网短信网关(ISMG)与汇接网关(GNS)之间的消息定义 257.6.1 ISMG请求连接到GNS或GNS请求连接到ISMG（CMPP_CONNECT）操作 257.6.2 ISMG请求拆除到GNS的连接或GNS请求拆除到ISMG的连接（CMPP_TERMINATE）操作 267.

6、6.3 ISMG向汇接网关查询MT路由（CMPP_MT_ROUTE）操作 267.6.3.1 CMPP_MT_ROUTE消息定义（ISMGGNS） 267.6.3.2 CMPP_MT_ROUTE_RESP消息定义（GNS ISMG） 267.6.4 ISMG向汇接网关查询MO路由（CMPP_MO_ROUTE）操作 267.6.4.1 CMPP_MO_ROUTE消息定义（ISMGGNS） 267.6.4.2 CMPP_MO_ROUTE_RESP消息定义（GNS ISMG） 277.6.5ISMG向汇接网关获取路由（CMPP_GET_ROUTE）操作 277.6.5.1 CMPP_GET_ ROU

7、TE消息定义（ISMGGNS） 277.6.5.2 CMPP_GET_ ROUTE_RESP消息定义（GNS ISMG） 277.6.6 ISMG向汇接网关更新MT路由（CMPP_MT_ROUTE_UPDATE）操作 287.6.6.1 CMPP_MT_ROUTE_UPDATE消息定义（ISMGGNS） 287.6.6.2 CMPP_MT_ROUTE_UPDATE_RESP消息定义（GNS ISMG） 287.6.7 ISMG向汇接网关更新MO路由（CMPP_MO_ROUTE_UPDATE）操作 297.6.7.1 CMPP_MO_ROUTE_UPDATE消息定义（ISMGGNS） 297.6

8、.7.2CMPP_MO_ROUTE_UPDATE_RESP消息定义（GNS ISMG） 297.6.8汇接网关向ISMG更新MT路由（CMPP_PUSH_MT_ROUTE_UPDATE）操作 297.6.8.1 CMPP_PUSH_MT_ROUTE_UPDATE消息定义（GNSISMG） 307.6.8.2 CMPP_PUSH_MT_ROUTE_UPDATE_RESP消息定义（ISMG GNS） 307.6.9汇接网关向ISMG更新MO路由（CMPP_PUSH_MO_ROUTE_UPDATE）操作 307.6.9.1 CMPP_PUSH_MO_ROUTE_UPDATE消息定义（GNSISMG）

9、 307.6.9.2 CMPP_PUSH_MO_ROUTE_UPDATE_RESP消息定义（ISMG GNS） 317.7系统定义 317.7.1 Command_Id定义 31附录1 MO状态报告的产生 32修订历史 34前 言 本规范为中国移动通信集团公司企业规范，简称CMPP，现阶段版本是对1.2.1版修订后形成的，为2.0版。本规范描述了中国移动短信业务中各网元（包括ISMG、GNS和SP）之间的相关消息的类型和定义。根据业务的发展，规范中的信令操作和参数将会做进一步的调整和增加。本规范解释权属于中国移动通信集团公司。本规范起草单位：中国移动通信集团公司研发中心。1 范围本规范规定了以

10、下三方面的内容：（1） 信息资源站实体与互联网短信网关之间的接口协议；（2） 互联网短信网关之间的接口协议；（3） 互联网短信网关与汇接网关之间的接口协议。本规范适用于各SP和ISMG的开发厂商。2 缩略语英文缩写英文全称说明ISMG Internet Short Message Gateway互联网短信网关SMPP Short Message Peer to Peer短消息点对点协议CMPP China Mobile Peer to Peer中国移动点对点协议SMCShort Message Center短消息中心GNS Gateway Name Server网关名称服务器（汇接网关）SP

11、Service Provider业务提供者，即信息资源站实体SMCShort Message ControlSP为收取包月业务费用而向网关发送的消息，网关收到后不送给用户仅产生相应的话单；ISMG_Id网关代码：0XYZ010XYZ99，其中XYZ为省会区号，位数不足时左补零，如北京编号为1的网关代码为001001，江西编号为1的网关代码为079101，依此类推。SP_IdSP的企业代码：网络中SP地址和身 份的标识、地址翻译、计费、结算等 均以企业代码为依据。企业代码以数 字表示，共6位，从“9XY000”至 “9XY999”，其中“XY”为各移动公 司代码。SP_CodeSP的服务代码：服

12、务代码是在使用 短信方式的点播类业务中，提供给 用户点播的内容/应用服务提供商代 码。服务代码以数字表示，全国业 务服务代码长度统一为 4 位，即 “1000”“9999”；本地业务服务 代码长度统一为5 位，即 “01000”“09999”。Service_IdSP的业务类型，数字、字母和符号的 组合，由SP自定，如图片传情可定 为TPCQ，股票查询可定义为11。3网络结构如图1所示，互联网短信网关（ISMG）是外部信息资源站实体（SP）与移动网内短信中心之间的中介实体，互联网短信网关一方面负责接收SP发送给移动用户的信息和提交给短信中心。另一方面，移动用户点播SP业务的信息将由短信中心通过

13、互联网短信网关发给SP。另外，为了减轻短信中心的信令负荷，互联网短信网关还应根据路由原则将SP提交的信息转发到相应的互联网短信网关。互联网短信网关通过向汇接网关（GNS）查询的方式获得网关间的转发路由信息。4CMPP功能概述CMPP协议主要提供以下两类业务操作：（1） 短信发送（Short Message Mobile Originate，SM MO）典型的业务操作举例如图2所示：2图2 需要前转的MO示意图 1) 手机发出数据请求（可能是订阅信息或图片点播等），被源ISMG接收；2) 源ISMG对接收到的信息返回响应；3) 源ISMG在本地查询不到要连接的SP，向GNS(汇接网关)发路由请求

14、信息；4) GNS将路由信息返回；5) 源ISMG根据路由信息将请求前转给目的ISMG；6) 目的ISMG对接收到的信息返回响应；7) 目的ISMG将请求信息送SP8) SP返回响应；在以上操作中，步骤3到步骤8均使用CMPP协议；在随后的操作中，目的ISMG在接收到SP的响应后将产生MO状态报告发给源ISMG。（2） 短信接收（Short Message Mobile Terminated，SM MT）典型的业务操作举例如图3所示：8图3 需要前转的MT示意图 1) SP发出数据请求（可能是短信通知或手机铃声等），被源ISMG接收；2) 源ISMG对接收到的信息返回响应；3) 源ISMG在本

15、地数据库中找不到要目的手机号段所对应网关代码，向GNS（汇接网关）发路由请求信息；4) 汇接网关将路由信息返回；5) 源ISMG根据路由信息将请求前转给目的ISMG；6) 目的ISMG对接收到的信息返回响应；7) 目的ISMG将请求信息发送至SMC；8) SMC向目的ISMG返回响应；在上述操作中，步骤1到步骤6均使用CMPP协议；在随后的操作中，SMC将通过NO.7信令网向移动用户发送信息，移动用户收到后将返回状态报告（Delivery-Receipt）给短信中心，短信中心将按照MO操作的流程将状态报告返回给SP（如果SP要求返回状态报告）。5. 协议栈CMPP协议以TCP/IP作为底层通信

16、承载，具体结构由图4所示： GNS图4 CMPP协议栈6. 通信方式SP与ISMG之间、ISMG之间进行信息交互时，可以采用长连接方式，也可以采用短连接方式。所谓长连接，指在一个TCP连接上可以连续发送多个数据包，在TCP连接保持期间，如果没有数据包发送，需要双方发链路检测包以维持此连接。短连接是指通信双方有数据交互时，就建立一个TCP连接，数据发送完成后，则断开此TCP连接，即每次TCP连接只完成一对CMPP消息的发送。 .1 长连接通信双方以客户-服务器方式建立TCP连接，用于双方信息的相互提交。当信道上没有数据传输时，通信双方应每隔时间C发送链路检测包以维持此连接，当链路检测包发出超过时

17、间T后未收到响应，应立即再发送链路检测包，再连续发送N-1次后仍未得到响应则断开此连接。 参数C、T、N原则上应可配置，现阶段建议取值为：C=3分钟，T=60秒，N=3。 网关与SP之间、网关之间的消息发送后等待T秒后未收到响应，应立即重发，再连续发送N-1次后仍未得到响应则停发。现阶段建议取值为：T=60秒，N=3。 消息采用并发方式发送，加以滑动窗口流量控制，窗口大小参数W可配置，现阶段建议为16，即接收方在应答前一次收到的消息最多不超过16条。 长连接的操作流程举例如图5所示： . . . . . . 拆除TCP连接建立TCP连接对CMPP消息2的响应对CMPP消息1的响应CMPP消息2

18、服务器端客户端CMPP消息1滑动窗口不大于W W链路检测包 链路检测包响应 链路检测包响应 . . . . . . 图5 长连接一次操作流程.2 短连接通信双方以客户-服务器方式建立TCP连接，应答与请求在同一个连接中完成。系统采用客户/服务器模式，操作以客户端驱动方式发起连接请求，完成一次操作后关闭此连接。 网关与SP之间、网关之间的消息发送后等待T秒后未收到响应，应立即重发，再连续发送N-1次后仍未得到响应则停发。现阶段建议取值为：T=60秒，N=3。短连接的操作流程举例如图6所示： . . . . . . 拆除TCP连接服务器/客户端客户端/服务器端 建立TCP连接CMPP消息2对CMP

19、P消息2的响应拆除TCP连接图6 短连接的操作流程6.3 本协议中涉及的端口号端口号应用7890 长连接（SP与网关间）7900短连接（SP与网关间或网关之间）7930 长连接（网关之间）9168短连接（短信网关与汇接网关之间）6.4 交互过程中的应答方式在SP与ISMG之间、SMC与ISMG之间及ISMG之间的交互过程中均采用异步方式，即任一个网元在收到请求消息后应立即回送响应消息。举例如图7所示： SMC SP ISMG2 ISMG1 SMPP响应消息 SMPP请求消息CMPP响应消息CMPP响应消息图7 异步交互方式示意图7消息定义 7.1基本数据类型Unsigned Integer 无

20、符号整数Integer整数，可为正整数、负整数或零Octet String定长字符串，位数不足时，如果左补0则补ASCII表示的零，如果右补0则补二进制的零7.2消息结构项目说明Message Header消息头(所有消息公共包头)Message Body消息体7.3 消息头格式（Message Header）字段名字节数类型描述Total_Length 4Unsigned Integer消息总长度(含消息头及消息体)Command_Id4Unsigned Integer命令或响应类型Sequence_Id4Unsigned Integer消息流水号,顺序累加,步长为1,循环使用（一对请求和应

21、答消息的流水号必须相同）7.4信息资源站实体(SP)与互联网短信网关(ISMG)间的消息定义SP与ISMG之间互为客户/服务器，但要求SP首先以客户的身份请求连接到ISMG，之后SP与ISMG之间方可进行数据传输。7.4.1 SP请求连接到ISMG（CMPP_CONNECT）操作CMPP_CONNECT操作的目的是SP向ISMG注册作为一个合法SP身份，若注册成功后即建立了应用层的连接，此后SP可以通过此ISMG接收和发送短信。ISMG以CMPP_CONNECT_RESP消息响应SP的请求。7.4.1.1 CMPP_CONNECT消息定义（SPISMG）字段名字节数属性描述Source_Add

22、r 6Octet String源地址，此处为SP_Id，即SP的企业代码。AuthenticatorSource16Octet String用于鉴别源地址。其值通过单向MD5 hash计算得出，表示如下：AuthenticatorSource =MD5（Source_Addr+9 字节的0 +shared secret+timestamp）Shared secret 由中国移动与源地址实体事先商定，timestamp格式为：MMDDHHMMSS，即月日时分秒，10位。Version1Unsigned Integer双方协商的版本号(高位4bit表示主版本号,低位4bit表示次版本号)Times

23、tamp4Unsigned Integer时间戳的明文,由客户端产生,格式为MMDDHHMMSS，即月日时分秒，10位数字的整型，右对齐 。7.4.1.2 CMPP_CONNECT_RESP消息定义（ISMG SP）字段名字节数属性描述Status1Unsigned Integer状态0：正确1：消息结构错 2：非法源地址 3：认证错 4：版本太高 5 ：其他错误AuthenticatorISMG16Octet StringISMG认证码，用于鉴别ISMG。其值通过单向MD5 hash计算得出，表示如下：AuthenticatorISMG =MD5（Status+AuthenticatorSo

24、urce+shared secret），Shared secret 由中国移动与源地址实体事先商定，AuthenticatorSource为源地址实体发送给ISMG的对应消息CMPP_Connect中的值。 认证出错时，此项为空。Version1Unsigned Integer服务器支持的最高版本号7.4.2 SP或ISMG请求拆除连接（CMPP_TERMINATE）操作CMPP_TERMINATE操作的目的是SP或ISMG基于某些原因决定拆除当前的应用层连接而发起的操作。此操作完成后SP与ISMG之间的应用层连接被释放，此后SP若再要与ISMG通信时应发起CMPP_CONNECT操作。ISM

25、G或SP以CMPP_TERMINATE_RESP消息响应请求。7.4.2.1 CMPP_TERMINATE消息定义（SPISMG或ISMG SP）无消息体。7.4.2.2 CMPP_TERMINATE_RESP消息定义（SPISMG或ISMG SP）无消息体。7.4.3 SP向ISMG提交短信（CMPP_SUBMIT）操作CMPP_SUBMIT操作的目的是SP在与ISMG建立应用层连接后向ISMG提交短信。ISMG以CMPP_SUBMIT_RESP消息响应。7.4.3.1 CMPP_SUBMIT消息定义（SPISMG）字段名字节数属性描述Msg_Id8Unsigned Integer信息标识，

26、由SP侧短信网关本身产生，本处填空。Pk_total1Unsigned Integer相同Msg_Id的信息总条数，从1开始Pk_number1Unsigned Integer相同Msg_Id的信息序号，从1开始Registered_Delivery1Unsigned Integer是否要求返回状态确认报告：0：不需要1：需要2：产生SMC话单 （该类型短信仅供网关计费使用，不发送给目的终端)Msg_level1Unsigned Integer信息级别Service_Id10Octet String业务类型，是数字、字母和符号的组合。Fee_UserType1Unsigned Integer计

27、费用户类型字段0：对目的终端MSISDN计费；1：对源终端MSISDN计费；2：对SP计费;3：表示本字段无效，对谁计费参见Fee_terminal_Id字段。Fee_terminal_Id21Unsigned Integer被计费用户的号码（如本字节填空，则表示本字段无效，对谁计费参见Fee_UserType字段，本字段与Fee_UserType字段互斥）TP_pId1Unsigned IntegerGSM协议类型。详细是解释请参考GSM03.40中的9.2.3.9TP_udhi1Unsigned IntegerGSM协议类型。详细是解释请参考GSM03.40中的9.2.3.23,仅使用1位

28、，右对齐Msg_Fmt1Unsigned Integer信息格式 0：ASCII串 3：短信写卡操作 4：二进制信息 8：UCS2编码15：含GB汉字 。 Msg_src6Octet String信息内容来源(SP_Id)FeeType2Octet String资费类别01：对“计费用户号码”免费02：对“计费用户号码”按条计信息费03：对“计费用户号码”按包月收取信息费04：对“计费用户号码”的信息费封顶05：对“计费用户号码”的收费是由SP实现FeeCode6Octet String资费代码（以分为单位）ValId_Time17Octet String存活有效期，格式遵循SMPP3.3协议

29、At_Time17Octet String定时发送时间，格式遵循SMPP3.3协议Src_Id21Octet String源号码SP的服务代码或前缀为服务代码的长号码, 网关将该号码完整的填到SMPP协议Submit_SM消息相应的source_addr字段，该号码最终在用户手机上显示为短消息的主叫号码DestUsr_tl1Unsigned Integer接收信息的用户数量(小于100个用户)Dest_terminal_Id21*DestUsr_tlOctet String接收短信的MSISDN号码Msg_Length1Unsigned Integer信息长度(Msg_Fmt值为0时：160个字节；其它=140个字节)Msg_ContentMsg_lengthOctet String信息内容Reserve8Octet String保留注意：关于短信群发的问题，若SP对于群发消息不要求状态报告的回送时，才可以考虑群发，否则必须逐条发送。7.4.3.2 CMPP_SUBMIT_RESP消息定义（ISMG SP）字段名字节数属性描述Msg_Id8Unsigned Integer信息标识，生成算法如下：采用64位（8字节）的整数：（1） 时间（格式为MMDDHHMMSS，即月日时分秒）：bit64bit39，其中bit