SMPP協(xié)議V3.4中文簡明版

1、SMPP協(xié)議描述1 接口協(xié)議簡介隨著短消息業(yè)務(wù)在移動(dòng)通信網(wǎng)上的廣泛開展，運(yùn)營商可以利用短消息平臺(tái)向用戶提供豐富的增值業(yè)務(wù)。短消息中心（SMSC）可以與人工臺(tái)、自動(dòng)臺(tái)、WEB Server、E-mail Server、WAP網(wǎng)關(guān)等各種非PLMN網(wǎng)的擴(kuò)展短消息實(shí)體（ESME）配合工作，從而為移動(dòng)用戶提供豐富多采的功能。在SMSC與ESME間采用標(biāo)準(zhǔn)的協(xié)議接口，有助于實(shí)現(xiàn)其他廠家的ESME的接入，為運(yùn)營者集成第三方產(chǎn)品、發(fā)展短消息新業(yè)務(wù)提供方便。SMPP協(xié)議規(guī)范是內(nèi)容主要針對(duì)擴(kuò)展短消息實(shí)體與短消息中心的通信協(xié)議。協(xié)議主要描述短消息中心和擴(kuò)展短消息實(shí)體之間的協(xié)議數(shù)據(jù)傳輸格式。此協(xié)議運(yùn)行在底層通訊協(xié)議（

2、例如TCP/IP，X.25）上。GSM03.39 v5.0.0中推薦的SMPP協(xié)議的內(nèi)容中，能支持GSM的 PHASE2+的業(yè)務(wù)，另外還包括了可選的短消息用戶管理的功能。規(guī)范面向現(xiàn)有的短消息業(yè)務(wù)，以后對(duì)于新業(yè)務(wù)（如WAP業(yè)務(wù)）的支持，可做相應(yīng)修改。GSM 03.39 v5.0.0協(xié)議中錯(cuò)誤狀態(tài)和短消息狀態(tài)沒有定義具體的值，以Aldiscon的SMPP Application定義為準(zhǔn)。參考資料GSM 03.39(Version 5.0.0)：European digital cellular telecommunications system(Phase 2);Interface protoco

3、ls 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 telecommunicat

4、ions 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短消息實(shí)體SMPP短消息點(diǎn)對(duì)點(diǎn)協(xié)議SMSC短消息服務(wù)中心2 / 30ESME擴(kuò)展短消息實(shí)體SMEI短

5、消息擴(kuò)展接口（協(xié)議）2 功能概述通過SMEI，ESME（例如尋呼臺(tái)，語音郵箱系統(tǒng)）能連接（BIND）或斷連（UNBIND）短消息中心，提交（SUBMIT）短消息。 此協(xié)議包含以下兩部分：*（協(xié)議）ESME到SMSC的消息 *（協(xié)議）SMSC到擴(kuò)展ESME的消息其中用戶管理部分只適用于SMSC有用戶數(shù)據(jù)庫支持的情況 ESME可以與SMSC直接或者間接相連，直接相連時(shí)通過本規(guī)范確定的協(xié)議與SMSC通信，間接相連時(shí)，通過ESME Agent與SMSC相連，ESME Agent為ESME與SMSC之間的連接代理。ESME Agent與SMSC間走內(nèi)部消息，ESME和ESME Agent之間則走標(biāo)準(zhǔn)的S

6、MPP協(xié)議。采用ESME Agent間接相連方式，對(duì)接入SMSC的ESME提供了分類管理的便利（不同ESME連接到不同的Agent），有利于負(fù)荷分擔(dān)和系統(tǒng)的穩(wěn)定。見圖1。圖1：ESME與SMSC的直接和間接連接方式圖 SMSC和ESME連接的短消息系統(tǒng)網(wǎng)絡(luò)ESME到SMSC的消息ESME能提交短消息到SMSC，也可以查詢以前所提交的短消息的狀態(tài)等信息。SMSC到ESME的消息SMSC可以下發(fā)短消息到ESME。3 消息協(xié)議l 所有的消息，不管是從ESME到SMSC，還是從SMSC到ESME的消息，消息都是交互的，都必須產(chǎn)生一個(gè)響應(yīng)（acknowledge）。l 從ESME到SMSC所提交的消息，

7、可能有兩種響應(yīng)：*SMSC收到消息的響應(yīng)（ACK）*如果這條短消息設(shè)置了需要狀態(tài)報(bào)告，那么當(dāng)這條短消息到達(dá)目標(biāo)地之后，SMSC會(huì)產(chǎn)生一個(gè)狀態(tài)報(bào)告的消息給ESME。4 ESME到SMSC的消息ESME到SMSC的消息，如：提交、查詢、刪除短消息等請求，ESME必須以TRANSMITTER類型連接到SMSC。圖4描述了一個(gè)典型的TRANSMITTER類型的請求應(yīng)答的示例。TRANSMITTER類型的ESME是以BIND_TRANCESMITTER連接到SMSC的ESME，此類型的ESME向SMSC發(fā)起提交短消息，查詢短消息狀態(tài)，刪除短消息等請求，SMSC返回請求的應(yīng)答。ESME和SMSC之間的請求

8、應(yīng)答消息可以是同步方式也可以是異步方式的。所以ESME可能在SMSC沒有應(yīng)答的情況下，發(fā)起多個(gè)請求到SMSC。SMSC應(yīng)該按照收到的請求順序，給EMSE回響應(yīng)。但是ESME必須能夠處理沒有按順序的響應(yīng)。圖4：TRANSMITTER類型的EMSE和SMSC的消息序列示例表1：ESME到SMSC的消息命令描述bind_receiverESME要求以接收者身份連接到SMSCbind_transmitterESME要求以發(fā)送者身份連接到SMSCUnbindESME要求斷開連接到SMSCsubmit_smESME提交短消息到SMSC，以便SMSC下發(fā)此短消息到指定的移動(dòng)臺(tái)。deliver_sm_resp

9、deliver_sm的響應(yīng)。query_smESME查詢以前所提交的短消息的狀態(tài)cancel_smESME要求取消以前所提交的某條短消息replace_smESME要求替換以前所提交的某條短消息enquire_link詢問與SMSC的連接情況generic_nak表示消息頭有錯(cuò)誤的響應(yīng)5 SMSC到ESME的消息SMSC到ESME的消息，如：SMSC轉(zhuǎn)發(fā)短消息到ESME，ESME必須以RECEIVER類型連接到SMSC。圖5描述了一個(gè)典型的RECEIVER類型的ESME和SMSC之間的消息序列的示例。RECEIVER類型的ESME是以BIND_RECEIVER連接到SMSC的ESME，SMSC

10、向此類ESME轉(zhuǎn)發(fā)短消息，ESME向SMSC回應(yīng)答。ESME和SMSC之間的請求應(yīng)答消息可以是阻塞方式也可以是異步方式的。所以SMSC可能在ESME沒有回應(yīng)答的情況下，發(fā)送發(fā)起多個(gè)deliver_sm請求到ESME。ESME應(yīng)該按照收到的請求順序，給SMSC返回響應(yīng)。但是SMSC必須能夠處理沒有按順序回的響應(yīng)。圖5：RECEIVER類型的EMSE和SMSC的消息序列示例表2：SMSC到ESME的消息命令描述bind_receiver_respbind_receiver的響應(yīng)，status表示連接成功與否bind_transmitter_respbind_transmitter的響應(yīng)，statu

11、s表示連接成功與否unbind_respunbind的響應(yīng)，status表示斷開連接成功與否submit_sm_respsubmit_sm的響應(yīng)，status表明提交短消息是否成功deliver_smSMSC下發(fā)短消息到ESMEquery_sm_respquery_sm的響應(yīng)，status表明此次詢問是否成功，其它內(nèi)容返回查詢到的短消息信息cancel_sm_respcancel_sm的響應(yīng)。Status表明取消短消息是否成功replace_sm_respreplace_sm的響應(yīng)，status表明此次替換是否成功enquire_link_respEnquire_link的響應(yīng)enquire_

12、link詢問與ESME的連接情況generic_nak表示消息頭有錯(cuò)誤的響應(yīng)6 消息語法在以下語法說明中，遵從以下規(guī)則：A.未使用的字段，依據(jù)類型必須設(shè)置為0或NULL。B.消息由消息頭和消息體組成C.狀態(tài)（status)如在命令語法中未加說明 0：表示成功非0：表示失敗1：保留。 schedule_delivery_time：該字段表示計(jì)劃下發(fā)該短消息的時(shí)間。 時(shí)間格式請參考前面定義的C_StringTime 的格式. 如不需要，可設(shè)置為NULL。 validity_period：該字段表示短消息的最后生存期限。時(shí)間格式請 參考前面定義的C_StringTime的格式.如不需要， 可設(shè)置為N

13、ULL。 registered_delivery_flag：該字段是注冊短消息標(biāo)志，它表示當(dāng) 短消息到達(dá)最后的目的地后，是否需 要狀態(tài)報(bào)告。 取值說明： 0：不需要 1：需要 1：保留。 replace_if_present_flag：該字段表示替換短消息標(biāo)志。即當(dāng)提交 的短消息的源地址和目的地址相同時(shí)， 是否替換存在的短消息。 取值說明： 0：不替換 1：替換 1：保留。 data_coding：該字段表示數(shù)據(jù)編碼方案。 取值說明：0缺省編碼方案(7位)4英文編碼方案(不被手機(jī)支持)8UCS2編碼方案其他保留sm_default_msg_id：該字段表示預(yù)定義短消息ID。該ID是短消息中 心

14、管理者建立的預(yù)定義短消息表的索引。不想 發(fā)送預(yù)定義短消息時(shí)，該字段應(yīng)設(shè)為NULL。預(yù) 定義短消息ID值從0x01到0x64。詳細(xì)說明請參 考SMPP Applications Guide 9 - Default Short Message。sm_length：要發(fā)送的短消息數(shù)據(jù)內(nèi)容的字節(jié)長度。short_message：該字段表示短消息數(shù)據(jù)內(nèi)容。最大可到160字符。 只有sm_length中定義的字節(jié)長度可用。6.2.4.2 SUBMIT_SM_RESP語法字段長度（字節(jié)）類型Message_id最大9C_HexString具體參數(shù)說明： Message_id：該字段表示短消息ID，由短消息中

15、心產(chǎn)生，用于 以后查詢及替換短消息用，或是表明狀態(tài)報(bào)告所 對(duì)應(yīng)的源消息。如果沒有，該字段必須設(shè)為 NULL。6.2.5 DELIVER_SM命令此命令由SMSC產(chǎn)生，SMSC通過此命令發(fā)送短消息到目的ESME，它也可用于發(fā)送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.

16、2.6 ENQUIRE_LINK命令此命令用于ESME確認(rèn)和SMSC之間的連接。ESME發(fā)送一條ENQUIRE_LINK命令，SMSC響應(yīng)一條ENQUIRE_LINK_ACK命令，表示ESME和SMSC之間的連接正常。6.2.6.1 ENQUIRE_LINK語法此命令只有消息頭，沒有消息體。6.2.6.2 ENQUIRE_LINK_RESP語法此命令只有消息頭，沒有消息體。6.3 消息體參數(shù)說明address：地址號(hào)碼address_range：地址范圍data_coding：數(shù)據(jù)編碼方案, ( 詳見GSM 03.40 1 9.2.3.10)例如：0：缺省編碼方案(7位)4：英文編碼方案(不被

17、手機(jī)支持)8：UCS2編碼方案(比如中文編碼)dest_addr_npi：目的地址編碼方案，同npidest_addr_ton：目的地址編碼類型，同tondestination_addr：目的地址，同addressesm_class：短消息類型此字段的說明如下：Bit76543210FlagReservedUDHIReservedReservedReservedDeliveryReceiptReservedReserved其中 UDHI 表示短消息內(nèi)容是否有頭結(jié)構(gòu)。置位表示有。Delivery Receipt，在DELIVER_SM協(xié)議中使用，表示是否是此條消息是否是狀態(tài)報(bào)告。對(duì)于普通的SUB

18、MIT_SM命令，此字段設(shè)為0。final_date：短消息的生命期終止的實(shí)際時(shí)間，如果此短消息已從SMSC的等待發(fā)送隊(duì)列中刪除，即為刪除時(shí)間，否則為SMSC當(dāng)前的時(shí)間interface_version：用來描述SMEI協(xié)議的版本號(hào)Message_id：短消息ID，它由SMSC設(shè)置。用于查詢以及替換短消息等操作時(shí)使用。Command Status：短消息當(dāng)前的狀態(tài).0表示成功，非0表示失敗npi：地址編碼方案，（定義詳見GSM03.401 9.1.2.5)例如： 1 表示ISDN電話編碼計(jì)劃password：用來登錄的密碼priority_flag：優(yōu)先級(jí)1：高優(yōu)先級(jí)0：普通優(yōu)先級(jí)1：保留pr

19、otocol_ID：GSM協(xié)議類型（定義詳見GSM03.401 9.2.3.9)registered_delivery_flag：注冊短消息標(biāo)志，它表示當(dāng)此短消息到達(dá)最后的目的地后，是否需要送達(dá)狀態(tài)報(bào)告（DELIVERY RECEIPT）。0：不需要1：需要1：保留replace_if_present_flag：替換標(biāo)志，當(dāng)存在的短消息的源地址和目的地址都相同時(shí)，是否替換存在的短消息。0：不替換1：替換1：保留schedule_delivery_time：計(jì)劃下發(fā)短消息的時(shí)間service_type:：保留，必須設(shè)為NULLshort_message：短消息數(shù)據(jù)內(nèi)容。在7bit時(shí)，是160字符

20、;在8bit時(shí)，是140字符。sm_default_msg_id：預(yù)定義短消息ID，不是預(yù)定義短消息時(shí)應(yīng)設(shè)為0，預(yù)定義短消息ID值從0x01到0x64。sm_length：短消息的數(shù)據(jù)長度，以字節(jié)計(jì)算source_addr：源地址編號(hào)，同addresssource_addr_npi：源地址編碼方案，同npisource_addr_ton：源地址編碼類型，同tonsystem_id：接口ID，用來描述虛擬連接的用戶名system_type：用來描述用戶的類型ton：地址編碼類型，（定義詳見GSM03.401 9.1.2.5)0未知號(hào)碼1國際號(hào)碼2國內(nèi)號(hào)碼3網(wǎng)絡(luò)專用號(hào)碼4用戶號(hào)碼5字母號(hào)碼(按照 GSMTS0