Ogni messaggio SMPP è una PDU (Protocol Data Unit) con un header fisso di 16 byte seguito da un body specifico dell'operazione. L'header è costituito da quattro interi big-endian da 4 byte: command_length, command_id, command_status e sequence_number. command_length conteggia l'intera PDU header incluso, quindi il ricevente legge prima 4 byte e poi il resto.
bind_transceiverAprire e autenticare la sessionebind_transceiver_respSessione accettatasubmit_smInviare un messaggiosubmit_sm_respAccettato, ID messaggio restituitodeliver_smRicevuta di consegna o messaggio in entratadeliver_sm_respConfermatoenquire_linkKeepalive durante l'inattività
L'header di 16 byte
Ogni PDU inizia con gli stessi quattro interi a 32 bit senza segno in ordine di rete (big-endian). command_length è il numero totale di ottetti della PDU inclusi questi 16 byte di header: un parser legge i primi 4 byte, ricava la lunghezza completa e legge il resto. command_id identifica l'operazione. command_status vale 0 (ESME_ROK) nelle richieste e trasporta un codice di errore nelle risposte. sequence_number correla una richiesta con la sua risposta.
| Offset | Campo | Dimensione | Scopo |
|---|---|---|---|
| 0 | command_length | 4 octets | Lunghezza totale della PDU in ottetti, intestazione inclusa |
| 4 | command_id | 4 octets | Identificatore operazione (es. submit_sm = 0x00000004) |
| 8 | command_status | 4 octets | 0 in una richiesta; codice di errore in una risposta |
| 12 | sequence_number | 4 octets | Correlaziona richiesta↔risposta (0x00000001–0x7FFFFFFF) |
command_id e il bit di risposta
Ogni operazione ha un command_id. La risposta corrispondente usa lo stesso valore con il bit più significativo impostato (OR logico con 0x80000000). Così submit_sm è 0x00000004 e submit_sm_resp è 0x80000004. generic_nack (0x80000000) è la risposta di errore generica per una PDU non interpretabile o non valida.
| Operazione | Richiesta | Risposta |
|---|---|---|
| generic_nack | — | 0x80000000 |
| bind_receiver | 0x00000001 | 0x80000001 |
| bind_transmitter | 0x00000002 | 0x80000002 |
| query_sm | 0x00000003 | 0x80000003 |
| submit_sm | 0x00000004 | 0x80000004 |
| deliver_sm | 0x00000005 | 0x80000005 |
| unbind | 0x00000006 | 0x80000006 |
| replace_sm | 0x00000007 | 0x80000007 |
| cancel_sm | 0x00000008 | 0x80000008 |
| bind_transceiver | 0x00000009 | 0x80000009 |
| enquire_link | 0x00000015 | 0x80000015 |
| data_sm | 0x00000103 | 0x80000103 |
Il body e come sono codificati i campi
Dopo l'header viene il body specifico dell'operazione con i parametri obbligatori, opzionalmente seguito dai parametri opzionali TLV. SMPP utilizza tre codifiche di campo. Gli interi sono a dimensione fissa, senza segno, big-endian. Le C-Octet String sono testo ASCII terminato da un NULL (0x00), con una lunghezza massima dichiarata che include il terminatore. Le Octet String sono campi di byte grezzi la cui lunghezza è indicata da un campo di lunghezza precedente (ad esempio short_message, la cui dimensione è fissata da sm_length).
| Tipo | Codifica |
|---|---|
| Integer | Interi senza segno a 1/2/4 ottetti fissi, big-endian (ordine dei byte di rete) |
| C-Octet String | ASCII terminato da NUL; la lunghezza massima include il terminatore 0x00 |
| C-Octet String (Decimal/Hex) | Come sopra, ma limitato alle cifre ASCII decimali o esadecimali |
| Octet String | Byte grezzi; la lunghezza è fornita da un campo di lunghezza separato, senza terminatore |
Un esempio pratico: submit_sm sul filo
Una PDU submit_sm minimale. Il command_length dell'header (0x0000003D = 61) è il numero totale di byte; command_id 0x00000004 è submit_sm; command_status 0 indica una richiesta; sequence_number 0x0000000F correla la risposta. Il body segue poi nell'ordine fisso dei campi definito dalla specifica.
00 00 00 3D command_length = 61
00 00 00 04 command_id = submit_sm
00 00 00 00 command_status = ESME_ROK (request)
00 00 00 0F sequence_number = 15
-- body --
00 service_type = "" (NULL)
05 source_addr_ton = 5 (alphanumeric)
00 source_addr_npi = 0 (unknown)
42 4E 00 source_addr = "BN" + NULL
01 dest_addr_ton = 1 (international)
01 dest_addr_npi = 1 (E.164/ISDN)
... destination_addr, esm_class, ... short_messageDomande frequenti
command_length include l'header?
Sì. command_length è la lunghezza totale dell'intera PDU in ottetti, inclusi i 16 byte di header. Un ricevente legge esattamente command_length byte per consumare un'intera PDU dallo stream TCP.
Quale ordine dei byte usa SMPP?
L'ordine di rete — big-endian — per tutti i campi interi multi-ottetto, inclusi tutti i campi dell'header. Un valore a 4 byte pari a 61 viene trasmesso come 00 00 00 3D.
Come sono terminati i campi di testo?
I campi di testo sono C-Octet String: caratteri ASCII terminati da un singolo byte NULL (0x00). Una C-Octet String vuota è composta dal solo byte NULL. La lunghezza massima dichiarata include quel terminatore.
Che cos'è una generic_nack?
generic_nack (command_id 0x80000000) è la risposta che il ricevente restituisce quando una PDU non può essere interpretata o è fondamentalmente non valida — ad esempio per un command_length errato o un command_id sconosciuto. Il suo command_status ne indica il motivo.
Come delimita le PDU un ricevente sullo stream TCP?
TCP è uno stream di byte senza confini di messaggio, quindi il ricevente legge i primi 4 byte per ottenere command_length, poi legge quel numero totale di byte per isolare una PDU completa prima di interpretare il resto dell'header e il body.
Specifiche della fonte
Gli standard pubblicati su cui si basa questa pagina. Si apre in una nuova scheda.