FreeCalypso > hg > sms-coding-utils

annotate doc/Tool-workflow @ 23:e56bb9f09ff1

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
sms-encode-text: port over -e option from fcup-smsend
author Mychaela Falconia <falcon@freecalypso.org>
date Sat, 02 Sep 2023 19:22:05 +0000
parents 6a1a436747e9
children f0139d74d3aa
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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
6a1a436747e9 doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
49 repository. Allowed options are -c, -C, -u and -U, and they work exactly the
6a1a436747e9 doc/Tool-workflow: document written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
50 same as in fcup-smsend.
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.