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

1、中国网通PHS短消息网关技术规范第一分册中国网络通信集团公司企业标准PHS短消息网关技术规范第一分册 短消息网关与服务提供商（SP）接口规范（CNGP）V2.0 发布目 录前 言 11适用范围 22引用标准 23缩略语 24CNGP概述 34.1 CNGP功能描述 34.2 协议栈 34.3 通信方式 34.3.1 长连接 44.3.2 短连接 64.3.3 交互过程中的应答方式 74.3.4 端口号 74.4 通信流程 74.4.1 CNGP登录模式 74.4.2 SP发送短消息 84.4.3 SP接收短消息 84.4.4 SMGW转发短消息 94.5 编号规则 105CNGP消息定义 12

2、5.1 基本数据类型 125.2 消息结构 125.3 消息头格式 125.4 SP与SMGW之间的消息定义 135.4.1 login 135.4.2 login_resp 145.4.3 submit 155.4.4 submit_resp 165.4.5 deliver 165.4.6 deliver_resp 175.4.7 active_test 185.4.8 active_test_resp 185.4.9 exit 185.4.10 exit_resp 185.5 SMGW与SMGW之间的消息定义 185.5.1 login 195.5.2 login_resp 195.5.3

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前 言本标准描述了PHS短消息网关（SMGW）和服务提供商

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

5、络通信集团公司、中国网通集团研究院本标准主要起草人：张文钺、李松林、蒋美景、叶丹、杨哲、宋冠云本规范的解释权属于中国网络通信集团公司。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 Service Center短消息中心SP Ser

6、vice 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之间的通信标准。CNGP可以实现以下功能：1) SP通过S

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

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

9、立即重发，再连续发送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连接，应答与请求在同一个连接中完成。系统采用客

10、户/服务器模式，操作以客户端驱动方式发起连接请求，完成一次操作后关闭此连接。SMGW与SP之间、SMGW与SMGW之间的消息发送后等待T秒后未收到应答，应根据重发机制进行重发，再连续发送N-1次后仍未得到应答则停发。现阶段建议取值为：T=60秒，N=3。短连接的操作流程举例如图4.3所示： . . . . . . 服务器/客户端客户端/服务器端建立TCP连接CNGP消息2对CNGP消息2的应答拆除TCP连接图4.3 短连接的操作流程4.3.3 交互过程中的应答方式在SP与SMGW及SMGW与SMGW之间的交互过程中均采用异步方式，即任一个网元在收到请求消息后应立即回送应答消息。举例如图4.4所

11、示： SMGW2 SMGW1 SMSC SP CNPP应答消息 CNPP请求消息图4.4 异步交互方式示意图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）。在发送模式中客户端只能发送短消息、在接收模式中客

12、户端只能接收短消息、在收发模式中客户端既可以发送也可以接收短消息。三种模式均可以采用长连接与短连接两种连接方式的一种，根据实际情况选择。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需要通过对方SM

13、GW认证。图 4.7 SMGW转发短消息4.5 编号规则在整个SMGW系统中所有的通信节点（SMGW、SP 和SMSC）都有一个唯一的数字编号，不同的SP 、SMSC 或SMGW 编号不能相同，编号由系统管理人员负责分配，由集团统一管理，编号规则如下：SMGW的编号规则：1AAAXYSMSC的编号规则： 2AAAXYSP企业的编号规则：3AAAQQQQQQ其中，AAA 表示三位长途区号(不足三位的长途区号右对齐左补零)，XY表示从00到99的序号，QQQQQQ 表示6位企业代码。SP服务的编号规则：服务代码是在使用短消息方式的点播类业务中，提供给用户点播的短消息服务代码。服务代码以前缀4位数字

14、表示，全国业务服务代码长度统一为 8 位，即前缀“1000”“9999”，其中前缀为“1061”“1069”，由集团统一分配；本地业务服务代码长度统一为9 位，即前缀“01000”“09999”，其中前缀为“1061”“1069”，后五位数字由各省自行分配。SP业务的编号规则：SP的业务类型，数字、字母和符号的组合，由SP自定，如图片传情可定为TPCQ，股票查询可定义为11。最大长度为10字节。5CNGP消息定义5.1 基本数据类型类型说明Integer整数，长度根据具体协议确定，多字节情况下高字节在前Unsigned Integer无符号整数Octet String定长字符串，位数不足时左对

15、齐，右补二进制的零5.2 消息结构项目说明格式Message Header消息头（所有消息公共包头）定长Message Body消息体（必选部分）变长Message Body消息体（可选部分）TLV5.3 消息头格式字段名字节数类型描述total_length4Unsigned Integer消息总长度(含消息头及消息体)command_id4Unsigned Integer命令标识command_status4Unsigned Integer命令状态（参见7.4 status错误代码表）sequence_id4Unsigned Integer消息流水号，顺序累加，步长为1，循环使用（一对请求

16、和应答消息的流水号必须相同）5.4 SP与SMGW之间的消息定义请求名称请求标识消息方向说明login0x00000001SPSMGW登录请求login_resp0x80000001SPSMGW登录请求的应答submit0x00000002SP SMGWSP发送短消息请求submit_resp0x80000002SPSMGWSP发送短消息请求的应答deliver0x00000003SMGWSPSMGW发送短消息请求deliver_resp0x80000003SMGWSPSMGW发送短消息的应答active_test0x00000004SPSMGW测试通信链路是否正常请求（由客户端发起，SP和S

17、MGW可以通过定时发送此请求来维持连接）active_test_resp0x80000004SP SMGW测试通信链路是否正常的应答exit0x00000006SPSMGW退出请求exit_resp0x80000006SPSMGW退出请求的应答5.4.1 login字段长度（字节）数据类型说明ClientID10Octet StringSMGW设置的SP接入标识AuthenticatorClient16Octet String客户端密码用于鉴别客户端的接入请求。其值通过单向MD5 hash计算得出，表示如下：AuthenticatorClient =MD5（ClientID+7字节的二进制0

18、+Shared secret+TimeStamp）Shared secret 由服务器端与客户端事先商定的，最长15 字节， TimeStamp格式为：mmddhhmmss，即月日时分秒，10位LoginMode1Integer登录类型（0=发送短消息，1=接收短消息，2=收发短消息，其他保留）TimeStamp4Integer时间戳的明文，由客户端产生，格式为mmddhhmmss，即月日时分秒，10位数字的整型，右对齐 Version1Integer客户端支持的版本号(高位4bit表示主版本号，低位4bit表示次版本号)5.4.2 login_resp字段长度（字节）数据类型说明Authen

19、ticatorServer16Octet String服务器端认证码，当客户端认证出错时，此项为空其值通过单向MD5 hash计算得出，表示如下：AuthenticatorServer=MD5(Status+AuthenticatorClient+Shared secret)Shared secret 由服务器端与客户端事先商定，最长15 字节AuthenticatorClient为客户端发送给服务器端的上一条消息login中的值Version1Integer服务器支持的最高版本号5.4.3 submit字段长度（字节）数据类型说明SPID10IntegerSP的企业代码SubType1Int

20、eger短消息子类型（0取消订阅，1订阅或点播请求，2点播下发，3订阅下发，其他保留）NeedReport1Integer是否要求返回状态报告：（0不要求，1要求）Priority1Integer发送优先级（从0到3）3为最高级ServiceID10Octet String业务类型FeeType2Octet String资费类型00=免费01=按条收费02=包月03=封顶04=包月扣费请求05=CR话单 其他：保留FeeUserType1Octet String计费用户类型字段0：对目的终端计费1：对源终端计费2：对SP计费3：按照计费用户号码计费其他保留FeeCode6Octet Strin

21、g每条短消息的信息费，单位：分MsgFormat1Octet String短消息格式（参见短消息格式代码表7.1）ValidTime17Octet String有效时间，（格式：参照SMPP3.4协议）AtTime17Octet String定时发送时间，（格式：参照SMPP3.4协议）SrcTermID21Octet String短消息发送用户号码ChargeTermID21Octet String计费用户号码DestTermIDCount1Integer短消息接收号码总数（100）DestTermID21* DestTerm CountOctet String短消息接收号码（连续存储Des

22、tTermIDCount个号码）MsgLength1Unsigned Integer短消息长度MsgContent254Octet String短消息内容ProtocolIDTLV协议标识（参见TLV说明表7.5）5.4.4 submit_resp字段长度（字节）数据类型说明MsgID10Octet StringSMGW产生的短消息流水号，由三部分组成：SMGW代码：3字节（BCD码）时间：4字节（BCD码）序列号：3字节（BCD码）CongestionState TLV 流量控制（参见TLV说明表7.5）5.4.5 deliver字段长度（字节）数据类型说明MsgID10Octet Stri

23、ngSMGW产生的短消息流水号，由三部分组成：SMGW代码：3字节（BCD码）时间：4字节（BCD码）序列号：3字节（BCD码）IsReport1Integer是否状态报告：0：不是1：是MsgFormat1Integer短消息格式（参见短消息格式代码表7.1）RecvTime14Octet String短消息接收时间（格式：yyyymmddhhmmss，例如20010301200000）SrcTermID21Octet String短消息发送用户号码DestTermID21Octet String短消息接收用户号码MsgLength1Unsigned Integer短消息长度MsgConte

24、nt254Octet String短消息内容ProtocolIDTLV协议标识（参见TLV说明表7.5）5.4.6 deliver_resp字段长度（字节）数据类型说明MsgID10Octet StringSMGW产生的短消息流水号，由三部分组成：SMGW代码：3字节（BCD码）时间：4字节（BCD码）序列号：3字节（BCD码）CongestionState TLV 流量控制（参见TLV说明表7.5）5.4.7 active_test无消息体。5.4.8 active_test_resp无消息体。5.4.9 exit无消息体。5.4.10 exit_resp无消息体。5.5 SMGW与SMGW

25、之间的消息定义请求名称请求标识说明login0x00000001SMGW登录请求login_resp0x80000001SMGW登录请求的应答active_test0x00000004测试通信链路是否正常请求（由客户端发起，SMGW和SMGW可以通过定时发送此请求来维持连接）active_test_resp0x80000004测试通信链路是否正常的应答forward0x00000005SMGW转发短消息请求forward_resp0x80000005SMGW转发短消息的应答exit0x00000006退出请求exit_resp0x80000006退出请求的应答5.5.1 login字段长度（字

26、节）数据类型说明ClientID10Octet String此处为源SMGW代码AuthenticatorClient16Octet String客户端密码用于鉴别客户端的接入请求。其值通过单向MD5 hash计算得出，表示如下：AuthenticatorClient =MD5（ClientID+7字节的二进制0 +Shared secret+TimeStamp） Shared secret 由服务器端与客户端事先商定的，最长15 字节， TimeStamp格式为：mmddhhmmss，即月日时分秒，10位LoginMode1Integer登录类型（0=发送短消息，1=接收短消息，2=收发短消

27、息，其他保留）TimeStamp4Integer时间戳的明文，由客户端产生，格式为mmddhhmmss，即月日时分秒，10位数字的整型，右对齐 Version1Integer客户端支持的版本号(高位4bit表示主版本号，低位4bit表示次版本号)5.5.2 login_resp字段长度（字节）数据类型说明AuthenticatorServer16Octet String服务器端认证码，当客户端认证出错时，此项为空其值通过单向MD5 hash计算得出，表示如下：AuthenticatorServer=MD5(Status+AuthenticatorClient+Shared secret) Sh

28、ared secret 由服务器端与客户端事先商定，最长15 字节 AuthenticatorClient为客户端发送给服务器端的上一条消息login中的值Version1Integer服务器支持的最高版本号5.5.3 active_test无消息体。5.5.4 active_test_resp无消息体。5.5.5 forward字段长度（字节）数据类型说明MsgID10Octet StringSMGW产生的短消息流水号，由三部分组成：SMGW代码：3字节（BCD码）时间：4字节（BCD码）序列号：3字节（BCD码）DestSMGWNo6Octet String目标SMGW代码SrcSMGWNo6Octet String源SMGW代码SMSCNo6Octet String源SMSC代码SMType1Integer短消息类型（0=PHS用户发到SP的MO，1PHS用户发到异网用户，2SP发到PHS用户的MT，3异网用