FreeCalypso > hg > sms-coding-utils
annotate doc/Tool-workflow @ 26:c8cb05b69118
libcoding alpha addr: support both encoding and decoding
author | Mychaela Falconia <falcon@freecalypso.org> |
---|---|
date | Thu, 13 Jun 2024 01:55:19 +0000 |
parents | f0139d74d3aa |
children |
rev | line source |
---|---|
19
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
1 The present sms-coding-utils suite consists of two principal programs: |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
2 sms-encode-text and sms-gen-tpdu. There is also a shell script named |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
3 gen-sms-deliver-pdu that serves as a wrapper around sms-gen-tpdu for one |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
4 important use case of network-side testing of MT SMS. |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
5 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
6 sms-encode-text encodes only the user text body of SMS (either single or |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
7 concatenated) and does not deal with any of the headers. The output from |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
8 sms-encode-text is designed to be fed into sms-gen-tpdu with some additional |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
9 prepended lines, either by way of a wrapper shell script like |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
10 gen-sms-deliver-pdu or by way of an intermediate file: redirect the output of |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
11 sms-encode-text into a file, manually edit that file to add user-addr and |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
12 possibly other header lines, and then feed it to sms-gen-tpdu. |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
13 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
14 The intermediate format in which SMS user data payload is passed from |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
15 sms-encode-text to sms-gen-tpdu is long hex strings, with the following |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
16 peculiarities: |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
17 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
18 * In the most common case of GSM7 encoding, the conversion from ASCII to |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
19 GSM 03.38 has already been done (for example, character '@' will be encoded |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
20 as 00 rather than 40 in these hex strings, and '[' will be escape-encoded as |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
21 1B3C), but the packing of septets into octets has NOT been done yet - instead |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
22 a string of binary septets is emitted, with the high bit clear in each hex |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
23 byte. |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
24 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
25 * In the case of GSM7-encoded message segments that begin with UDH (used for |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
26 concatenated SMS), the UDH part is encoded as octets, followed by septets for |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
27 the text part. The recipient of this intermediate format will need to extract |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
28 UDHL from the first octet of the hex string and use this length to locate the |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
29 boundary between octet-encoded UDH and septet-encoded text. |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
30 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
31 This peculiar format was chosen because it is the representation format used in |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
32 SMPP transport, and in any case it is a necessary intermediate step between |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
33 ASCII input and the final GSM 03.40 TPDU form. The Mother had to write another |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
34 test program for SMPP (smpp-send in themwi-system-sw repository), and that |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
35 program is front-fed with the same sms-encode-text preliminary. |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
36 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
37 sms-encode-text usage |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
38 ===================== |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
39 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
40 The basic usage synopsis is: |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
41 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
42 sms-encode-text [options] [message-text] |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
43 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
44 If the message text to be encoded is given on the command line, it must be a |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
45 single argument, i.e., quotes will need to be used at the shell level. If no |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
46 message text is given on the command line, it will be read from stdin instead. |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
47 The operation of this program generally mirrors fcup-smsend from FreeCalypso |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
48 host tools - please read User-phone-tools document in freecalypso-tools |
24
f0139d74d3aa
doc/Tool-workflow: document sms-encode-text -e option
Mychaela Falconia <falcon@freecalypso.org>
parents:
19
diff
changeset
|
49 repository. Allowed options are -c, -C, -e, -u and -U, and they work exactly |
f0139d74d3aa
doc/Tool-workflow: document sms-encode-text -e option
Mychaela Falconia <falcon@freecalypso.org>
parents:
19
diff
changeset
|
50 the same as in fcup-smsend. |
19
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
51 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
52 Just like fcup-smsend, sms-encode-text can generate either single SMS (if the |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
53 message text fits within 160 characters for GSM7 or 70 characters for UCS-2) or |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
54 concatenated SMS. To enable the possibility of concatenated SMS, you have to |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
55 invoke the program with either -c or -C option; the difference between these |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
56 two options is in how the reference number for concatenated SMS is obtained. |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
57 With -C you specify this reference number explicitly; with -c the program |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
58 implements the same $HOME/.concat_sms_refno logic as fcup-smsend. |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
59 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
60 In the case of single SMS, the output from sms-encode-text consists of two |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
61 lines: a mode-setting line that reads either 'dcs 0 septet' or 'dcs 8 octet', |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
62 followed by a message line. The single message line consists of 'msg' keyword |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
63 followed by a long hex string as explained in the previous section. |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
64 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
65 In the case of concatenated SMS, the output from sms-encode-text consists of 3 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
66 or more lines: a dcs line that is the same as for single SMS, followed by 2 or |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
67 more msg-udh lines. Each msg-udh line carries a TP-UD field that consists of |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
68 UDH followed by text, and the msg-udh keyword (as distinct from plain 'msg') |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
69 conveys the UDHI bit. |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
70 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
71 sms-gen-tpdu usage |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
72 ================== |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
73 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
74 sms-gen-tpdu takes only one command argument: a mode keyword selecting which |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
75 type of PDU needs to be generated. The 4 choices are: |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
76 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
77 mo Generate a pure GSM 03.40 SMS-SUBMIT TPDU |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
78 mt Generate a pure GSM 03.40 SMS-DELIVER TPDU |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
79 sc-mo Generate SMS-SUBMIT with a prepended SC-address |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
80 sc-mt Generate SMS-DELIVER with a prepended SC-address |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
81 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
82 sc-mo and sc-mt forms are intended for the mobile side of GSM, as this format |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
83 is written into EF_SMS on SIMs and exchanged in GSM 07.05 PDU mode. Plain mt |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
84 format is intended for generating SMS-DELIVER TPDUs for MT SMS testing from the |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
85 network side (SMSC development), and plain mo format exists for completeness. |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
86 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
87 All other bits beyond the above mode selection are read from stdin. The input |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
88 is line-based and is expected to consist of setting lines followed by message |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
89 lines. Each msg or msg-udh line in the input results in a TPDU being generated, |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
90 but in order to produce valid message PDUs for anything other than an MO draft |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
91 that hasn't had its To address set yet, these message lines need to be preceded |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
92 by some setting lines. Usually only user-addr setting needs to be given before |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
93 sms-encode-text output; other settings may be given as part of more advanced |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
94 experiments. |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
95 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
96 The following settings are supported: |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
97 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
98 dcs INTEGER (septet|octet) |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
99 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
100 Set TP-DCS. The first argument is the value to be put into the TP-DCS octet in |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
101 the TPDU; the second argument is a mode keyword that tells sms-gen-tpdu whether |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
102 it should operate in septet or octet mode when encoding TP-UDL and TP-UD. |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
103 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
104 lp |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
105 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
106 Set TP-LP; valid only in MT mode. |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
107 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
108 mms |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
109 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
110 Set TP-MMS; valid only in MT mode. Note that the bit encoding this Boolean flag |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
111 is inverted: when no TP-MMS is set, the bit is 1, and when 'mms' setting is |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
112 given, the bit becomes 0. |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
113 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
114 mr INTEGER |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
115 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
116 Set TP-MR; valid only in MO mode. The default in the absence of this setting |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
117 is 0xFF. |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
118 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
119 pid INTEGER |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
120 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
121 Set TP-PID. The default in the absence of this setting is 0. |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
122 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
123 rd |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
124 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
125 Set TP-RD; valid only in MO mode. |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
126 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
127 rp |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
128 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
129 Set TP-RP. |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
130 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
131 sc-addr NUMBER[,INTEGER] |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
132 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
133 Valid only in sc-mo and sc-mt modes: set the SC-address to be prepended before |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
134 the GSM 03.40 TPDU. If this setting is omitted, a null SC-address (a single |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
135 length octet of 0) is emitted. The latter approach works with GSM 07.05 at |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
136 least with FreeCalypso firmware - the MS firmware replaces this null SC-address |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
137 with the one programmed on the SIM. |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
138 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
139 sc-ts YY/MM/DD,HH:MM:SS[+-]TZ |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
140 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
141 Set TP-SCTS; valid only in MT mode. If this setting is not given, the current |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
142 local time is used to generate TP-SCTS. |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
143 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
144 sr |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
145 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
146 Set TP-SRI or TP-SRR (different names for the same bit). |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
147 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
148 user-addr NUMBER[,INTEGER] |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
149 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
150 Set TP-DA in SMS-SUBMIT or TP-OA in SMS-DELIVER. |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
151 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
152 user-addr alpha:STRING |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
153 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
154 This special form of user-addr sets TP-OA (or TP-DA - we provide mechanism, not |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
155 policy) in the special alphanumeric address format (TON=5, NPI=0). The alpha |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
156 address can be up to 11 GSM7 characters; the GSM7 string is given in standard |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
157 FreeCalypso representation defined in the SIM-data-formats specification in |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
158 freecalypso-docs. |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
159 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
160 vp-abs YY/MM/DD,HH:MM:SS[+-]TZ |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
161 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
162 Set TP-VP in absolute format; valid only in MO mode. |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
163 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
164 vp-rel INTEGER |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
165 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
166 Set TP-VP in relative format; valid only in MO mode. |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
167 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
168 INTEGER format: decimal by default, hexadecimal if prefixed with 0x. |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
169 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
170 NUMBER[,INTEGER] phone number entry format for user-addr and sc-addr |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
171 -------------------------------------------------------------------- |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
172 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
173 The same convention is used as elsewhere in FreeCalypso queendom, e.g., in |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
174 fcup-smsend and fc-simtool: |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
175 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
176 * If no comma-separated TON/NPI byte is given, it defaults to 0x91 if the number |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
177 begins with '+' or 0x81 otherwise. |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
178 |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
179 * If the number is suffixed with a comma and a byte-sized integer (decimal by |
6a1a436747e9
doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
180 default or 0x prefix for hex), the TON/NPI byte is set explicitly. |