SMPP是一种通用的短信接口协议
2009-05-07 10:03
246 查看
SMPP是一种通用的短信接口协议,本文摘录了能实现短信基本功能的内容。
前言
短消息中心(SMSC)可以与各种扩展短消息实体(ESME)配合工作,从而为移动用户提供丰富多采的功能。
符号和缩略语
SMSC指短消息中心。
ESME在本规范中指的是通过本规范规定的协议与SMSC通信,请求特定的短消息服务的功能实体。
SS指人工话务接入并受理短消息服务请求的系统。
AS指利用交互式语音技术受理短消息服务请求的系统。
SS(秘书台)和AS(自动台)是典型的ESME。
SMSC和ESME之间的传输网络可以是基于X.25, 或TCP/IP。
ESME到SMSC的消息
ESME到SMSC的消息,如:提交、查询、删除短消息等请求,ESME必须以TRANSMITTER类型连接到SMSC。
图4描述了一个典型的TRANSMITTER类型的请求应答的示例。TRANSMITTER类型的ESME是以BIND_TRANCESMITTER连接到SMSC的ESME,此类型的ESME向SMSC发起提交短消息,查询短消息状态,删除短消息等请求,SMSC返回请求的应答。
ESME和SMSC之间的请求应答消息可以是阻塞方式也可以是异步方式的。所以ESME可能在SMSC没有应答的情况下,发起多个请求到SMSC。
SMSC应该按照收到的请求顺序,给EMSE回响应。但是ESME必须能够处理没有按顺序的响应。
SMSC到ESME的消息
SMSC到ESME的消息,如:SMSC转发短消息到ESME,ESME必须以RECEIVER类型连接到SMSC。
图5描述了一个典型的RECEIVER类型的ESME和SMSC之间的消息序列的示例。RECEIVER类型的ESME是以BIND_RECEIVER连接到SMSC的ESME,SMSC向此类ESME转发短消息,ESME向SMSC回应答。
ESME和SMSC之间的请求应答消息可以是阻塞方式也可以是异步方式的。所以SMSC可能在ESME没有回应答的情况下,发送发起多个deliver_sm请求到ESME。
ESME应该按照收到的请求顺序,给SMSC返回响应。但是SMSC必须能够处理没有按顺序回的响应。
消息流
本规范中规定的所有协议,不管是从ESME到SMSC,还是从SMSC到ESME的消息,接收到请求的一方,都必须给请求方回一个应答消息(acknowledge)。
消息语法
在以下语法说明中,遵从以下规则:
A.未使用的字段,依据类型必须设置为0或NULL。
B.消息由消息头和消息体组成。
C.状态(Command_status)的定义如表3所示。
状态定义
类型定义
(1)integer:一定字节数所组成的整数,高位在前,低位在后。例 如:1字节(BYTE),2字节(WORD ) , 4字节 (DWORD) ,6字节等等。
(2)C_String:以NULL结束的ASCII字符串。
(3)C_DecString:以NULL结束的ASCII字符串,它由一系列的10进制字符 组成(‘0’---‘9’)。
(4)C_OctetString:由任意8位字节组成数据流串。
(5)C_HexString:以NULL结束的ASCII字符串,它由一系列的16进制字符组 成(‘0’---‘9’,‘A’(‘a’)---‘F’(‘f’))。
(6)C_UnicodeString:以NULL结束的Unicode编码的字符串。
(7)C_StringTime:表示时间的字符串,它为以下格式。“YYMMDDhhmmsstnnp" , 长度定为17个字节或1个字节,最后一个字节值必须为NULL,1个字节表示 使用缺省的时间定义(由短消息中心实现时具体设置),17个字节的具体格式 如下:
对于千年问题,采用时间窗口的方法来解决,具体方法为YY>90解释为19YY;否则解释为20YY。
消息头语法
表4:短消息头语法
消息体语法
以下几条命令实现后,就可以实现短消息的收发。
BIND_RECEIVER命令
此命令在扩展短消息实体和短消息中心之间产生虚连接,该连接支持所有的协议命令。
BIND_RECEIVER语法
消息头中的Command_ID是“bind_receiver"
表5:BIND_RECEIVER语法
BIND_RECEIVER_RESP语法
消息头中的Command_ID 是“bind_receiver_resp"。
表6:BIND_RECEIVER_RESP语法
状态取值范围:
E_SUCCESS
E_OTHERERR
E_CMDLENERR
E_NORIGHT
E_INVLDSYSTEMID
E_INVLDPASSWORD
E_INVLDSYSTEMTYPE
E_INVLDIFVER
UNBIND命令
此命令用于断开ESME和SMSC之间的连接。
UNBIND语法
此消息只有消息头,没有消息体,消息头中的Command_ID是“unbind"。
UNBIND_RESP语法
此消息只有消息头,没有消息体,消息头中的Command_ID是“unbind_resp"。
状态取值范围:
E_SUCCESS
E_OTHERERR
E_CMDLENERR
E_NORIGHT
6.5.2.4 SUBMIT_SM命令
此命令用于ESME提交短消息到SMSC,以便SMSC把此短消息发给特定的移动台。
SUBMIT_SM语法
消息头中的Command_ID是"submit_sm"
表7:SUBMIT_SM语法
SUBMIT_SM_RESP语法
消息头中的Command_ID是"submit_sm_resp"
表8:SUBMIT_SM_RESP语法
状态取值范围:
E_SUCCESS
E_OTHERERR
E_CMDLENERR
E_NORIGHT
E_ADDRERR
E_MOEXCEED
E_MTEXCEED
E_INVLDUSER
E_INVLDDATAFMT
E_CREATEMSGFAILURE
E_INVLDORGTON
E_INVLDORGNPI
E_ORGADDRERR
E_INVLDDESTTON
E_INVLDDESTNPI
E_DESTADDRERR
E_INVLDSCHEDULE
E_INVLDEXPIRE
E_INVLDESM
E_INVLDUDLEN
E_INVLDPRI
E_INVLDRDF
E_INVLDRPF
DELIVER_SM命令
此命令由SMSC产生,SMSC通过此命令发送短消息到目的ESME,它也可用于发送转发状态报告(DELIVERY RECEIPT)消息。
DELIVER_SM语法
它的语法和SUBMIT_SM的语法消息体是相同的,只是在消息头中的Command_ID是“deliver_sm"。
DELIVER_SM_RESP语法
它的语法和SUBMIT_SM_RESP的语法消息体是一样的,只是在消息头中的Command_ID是“deliver_sm_resp"。
附:消息体参数说明
address:
地址号码
address_range
地址范围
data_coding:
数据编码方案, ( 详见GSM 03.40 [1] 9.2.3.10)
dest_address_npi:
目的地址编码方案,同npi
dest_address_ton:
目的地址编码类型,同ton
destination_address:
目的地址,同address
esm_class:
短消息类型
其中UDHI为1表示短消息内容中有头结构,为0表示没有头结构。
Delivery RCPT为1表示是此条短消息是状态报告,0表示为正常的下发短消息。此位只对DELIVER_SM有效。
其他为保留。
如果有头结构,short_message_text为以下格式:
{
BYTE UDHL; //信息元素的结构集合所用的字节数
Information?Element-struct Information?Element;
//若干信息元素的结构集合, 其占用的字节数目由UDHL指示
...
SM; 短消息内容
}
其中Information?Element-struct的结构如下:
{
BYTE Information?Element?Identifier // 信息元素的标志
BYTE Length of Information?Element //信息元素数据所用的字节数
Information?Element Data
//信息元素数据,其占用的字节数目由Length of Information?Element指示
}
定义详见GSM 03.40 (7.2.0) 9.2.3.24
final_date:
短消息的生命期终止的实际时间,如果此短消息已从SMSC的等待发送队列中删除,即为删除时间,否则为SMSC当前的时间
GSM_code:
GSM错误码,见下表
interface_version:
用来描述本协议的版本号
在ESME连接SMSC时,如果ESME提出的版本号高于SMSC的版本号,则SMSC给出否定响应,响应中的status表示SMSC的版本号;ESME提出的版本号低于或等于SMSC的版本号,则SMSC给出肯定响应,在连接成功后的会话过程中,双方将以ESME提出的版本号作为通信的依据。interface_version的值从1开始,0保留。
现约定,对于interface_version>=1,必须支持除REPLACE_SM_EX命令和用户管理命令以外的所有协议命令, 对于interface_version>=2, 必须支持所有本文中提到的协议命令。
message_id:
短消息ID,它由SMSC设置。用于查询以及替换短消息等操作时使用。
message_status:
短消息当前的状态:
0:转发状态
1:发送成功(不在尝试转发)
2:发送失败(不在尝试转发)
3:因下发失败而等待(继续尝试转发)
4:因定时消息而等待(继续尝试转发)
5:短消息被删除(不在尝试转发)
6:短消息超时删除(不在尝试转发)
7:无效状态(不在尝试转发)
8:EN_ROUTE,为兼容SMPP协议保留
9:DELIVERED,为兼容SMPP协议保留
10:EXPIRED,为兼容SMPP协议保留
11:DELETED,为兼容SMPP协议保留
12:UNDELIVERABLE,为兼容SMPP协议保留
13:ACCEPTED,为兼容SMPP协议保留
14:INVALID,为兼容SMPP协议保留
其他:保留
MS_type:
手机类型
0:中文手机
1:英文手机
>1:保留
npi:
地址编码方案,(定义详见GSM03.40[1] 9.1.2.5)
0:未知
1:ISDN电话编码方案
3:数据编码方案(X.121)
4:电报编码方案
8:国家编码方案
9:专用编码方案
10:ERMES 编码方案(ETSI DE/PS 3 01?3)
15:扩充保留
从0到15的其他值保留
OCOS:
最大提交短消息,某移动台提交到SMSC的等待下发的短消息的最大数目
password:
用来登录的密码
priority_flag:
优先级
1:高优先级
0:普通优先级
>1:保留
protocol_ID:
GSM协议类型(定义详见GSM03.40[1] 9.2.3.9)
registered_delivery_flag:
注册短消息标志,它表示当此短消息到达最后的目的地后,是否需要 转发状态报告(DELIVERY RECEIPT)。
0:不需要
1:需要
>1:保留
replace_if_present_flag:
替换标志,当SUBMIT命令中指示的源地址和目的地址与等待下发的短消息的源地址和目的地址都相同时,是否替换这些等待下发的短消息。在DELIVERY命令中该参数无效,需置为0。
0:不替换
1:替换
>1:保留
schedule_delivery_time:
对于SUBMIT命令,该参数指计划下发短消息的时间,对于DELIVERY命令,该参数指SMSC收到要下发到ESME的短消息的时间。
service_type:
保留,必须设为NULL,原该参数指明短消息服务的类别
short_message_text:
短消息数据内容,当编码类型为7位码,类型为C_String,最大长度为160个字符。8位码时,类型为C_String,最大长度为140个字节。当为Unicode时,类型为C_UnicodeString,最大长度为70个字符。
SM_allowed:
是否提供短消息业务
0:不提供
1:提供
其余值保留
sm_default_msg_id:
预定义短消息ID,不是预定义短消息时应设为0。预定义短消息ID值从0x01到 0x64,其值的具体含义由特定的ESME和SMSC约定。其余值保留。
sm_length:
短消息的数据长度,以字节计算。
source_address:
源地址编号,同address。
source_address_npi:
源地址编码方案,同npi。
source_address_ton:
源地址编码类型,同 ton。
sub_address:
用户通信地址。
sub_ID:
用户ID,同address。
sub_name:
用户名。
reg_datetime:
用户注册登记时间 。
system_id:
接口ID,用来描述虚拟连接的用户名,即ESME登录SMSC使用的帐号。
system_type:
用来描述用户的类型。
TCOS:
最大下发数,指等待下发到某移动台的最大短消息数目。
ton:
地址编码类型,(定义详见GSM03.40[1] 9.1.2.5)
0 未知号码
1 国际号码,例如8613901234567
2 国内号码,例如13901234567
3 网络专用号码
4 用户号码
5 字母号码(按照 GSM?TS03.38 7-bit 缺省字母表编码)
6 缩写号码
7 保留
validity_peroid:
短消息的最后生存期限。
附录A:命令标志数值定义
前言
短消息中心(SMSC)可以与各种扩展短消息实体(ESME)配合工作,从而为移动用户提供丰富多采的功能。
符号和缩略语
ESME Agent | External Short Message Entity Agent 扩展短消息实体代理 |
ESME | External Short Message Entity 扩展短消息实体 |
PLMN | Public Land Mobile Network 公共陆地移动网 |
SMSC | Short Message Service Center 短消息中心 |
SMPP | Short Message Peer to Peer 短消息点对点协议 |
SS | Secretary System 秘书台 |
AS | Auto System 自动台 |
ESME在本规范中指的是通过本规范规定的协议与SMSC通信,请求特定的短消息服务的功能实体。
SS指人工话务接入并受理短消息服务请求的系统。
AS指利用交互式语音技术受理短消息服务请求的系统。
SS(秘书台)和AS(自动台)是典型的ESME。
SMSC和ESME之间的传输网络可以是基于X.25, 或TCP/IP。
ESME到SMSC的消息
ESME到SMSC的消息,如:提交、查询、删除短消息等请求,ESME必须以TRANSMITTER类型连接到SMSC。
图4描述了一个典型的TRANSMITTER类型的请求应答的示例。TRANSMITTER类型的ESME是以BIND_TRANCESMITTER连接到SMSC的ESME,此类型的ESME向SMSC发起提交短消息,查询短消息状态,删除短消息等请求,SMSC返回请求的应答。
ESME和SMSC之间的请求应答消息可以是阻塞方式也可以是异步方式的。所以ESME可能在SMSC没有应答的情况下,发起多个请求到SMSC。
SMSC应该按照收到的请求顺序,给EMSE回响应。但是ESME必须能够处理没有按顺序的响应。
SMSC到ESME的消息
SMSC到ESME的消息,如:SMSC转发短消息到ESME,ESME必须以RECEIVER类型连接到SMSC。
图5描述了一个典型的RECEIVER类型的ESME和SMSC之间的消息序列的示例。RECEIVER类型的ESME是以BIND_RECEIVER连接到SMSC的ESME,SMSC向此类ESME转发短消息,ESME向SMSC回应答。
ESME和SMSC之间的请求应答消息可以是阻塞方式也可以是异步方式的。所以SMSC可能在ESME没有回应答的情况下,发送发起多个deliver_sm请求到ESME。
ESME应该按照收到的请求顺序,给SMSC返回响应。但是SMSC必须能够处理没有按顺序回的响应。
消息流
本规范中规定的所有协议,不管是从ESME到SMSC,还是从SMSC到ESME的消息,接收到请求的一方,都必须给请求方回一个应答消息(acknowledge)。
消息语法
在以下语法说明中,遵从以下规则:
A.未使用的字段,依据类型必须设置为0或NULL。
B.消息由消息头和消息体组成。
C.状态(Command_status)的定义如表3所示。
状态定义
错误代码 | 描述 |
E_SUCCESS(0X00000000) | 成功 |
E_OTHERERR(0X00000001) | 其他错误 |
0X00000002 – 0X0000000F | 保留给SMSC厂商定义错误 |
E_MSGLENERR(0X00000010) | 消息长度错误 |
E_CMDLENERR(0X00000011) | 命令长度错误 |
E_INVLDCMDID(0X00000012) | 消息ID无效 |
E_NORIGHT(0X00000013) | 没有执行此命令的权限 |
0X00000014 – 0X0000001F | 保留 |
E_INVLDSYSTEMID(0X00000020) | 无效的SYSTEMID |
E_INVLDPASSWORD(0X00000021) | 无效的密码 |
E_INVLDSYSTEMTYPE(0X00000022) | 无效的SYSTEMTYPE |
0X00000023 – 0X0000003F | 保留 |
E_ADDRERR(0X00000040) | 地址错误 |
E_MOEXCEED(0X00000041) | 超过最大提交数 |
E_MTEXCEED(0X00000042) | 超过最大下发数 |
E_INVLDUSER(0X00000043) | 无效的用户 |
E_INVLDDATAFMT(0X00000044) | 无效的数据格式 |
E_CREATEMSGFAILURE(0X00000045) | 创建消息失败 |
E_INVLDMSGID(0X00000046) | 无效的短消息ID |
E_DATABASEFAILURE(0X00000047) | 数据库失败 |
E_CANCELMSGFAILURE(0X00000048) | 取消消息失败 |
E_MSGSTATEERR(0X00000049) | 短消息状态错误 |
E_REPLACEMSGFAILURE(0X0000004A) | 替换消息失败 |
E_INVLDRPLADDR(0X0000004B) | 替换消息源地址错误 |
0X0000004C – 0X0000005F | 保留 |
E_INVLDORGTON(0X00000060) | 无效的源地址TON |
E_INVLDORGNPI(0X00000061) | 无效的源地址NPI |
E_ORGADDRERR(0X00000062) | 源地址错误 |
E_INVLDDESTTON(0X00000063) | 无效的目的地址TON |
E_INVLDDESTNPI(0X00000064) | 无效的目的地址NPI |
E_DESTADDRERR(0X00000065) | 目的地址错误 |
E_INVLDSCHEDULE(0X00000066) | 无效的定时时间 |
E_INVLDEXPIRE(0X00000067) | 无效的超时时间 |
E_INVLDESM(0X00000068) | 无效的ESM_CALSS |
E_INVLDUDLEN(0X00000069) | 无效的UDLEN |
E_INVLDPRI(0X0000006A) | 无效的PRI |
E_INVLDRDF(0X0000006B) | 无效的Registered_delivery_flag |
E_INVLDRPF(0X0000006C) | 无效的Replace_if_present_flag |
0X0000006D – 0X0000007F | 保留 |
用户管理部分(可选) | |
E_USERALREADYEXIST(0X00000080) | 指定用户已经存在 |
E_CREATEUSERERR(0X00000081) | 创建用户失败 |
E_USERIDERR(0X00000082) | 用户ID错误 |
E_USERNOTEXIST(0X00000083) | 指定用户不存在 |
0X00000084 – 0X0000008F | 保留 |
0X00000090 – 0X00000FFF | 保留给SMSC厂商定义错误 |
其他 | 保留 |
(1)integer:一定字节数所组成的整数,高位在前,低位在后。例 如:1字节(BYTE),2字节(WORD ) , 4字节 (DWORD) ,6字节等等。
(2)C_String:以NULL结束的ASCII字符串。
(3)C_DecString:以NULL结束的ASCII字符串,它由一系列的10进制字符 组成(‘0’---‘9’)。
(4)C_OctetString:由任意8位字节组成数据流串。
(5)C_HexString:以NULL结束的ASCII字符串,它由一系列的16进制字符组 成(‘0’---‘9’,‘A’(‘a’)---‘F’(‘f’))。
(6)C_UnicodeString:以NULL结束的Unicode编码的字符串。
(7)C_StringTime:表示时间的字符串,它为以下格式。“YYMMDDhhmmsstnnp" , 长度定为17个字节或1个字节,最后一个字节值必须为NULL,1个字节表示 使用缺省的时间定义(由短消息中心实现时具体设置),17个字节的具体格式 如下:
YY' | 年份的最后2位 (00-99) |
MM | 月份(01-12) |
DD | 日 (01-31) |
Hh | 小时 (00-23) |
Mm | 分 (00-59) |
Ss | 秒 (00-59) |
T | 十分之一秒 (0-9) |
Nn | 与UTC (Universal Time Constant) 时间超前或落后 的差距(00-48). |
‘+’(p) | 时间超前于UTC time. |
‘-’(p) | 时间落后于 UTC time. |
消息头语法
表4:短消息头语法
字段 | 长度(字节) | 类型 | 描述 |
Command_Length | 4 | integer | 消息包的长度,包括此字段 |
Command_ID | 4 | integer | 这个字段表明此条短消息的类型,例如ESME_SUB_SM表示此消息为ESME向SMSC提交短消息。具体数值定义见附录A。 |
Command_status | 4 | integer | 此字段表示一个命令的成功与失败,如失败,指示引起失败的错误类型等信息,它在请求中必须设为0。 |
Sequence_No | 4 | integer | 此字段表示消息的序列号,它由ESME产生,它是消息和它的应答之间的对应标志,它的数值在0到0XFFFFFFFF间必须保证严格单调的递增,当达到0XFFFFFFFF时,从0开始下一循环。 |
Optional Message Body | 可变 | 混合 | 此字段表示短消息的消息体部分,具体定义见6.5.2 |
以下几条命令实现后,就可以实现短消息的收发。
BIND_RECEIVER命令
此命令在扩展短消息实体和短消息中心之间产生虚连接,该连接支持所有的协议命令。
BIND_RECEIVER语法
消息头中的Command_ID是“bind_receiver"
表5:BIND_RECEIVER语法
字段 | 长度(字节) | 类型 | 描述 |
system_id | 最大 16 | C_String | 接口ID |
password | 最大 9 | C_String | 密码 |
system_type | 最大 13 | C_String | 接口类型 |
Interface_version | 1 | integer | 接口版本号 |
Ton | 1 | integer | 保留,应设置为0 |
npi | 1 | integer | 保留,应设置为0 |
address_range | 最大 41 | C_DecString | 保留,应设置为NULL |
消息头中的Command_ID 是“bind_receiver_resp"。
表6:BIND_RECEIVER_RESP语法
字段 | 大小(字节) | 类型 | 描述 |
System_id | 最大 16 | C_String | 接口ID |
E_SUCCESS
E_OTHERERR
E_CMDLENERR
E_NORIGHT
E_INVLDSYSTEMID
E_INVLDPASSWORD
E_INVLDSYSTEMTYPE
E_INVLDIFVER
UNBIND命令
此命令用于断开ESME和SMSC之间的连接。
UNBIND语法
此消息只有消息头,没有消息体,消息头中的Command_ID是“unbind"。
UNBIND_RESP语法
此消息只有消息头,没有消息体,消息头中的Command_ID是“unbind_resp"。
状态取值范围:
E_SUCCESS
E_OTHERERR
E_CMDLENERR
E_NORIGHT
6.5.2.4 SUBMIT_SM命令
此命令用于ESME提交短消息到SMSC,以便SMSC把此短消息发给特定的移动台。
SUBMIT_SM语法
消息头中的Command_ID是"submit_sm"
表7:SUBMIT_SM语法
字段 | 长度(字节) | 类型 | 描述 |
service_type | 最大6 | C_OctetString | 保留,必须设为0 |
source_address_ton | 1 | integer | 源地址编码类型 |
source_address_npi | 1 | integer | 源地址编码方案 |
source_address | 最大21 | C_DecString | 源地址 |
dest_address_ton | 1 | integer | 目的地址编码类型 |
dest_address_npi | 1 | integer | 目的地址编码方案 |
destination_address | 最大21 | C_DecString | 目的地址 |
esm_class | 1 | integer | 短消息类型 |
protocol_ID | 1 | integer | GSM协议类型 |
priority_flag | 1 | integer | 优先级 |
schedule_delivery_time | 最大17 | C_StringTime | 计划下发短消息的时间 |
validity_period | 最大17 | C_StringTime | 短消息的最后有效期限 |
registered_delivery_flag | 1 | integer | 注册短消息标志 |
replace_if_present_flag | 1 | integer | 替换短消息标志。 |
data_coding | 1 | integer | 数据编码方案 |
sm_default_msg_id | 1 | integer | 预定义短消息ID |
sm_length | 1 | integer | 短消息的长度 |
short_message_text | 最大161 | 可变 | 短消息数据内容 |
消息头中的Command_ID是"submit_sm_resp"
表8:SUBMIT_SM_RESP语法
字段 | 长度(字节) | 类型 | 描述 |
Message_id | 最大9 | C_HexString | 短消息ID |
E_SUCCESS
E_OTHERERR
E_CMDLENERR
E_NORIGHT
E_ADDRERR
E_MOEXCEED
E_MTEXCEED
E_INVLDUSER
E_INVLDDATAFMT
E_CREATEMSGFAILURE
E_INVLDORGTON
E_INVLDORGNPI
E_ORGADDRERR
E_INVLDDESTTON
E_INVLDDESTNPI
E_DESTADDRERR
E_INVLDSCHEDULE
E_INVLDEXPIRE
E_INVLDESM
E_INVLDUDLEN
E_INVLDPRI
E_INVLDRDF
E_INVLDRPF
DELIVER_SM命令
此命令由SMSC产生,SMSC通过此命令发送短消息到目的ESME,它也可用于发送转发状态报告(DELIVERY RECEIPT)消息。
DELIVER_SM语法
它的语法和SUBMIT_SM的语法消息体是相同的,只是在消息头中的Command_ID是“deliver_sm"。
DELIVER_SM_RESP语法
它的语法和SUBMIT_SM_RESP的语法消息体是一样的,只是在消息头中的Command_ID是“deliver_sm_resp"。
附:消息体参数说明
address:
地址号码
address_range
地址范围
data_coding:
数据编码方案, ( 详见GSM 03.40 [1] 9.2.3.10)
dest_address_npi:
目的地址编码方案,同npi
dest_address_ton:
目的地址编码类型,同ton
destination_address:
目的地址,同address
esm_class:
短消息类型
Bit: | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 |
Flag: | Reserved | UDHI | Reserved | Delivery RCPT | Reserved |
Delivery RCPT为1表示是此条短消息是状态报告,0表示为正常的下发短消息。此位只对DELIVER_SM有效。
其他为保留。
如果有头结构,short_message_text为以下格式:
{
BYTE UDHL; //信息元素的结构集合所用的字节数
Information?Element-struct Information?Element;
//若干信息元素的结构集合, 其占用的字节数目由UDHL指示
...
SM; 短消息内容
}
其中Information?Element-struct的结构如下:
{
BYTE Information?Element?Identifier // 信息元素的标志
BYTE Length of Information?Element //信息元素数据所用的字节数
Information?Element Data
//信息元素数据,其占用的字节数目由Length of Information?Element指示
}
定义详见GSM 03.40 (7.2.0) 9.2.3.24
final_date:
短消息的生命期终止的实际时间,如果此短消息已从SMSC的等待发送队列中删除,即为删除时间,否则为SMSC当前的时间
GSM_code:
GSM错误码,见下表
错误码 | 值 | 描述 |
ERROR_NONE | 0 | 无错误 |
P_UNKNOWN | 1 | 不知道的用户 |
P_PROVISION | 2 | 不提供此功能 |
T_BARRED | 3 | 呼叫废弃 |
T_SUPPORT | 4 | 此机制不支持 |
T_ABSENT | 5 | 用户不能通讯 |
T_MSSUPPORT | 6 | 移动台不支持短消息 |
T_MSERROR | 7 | 移动台接收短消息出现错误 |
P_ILLEGAL_SUB | 8 | 不合法的用户 |
P_ILLEGAL_EQUIP | 9 | 不合法的设备 |
T_SYSTEM | 10 | 系统失败 |
T_MEMCAP | 11 | 内存不足 |
用来描述本协议的版本号
在ESME连接SMSC时,如果ESME提出的版本号高于SMSC的版本号,则SMSC给出否定响应,响应中的status表示SMSC的版本号;ESME提出的版本号低于或等于SMSC的版本号,则SMSC给出肯定响应,在连接成功后的会话过程中,双方将以ESME提出的版本号作为通信的依据。interface_version的值从1开始,0保留。
现约定,对于interface_version>=1,必须支持除REPLACE_SM_EX命令和用户管理命令以外的所有协议命令, 对于interface_version>=2, 必须支持所有本文中提到的协议命令。
message_id:
短消息ID,它由SMSC设置。用于查询以及替换短消息等操作时使用。
message_status:
短消息当前的状态:
0:转发状态
1:发送成功(不在尝试转发)
2:发送失败(不在尝试转发)
3:因下发失败而等待(继续尝试转发)
4:因定时消息而等待(继续尝试转发)
5:短消息被删除(不在尝试转发)
6:短消息超时删除(不在尝试转发)
7:无效状态(不在尝试转发)
8:EN_ROUTE,为兼容SMPP协议保留
9:DELIVERED,为兼容SMPP协议保留
10:EXPIRED,为兼容SMPP协议保留
11:DELETED,为兼容SMPP协议保留
12:UNDELIVERABLE,为兼容SMPP协议保留
13:ACCEPTED,为兼容SMPP协议保留
14:INVALID,为兼容SMPP协议保留
其他:保留
MS_type:
手机类型
0:中文手机
1:英文手机
>1:保留
npi:
地址编码方案,(定义详见GSM03.40[1] 9.1.2.5)
0:未知
1:ISDN电话编码方案
3:数据编码方案(X.121)
4:电报编码方案
8:国家编码方案
9:专用编码方案
10:ERMES 编码方案(ETSI DE/PS 3 01?3)
15:扩充保留
从0到15的其他值保留
OCOS:
最大提交短消息,某移动台提交到SMSC的等待下发的短消息的最大数目
password:
用来登录的密码
priority_flag:
优先级
1:高优先级
0:普通优先级
>1:保留
protocol_ID:
GSM协议类型(定义详见GSM03.40[1] 9.2.3.9)
registered_delivery_flag:
注册短消息标志,它表示当此短消息到达最后的目的地后,是否需要 转发状态报告(DELIVERY RECEIPT)。
0:不需要
1:需要
>1:保留
replace_if_present_flag:
替换标志,当SUBMIT命令中指示的源地址和目的地址与等待下发的短消息的源地址和目的地址都相同时,是否替换这些等待下发的短消息。在DELIVERY命令中该参数无效,需置为0。
0:不替换
1:替换
>1:保留
schedule_delivery_time:
对于SUBMIT命令,该参数指计划下发短消息的时间,对于DELIVERY命令,该参数指SMSC收到要下发到ESME的短消息的时间。
service_type:
保留,必须设为NULL,原该参数指明短消息服务的类别
short_message_text:
短消息数据内容,当编码类型为7位码,类型为C_String,最大长度为160个字符。8位码时,类型为C_String,最大长度为140个字节。当为Unicode时,类型为C_UnicodeString,最大长度为70个字符。
SM_allowed:
是否提供短消息业务
0:不提供
1:提供
其余值保留
sm_default_msg_id:
预定义短消息ID,不是预定义短消息时应设为0。预定义短消息ID值从0x01到 0x64,其值的具体含义由特定的ESME和SMSC约定。其余值保留。
sm_length:
短消息的数据长度,以字节计算。
source_address:
源地址编号,同address。
source_address_npi:
源地址编码方案,同npi。
source_address_ton:
源地址编码类型,同 ton。
sub_address:
用户通信地址。
sub_ID:
用户ID,同address。
sub_name:
用户名。
reg_datetime:
用户注册登记时间 。
system_id:
接口ID,用来描述虚拟连接的用户名,即ESME登录SMSC使用的帐号。
system_type:
用来描述用户的类型。
TCOS:
最大下发数,指等待下发到某移动台的最大短消息数目。
ton:
地址编码类型,(定义详见GSM03.40[1] 9.1.2.5)
0 未知号码
1 国际号码,例如8613901234567
2 国内号码,例如13901234567
3 网络专用号码
4 用户号码
5 字母号码(按照 GSM?TS03.38 7-bit 缺省字母表编码)
6 缩写号码
7 保留
validity_peroid:
短消息的最后生存期限。
附录A:命令标志数值定义
命令码宏定义 | 数值 | 描述 |
ESME_BNDRCV | 0X00000001 | ESME要求连接到SMSC |
ESME_BNDRCV | 0X80000001 | 连接SMSC的响应 |
ESME_BNDTRN | 0X00000002 | ESME要求连接到SMSC |
ESME_BNDTRN_RESP | 0X80000002 | 连接SMSC的响应 |
ESME_UBD | 0X00000006 | ESME要求断开连接到SMSC |
ESME_UBD_RESP | 0X80000006 | 断开连接的响应 |
ESME_SUB_SM | 0X00000004 | ESME提交短消息到SMSC,以便SMSC下发此短消息到特定的用户。 |
ESME_SUB_SM_RESP | 0X80000004 | 提交短消息的响应 |
ESME_DELIVER_SM | 0X00000005 | SMSC下发短消息到特定的ESME |
ESME_DELIVER_SM_RESP | 0X80000005 | 下发短消息的响应 |
ESME_QUERY_SM | 0X00000003 | ESME查询以前所提交的短消息的状态 |
ESME_QUERY_SM_RESP | 0X80000003 | 查询短消息的响应 |
ESME_CANCEL_SM | 0X00000008 | ESME要求取消以前所提交的某条短消息 |
ESME_CANCEL_SM_RESP | 0X80000008 | ESME要求取消以前所提交的某条短消息的响应 |
ESME_REPLACE_SM | 0X00000007 | ESME要求替换以前所提交的某条短消息 |
ESME_REPLACE_SM_RESP | 0X80000007 | ESME要求替换以前所提交的某条短消息的响应 |
ESME_QRYLINK | 0X00000015 | 询问扩展短消息实体与短消息中心的连接情况 |
ESME_QRYLINK_RESP | 0X80000015 | 询问扩展短消息实体与短消息中心的连接情况的响应 |
ESME_NACK | 0X80000000 | 接收消息头错误的响应 |
ESME_REPLACE_SM_EX | 0X00000090 | ESME要求替换以前所提交的某条短消息的扩展命令,它增加了数据编码格式字段 |
ESME_REPLACE_SM_EX_RESP | 0X80000090 | 扩展替换短消息的的响应 |
ESME_ADD_SUB | 0X000000A0 | 增加用户 |
ESME_ADD_SUB_RESP | 0X800000A0 | 增加用户的响应 |
ESME_DEL_SUB | 0X000000A1 | 删除用户 |
ESME_DEL_SUB_RESP | 0X800000A1 | 删除用户的响应 |
ESME_MOD_SUB | 0X000000A2 | 修改用户 |
ESME_MOD_SUB_RESP | 0X800000A2 | 修改用户的响应 |
ESME_QRY_SUB | 0X000000A3 | 查询用户的信息 |
ESME_QRY_SUB_RESP | 0X800000A3 | 查询用户的信息的响应 |
相关文章推荐
- SMPP是一种通用的短信接口协议
- SMPP是一种通用的短信接口协议
- SMPP是一种通用的短信接口协议
- 串口USART UART 接收结束标志是怎么回事 这是一种自己定义的协议 没有通用协议
- 短信猫二次开发接口支持任何一种开发语言性能稳定
- UTRAN 接口通用协议模型
- 手机短信服务接口合作协议原理与分析
- 短信接口验证码通用功能及其接入流程
- objective-C中没有"接口"与"泛型"这样的说法,但有正式协议protocal 和 一种特殊的指针id类型
- 基于SMPP协议的GSM短消息增值业务接口设计与实现
- 详解各短信接口协议的优劣
- 通用短信平台接口
- 上海移动通信企业短信通平台接口协议
- 华为短信开发包开发联通sgip1.2接口协议报错
- 一种通用的接口设计方案
- 接口表:一种通用机制
- 短信网关协议(cmpp、sgip、smgp、smpp)长短信开发要点
- Http通用短信接口开发经验及具体开发实现
- 一种通用的树形二进制协议描述方法与处理算法
- CMPP和SMPP协议比较[转-理解短信中心协议原理]