amadeus0818的博客

SMPP 协议 3.4, 英文版， 可选择。 Table of Contents 1. Introduction.................................................................................................................8 1.1 SMPP Overview...............................................................................................8 1.2 Scope................................................................................................................9 1.3 Glossary .........................................................................................................10 1.4 References......................................................................................................11 2. SMPP Protocol Overview.........................................................................................12 2.1 SMPP Protocol Definition .............................................................................13 2.2 SMPP Session Description ............................................................................14 2.2.1 Outbind .........................................................................................16 2.3 SMPP PDUs...................................................................................................17 2.4 SMPP Network Layer Connections ...............................................................19 2.5 SMPP messages sent from ESME to SMSC..................................................20 2.5.1 SMPP Message Response from SMSC to ESME.........................20 2.5.2 Typical SMPP session sequence - ESME Transmitter .................21 2.6 SMPP messages sent from SMSC to ESME..................................................23 2.6.1 SMPP Message Response from ESME to SMSC.........................23 2.6.2 Typical SMPP session sequence - ESME Receiver......................24 2.7 Duplex message exchange between an SMSC and an ESME .......................26 2.7.1 Typical SMPP session sequence - ESME Transceiver .................27 2.8 SMPP Error Handling ....................................................................................29 2.9 SMPP Timers .................................................................................................29 2.10 Message Modes..............................................................................................30 2.10.1 Store and Forward Message Mode ...............................................30 2.10.2 Datagram Message Mode .............................................................32 2.10.3 Transaction Message Mode ..........................................................33 2.11 Message Types...............................................................................................34 3. SMPP PDU Type and Format Definitions ..............................................................36 3.1 SMPP PDU - Type Definitions......................................................................36 3.1.1 SMPP Parameter Field Size Notation ...........................................37 3.2 SMPP PDU Format - Overview.....................................................................38 3.2.1 SMPP PDU Layout .......................................................................39 3.2.2 SMPP PDU Length .......................................................................41 3.2.3 SMPP Message length and extended message length...................41 3.2.4 Optional Parameters......................................................................42 3.2.4.1 Optional Parameter Format.....................................42 3.3 Guidelines for SMPP Forward Compatibility................................................43 3.4 Guidelines for SMPP Backward Compatibility .............................................44 4. SMPP PDU Definition ..............................................................................................45 4.1 “BIND” Operation .........................................................................................45 4.1.1 “BIND_TRANSMITTER” Syntax ...............................................46 4.1.2 “BIND_TRANSMITTER_RESP” Syntax....................................47 4.1.3 “BIND_RECEIVER” Syntax........................................................48 4.1.4 “BIND_RECEIVER_RESP” ........................................................50 4.1.5 “BIND_TRANSCEIVER” Syntax................................................51 4.1.6 “BIND_TRANSCEIVER_RESP” ................................................53 SMPP Protocol Specification v3.4 Table of Contents Issue 1.2 ©SMPP Developers Forum Page 5 of 169 4.1.7 “OUTBIND” Operation. ...............................................................54 4.1.7.1 “OUTBIND” Syntax..............................................54 4.2 “UNBIND” Operation....................................................................................55 4.2.1 “UNBIND” ...................................................................................56 4.2.2 “UNBIND_RESP”.......................................................................56 4.3 “GENERIC_NACK” PDU ............................................................................57 4.3.1 “GENERIC_NACK” Syntax ........................................................57 4.4 “SUBMIT_SM” Operation ............................................................................58 4.4.1 “SUBMIT_SM” Syntax ................................................................59 4.4.1.1 Source and Destination Addressing .......................66 4.4.1.2 Message Replace operation in “SUBMIT_SM”.....66 4.4.2 “SUBMIT_SM_RESP”.................................................................67 4.5 “SUBMIT_MULTI” Operation .....................................................................68 4.5.1 “SUBMIT_MULTI” Syntax .........................................................69 4.5.1.1 Destination Address definition ...............................75 4.5.1.2 Distribution List (DL) definition ............................75 4.5.2 “SUBMIT_MULTI_RESP” Syntax..............................................76 4.5.2.1 Unsuccessful deliveries ..........................................77 4.6 “DELIVER_SM” Operation ..........................................................................78 4.6.1 “DELIVER_SM” Syntax ..............................................................79 4.6.2 “DELIVER_SM_RESP” Syntax ..................................................85 4.7 “DATA_SM” Operation ................................................................................86 4.7.1 “DATA_SM” Syntax ....................................................................87 4.7.2 “DATA_SM_RESP” Syntax ........................................................93 4.8 “QUERY_SM” Operation..............................................................................94 4.8.1 “QUERY_SM” Syntax .................................................................95 4.8.2 “QUERY_SM_RESP” Syntax......................................................96 4.9 “CANCEL_SM” Operation ...........................................................................97 4.9.1 “CANCEL_SM” Syntax ...............................................................98 4.9.2 “CANCEL_SM_RESP” Syntax..................................................100 4.10 “REPLACE_SM” Operation........................................................................101 4.10.1 “REPLACE_SM” Syntax ...........................................................102 4.10.2 “REPLACE_SM_RESP” Syntax................................................104 4.11 “ENQUIRE_LINK” Operation ....................................................................105 4.11.1 “ENQUIRE_LINK” Syntax........................................................106 4.11.2 “ENQUIRE_LINK_RESP” Syntax ............................................106 4.12 “ALERT_NOTIFICATION” Operation ......................................................107 4.12.1 “ALERT_NOTIFICATION” Syntax..........................................108 5. SMPP Parameter Definition...................................................................................109 5.1 Command Header Parameters.....................................................................109 5.1.1 command_length.........................................................................109 5.1.2 command_id................................................................................109 5.1.2.1 SMPP Command set .............................................110 5.1.3 command_status..........................................................................112 5.1.4 sequence_number........................................................................115 5.2 Mandatory SMPP Parameters ......................................................................116 5.2.1 system_id ....................................................................................116 5.2.2 password .....................................................................................116 5.2.3 system_type.................................................................................116 5.2.4 interface_version.........................................................................116 Page 6 of 169 ©SMPP Developers Forum Issue 1.2 Table of Contents SMPP Protocol Specification v3.4 5.2.5 addr_ton, source_addr_ton, dest_addr_ton, esme_addr_ton.......117 5.2.6 addr_npi, source_addr_npi, dest_addr_npi, esme_addr_npi.......118 5.2.7 address_range..............................................................................118 5.2.8 source_addr .................................................................................119 5.2.9 destination_addr ..........................................................................119 5.2.10 esme_addr ...................................................................................119 5.2.11 service_type ................................................................................120 5.2.12 esm_class ....................................................................................121 5.2.13 protocol_id ..................................................................................123 5.2.14 priority_flag ................................................................................123 5.2.15 schedule_delivery_time ..............................................................124 5.2.16 validity_period ............................................................................124 5.2.17 registered_delivery......................................................................124 5.2.18 replace_if_present_flag...............................................................125 5.2.19 data_coding .................................................................................126 5.2.20 sm_default_msg_id .....................................................................127 5.2.21 sm_length....................................................................................128 5.2.22 short_message .............................................................................128 5.2.23 message_id..................................................................................128 5.2.24 number_of_dests .........................................................................128 5.2.25 dest_flag ......................................................................................129 5.2.26 no_unsuccess...............................................................................129 5.2.27 dl_name.......................................................................................129 5.2.28 message_state..............................................................................130 5.3 SMPP Optional Parameter Description........................................................131 5.3.1 Optional Parameter Tag Identifiers.............................................131 5.3.2 SMPP Optional Parameter Tag definitions.................................132 5.3.2.1 dest_addr_subunit .................................................134 5.3.2.2 source_addr_subunit .............................................134 5.3.2.3 dest_network_type................................................135 5.3.2.4 source_network_type............................................135 5.3.2.5 dest_bearer_type ...................................................136 5.3.2.6 source_bearer_type ...............................................136 5.3.2.7 dest_telematics_id.................................................137 5.3.2.8 source_telematics_id.............................................137 5.3.2.9 qos_time_to_live...................................................138 5.3.2.10 payload_type.........................................................138 5.3.2.11 additional_status_info_text...................................139 5.3.2.12 receipted_message_id ...........................................139 5.3.2.13 ms_msg_wait_facilities ........................................140 5.3.2.14 privacy_indicator ..................................................141 5.3.2.15 source_subaddress ................................................142 5.3.2.16 dest_subaddress ....................................................143 5.3.2.17 user_message_reference .......................................143 5.3.2.18 user_response_code ..............................................144 5.3.2.19 language_indicator................................................144 5.3.2.20 source_port ...........................................................145 5.3.2.21 destination_port ....................................................145 5.3.2.22 sar_msg_ref_num .................................................146 5.3.2.23 sar_total_segments................................................147 5.3.2.24 sar_segment_seqnum............................................147 SMPP Protocol Specification v3.4 Table of Contents Issue 1.2 ©SMPP Developers Forum Page 7 of 169 5.3.2.25 sc_interface_version .............................................148 5.3.2.26 display_time..........................................................148 5.3.2.27 ms_validity ...........................................................149 5.3.2.28 dpf_result ..............................................................149 5.3.2.29 set_dpf...................................................................150 5.3.2.30 ms_availability_status...........................................151 5.3.2.31 network_error_code..............................................152 5.3.2.32 message_payload ..................................................153 5.3.2.33 delivery_failure_reason ........................................153 5.3.2.34 more_messages_to_send.......................................154 5.3.2.35 message_state .......................................................154 5.3.2.36 callback_num........................................................155 5.3.2.37 callback_num_pres_ind ........................................156 5.3.2.38 callback_num_atag ...............................................157 5.3.2.39 number_of_messages............................................158 5.3.2.40 sms_signal.............................................................158 5.3.2.41 alert_on_message_delivery...................................159 5.3.2.42 its_reply_type .......................................................159 5.3.2.43 its_session_info.....................................................160 5.3.2.44 ussd_service_op....................................................161 6. Network Implementation........................................................................................162 6.1 Network Error Codes ...................................................................................162 6.2 Maximum Message Length..........................................................................162 7. General Definitions .................................................................................................163 7.1 Time Definitions ..........................................................................................163 7.1.1 Time Format................................................................................163 7.1.1.1 Absolute Time format...........................................163 7.1.1.2 Relative Time Format ...........................................164 7.2 Timer Definitions.........................................................................................165 Appendix A ..........................................................................................................................166 Appendix B ..........................................................................................................................167 Appendix C ..........................................................................................................................169