中国电信集团公司2008-03实施2008-03发布中国电信短消息网关协议〔SMGP〕CT/T SN RC1 SMGP VCT中国电信企业标准目 录1 适用范围 22 引用标准 33 缩略语 44 SMGP协议概述 54.1 定义 54.2 通信方式 54.3 协议应用及涉及的端口号 75 SMGP协议 105.1 数据类型 105.2 消息结构 106 参数定义 256.1 消息头参数描述 256.2 消息体必选参数描述 276.3 消息体可选参数描述 427 基于SMGP协议的API函数 48附录A 基于SMGP协议的API函数说明(标准性附录) 49A.1根本要求 49A.2 API数据结构说明〔以C语言为例〕 50A.3 API函数说明 52A.4配置SMGP API 56A.5短消息的自动分割功能 57A.6错误代码含义 57附录B 短消息群发功能的实现〔资料性附录〕 60附录C 修改历史记录 60前 言本标准规定了短消息网关与其它网元之间进行短消息传输的接口协议本标准是在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.0【3】中国电信CDMA短消息网关测试标准v1.0.0【4】中国电信综合业务管理平台ISMP接口标准 V1.0.03 缩略语缩略语英文全名中文全名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网元设备称为ESME4.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所示： . . . . . . 滑动窗口不大于W WSMGP消息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短消息发送优先级Serv。