中国移动通信互联网短信网关接口协议doc.docx

1、中国移动通信互联网短信网关接口协议doc中国移动通信互联网短信网关接口协议(China Mobile Peer to Peer, CMPP)V2.0)中国移动通信集团公司2002 年 4 月、八前123网络结构 4.CMPP功能概述5.协议栈 6.通信方式 6.16.26.36.47.消息定义 7.1基本数据类型 7.2消息结构 7.3消息头格式( Message Header) 7.4信息资源站实体(SP)与互联网短信网关(ISMG)间的消息定义 7.4.1SP请求连接至U ISMG (CMPP_CONNECT )操作 7.4.1.1CMPP_CONNECT 消息定义( SP ISMG) 7

2、.4.1.2CMPP_CONNECT_RESP 消息定义( ISMG SP) 742 SP或 ISMG 请求拆除连接(CMPP_TERMINA TE)操作 742.1CMPP_TERMINATE 消息定义(SP ISMG 或ISMG SP)742.2CMPP_TERMINATE_RESP 消息定义(SP ISMG 或 ISMG7.4.3SP向 ISMG 提交短信(CMPP_SUBMIT )操作 7.4.3.1CMPP_SUBMIT 消息定义( SP ISMG) 7.4.3.2CMPP_SUBMIT_RESP 消息定义( ISMG SP) 7.4.4SP向ISMG查询发送短信状态(CMPP_QU

3、ERY )操作 7.4.4.1CMPP_QUERY 消息的定义( SP ISMG) 7.4.4.2CMPP_QUERY_RESP 消息的定义( ISMG SP) 7.4.5ISMG 向 SP送交短信(CMPP_DELIVER )操作 7.4.5.1CMPP_DELIVER 消息定义( ISMG SP) 7.4.5.2CMPP_DELIVER_RESP 消息定义( SP ISMG) 7.4.6SP向ISMG发起删除短信(CMPP_CANCEL )操作 7.4.6.1CMPP_CANCEL 消息定义( SP ISMG) 7.4.6.2CMPP_CANCEL_RESP 消息定义( ISMG SP)

4、7.4.7链路检测( CMPP_ACTIVE_TEST )操作 7.4.7.1CMPP_ACTIVE_TEST 定义(SP ISMG 或 ISMG SP).7.4.7.2CMPP_ACTIVE_TEST_RESP 定义(SP ISMG 或ISMG SP)7.5互联网短信网关 (ISMG) 之间的消息定义 7.5.1源ISMG请求连接到目的ISMG ( CMPP_CONNECT )操作 7.5.2源ISMG请求拆除到目的ISMG的连接(CMPP_TERMINA TE)操作.7.5.3链路检测( CMPP_ACTIVE_TEST )操作 187.5.4源ISMG向目的ISMG转发短信(CMPP_F

5、WD )操作 187.5.4.1CMPP_FWD 定义( ISMG ISMG) 197.5.4.2CMPP_FWD_RESP 定义( ISMG ISMG) 227.6互联网短信网关(ISMG)与汇接网关(GNS)之间的消息定义 227.6.1ISMG请求连接到GNS或GNS请求连接到ISMG( CMPP_CONNECT )操作.227.6.2ISMG 请 求 拆 除 到 GNS 的 连 接 或 GNS 请 求 拆 除 到 ISMG 的 连 接 (CMPP_TERMINA TE)操作 227.6.3ISMG向汇接网关查询 MT路由(CMPP_MT_ROUTE )操作7.6.3.1CMPP_MT_

6、ROUTE 消息定义( ISMG GNS)7.6.3.2CMPP_MT_ROUTE_RESP 消息定义( GNS764 ISMG向汇接网关查询 MO路由(CMPP_MO_ROUTE7.6.4.1CMPP_MO_ROUTE 消息定义( ISMG GNS)7.6.4.2CMPP_MO_ROUTE_RESP 消息定义( GNS7.6.5ISMG向汇接网关获取路由( CMPP_GET_ROUTE )操作 247.6.5.1CMPP_GET_ ROUTE 消息定义( ISMG GNS) 247.6.5.2CMPP_GET_ ROUTE_RESP 消息定义( GNS ISMG) 247.6.6ISMG 向

7、汇接网关更新 MT路由(CMPP_MT_ROUTE_UPDA TE)操作 257.6.6.1CMPP_MT_ROUTE_UPDATE 消息定义( ISMG GNS) 257.6.6.2CMPP_MT_ROUTE_UPDATE_RESP 消息定义( GNS ISMG) 257.6.7ISMG 向汇接网关更新 MO路由(CMPP_MO_ROUTE_UPDA TE)操作 257.6.7.1CMPP_MO_ROUTE_UPDATE 消息定义( ISMG GNS) 257.6.7.2CMPP_MO_ROUTE_UPDATE_RESP 消息定义( GNS ISMG) 267.6.8汇接网关向 ISMG 更

8、新 MT 路由(CMPP_PU SH_MT_ROUTE_ UP DATE )操作 267.6.8.1CMPP_PUSH_MT_ROUTE_UPDATE 消息定义( GNS ISMG ) 267.6.8.2CMPP_PUSH_MT_ROUTE_UPDATE_RESP 消息定义( ISMG GNS) 267.6.9汇接网关向 ISMG 更新 MO 路由(CMPP_PU SH_MO_ROUTE_ UP DATE )操作 277.6.9.1CMPP_PUSH_MO_ROUTE_UPDA TE消息定义(GNS ISMG ) .277.6.9.2CMPP_PUSH_MO_ROUTE_UPDA TE_RES

9、P 消 息 定 义 ( ISMG2727272931GNS) 7.7系统定义 7.7.1Comma nd_ld 定义 附录1 MO状态报告的产生. 修订历史 、八 前言本规范为中国移动通信集团公司企业规范，简称CMPP ，现阶段版本是对 1.2.1 版修订后形成的，为 2.0 版。本规范描述了中国移动短信业务中各网元（包括ISMG 、GNS 和 SP)之间的相关消息的类型和定义。 根据业务的发展， 规范中的信令操作和参数将会做进一步的调整和增加。本规范解释权属于中国移动通信集团公司。本规范起草单位：中国移动通信集团公司研发中心。1范围本规范规定了以下三方面的内容：1）信息资源站实体与互联网短信

10、网关之间的接口协议；2）互联网短信网关之间的接口协议；3）互联网短信网关与汇接网关之间的接口协议。本规范适用于各 SP 和 ISMG 的开发厂商。2缩略语英文缩写ISMGSMPPCMPPSMCGNS SP英文全称 Internet Short Message Gateway Short Message Peer to Peer China Mobile Peer to Peer Short Message Center Gateway Name Server Service ProviderSMCShort Message ControlISMG_Id说明 互联网短信网关 短消息点对点协议 中

11、国移动点对点协议 短消息中心 网关名称服务器（汇接网关） 业务提供者，即信息资源站实体 SP 为收取包月业务费用而向网关发送的消息，网关收 到后不送给用户仅产生相应的话单； 网关代码： 0XYZ010XYZ99 ，其中 位数不足时左补零，如北京编号为 001001，江西编号为 1 的网关代码为XYZ 为省会区号， 1 的网关代码为 079101，依此类推。SP_ldSP_CodeService Id份的标识、地址翻译、计费、结算均以企业代码为依据。企业代码以字表示，共 6 位，从.“ 9XY000 ”“ 9XY999 ”， 其中“ XY”为各移动司代码。SP的服务代码：服务代码是在使短信方式的

12、点播类业务中，提供用户点播的内容/应用服务提供商码。服务代码以数字表示 ,全国务服务代码长度统一为 4位，“ 1000 ” - “ 9999 ” ;本地业务服代码长度统一为5 位,“01000”“ 09999”。SP的业务类型，数字、字母和符号组合，由 SP 自定，如图片传情可的企业代码：网络中 SP地址和SP为TPCQ,股票查询可定义为11。身等数至公的定用给代业即务3.网络结构短信中心SMPP.I SP于SPISMG&M PP In ternet、.吴 Internet .XSMPP 氓能丁二二 1J专线或局域网专线或局域网In ternetGNS图1互联网短信网关逻辑网络结构如图1所示，

13、互联网短信网关（ISMG ）是外部信息资源站实体（SP）与移动网内短信中心 之间的中介实体，互联网短信网关一方面负责接收 SP发送给移动用户的信息和提交给短信中心。另一方面，移动用户点播 SP业务的信息将由短信中心通过互联网短信网关发给 SP。另外，为了减轻短信中心的信令负荷，互联网短信网关还应根据路由原则将 SP提交的信息转发到相应的互联网短信网关。 互联网短信网关通过向汇接网关 （GNS）查询的方式获得网关间的转发路由信息。4.CMPP功能概述CMPP协议主要提供以下两类业务操作：(1) 短信发送(Short Message Mobile Originate，SM MO)2所示:典型的业务

14、操作举例如图手机发出数据请求(可能是订阅信息或图片点播等)源ISMG对接收到的信息返回响应；源ISMG在本地查询不到要连接的 SP,向GNS(汇接网关)发路由请求信息;GNS将路由信息返回；源ISMG根据路由信息将请求前转给目的 ISMG ；目的ISMG对接收到的信息返回响应；目的ISMG将请求信息送SPSP返回响应； 在以上操作中，步骤3到步骤8均使用CMPP协议；在随后的操作中，目的ISMG在接收到SP的响应后将产生 M0状态报告发给源ISMG。(2) 短信接收(Short Message Mobile Terminated，SM MT)3所示:图3需要前转的MT示意图典型的业务操作举例如

15、图5)6)7)8)源ISMG根据路由信息将请求前转给目的 ISMG ；目的ISMG对接收到的信息返回响应； 目的ISMG将请求信息发送至 SMC ；SMC向目的ISMG返回响应； 在上述操作中，步骤 1到步骤6均使用CMPP协议；在随后的操作中，SMC将通过N0.7信令网向移动用户发送信息，移动用户收到后将返回 状态报告(Delivery-Receipt )给短信中心，短信中心将按照 M0操作的流程将状态报告返回 给SP (如果SP要求返回状态报告)。5.协议栈CMPP协议以TCP /IP作为底层通信承载，具体结构由图 4所示:图4 CMPP协议栈6.通信方式SP与ISMG之间、方式。所谓长连

16、接， 如果没有数据包发送， 需要双方发链路检测包以维持此连接。 短连接是指通信双方有数据交互时，就建立一个TCP连接，数据发送完成后，则断开此 TCP连接，即每次TCP连接只完 成一对CMPP消息的发送。6.1长连接通信双方以客户-服务器方式建立TCP连接，用于双方信息的相互提交。当信道上没有数据 传输时，通信双方应每隔时间 C发送链路检测包以维持此连接，当链路检测包发出超过时间T后未收到响应，应立即再发送链路检测包，再连续发送 N-1次后仍未得到响应则断开此连接。参数C、T、N原则上应可配置，现阶段建议取值为： C=3分钟，T=60秒，N=3。网关与SP之间、网关之间的消息发送后等待 T秒后

17、未收到响应，应立即重发，再连续发送N-1次后仍未得到响应则停发。现阶段建议取值为： T=60秒，N=3。消息采用并发方式发送，加以滑动窗口流量控制，窗口大小参数 W可配置，现阶段建议为16,即接收方在应答前一次收到的消息最多不超过 16条。长连接的操作流程举例如图 5所示：图5长连接一次操作流程6.2短连接通信双方以客户-服务器方式建立 TCP连接，应答与请求在同一个连接中完成。系统采用客 户/服务器模式，操作以客户端驱动方式发起连接请求，完成一次操作后关闭此连接。网关与SP之间、网关之间的消息发送后等待 T秒后未收到响应，应立即重发，再连续T=60 秒，N=3。发送N-1次后仍未得到响应则停

18、发。现阶段建议取值为:短连接的操作流程举例如图 6所示:6.3本协议中涉及的端口号端口号应用7890长连接（SP与网关间）7900短连接（SP与网关间或网关之间）7930长连接（网关之间）9168短连接（短信网关与汇接网关之间）6.4交互过程中的应答方式在SP与ISMG之间、SMC与ISMG之间及ISMG之间的交互过程中均采用异步方式， 即任7所示:一个网元在收到请求消息后应立即回送响应消息。举例如图SMPP响应消息CMPP请求消息CMPP响应消息CMPP请求消息CMPP响应消息图7异步交互方式示意图7.消息定义7.1基本数据类型Un sig ned In teger无符号整数In teger

19、整数，可为正整数、负整数或零Octet Stri ng定长字符串，位数不足时，如果左补0则补ASCII表示的 零，如果右补0则补二进制的零7.2消息结构项目说明Message Header消息头（所有消息公共包头）Message Body消息体7.3消息头格式(Message Header)字段名字节数类型描述Total Le ngth4Un sig ned In teger消息总长度（含消息头及消息体）Comma nd ld4Un sig ned In teger命令或响应类型Seque nce_ld4Un sig ned In teger消息流水号，顺序累加渉长为1,循环使用 （一对请求和

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

21、描述Source Addr6Octet Stri ng源地址，此处为 SP ld,g卩SP的企业代码。Authe nticatorSo urce16Octet Stri ng用于鉴别源地址。其值通过单向MD5 hash计算 得出，表示如下：Authe nticatorSource =MD5 （ Source_Addr+9 字节的 0 +shared secret+timesta mp）Shared secret由中国移动与源地址实体事先商 定，timestamp 格式为：MMDDHHMMSS ，即 月日时分秒，10位。Versio n1Un sig ned In teger双方协商的版本号（咼

22、位4bit表示主版本号，低位4bit表示次版本号）Timesta mp4Un sig ned In teger时间戳的明文，由客户端产生，格式为MMDDHHMMSS ,即月日时分秒，10位数字的 整型，右对齐 。字段名字节数属性描述Status1Un sig ned In teger状态0:正确1:消息结构错2:非法源地址3:认证错4:版本太咼5 :其他错误Authe nticator ISMG16Octet Stri ngISMG认证码，用于鉴别 ISMG。其值通过单向MD5 hash计算得出，表示如下：Authe nticatorlSMG =MD5(Status+Authenticator

23、Source+shared secret),Shared secret由中国移动与源地址实体事先商 定，AuthenticatorSource为源地址实体发送给ISMG的对应消息CMPP_Connect中的值。 认证出错时，此项为空。Versio n |1Un sig ned In teger服务器支持的最高版本号7.4.1.2 CMPP CONNECT RESP 消息定义（ISMG SP）742 SP或ISMG请求拆除连接(CMPP_TERMINA TE)操作CMPP TERMINATE操作的目的是 SP或ISMG基于某些原因决定拆除当前的应用层连接而发起的操作。此操作完成后SP与ISMG之

24、间的应用层连接被释放,此后SP若再要与ISMG通信时应发起CMPP_CONNECT操作。ISMG 或SP以CMPP TERMINATE RESP 消息响应请求。7.4.2.1 CMPP_TERMINA TE 消息定义（SP ISMG 或 ISMG SP）无消息体。742.2 CMPP_TERMINA TE_RESP 消息定义（SP ISMG 或 ISMG 无消息体。SP）743 SP 向 ISMG 提交短信（CMPP_SUBMIT ）操作CMPP SUBMIT 操作的目的是 SP在与ISMG建立应用层连接后向ISMG提交短信。ISMG 以 CMPP_SUBMIT_RESP 消息响应。字段名字节

25、数属性描述Msg Id8Un sig ned In teger信息标识，由SP侧短信网关本身产生，本处填空。Pk total1Un sig ned In teger相同Msg Id的信息总条数，从1开始Pk nu mber1Un sig ned In teger相同Msg Id的信息序号，从1开始7.4.3.1 CMPP SUBMIT 消息定义（SP ISMG）Registered_Delivery1Un sig ned In teger是否要求返回状态确认报告：0：不需要1：需要2 :产生SMC话单（该类型短信仅供网关计费使用， 不发送给目的终端）Msg level1Un sig ned I

26、n teger信息级别Service Id10Octet Stri ng业务类型，是数字、字母和符号的组合。Fee_UserT ype1Un sig ned In teger计费用户类型字段0:对目的终端 MSISDN计费；1:对源终端 MSISDN计费；2:对SP计费；3:表示本字段无效，对谁计费参见Fee terminalld 字段。 - -Fee_term in al_Id21Un sig ned In teger被计费用户的号码（如本字节填空，则表示本字 段无效，对谁计费参见 Fee_UserType字段，本字段与Fee UserType字段互斥）TP_pld1Un sig ned I

27、n tegerGSM协议类型。详细是解释请参考 GSM03.40中的 923.9TP_udhi1Un sig ned In tegerGSM协议类型。详细是解释请参考 GSM03.40中的9.2.3.23,仅使用1位，右对齐Msg_Fmt1Un sig ned In teger信息格式0: ASCII 串3:短信写卡操作4:二进制信息8: UCS2编码15:含 GB 汉字。Msg src6Octet Stri ng信息内容来源（SP ld）FeeType2Octet Stri ng资费类别01 :对“计费用户号码”免费02 :对“计费用户号码”按条计信息费03 :对“计费用户号码”按包月收取信

28、息费04 :对“计费用户号码”的信息费封顶05 :对“计费用户号码”的收费是由 SP实现FeeCode6Octet Stri ng资费代码（以分为单位）ValId Time17Octet Stri ng存活有效期，格式遵循 SMPP3.3协议At Time17Octet Stri ng定时发送时间，格式遵循 SMPP3.3协议Src_Id21Octet Stri ng源号码SP的服务代码或前缀为服务代码的长号码 ，网关将该号码完整的填到 SMPP协议Submit_SM消息 相应的source_addr字段，该号码最终在用户手机 上显示为短消息的主叫号码DestUsr tl1Un sig ned

29、 In teger接收信息的用户数量（小于100个用户）Dest_termi nal_ld21*Des tUsr tlOctet Stri ng接收短信的MSISDN号码Msg_Le ngth1Un sig ned In teger信息长度（Msg_Fmt值为0时：160个字节；其 它=140个字节）Msg_Co ntentMsg_le ngthOctet Stri ng信息内容Reserve8Octet Stri ng保留注意：关于短信群发的问题，若 SP对于群发消息不要求状态报告的回送时，才可以考虑群发，否则必须逐条发送。743.2 CMPP_SUBMIT_RESP 消息定义(ISMG SP)字段名Msg_ld字节数8属性Un sig ned In teger描述信息标识，生成算法如下: 采用（1）(2)64位（8字节）的整数： 时间（格式为 MMDDHHMMSS ，即月日时 分秒）：bit64bit39，其中bit64