中国电信集团公司2008-08实施2008-08发布CP/SP开发-中国电信短消息网关协议（SMGP）CT/T SN RC1 CP/SP开发-SMGP VCT中国电信企业标准目 录1适用范围22引用标准33缩略语44SMGP协议概述54.1定义54.2通信方式54.3协议应用及涉及的端口号75SMGP协议105.1数据类型105.2消息结构106参数定义236.1消息头参数描述236.2消息体必选参数描述256.3消息体可选参数描述407基于SMGP协议的API函数47附录A 基于SMGP协议的API函数说明(规范性附录)48A.1基本要求48A.2 API数据结构说明（以C语言为例）49A.3 API函数说明51A.4配置SMGP API55A.5短消息的自动分割功能56A.6错误代码含义57附录B 短消息群发功能的实现（资料性附录）59附录C 修改历史记录59前 言本标准规定了短消息网关与其它网元之间进行短消息传输的接口协议。本标准是在SMGP协议V2.0的基础上，基于3G网络的短消息业务发展需求进行修订而成。本标准共包含3部分：1、SMGP基本协议；2、SMGP协议扩展计费接口；3、SMGP协议扩展电子商务接口。本文只描述了第1部分SMGP基本协议，第2部分和第3部分同SMGP协议V2.0。本标准起草单位：中国电信股份有限公司、中国电信股份有限公司上海研究院本标准主要起草人：葛敏 周文君 顾丽丽 蒋力 董斌 施唯佳1 适用范围本协议适用于短消息网络上（固定网、移动网）短消息网关与其它网元之间进行短消息的传输。本协议适用于短消息网关、相关网元设备开发商及内容提供商。2 引用标准下列文件通过本文的参考而成为本规范的条款。凡是注日期的参考文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本文，凡是不注日期的参考文件，其最新版本适用于本文。【1】Short Message Peer to Peer Protocol Specification【2】中国电信CDMA短消息网关设备规范v1.0.1【3】中国电信CDMA短消息网关测试规范v1.0.1【4】中国电信综合业务管理平台ISMP接口规范_RC_-SS接口3 缩略语缩略语英文全名中文全名ESMEExternal Short Message Entity外部短消息实体GNSGateway Name Server汇接网关SPService Provider服务提供商SMSCShort Message Service Center短消息业务中心SMGPShort Message Gateway Protocol短消息网关协议SMGWShort Message Gateway短消息网关SMPPShort Message Point to Point Protocol短消息点到点协议4 SMGP协议概述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所示： . . . . . . 滑动窗口不大于WWSMGP消息1客户端服务器端SMGP消息2对SMGP消息1的响应对SMGP消息2的响应链路检测包 链路检测包响应建立TCP连接链路检测包 链路检测包响应拆除TCP连接 . . . . . . 图4.1 长连接操作流程4.2.2 短连接通信双方以客户-服务器方式建立TCP连接，应答与请求在同一个连接中完成。系统采用客户/服务器模式，操作以客户端驱动方式发起连接请求，完成一次操作后关闭此连接。通信双方之间的消息发送后等待T秒后未收到响应，应立即重发，再连续发送N-1次后仍未得到响应则停发。现阶段建议取值为：T=60秒，N=3。短连接的操作流程举例如图2所示：对SMGP消息1的响应SMGP消息1建立TCP连接拆除TCP连接SMGP消息2对SMGP消息2的响应建立TCP连接拆除TCP连接 . . . . . . 客户端服务器端图4.2 短连接操作流程 4.3 协议应用及涉及的端口号SMGP协议在中国电信中的应用主要体现在两类短消息业务上：一类是固定网短消息业务，另一类是移动网短消息业务。4.3.1 固定网短消息业务图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协议扩展计费接口(参见SMGP V2.0)进行计费信息的传输，端口号为8900，二级SMGW作为服务器端，一级SMGW作为客户端；3. 一级SMGW与SP一级SMGW与SP之间采用SMGP协议进行短消息的传输，端口号为8890，一级SMGW为服务器端，SP为客户端；4. 二级SMGW和PHS预付费平台二级SMGW与PHS预付费平台之间采用SMGP协议扩展计费接口(参见SMGP V2.0)进行计费信息的传输，端口号为9100，预付费平台作为服务器端，二级SMGW作为客户端。4.3.2 移动网短消息业务GNSSMGWSMGWSMCSMC图4.4移动网短消息业务系统结构简图构图SMGPSMGPSPSPSMGPSMGPSMGP移动网移动网移动网终端移动网终端移动网短消息业务系统结构简图如图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为客户端。5 SMGP协议5.1 数据类型5.1.1 基本数据类型Integer无符号整数Octet String不强制以0x00结尾的定长字符串。当位数不足时，在不明确注明的情况下，应左对齐，右补0x00。在明确注明的情况下，以该字段的明确注明为准。5.1.2 可选参数可选参数采用TLV（Tag、Length、Value）形式定义，每个可选参数的Tag、Length、Value的定义见6.3节。字段长度（字节）数据类型说明Tag2Integer字段的标签，用于唯一标识可选参数Length2Integer字段的长度Value可变长度可变类型字段内容5.2 消息结构项目说明Message Header消息头(所有消息公共包头)Message Body消息体5.2.1 消息头结构字段长度（字节）数据类型说明参考PacketLength4Integer数据包长度RequestID4Integer请求标识SequenceID4Integer消息流水号5.2.2 消息体结构5.2.2.1 登录操作（Login）Login操作的目的是客户端向服务器端注册作为一个合法客户端身份，若注册成功后即建立了应用层的连接，此后客户端可以与此服务器端进行消息的接收和发送。服务器端以Login_Resp消息响应客户端的请求。5.2.2.1.1 Login字段长度（字节）数据类型说明参考必选参数ClientID8Octet String客户端用来登录服务器端的用户账号。AuthenticatorClient16Octet String客户端认证码，用来鉴别客户端的合法性。LoginMode1Integer客户端用来登录服务器端的登录类型。TimeStamp4Integer时间戳ClientVersion1Integer客户端支持的协议版本号5.2.2.1.2 Login_Resp字段长度（字节）数据类型说明参考必选参数Status4Integer请求返回结果AuthenticatorServer16Octet String服务器端返回给客户端的认证码ServerVersion1Integer服务器端支持的最高版本号5.2.2.2 SP向SMGW提交短消息的操作（Submit）5.2.2.2.1 Submit字段长度（字节）数据类型说明参考必选参数MsgType1Integer短消息类型NeedReport1IntegerSP是否要求返回状态报告Priority1Integer短