MAS接口协议通道对接CMPP20网关协议分析.docx

1、MAS接口协议通道对接CMPP20网关协议分析中国移动通信互联网短信网关接口协议(China Mobile Peer to Peer, CMPP)(V2.0)中国移动通信集团公司2002 年 4 月1 编制说明 错误！未定义书签。2 缩略语 53网络结构 64 CMPP 功能概述 65.协议栈 86.通信方式 86.1长连接 96.2短连接 116.3本协议中涉及的端口号 126.4交互过程中的应答方式 127消息定义 127.1基本数据类型 127.2消息结构 137.3消息头格式( Message Header) 137.4信息资源站实体(SP)与互联网短信网关(ISMG)间的消息定义 1

2、3741SP 请求连接至U ISMG ( CMPP_CONNECT )操作 137.4.1.1CMPP_CONNECT 消息定义( SP ISMG) 137.4.1.2CMPP_CONNECT_RESP 消息定义( ISMG SP) 14742SP 或 ISMG 请求拆除连接(CMPP_TERMINA TE )操作 147.4.2.1CMPP_TERMINATE 消息定义( SP ISMG 或 ISMG SP) 147.4.2.2CMPP_TERMINATE_RESP 消息定义( SP ISMG 或 ISMG SP) .14743SP 向 ISMG 提交短信(CMPP_SUBMIT )操作 1

3、57.4.3.1CMPP_SUBMIT 消息定义( SP ISMG) 157.4.3.2CMPP_SUBMIT_RESP 消息定义( ISMG SP) 16744SP向ISMG查询发送短信状态(CMPP_QUERY )操作 177.4.4.1CMPP_QUERY 消息的定义( SP ISMG ) 177.4.4.2CMPP_QUERY_RESP 消息的定义( ISMG SP) 177.4.5ISMG 向 SP送交短信(CMPP_DELIVER )操作 187.4.5.1CMPP_DELIVER 消息定义( ISMG SP) 187.4.5.2CMPP_DELIVER_RESP 消息定义( SP

4、 ISMG) 207.4.6SP向ISMG发起删除短信(CMPP_CANCEL )操作 207.4.6.1CMPP_CANCEL 消息定义( SP ISMG ) 207.4.6.2CMPP_CANCEL_RESP 消息定义( ISMG SP) 207.4.7链路检测( CMPP_ACTIVE_TEST )操作 217.4.6.1CMPP_ACTIVE_TEST 定义( SP ISMG 或 ISMG SP) 217.4.6.2CMPP_ACTIVE_TEST_RESP 定义( SP ISMG 或 ISMG SP) 217.5互联网短信网关 (ISMG) 之间的消息定义 217.5.1源 ISMG

5、 请求连接至目的 ISMG (CMPP_CONNECT )操作 217.5.2源ISMG请求拆除到目的ISMG的连接(CMPP_TERMINA TE)操作 217.5.3链路检测( CMPP_ACTIVE_TEST )操作 217.5.4 源 ISMG 向目的 ISMG 转发短信( CMPP_FWD )操作 217.5.4.1CMPP_FWD 定义( ISMG ISMG ) 217.5.4.2CMPP_FWD_RESP 定义( ISMG ISMG) 257.6互联网短信网关(ISMG)与汇接网关(GNS)之间的消息定义 25761 ISMG请求连接到 GNS或GNS请求连接到ISMG (CMP

6、P_CONNECT )操作 257.6.2ISMG 请求拆除到 GNS 的连接或 GNS 请求拆除到 ISMG 的连接(CMPP_TERMINA TE)操作 267.6.3ISMG 向汇接网关查询 MT 路由( CMPP_MT_ROUTE )操作 267.6.3.1CMPP_MT_ROUTE 消息定义( ISMG GNS) 267.6.3.2CMPP_MT_ROUTE_RESP 消息定义( GNS ISMG ) 267.6.4ISMG 向汇接网关查询 MO 路由( CMPP_MO_ROUTE )操作 267.6.4.1CMPP_MO_ROUTE 消息定义( ISMG GNS) 267.6.4.

7、2CMPP_MO_ROUTE_RESP 消息定义( GNS ISMG) 277.6.5ISMG 向汇接网关获取路由( CMPP_GET_ROUTE )操作 277.6.5.1CMPP_GET_ ROUTE 消息定义( ISMG GNS) 277.6.5.2CMPP_GET_ ROUTE_RESP 消息定义( GNS ISMG) 277.6.6ISMG 向汇接网关更新 MT 路由( CMPP_MT_ROUTE_UPDATE )操作 287.6.6.1CMPP_MT_ROUTE_UPDATE 消息定义( ISMG GNS) 287.6.6.2CMPP_MT_ROUTE_UPDATE_RESP 消息

8、定义( GNS ISMG ) 287.6.7ISMG 向汇接网关更新 MO 路由( CMPP_MO_ROUTE_UPDATE )操作 297.6.7.1CMPP_MO_ROUTE_UPDATE 消息定义( ISMG GNS) 297.6.7.2CMPP_MO_ROUTE_UPDATE_RESP 消息定义( GNS ISMG) 297.6.8汇接网关向 ISMG 更新 MT 路由(CMPP_PUSH_MT_ROUTE_UPDA TE)操作 297.6.8.1CMPP_PUSH_MT_ROUTE_UPDA TE 消息定义( GNS ISMG ) 30768.2CMPP_PUSH_MT_ROUTE_

9、UPDATE_RESP 消息定义 (ISMGGNS) 307.6.9汇接网关向 ISMG 更新 MO 路由( CMPP_PUSH_MO_ROUTE_UPDATE )操作 307.6.9.1CMPP_PUSH_MO_ROUTE_UPDA TE 消息定义( GNS ISMG ) .307.6.9.2CMPP_PUSH_MO_ROUTE_UPDATE_RESP 消 息定义( ISMGGNS) 317.7 系统定义 317.7.1Command_Id 定义 31附录 1 MO 状态报告的产生 32修订历史 34Page 4 of 34Page 4 of 341.开幕本规范为中国移动通信集团公司企业规范

10、，简称 CMPP，现阶段版本为2.0版。本规范规定了以下三方面的内容：(1)信息资源站实体与互联网短信网关之间的接口协议;(2)互联网短信网关之间的接口协议；(3)互联网短信网关与汇接网关之间的接口协议。2.缩略语英文缩写英文全称说明ISMGInternet Short Message Gateway互联网短信网关SMPPShort Message Peer to Peer短消息点对点协议CMPPChina Mobile Peer to Peer中国移动点对点协议SMCShort Message Cen ter短消息中心GNSGateway Name Server网关名称服务器(汇接网关)SP

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

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

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

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

15、铃声等） ，被源ISMG接收；2） 源ISMG对接收到的信息返回响应；3） 源ISMG在本地数据库中找不到要目的手机号段所对应网关代码， 向GNS （汇接网关）发路由请求信息；4） 汇接网关将路由信息返回；5） 源ISMG根据路由信息将请求前转给目的 ISMG ；6） 目的ISMG对接收到的信息返回响应；7） 目的ISMG将请求信息发送至 SMC ；8） SMC向目的ISMG返回响应；在上述操作中，步骤 1到步骤6均使用CMPP协议；在随后的操作中，SMC将通过N0.7信令网向移动用户发送信息，移动用户收到后将返回状态报告（Delivery-Receipt ）给短信中心，短信中心将按照 M0操

16、作的流程将状态报告返回 给SP （如果SP要求返回状态报告）。5.协议栈CMPP协议以TCP/IP作为底层通信承载，具体结构由图 4所示:SP ISMG ISMG GNS图4 CMPP协议栈6.通信方式SP与ISMG之间、ISMG之间进行信息交互时，可以采用长连接方式，也可以采用短连接 方式。所谓长连接，指在一个TCP连接上可以连续发送多个数据包， 在TCP连接保持期间，如果没有数据包发送，需要双方在此 TCP连接上发链路检测包以维持此连接。短连接是指通信双方有数据交互时，就建立一个 TCP连接，数据发送完成后，则断开此 TCP连接，即 每次TCP连接只完成一对CMPP消息的发送。短信网关之间

17、前转时要求每条消息都要有状态报告。当向用户发送信息发生错误时, 网关应向SP发送错误状态报告。6.1长连接通信双方以客户-服务器方式建立TCP连接，用于双方信息的相互提交。 TCP连接建立后，由客户端发起建立应用层连接， 然后进行数据传输。当信道上没有数据传输时，通信双方应每隔时间C发送链路检测包以维持此连接，当链路检测包发出超过时间 T后未收到响应，应立即再发送链路检测包，连续发送 N-1次后仍未得到响应则断开此连接。参数C、T、N原则上应可配置，现阶段建议取值为： C=3分钟，T=60秒，N=3。网关与SP之间、网关之间的消息发送后等待 T秒后未收到响应，应立即重发，连续发送N-1次后仍未

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

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

20、ger无符号整数In teger整数，可为正整数、负整数或零Octet Stri ng定长字符串，位数不足时，如果左补0则补ASCII表示的 零，如果右补0则补二进制的零7.2消息结构项目说明Message Header消息头（所有消息公共包头）Message Body消息体7.3 消息头格式(Message Heade)字段名字节数类型描述Total_Le ngth4Un sig ned In teger消息总长度（含消息头及消息体）Comma ndd4Un sig ned In teger命令或响应类型Seque nce_ld4Un sig ned In teger消息流水号，顺序累加，步

21、长为1,循环使用 （一对请求和应答消息的流水号必须相同）定义741 SP请求连接至U ISMG(CMPP_CONNECT)操作CMPP_CONNECT操作的目的是 SP向ISMG注册作为一个合法 SP身份，若注册成功后即 建立了应用层的连接，此后 SP可以通过此ISMG接收和发送短信。ISMG以CMPP_CONNECT_RESP消息响应 SP的请求。741.1CMPP CONNECT 消息定义(SP ISMG)字段名字节数属性描述Source_Addr6Octet Stri ng源地址，此处为 SP Id,即卩SP的企业 代码。Authe nticatorSource16Octet Stri

22、ng用于鉴别源地址。其值通过单向MD5 hash计算得出，表示如下：Authe nticatorS ource =MD5 （ Source_Addr+9 字节的 0 +shared secret+timestamp）Shared secret由中国移动与源地址实体事先商定，timestamp格式为： MMDDHHMMSS ，即月日时分秒，10 位。Versio n1Un sig ned In teger双方协商的版本号(高位4bit表示主 版本号，低位4bit表示次版本号)Timestamp4Un sig ned In teger时间戳的明文，由客户端产生，格式为MMDDHHMMSS ，即月日

23、时分秒，10 位数字的整型，右对齐 。741.2CMPP CONNECT RESP消息定义（ISMG SP）字段名字节数属性描述Status1Un sig ned In teger状态0 :正确1：消息结构错2:非法源地址3:认证错4 :版本人咼5 :其他错误Authe nticatorlSMG16Octet Stri ngISMG认证码，用于鉴别 ISMG。 其值通过单向MD5 hash计算得出， 表示如下：Authe nticatorlSMG =MD5(Status+AuthenticatorS ource+share d secret), Shared secret 由中国移动 与源地址

24、实体事先商定， Authe nticatorSource 为源地址实体 发送给ISMG 的对应消息 CMPP_Connect 中的值。认证出错时，此项为空。Versio n1Un sig ned In teger服务器支持的最高版本号7.4.2 SP或ISMG请求拆除连接(CMPP_TERMINATE )操作CMPP_TERMINATE操作的目的是 SP或ISMG基于某些原因决定拆除当前的应用层连接而 发起的操作。此操作完成后SP与ISMG之间的应用层连接被释放， 此后SP若再要与ISMG 通信时应发起CMCC_CONNECT操作。ISMG 或 SP 以 CMPP_TERMINATE_RESP

25、 消息响应请求。7.4.2.1CMPP_TERMINATE 消息定义(SP ISMG 或 ISMG SP)无消息体。7.4.2.2CMPP_TERMINATE_RESP 消息定义（SP ISMG 或 ISMG SP）无消息体。743 SP 向 ISMG 提交短信(CMPP_SUBMIT )操作CMPP_SUBMIT操作的目的是 SP在与ISMG建立应用层连接后向 ISMG提交短信。ISMG 以 CMPP_SUBMIT_RESP 消息响应。7.4.3.1CMPP SUBMIT 消息定义(SP ISMG)字段名字节数属性描述Msgd8Un sig ned In teger信息标识，由 SP侧短信网

26、关本身产生， 本处填空。Pk_total1Un sig ned In teger相同Msgd的信息总条数，从1开始Pk_nu mber1Un sig ned In teger相同Msgd的信息序号，从1开始Registered_Del ivery1Un sig ned In teger是否要求返回状态确认报告：0:不需要1 需2 :产生SMC话单（该类型短信仅供网关计费使用，不发 送给目的终端）Msgevel1Un sig ned In teger信息级别Service Id10Octet Stri ng业务类型，是数字、字母和符号的组合。Fee_UserType1Un sig ned In

27、teger计费用户类型字段0:对目的终端 MSISDN计费；1:对源终端MSISDN计费；2:对SP计费；3:表示本字段无效，对谁计费参见Fee terminal Id 字段。Fee_term in al_I d - -21Un sig ned In teger被计费用户的号码（如本字节填空，则表 示本字段无效，对谁计费参见Fee_UserType 字段， 本字段与 Fee UserType字段互斥）TP_pId1Un sig ned In tegerGSM协议类型。详细是解释请参考GSM03.40 中的 9.2.3.9TP_udhiUn sig ned In tegerGSM协议类型。详细是

28、解释请参考GSM03.40中的9.2.3.23,仅使用1位，右对齐Msg_FmtUn sig ned In teger信息格式0: ASCII 串3:短信写卡操作4:二进制信息8: UCS2编码15:含 GB 汉字。Msg src6Octet Stri ng信息内容来源（SP ld）FeeType2Octet Stri ng资费类别01 :对“计费用户号码”免费02 :对“计费用户号码”按条计信息费03 :对“计费用户号码”按包月收取信息 费04 :对“计费用户号码”的信息费封顶05 :对“计费用户号码”的收费是由 SP实现FeeCode6Octet Stri ng资费代码（以分为单位）Val

29、id 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 In teger接收信息的用户数量（小于100个用户）Dest termi nald21*DestUsr tlOctet Stri ng接收业务的MSISDN号码Msg_Le ngth1Un sig ned In teger信息长度（Msg_Fmt值为0时：160个字 节；其它=140个字节）Msg Co ntentMsgen gthOctet Stri ng信息内容Reserve8Octet Stri ng保留注意：关于短信群发的问题，若 SP对于群发消息不要求状态报告的回送时，才可以考虑群发，否则必须逐条发送。743.2CMPP_SUBMIT_RESP消息