中国网通PHS短消息网关技术规范第一分册Word下载.docx

1、5.5.2 login_resp 195.5.3 active_test 205.5.4 active_test_resp 205.5.5 forward 205.5.6 forward_resp 225.5.7 exit 225.5.8 exit_resp 236状态报告格式 246.1 MO的状态报告 246.2 MT的状态报告 257CNGP编码说明 267.1 短消息格式代码表 267.2 短消息状态表 267.3 Err错误代码表 317.4 status错误代码表 327.5 TLV说明表 338基于CNGP的API函数 35附录A 基于CNGP协议的API函数说明 36前 言本标

2、准描述了PHS短消息网关（SMGW）和服务提供商（SP）之间、短消息网关（SMGW）和短消息网关（SMGW）之间的通信协议。本协议简称CNGP（China Netcom Short Message Gateway Protocol）。本标准是PHS短消息网关技术规范的系列规范之一，该系列规范的名称如下：PHS短消息网关技术规范 第一分册：短消息网关与服务提供商（SP）接口规范（CNGP）；PHS短消息网关技术规范 第二分册：短消息网关与计费中心接口规范；PHS短消息网关技术规范 第三分册：短消息中心外部接口协议（CNPP）；PHS短消息网关技术规范 第四分册：短消息网关设备规范；PHS短消息网

3、关技术规范 V2.0说明。本标准起草单位：中国网络通信集团公司、中国网通集团研究院本标准主要起草人：张文钺、李松林、蒋美景、叶丹、杨哲、宋冠云本规范的解释权属于中国网络通信集团公司。1适用范围本规范适用于短消息网关（SMGW）开发商和短消息服务提供商（SP）。2引用标准 SMPP （Short Message Peer to Peer Protocol Specification） v3.43缩略语英文缩写英文全称说明SMGW Short Message Gateway短消息网关SMPPShort Message Peer to Peer 短消息点对点协议SMSCShort Message S

4、ervice Center短消息中心SP Service Provider服务提供商TLVTag Length Value由tag/length/value三参数定义变量MOMessage Origination用户发送短消息到SP 的上行过程MTMessage TerminationSP发送短消息到用户的下行过程PSCPrepaid Service Center预付费中心CRCharge RequestSP为收取业务费用而向短消息网关发送的消息，短消息网关收到消息后不送给用户，仅产生相应的话单4CNGP概述4.1 CNGP功能描述CNGP标准是SP与SMGW，以及SMGW与SMGW之间的通信

5、标准。CNGP可以实现以下功能：1） SP通过SMGW向用户发送短消息，例如邮件通知、天气预报等。2） 短消息用户向SP点播信息，例如查询股票信息、航班信息等。3） SP以某个短消息用户的身份向其他短消息用户发送信息。4） 短消息用户发送的短消息通过SMGW转发给异地或异网的短消息用户。注：异网是指其他运营商的网络，以下同。4.2 协议栈CNGP标准以TCP/IP作为底层通信承载，具体结构由图4.1所示：图4.1 CNGP协议栈4.3 通信方式SP与SMGW之间、SMGW与SMGW之间进行信息交互时，可以采用长连接方式，也可以采用短连接方式。所谓长连接，指在一个TCP连接上可以连续发送多个数据

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

7、SMGW之间的消息发送后等待T秒后未收到应答，应立即重发，再连续发送N-1次后仍未得到应答则停发。现阶段建议取值为：T=60秒，N=3。消息采用并发方式发送，加以滑动窗口流量控制，窗口大小参数W可配置，现阶段建议为16，即接收方在应答前一次收到的消息最多不超过16条。长连接的操作流程举例如图4.2所示： . . . . . . 拆除TCP连接建立TCP连接对CNGP消息2的应答对CNGP消息1的应答CNGP消息2服务器端客户端CNGP消息1滑动窗口不大于W W链路检测消息 链路检测消息应答图4.2 长连接一次操作流程4.3.2 短连接通信双方以客户-服务器方式建立TCP连接，应答与请求在同一个

8、连接中完成。系统采用客户/服务器模式，操作以客户端驱动方式发起连接请求，完成一次操作后关闭此连接。SMGW与SP之间、SMGW与SMGW之间的消息发送后等待T秒后未收到应答，应根据重发机制进行重发，再连续发送N-1次后仍未得到应答则停发。短连接的操作流程举例如图4.3所示：服务器/客户端客户端/服务器端图4.3 短连接的操作流程4.3.3 交互过程中的应答方式在SP与SMGW及SMGW与SMGW之间的交互过程中均采用异步方式，即任一个网元在收到请求消息后应立即回送应答消息。举例如图4.4所示： SMGW2 SMGW1 SMSC SP CNPP应答消息 CNPP请求消息图4.4 异步交互方式示意

9、图4.3.4 端口号端口号应用9890 长连接（SP与SMGW之间）9900短连接（SP与SMGW或SMGW与SMGW之间）9930 长连接（SMGW与SMGW之间）9001长连接（SMGW与预付费平台之间）4.4 通信流程4.4.1 CNGP登录模式在CNGP标准的一个会话中客户端可以采用三种登录方式与服务器端相连：发送模式（Transmit Mode）、接收模式（Receive Mode）和收发模式（Transceiver Mode）。在发送模式中客户端只能发送短消息、在接收模式中客户端只能接收短消息、在收发模式中客户端既可以发送也可以接收短消息。三种模式均可以采用长连接与短连接两种连接方

10、式的一种，根据实际情况选择。4.4.2 SP发送短消息SP以发送者或者是收发者身份登录后，就可以发送短消息。SP可以不等待上一个短消息的应答消息，就发送下一个短消息。图 4.5 SP发送短消息4.4.3 SP接收短消息SP以接收者或者是收发者身份登录后，SMGW向SP发送短消息，SMGW可以不等待上一个短消息的应答消息，就发送下一个短消息。图 4.6 SP接收短消息4.4.4 SMGW转发短消息SMGW需要把异地或异网短消息转发到相应的SMGW，在转发短消息之前SMGW需要通过对方SMGW认证。图 4.7 SMGW转发短消息4.5 编号规则在整个SMGW系统中所有的通信节点（SMGW、SP 和

11、SMSC）都有一个唯一的数字编号，不同的SP 、SMSC 或SMGW 编号不能相同，编号由系统管理人员负责分配，由集团统一管理，编号规则如下：SMGW的编号规则：1AAAXYSMSC的编号规则： 2AAAXYSP企业的编号规则：3AAAQQQQQQ其中，AAA 表示三位长途区号（不足三位的长途区号右对齐左补零），XY表示从00到99的序号，QQQQQQ 表示6位企业代码。SP服务的编号规则：服务代码是在使用短消息方式的点播类业务中，提供给用户点播的短消息服务代码。服务代码以前缀4位数字表示，全国业务服务代码长度统一为 8 位，即前缀“1000”“9999”，其中前缀为“1061”“1069”，

12、由集团统一分配；本地业务服务代码长度统一为9 位，即前缀“01000”“09999”，其中前缀为“1061”“1069”，后五位数字由各省自行分配。SP业务的编号规则：SP的业务类型，数字、字母和符号的组合，由SP自定，如图片传情可定为TPCQ，股票查询可定义为11。最大长度为10字节。5CNGP消息定义5.1 基本数据类型类型Integer整数，长度根据具体协议确定，多字节情况下高字节在前Unsigned Integer无符号整数Octet String定长字符串，位数不足时左对齐，右补二进制的零5.2 消息结构项目格式Message Header消息头（所有消息公共包头）定长Message

13、 Body消息体（必选部分）变长消息体（可选部分）5.3 消息头格式字段名字节数描述total_length4消息总长度（含消息头及消息体）command_id命令标识command_status命令状态（参见7.4 status错误代码表）sequence_id消息流水号，顺序累加，步长为1，循环使用（一对请求和应答消息的流水号必须相同）5.4 SP与SMGW之间的消息定义请求名称请求标识消息方向login0x00000001SPSMGW登录请求login_resp0x80000001登录请求的应答submit0x00000002SP SMGWSP发送短消息请求submit_resp0x80

14、000002SP发送短消息请求的应答deliver0x00000003SMGWSPSMGW发送短消息请求deliver_resp0x80000003SMGW发送短消息的应答active_test0x00000004测试通信链路是否正常请求（由客户端发起，SP和SMGW可以通过定时发送此请求来维持连接）active_test_resp0x80000004测试通信链路是否正常的应答exit0x00000006退出请求exit_resp0x80000006退出请求的应答5.4.1 login字段长度（字节）数据类型ClientID10SMGW设置的SP接入标识AuthenticatorClient1

15、6客户端密码用于鉴别客户端的接入请求。其值通过单向MD5 hash计算得出，表示如下：AuthenticatorClient =MD5（ClientID+7字节的二进制0 +Shared secret+TimeStamp）Shared secret 由服务器端与客户端事先商定的，最长15 字节， TimeStamp格式为：mmddhhmmss，即月日时分秒，10位LoginMode1登录类型（0=发送短消息，1=接收短消息，2=收发短消息，其他保留）TimeStamp时间戳的明文，由客户端产生，格式为mmddhhmmss，即月日时分秒，10位数字的整型，右对齐 Version客户端支持的版本号

16、（高位4bit表示主版本号，低位4bit表示次版本号）5.4.2 login_respAuthenticatorServer服务器端认证码，当客户端认证出错时，此项为空AuthenticatorServer=MD5（Status+AuthenticatorClient+Shared secret）Shared secret 由服务器端与客户端事先商定，最长15 字节AuthenticatorClient为客户端发送给服务器端的上一条消息login中的值服务器支持的最高版本号5.4.3 submitSPIDSP的企业代码SubType短消息子类型（0取消订阅，1订阅或点播请求，2点播下发，3订阅

17、下发，其他保留）NeedReport是否要求返回状态报告：（0不要求，1要求）Priority发送优先级（从0到3）3为最高级ServiceID业务类型FeeType2资费类型00=免费01=按条收费02=包月03=封顶04=包月扣费请求05=CR话单 其他：保留FeeUserType计费用户类型字段0：对目的终端计费1：对源终端计费2：对SP计费3：按照计费用户号码计费其他保留FeeCode6每条短消息的信息费，单位：分MsgFormat短消息格式（参见短消息格式代码表7.1）ValidTime17有效时间，（格式：参照SMPP3.4协议）AtTime定时发送时间，（格式：SrcTermID

18、21短消息发送用户号码ChargeTermID计费用户号码DestTermIDCount短消息接收号码总数（100）DestTermID21* DestTerm Count短消息接收号码（连续存储DestTermIDCount个号码）MsgLength短消息长度MsgContent254短消息内容ProtocolID协议标识（参见TLV说明表7.5）5.4.4 submit_respMsgIDSMGW产生的短消息流水号，由三部分组成：SMGW代码：3字节（BCD码）时间：4字节（BCD码）序列号：CongestionState TLV 流量控制（参见TLV说明表7.5）5.4.5 delive

19、rIsReport是否状态报告：不是是RecvTime14短消息接收时间（格式：yyyymmddhhmmss，例如20010301200000）短消息接收用户号码5.4.6 deliver_resp5.4.7 active_test无消息体。5.4.8 active_test_resp5.4.9 exit5.4.10 exit_resp5.5 SMGW与SMGW之间的消息定义SMGW登录请求SMGW登录请求的应答测试通信链路是否正常请求（由客户端发起，SMGW和SMGW可以通过定时发送此请求来维持连接）forward0x00000005SMGW转发短消息请求forward_resp0x8000

20、0005SMGW转发短消息的应答5.5.1 login此处为源SMGW代码 Shared secret 由服务器端与客户端事先商定的，最长15 字节， TimeStamp格式为：5.5.2 login_resp Shared secret 由服务器端与客户端事先商定，最长15 字节 AuthenticatorClient为客户端发送给服务器端的上一条消息login中的值5.5.3 active_test5.5.4 active_test_resp5.5.5 forwardDestSMGWNo目标SMGW代码SrcSMGWNo源SMGW代码SMSCNo源SMSC代码SMType短消息类型（0=PHS用户发到SP的MO，1PHS用户发到异网用户，2SP发到PHS用户的MT，3异网用