FreeCalypso > hg > sms-coding-utils

annotate doc/Network-MT-SMS-testing @ 22:8a2038c6a156

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
LICENSE: same as FC host tools and FC SIM tools The present code is mostly pieced together from FC User Phone Tools (freecalypso-tools/uptools) and fc-sim-tools, hence it makes no rational sense for it to be subject to any different license terms than those two major packages - but make it explicit.
author Mychaela Falconia <falcon@freecalypso.org>
date Thu, 31 Aug 2023 23:03:38 +0000
parents b23b9f69c02a
children d7571dc2fecc
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
1a923a97228e doc/Network-MT-SMS-testing: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
23 Tool-workflow article under sms-gen-tpdu description.
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.