annotate doc/Network-MT-SMS-testing @ 32:829e082793d0

new README
author Mychaela Falconia <falcon@freecalypso.org>
date Fri, 14 Jun 2024 19:42:25 +0000
parents d7571dc2fecc
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
20
1a923a97228e doc/Network-MT-SMS-testing: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
1 Testing MT direction of SMS-PP from the network side
1a923a97228e doc/Network-MT-SMS-testing: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
2 ====================================================
1a923a97228e doc/Network-MT-SMS-testing: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
3
1a923a97228e doc/Network-MT-SMS-testing: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
4 The envisioned way to generate SMS-DELIVER TPDUs for MT SMS testing from the
1a923a97228e doc/Network-MT-SMS-testing: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
5 network side is to run a shell pipeline of this form:
1a923a97228e doc/Network-MT-SMS-testing: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
6
1a923a97228e doc/Network-MT-SMS-testing: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
7 sms-encode-text [opt] [msg-text] | gen-sms-deliver-pdu from-number [opt]
1a923a97228e doc/Network-MT-SMS-testing: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
8
1a923a97228e doc/Network-MT-SMS-testing: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
9 Breaking it down:
1a923a97228e doc/Network-MT-SMS-testing: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
10
1a923a97228e doc/Network-MT-SMS-testing: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
11 * The message text to be turned into an SMS-DELIVER TPDU (or multiple such TPDUs
21
b23b9f69c02a doc/Network-MT-SMS-testing: grammar fix
Mychaela Falconia <falcon@freecalypso.org>
parents: 20
diff changeset
12 with concatenated SMS) can be given on the command line as an argument to the
20
1a923a97228e doc/Network-MT-SMS-testing: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
13 sms-encode-text step in the pipeline, or can be fed as stdin to the pipeline.
1a923a97228e doc/Network-MT-SMS-testing: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
14
1a923a97228e doc/Network-MT-SMS-testing: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
15 * Options for concatenated SMS or UCS-2 encoding need to be given at the
1a923a97228e doc/Network-MT-SMS-testing: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
16 sms-encode-text pipeline stage.
1a923a97228e doc/Network-MT-SMS-testing: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
17
1a923a97228e doc/Network-MT-SMS-testing: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
18 * The "From" number to be encoded into the SMS-DELIVER TPDU is given as a
1a923a97228e doc/Network-MT-SMS-testing: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
19 mandatory argument at the gen-sms-deliver-pdu pipeline stage.
1a923a97228e doc/Network-MT-SMS-testing: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
20
1a923a97228e doc/Network-MT-SMS-testing: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
21 * Additional options may be given at the gen-sms-deliver-pdu pipeline stage.
1a923a97228e doc/Network-MT-SMS-testing: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
22 Possible options are lp, mms, rp, sr, pid and sc-ts, described in the
30
d7571dc2fecc doc: encoder/generator portion is now just one part
Mychaela Falconia <falcon@freecalypso.org>
parents: 21
diff changeset
23 Generator-tool-workflow article under sms-gen-tpdu description.
20
1a923a97228e doc/Network-MT-SMS-testing: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
24
1a923a97228e doc/Network-MT-SMS-testing: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
25 The output from this pipeline will be a single hex-encoded SMS-DELIVER TPDU,
1a923a97228e doc/Network-MT-SMS-testing: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
26 emitted as one long hex line, or multiple such hex lines (each carrying a TPDU)
1a923a97228e doc/Network-MT-SMS-testing: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
27 in the case of concatenated SMS. Test programs written in the course of SMSC
1a923a97228e doc/Network-MT-SMS-testing: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
28 development will be designed to take this hex TPDU format as their input, on
1a923a97228e doc/Network-MT-SMS-testing: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
29 stdin, so that the final SMSC-specific step will be simply added to the
1a923a97228e doc/Network-MT-SMS-testing: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
30 just-described pipeline.