smpp协议描述

SMPP协议描述1 接口协议简介随着短消息业务在移动通信网上的广泛开展，运营商可以利用短消息平台向用户提供丰富的增值业务。短消息中心（SMSC）可以与人工台、自动台、WEB Server、E-mail Server、WAP网关等各种非PLMN网的扩展短消息实体（ESME）配合工作，从而为移动用户提供丰富多采的功能。在SMSC与ESME间采用标准的协议接口，有助于实现其他厂家的ESME的接入，为运营者集成第三方产品、发展短消息新业务提供方便。SMPP协议规范的内容主要针对扩展短消息实体与短消息中心的通信协议。协议主要描述短消息中心和扩展短消息实体之间的协议数据传输格式。此协议运行在底层通讯协议（例如TCP/IP，X.25）上。GSM03.39 v5.0.0中推荐的SMPP协议的内容中，能支持GSM的 PHASE2+的业务，另外还包括了可选的短消息用户管理的功能。规范面向现有的短消息业务，以后对于新业务（如WAP业务）的支持，可做相应修改。GSM 03.39 v5.0.0协议中错误状态和短消息状态没有定义具体的值，以Aldiscon的SMPP Application定义为准。参考资料GSM 03.39(Version 5.0.0)：European digital cellular telecommunications system(Phase 2);Interface protocols for the connection of Short Message Service Centres(SMSCs)to Short Message Entities(SMEs);GSM 03.40(Version 4.8.1)：European digital cellular telecommunications system(Phase 2);Technical realization of the Short Message Service Point to PointGSM 03.38(Version 5.2.0)：Digital cellular telecommunications system(Phase 2+)；Alphabets and language_specific informationGSM 03.47(Version 5.0.0)：Digital cellular telecommunications system;Example protocol stacks for interconnecting Service Center(SC) and Mobile_services Switching Center(s)(MSC)1.1 缩略语SME短消息实体SMPP短消息点对点协议SMSC短消息服务中心ESME扩展短消息实体SMEI短消息扩展接口（协议）2 功能概述通过SMEI，ESME（例如寻呼台，语音邮箱系统）能连接（BIND）或断连（UNBIND）短消息中心，提交（SUBMIT）短消息。 此协议包含以下两部分：*（协议）ESME到SMSC的消息 *（协议）SMSC到扩展ESME的消息其中用户管理部分只适用于SMSC有用户数据库支持的情况 ESME可以与SMSC直接或者间接相连，直接相连时通过本规范确定的协议与SMSC通信，间接相连时，通过ESME Agent与SMSC相连，ESME Agent为ESME与SMSC之间的连接代理。ESME Agent与SMSC间走内部消息，ESME和ESME Agent之间则走标准的SMPP协议。采用ESME Agent间接相连方式，对接入SMSC的ESME提供了分类管理的便利（不同ESME连接到不同的Agent），有利于负荷分担和系统的稳定。见图1。图1：ESME与SMSC的直接和间接连接方式图 SMSC和ESME连接的短消息系统网络ESME到SMSC的消息ESME能提交短消息到SMSC，也可以查询以前所提交的短消息的状态等信息。SMSC到ESME的消息SMSC可以下发短消息到ESME。3 消息协议l 所有的消息，不管是从ESME到SMSC，还是从SMSC到ESME的消息，消息都是交互的，都必须产生一个响应（acknowledge）。l 从ESME到SMSC所提交的消息，可能有两种响应：*SMSC收到消息的响应（ACK）*如果这条短消息设置了需要状态报告，那么当这条短消息到达目标地之后，SMSC会产生一个状态报告的消息给ESME。4 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必须能够处理没有按顺序的响应。图4：TRANSMITTER类型的EMSE和SMSC的消息序列示例表1：ESME到SMSC的消息命令描述bind_receiverESME要求以接收者身份连接到SMSCbind_transmitterESME要求以发送者身份连接到SMSCUnbindESME要求断开连接到SMSCsubmit_smESME提交短消息到SMSC，以便SMSC下发此短消息到指定的移动台。deliver_sm_respdeliver_sm的响应。query_smESME查询以前所提交的短消息的状态cancel_smESME要求取消以前所提交的某条短消息replace_smESME要求替换以前所提交的某条短消息enquire_link询问与SMSC的连接情况generic_nak表示消息头有错误的响应5 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必须能够处理没有按顺序回的响应。图5：RECEIVER类型的EMSE和SMSC的消息序列示例表2：SMSC到ESME的消息命令描述bind_receiver_respbind_receiver的响应，status表示连接成功与否bind_transmitter_respbind_transmitter的响应，status表示连接成功与否unbind_respunbind的响应，status表示断开连接成功与否submit_sm_respsubmit_sm的响应，status表明提交短消息是否成功deliver_smSMSC下发短消息到ESMEquery_sm_respquery_sm的响应，status表明此次询问是否成功，其它内容返回查询到的短消息信息cancel_sm_respcancel_sm的响应。Status表明取消短消息是否成功replace_sm_respreplace_sm的响应，status表明此次替换是否成功enquire_link_respEnquire_link的响应enquire_link询问与ESME的连接情况generic_nak表示消息头有错误的响应6 消息语法在以下语法说明中，遵从以下规则：A.未使用的字段，依据类型必须设置为0或NULL。B.消息由消息头和消息体组成C.状态（status)如在命令语法中未加说明 0：表示成功非0：表示失败1：保留。 schedule_delivery_time：该字段表示计划下发该短消息的时间。 时间格式请参考前面定义的C_StringTime 的格式. 如不需要，可设置为NULL。 validity_period：该字段表示短消息的最后生存期限。时间格式请 参考前面定义的C_StringTime的格式.如不需要， 可设置为NULL。 registered_delivery_flag：该字段是注册短消息标志，它表示当 短消息到达最后的目的地后，是否需 要状态报告。 取值说明： 0：不需要 1：需要 1：保留。 replace_if_present_flag：该字段表示替换短消息标志。即当提交 的短消息的源地址和目的地址相同时， 是否替换存在的短消息。 取值说明： 0：不替换 1：替换 1：保留。 data_coding：该字段表示数据编码方案。 取值说明：0缺省编码方案(7位)4英文编码方案(不被手机支持)8UCS2编码方案其他保留sm_default_msg_id：该字段表示预定义短消息ID。该ID是短消息中 心管理者建立的预定义短消息表的索引。不想 发送预定义短消息时，该字段应设为NULL。预 定义短消息ID值从0x01到0x64。详细说明请参 考SMPP Applications Guide 9 - Default Short Message。sm_length：要发送的短消息数据内容的字节长度。short_message：该字段表示短消息数据内容。最大可到160字符。 只有sm_length中定义的字节长度可用。6.2.4.2 SUBMIT_SM_RESP语法字段长度（字节）类型Message_id最大9C_HexString具体参数说明： Message_id：该字段表示短消息ID，由短消息中心产生，用于 以后查询及替换短消息用，或是表明状态报告所 对应的源消息。如果没有，该字段必须设为 NULL。6.2.5 DELIVER_SM命令此命令由SMSC产生，SMSC通过此命令发送短消息到目的ESME，它也可用于发送DELIVERY RECEIPT消息。6.2.5.1 DELIVER_SM语法它的语法和SUBMIT_SM的语法消息体是相同的，只是在消息头中的Command_id是“deliver_sm。6.2.5.2 DELIVER_SM_RESP语法它的语法和SUBMIT_SM_RESP的语法消息体是一样的，只是在消息头中的Command_id是“deliver_sm_resp。6.2.6 ENQUIRE_LINK命令此命令用于ESME确认和SMSC之间的连接。ESME发送一条ENQUIRE_LINK命令，SMSC响应一条ENQUIRE_LINK_ACK命令，表示ESME和SMSC之间的连接正常。6.2.6.1 ENQUIRE_LINK语法此命令只有消息头，没有消息体。6.2.6.2 ENQUIRE_LINK_RESP语法此命令只有消息头，没有消息体。6.3 消息体参数说明address：地址号码address_range：地址范围data_coding：数据编码方案, ( 详见GSM 03.40 1 9.2.3.10)例如：0：缺省编码方案(7位)4：英文编码方案(不被手机支持)8：UCS2编码方案(比如中文编码)dest_addr_npi：目的地址编码方案，同npidest_addr_ton：目的地址编码类型，同tondestination_addr：目的地址，同addressesm_class：短消息类型此字段的说明如下：Bit76543210FlagReservedUDHIReservedReservedReservedDeliveryReceiptReservedReserved其中 UDHI 表示短消息内容是否有头结构。置位表示有。Delivery Receipt，在DELIVER_SM协议中使用，表示是否是此条消息是否是状态报告。对于普通的SUBMIT_SM命令，此字段设为0。final_date：短消息的生命期终止的实际时间，如果此短消息已从SMSC的等待发送队列中删除，即为删除时间，否则为SMSC当前的时间interface_version：用来描述SMEI协议的版本号Message_id：短消息ID，它由SMSC设置。用于查询以及替换短消息等操作时使用。Command Status：短消息当前的状态.0表示成功，非0表示失败npi：地址编码方案，（定义详见GSM03.401 9.1.2.5)例如： 1 表示ISDN电话编码计划password：用来登录的密码priority_flag：优先级1：高优先级0：普通优先级1：保留protocol_ID：GSM协议类型（定义详见GSM03.401 9.2.3.9)registered_delivery_flag：注册短消息标志，它表示当此短消息到达最后的目的地后，是否需要送达状态报告（DELIVERY RECEIPT）。0：不需要1：需要1：保留replace_if_present_flag：替换标志，当存在的短消息的源地址和目的地址都相同时，是否替换存在的短消息。0：不替换1：替换1：保留schedule_delivery_time：计划下发短消息的时间service_type:：保留，必须设为NULLshort_message：短消息数据内容。在7bit时，是160字符;在8bit时，是140字符。sm_default_msg_id：预定义短消息ID，不是预定义短消息时应设为0，预定义短消息ID值从0x01到0x64。sm_length：短消息的数据长度，以字节计算source_addr：源地址编号，同addresssource_addr_npi：源地址编码方案，同npisource_addr_ton：源地址编码类型，同tonsystem_id：接口ID，用来描述虚拟连接的用户名system_type：用来描述用户的类型ton：地址编码类型，（定义详见GSM03.401 9.1.2.5)0未知号