中国电信短信网关SMGP协议(V3.0.3)

中国电信企业标准CTCT/TSNRC1SMGPV3.0.3中国电信短消息网关协议（SMGP）2008-08发布2008-08实施中国电信集团公司福富公司专用短消息网关协议SNRC1SMGPV3.0.3-1-目录1适用范围.......................................................................22引用标准.......................................................................33缩略语.........................................................................44SMGP协议概述..................................................................54.1定义........................................................................54.2通信方式....................................................................54.3协议应用及涉及的端口号......................................................75SMGP协议.....................................................................105.1数据类型...................................................................105.2消息结构...................................................................106参数定义......................................................................256.1消息头参数描述.............................................................256.2消息体必选参数描述.........................................................276.3消息体可选参数描述.........................................................427基于SMGP协议的API函数.......................................................49附录A基于SMGP协议的API函数说明(规范性附录)....................................50A.1基本要求.....................................................................50A.2API数据结构说明（以C语言为例）.............................................51A.3API函数说明.................................................................53A.4配置SMGPAPI.................................................................57A.5短消息的自动分割功能.........................................................58A.6错误代码含义.................................................................59附录B短消息群发功能的实现（资料性附录）..........................................61附录C修改历史记录...............................................................61福富公司专用短消息网关协议SNRC1SMGPV3.0.3-1-前言本标准规定了短消息网关与其它网元之间进行短消息传输的接口协议。本标准是在SMGP协议V2.0的基础上，基于3G网络的短消息业务发展需求进行修订而成。本标准共包含3部分：1、SMGP基本协议；2、SMGP协议扩展计费接口；3、SMGP协议扩展电子商务接口。本文只描述了第1部分SMGP基本协议，第2部分和第3部分同SMGP协议V2.0。本标准起草单位：中国电信股份有限公司、中国电信股份有限公司上海研究院本标准主要起草人：葛敏周文君顾丽丽蒋力董斌施唯佳福富公司专用短消息网关协议SNRC1SMGPV3.0.3-2-1适用范围本协议适用于短消息网络上（固定网、移动网）短消息网关与其它网元之间进行短消息的传输。本协议适用于短消息网关、相关网元设备开发商及内容提供商。福富公司专用短消息网关协议SNRC1SMGPV3.0.3-3-2引用标准下列文件通过本文的参考而成为本规范的条款。凡是注日期的参考文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本文，凡是不注日期的参考文件，其最新版本适用于本文。【1】ShortMessagePeertoPeerProtocolSpecification【2】中国电信CDMA短消息网关设备规范v1.0.1【3】中国电信CDMA短消息网关测试规范v1.0.1【4】中国电信综合业务管理平台ISMP接口规范_RC1.0.1_-SS接口福富公司专用短消息网关协议SNRC1SMGPV3.0.3-4-3缩略语缩略语英文全名中文全名ESMEExternalShortMessageEntity外部短消息实体GNSGatewayNameServer汇接网关SPServiceProvider服务提供商SMSCShortMessageServiceCenter短消息业务中心SMGPShortMessageGatewayProtocol短消息网关协议SMGWShortMessageGateway短消息网关SMPPShortMessagePointtoPointProtocol短消息点到点协议福富公司专用短消息网关协议SNRC1SMGPV3.0.3-5-4SMGP协议概述4.1定义SMGP协议是SMGW与其它网元设备（除SMC外）进行短消息传输的接口协议。非SMC网元设备向SMGW发送或从SMGW接收短消息，这些非SMC网元设备称为ESME。4.2通信方式SMGW与ESME之间共有两种连接方式：长连接和短连接。所谓长连接，指在一个TCP连接上可以连续发送多个数据包，在TCP连接保持期间，如果没有数据包发送，需要双方发链路检测包以维持此连接。短连接是指通信双方有数据交互时，就建立一个TCP连接，数据发送完成后，则断开此TCP连接，即每次TCP连接只完成一对SMGP消息的发送。4.2.1长连接通信双方以客户-服务器方式建立TCP连接，用于双方信息的相互提交。当信道上没有数据传输时，通信双方应每隔时间C发送链路检测包以维持此连接，当链路检测包发出超过时间T后未收到响应，应立即再发送链路检测包，再连续发送N-1次后仍未得到响应则断开此连接。参数C、T、N原则上应可配置，现阶段建议取值为：C=3分钟，T=60秒，N=3。通信双方之间的消息如果不能成功发送，应隔时间R进行重发，再连续发送N-1次后仍未发送成功则停发。现阶段建议取值为：R=60秒，N=3。通信双方之间的消息发送后等待T秒后未收到响应，应立即重发，再连续发送N-1次后仍未得到响应则停发。现阶段建议取值为：T=60秒，N=3。消息采用并发方式发送，加以滑动窗口流量控制，窗口大小参数W可配置，现阶段建议为16，即接收方在应答前一次收到的消息最多不超过16条。长连接的操作流程举例如图1所示：福富公司专用短消息网关协议SNRC1SMGPV3.0.3-6-......滑动窗口不大于WSMGP消息1客户端服务器端SMGP消息2对SMGP消息1的响应对SMGP消息2的响应链路检测包链路检测包响应建立TCP连接链路检测包链路检测包响应拆除TCP连接......图4.1长连接操作流程福富公司专用短消息网关协议SNRC1SMGPV3.0.3-7-4.2.2短连接通信双方以客户-服务器方式建立TCP连接，应答与请求在同一个连接中完成。系统采用客户/服务器模式，操作以客户端驱动方式发起连接请求，完成一次操作后关闭此连接。通信双方之间的消息发送后等待T秒后未收到响应，应立即重发，再连续发送N-1次后仍未得到响应则停发。现阶段建议取值为：T=60秒，N=3。短连接的操作流程举例如图2所示：4.3协议应用及涉及的端口号SMGP协议在中国电信中的应用主要体现在两类短消息业务上：一类是固定网短消息业务，对SMGP消息1的响应SMGP消息1建立TCP连接拆除TCP连接SMGP消息2对SMGP消息2的响应建立TCP连接拆除TCP连接......客户端服务器图4.2短连接操作流程福富公司专用短消息网关协议SNRC1SMGPV3.0.3-8-另一类是移动网短消息业务。4.3.1固定网短消息业务SMGP及SMGP扩展计费接口SMGPSMGPSMGPSPSMC预付费平台固定终端(PHS,”家加e”)SMC预付费平台SP一级SMGW二级SMGW固定网(PHS,PSTN)固定终端(PHS,”家加e”)固定网(PHS,PSTN)二级SMGWSPSMGP扩展计费接口SMGP扩展计费接口SMGP及SMGP扩展计费接口图4.3固定网短消息业务系统结构简图固定网短消息业务系统结构简图如图3所示。SMGP协议在固网短消息系统中应用情况如下：1.二级SMGW与SP二级SMGW与SP之间采用SMGP协议进行短消息的传输，端口号为8890，二级SMGW为服务器端，SP为客户端；2.二级SMGW与一级SMGW二级SMGW与一级SMGW之间采用SMGP协议进行短消息的传输，端口号为8900，二级SMGW与一级SMGW互为客户/服务器端；二级SMGW与一级SMGW之间采用SMGP协议扩展计费接口(参见SMGPV2.0)进行计费信息的传输，端口号为8900，二级SMGW作为服务器端，一级SMGW作为客户端；3.一级SMGW与SP一级SMGW与SP之间采用SMGP协议进行短消息的传输，端口号为8890，一级SMGW为服务器端，SP为客户端；福富公司专用短消息网关协议SNRC1SMGPV3.0.3-9-4.二级SMGW和PHS预付费平台二级SMGW与PHS预付费平台之间采用SMGP协议扩展计费接口(参见SMGPV2.0)进行计费信息的传输，端口号为9100，预付费平台作为服务器端，二级SMGW作为客户端。4.3.2移动网短消息业务移动网短消息业务系统结构简图如图4所示。SMGP协议在移动网短消息系统中应用情况如下：1.SMGW与SP¾SMGW与SP之间采用SMGP协议进行短消息的传输，端口号为8890，SMGW为服务器端，SP为客户端；2.SMGW与SMGW¾SMGW与SMGW之间采用SMGP协议进行短消息的传输，端口号为8900，SMGW与SMGW互为客户/服务器端；3.SMGW与GNS¾SMGW与GNS之间采用SMGP协议进行消息传输，端口号为8901，SMGW为服务器端，GNS为客户端。GNSSMGWSMGWSMCSMC图4.4移动网短消息业务系统结构简图构图SMGPSMGPSPSPSMGPSMGPSMGP移动网移动网移动网终端移动网终端福富公司专用短消息网关协议SNRC1