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

-7-
短消息网关协议 SN RC1 SMGP V3.0.3 另一类是移动网短消息业务。
4.3.1 固定网短消息业务
SMGP
SP
SMGP 及 SMGP 扩展计费接口
SMGP
SP
SMGP 扩展 计费接口
二级 SMGW
预付费平 台
SMC
一级 SMGW
固定网 (PHS,PSTN)
SMGP 及 SMGP 扩展计费接口
-5-
短消息网关协议 SN RC1 SMGP V3.0.3
客户端
建立 TCP 连接 SMGP 消息 1
服务器端
SMGP 消息 2
对 SMGP 消息 1 的响应
对 SMGP 消息 2 的响应
滑动窗口不大于 W
...... 链路检测包
链路检测包响应
链路检测包 链路检测包响应
...... 拆除 TCP 连接
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 所示：
短连接的操作流程举例如图 2 所示：
客户端
建立 TCP 连接
服务器
SMGP 消息 1 对 SMGP 消息 1 的响应
拆除 TCP 连接
建立 TCP 连接 SMGP 消息 2
对 SMGP 消息 2 的响应 拆除 TCP 连接 ......
图 4.2 短连接操作流程
4.3 协议应用及涉及的端口号
SMGP 协议在中国电信中的应用主要体现在两类短消息业务上：一类是固定网短消息业务，
二级 SMGW
SMGP SP
SMGP 扩展 计费接口
SMC
预付费 平台
固定网 (PHS,PSTN)
固定终端
固定终端
(PHS,”家加 e”)
(PHS,”家加 e”)
图
4.3 固定网短消息业务系统结构简图
固定网短消息业务系统结构简图如图 3 所示。SMGP 协议在固网短消息系统中应用情况如下： 1. 二级 SMGW 与 SP
-8-
短消息网关协议 SN RC1 SMGP V3.0.3 4. 二级 SMGW 和 PHS 预付费平台
二级 SMGW 与 PHS 预付费平台之间采用 SMGP 协议扩展计费接口(参见 SMGP V2.0)进行计 费信息的传输，端口号为 9100，预付费平台作为服务器端，二级 SMGW 作为客户端。
-1-
短消息网关协议 SN RC1 SMGP V3.0.3
前言
本标准规定了短消息网关与其它网元之间进行短消息传输的接口协议。 本标准是在 SMGP 协议 V2.0 的基础上，基于 3G 网络的短消息业务发展需求进行修订而成。 本标准共包含 3 部分：1、SMGP 基本协议；2、SMGP 协议扩展计费接口；3、SMGP 协议扩展电 子商务接口。本文只描述了第 1 部分 SMGP 基本协议，第 2 部分和第 3 部分同 SMGP 协议 V2.0。 本标准起草单位：中国电信股份有限公司、中国电信股份有限公司上海研究院 本标准主要起草人：葛敏 周文君 顾丽丽 蒋力 董斌 施唯佳
二级 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 为客户端；
CT
中国电信企业标准
CT/T SN RC1 SMGP V3.0.3
中国电信 短消息网关协议（SMGP）
2008-08 发布
中国电信集团公司
2008-08 实施
短消息网关协议 SN RC1 SMGP V3.0.3
目录
1 适用范围 ....................................................................... 2 2 引用标准 ....................................................................... 3 3 缩略语 ......................................................................... 4 4 SMGP 协议概述 .................................................................. 5
Short Message Gateway Protocol Short Message Gateway Short Message Point to Point Protocol
中文全名 外部短消息实体
汇接网关
服务提供商
短消息业务中心
短消息网关协议 短消息网关 短消息点到点协议
-4-
短消息网关协议 SN RC1 SMGP V3.0.3
4.1 定义 ........................................................................ 5 4.2 通信方式 .................................................................... 5 4.3 协议应用及涉及的端口号 ...................................................... 7 5 SMGP 协议 ..................................................................... 10 5.1 数据类型 ................................................................... 10 5.2 消息结构 ................................................................... 10 6 参数定义 ...................................................................... 25 6.1 消息头参数描述 ............................................................. 25 6.2 消息体必选参数描述 ......................................................... 27 6.3 消息体可选参数描述 ......................................................... 42 7 基于 SMGP 协议的 API 函数 ....................................................... 49 附录 A 基于 SMGP 协议的 API 函数说明(规范性附录) .................................... 50 A.1 基本要求 ..................................................................... 50 A.2 API 数据结构说明（以 C 语言为例） ............................................. 51 A.3 API 函数说明 ................................................................. 53 A.4 配置 SMGP API................................................................. 57 A.5 短消息的自动分割功能 ......................................................... 58 A.6 错误代码含义 ................................................................. 59 附录 B 短消息群发功能的实现（资料性附录）.......................................... 61 附录 C 修改历史记录 ............................................................... 61