FreeCalypso > hg > freecalypso-tools

annotate doc/User-phone-tools @ 1011:6d9b10633f10 default tip

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
etmsync Pirelli IMEI retrieval: fix poor use of printf() Bug reported by Vadim Yanitskiy <fixeria@osmocom.org>: the construct where a static-allocated string was passed to printf() without any format arguments causes newer compilers to report a security problem. Given that formatted output is not needed here, just fixed string output, change printf() to fputs(), and direct the error message to stderr while at it.
author Mychaela Falconia <falcon@freecalypso.org>
date Thu, 23 May 2024 17:29:57 +0000
parents 8cf7d41f2821
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
388
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
1 FreeCalypso User Phone Tools are a new software addition to the FreeCalypso
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
2 family. These tools are programs that run on a Unix host computer such as a
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
3 GNU/Linux PC or laptop and communicate with a FreeCalypso phone or modem via
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
4 the standard AT command interface, rather than any of the formerly proprietary
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
5 interfaces specific to TI's internal architecture. The following tools are
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
6 currently available:
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
7
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
8 fcup-at Issues an arbitrary AT command given on the command line.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
9
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
10 fcup-settime Issues AT+CCLK command to the target to set its clock to the
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
11 host computer's notion of local time.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
12
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
13 fcup-smdump Retrieves a dump of SMS records (received, sent or stored
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
14 messages) from the FC device's SMS storage (currently SIM
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
15 storage; ME storage may be implemented in the future),
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
16 optionally deleting them from the severely space-limited
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
17 SIM/ME storage afterward.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
18
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
19 fcup-smsend* Tools for sending outgoing SMS from a host computer through a
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
20 FreeCalypso phone or modem and/or writing such outgoing SMS
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
21 into the FC device's SMS storage.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
22
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
23 fcup-smwrite Debug and development tool: writes arbitrary message records
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
24 into the FC device's SMS storage (currently SIM storage) in any
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
25 of the possible 4 states, with arbitrary incoming or outgoing
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
26 SMS PDU content.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
27
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
28 Because these tools communicate with the target via standards-defined AT
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
29 commands, in theory they ought to work with any AT-command-speaking 3GPP phone
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
30 or modem and not just our own FreeCalypso. However, experience has shown that
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
31 in the case of the common proprietary implementations, practice does not match
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
32 theory: when I (Mychaela) tried these same AT commands against a random
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
33 off-the-shelf proprietary modem (Huawei E303 USB stick modem for 3G), the
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
34 following problems were seen:
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
35
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
36 * The essential AT+CMGL=4 command for retrieving the full set of SMS records
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
37 from SIM storage in PDU mode appears to be broken: all I got was a hang.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
38 Its text mode counterpart AT+CMGL="ALL" produces incomplete output.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
39
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
40 * Qualcomm/Huawei's implementation of the AT command interface does not allow
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
41 AT+CSCS to be set to "HEX"; our fcup-smdump implementation uses this setting
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
42 so that the phonebook names returned along with SMS PDUs in the +CMGL
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
43 responses can be parsed reliably no matter what weird characters they might
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
44 contain.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
45
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
46 * Setting AT+CSCS to "8859-1" is not supported either; this setting is used by
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
47 our fcup-smsend and fcup-smsendmult tools when sending in text mode.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
48
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
49 * Sending outgoing SMS with fcup-smsend in PDU mode (which does not touch
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
50 AT+CSCS) works in that the message goes out, but the tool complains afterward
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
51 because the echo after the ^Z is different from what our tools expect.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
52
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
53 Because of these quirks, our FC User Phone Tools officially work only with our
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
54 own FreeCalypso phones and modems, and are not expected to work against various
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
55 proprietary implementations. Let us not forget that the broken and buggy nature
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
56 of the common proprietary implementations is the very reason why we need
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
57 FreeCalypso in the first place.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
58
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
59 Target interface options
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
60 ========================
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
61
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
62 Our fcup-* tools can communicate with the AT-command-speaking target in one of
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
63 two ways:
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
64
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
65 * The default is the standard AT command interface over a dedicated UART. As
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
66 of this writing, the only FreeCalypso device that provides a full-featured AT
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
67 command interface of this kind is our FCDEV3B modem, but the ultimate goal of
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
68 the project is to build our own end user phone handset (a Libre Dumbphone)
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
69 that will also provide a full-featured AT command interface on its USB port
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
70 via a built-in CP2102 or FT232R chip.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
71
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
72 * As a dirty hack, one can run FreeCalypso GSM fw on some alien hw targets,
449
b1864e3f8fb4 CHANGES & doc/User-phone-tools: documented AT-over-RVT long strings
Mychaela Falconia <falcon@freecalypso.org>
parents: 388
diff changeset
73 currently Motorola C1xx and Pirelli DP-L10. In this hacked-up configuration
388
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
74 there is no dedicated UART available for a standard AT command interface, but
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
75 there is a hack that allows a limited subset of AT commands to be passed over
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
76 the RVTMUX binary packet interface provided by the running FreeCalypso GSM fw.
450
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
77 Our fcup-* tools can work with this alternate target interface option and
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
78 thereby support these crippled targets.
388
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
79
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
80 The AT-over-RVTMUX mechanism was originally invented back in 2015 as a
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
81 development aid, and was never intended for production use or to support any
449
b1864e3f8fb4 CHANGES & doc/User-phone-tools: documented AT-over-RVT long strings
Mychaela Falconia <falcon@freecalypso.org>
parents: 388
diff changeset
82 kind of end user functionality. One of the limitations of its original
b1864e3f8fb4 CHANGES & doc/User-phone-tools: documented AT-over-RVT long strings
Mychaela Falconia <falcon@freecalypso.org>
parents: 388
diff changeset
83 incarnation was that the strings that are sent to ATI via this interface were
b1864e3f8fb4 CHANGES & doc/User-phone-tools: documented AT-over-RVT long strings
Mychaela Falconia <falcon@freecalypso.org>
parents: 388
diff changeset
84 limited to 254 characters, whereas sending or writing SMS in hex format
b1864e3f8fb4 CHANGES & doc/User-phone-tools: documented AT-over-RVT long strings
Mychaela Falconia <falcon@freecalypso.org>
parents: 388
diff changeset
85 requires longer strings. As of early 2019, this limitation has been lifted:
b1864e3f8fb4 CHANGES & doc/User-phone-tools: documented AT-over-RVT long strings
Mychaela Falconia <falcon@freecalypso.org>
parents: 388
diff changeset
86 our Magnetite and Selenite firmwares from 20190109 onward support an extended
b1864e3f8fb4 CHANGES & doc/User-phone-tools: documented AT-over-RVT long strings
Mychaela Falconia <falcon@freecalypso.org>
parents: 388
diff changeset
87 version of our AT-over-RVTMUX hack that allows longer strings to be sent in
b1864e3f8fb4 CHANGES & doc/User-phone-tools: documented AT-over-RVT long strings
Mychaela Falconia <falcon@freecalypso.org>
parents: 388
diff changeset
88 pieces, and the present version of our FC User Phone Tools suite will send the
b1864e3f8fb4 CHANGES & doc/User-phone-tools: documented AT-over-RVT long strings
Mychaela Falconia <falcon@freecalypso.org>
parents: 388
diff changeset
89 strings it generates via this extended mechanism whenever they exceed the old
450
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
90 254 character limit. The new mechanism works correctly starting with the
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
91 20190128 firmware release for modem products and the 20190129 fw release for
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
92 Mot C1xx phones, thus when the present version of FC User Phone Tools is used
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
93 to communicate with our current firmwares, both target interface options provide
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
94 equivalent functionality on all supported targets.
388
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
95
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
96 All fcup-* tools take the following common command line options for selecting
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
97 the AT command target interface:
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
98
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
99 -B baud Valid only when -p is also given; selects a different baud rate
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
100 than the default 115200 bps.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
101
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
102 -n Dry run debug mode with no target interface at all: the AT
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
103 commands which would otherwise be sent to the target are simply
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
104 printed on stdout.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
105
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
106 -p ttyport Names the serial port to be used to talk to the target.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
107
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
108 -R Use the AT-over-RVTMUX interface instead of the standard AT
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
109 command interface over a dedicated UART.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
110
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
111 -X program Use the specified external program as the AT target
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
112 communication back-end; read the source code for the details.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
113
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
114 -R and -p options interact as follows:
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
115
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
116 Neither -R The standard dedicated AT command interface is used;
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
117 nor -p FC_GSM_DEVICE= environment variable needs to be set
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
118 to point to the serial port.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
119
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
120 -p only The standard dedicated AT command interface is used;
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
121 the serial port is named with the -p option.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
122
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
123 -R only AT-over-RVTMUX interface is used; the fcup-* tool connects
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
124 to an already running rvinterf process.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
125
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
126 -R and -p AT-over-RVTMUX interface is used; a new rvinterf process
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
127 is launched to talk RVTMUX on the specified serial port.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
128
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
129 Retrieving and decoding stored SMS
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
130 ==================================
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
131
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
132 As of this writing, our current FreeCalypso GSM firmware supports only SIM
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
133 storage for SMS, i.e., there is no working mechanism currently for storing SMS
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
134 records (received and sent messages) in the phone's or modem's own flash file
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
135 system. The capacity of this SIM SMS storage is determined by the SIM issuer,
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
136 but it is typically quite limited, on the order of 20 to 30 messages.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
137
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
138 The model adopted for FreeCalypso is that incoming (and possibly saved outgoing)
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
139 messages initially accumulate in the SIM storage as they come in, and then the
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
140 user periodically transfers them to her larger host computer, simultaneously
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
141 deleting them from the SIM storage to reclaim the limited space. The retrieval
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
142 of stored SMS from FreeCalypso GSM devices is accomplished with our fcup-smdump
450
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
143 utility; like all SMS operations with the current tools+firmware combination,
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
144 this operation works exactly the same whether the FC GSM device offers a full-
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
145 featured AT command interface or only AT over RVTMUX. SMS retrieval is always
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
146 done in PDU mode, and the output from fcup-smdump contains raw SMS PDUs in the
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
147 form of long hex strings. A separate utility called sms-pdu-decode then does
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
148 what its name says.
388
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
149
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
150 The intended mode of usage is something like this:
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
151
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
152 fcup-smdump -d >> long-term-sms-log
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
153
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
154 The -d option to fcup-smdump tells it to delete the retrieved messages from the
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
155 SIM or future ME storage; this option should only be used when the output is
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
156 redirected into some kind of longer-term storage. In the above model the file
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
157 named long-term-sms-log becomes what its name says as new messages retrieved
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
158 from the FC GSM device get added to it; the format will look like this:
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
159
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
160 Received message:
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
161 XXXXXX...
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
162
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
163 Received message:
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
164 XXXXXX...
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
165
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
166 Sent message:
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
167 XXXXXX...
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
168
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
169 Stored unsent message:
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
170 XXXXXX...
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
171
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
172 Received message:
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
173 XXXXXX...
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
174
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
175 Each of the "XXXXXX..." lines will be a long hex string giving an SMS PDU. The
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
176 idea is that the complete record of all received and sent messages should be
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
177 stored on the user's big computer in raw PDU form, rather than decoded, and the
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
178 decoding utility sms-pdu-decode should be invoked by the user (with the message
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
179 log file as input) as needed for reading these messages.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
180
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
181 The message decoding utility sms-pdu-decode does its best to decode and show
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
182 everything without dropping any bits: in addition to the actual decoded message
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
183 characters and the From/To address (the "end user" content of the message), it
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
184 decodes and shows the SC address, the first octet, the MR octet for outgoing
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
185 messages, PID and DCS octets, the SC timestamp or the validity period fields,
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
186 and the UDH bytes if present. However, some bits can still be lost in the
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
187 decoding, which is why it is important to archive messages in the raw PDU form:
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
188
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
189 * Padding bits used to round the From/To address and septet-based user data to
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
190 an octet boundary and to round any UDH to a septet boundary are not decoded.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
191
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
192 * If the user data portion of the message is 8-bit or compressed data (per the
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
193 DCS octet), it is shown as a raw hex dump, which is lossless, but if it is
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
194 GSM7 or UCS-2 text (GSM 03.38 character encodings), the characters are
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
195 converted to the user's character set (plain ASCII only by default) for
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
196 display, and some characters may not be displayable.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
197
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
198 Character sets and encodings
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
199 ----------------------------
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
200
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
201 By default, sms-pdu-decode only emits 7-bit ASCII characters in its output; any
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
202 GSM7 or UCS-2 characters which fall outside of this plain ASCII repertoire are
805
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
203 converted into backslash escapes. This conservative default behaviour can be
388
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
204 modified as follows:
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
205
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
206 -e option extends the potential output character repertoire from 7-bit ASCII to
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
207 8-bit ISO 8859-1. Any 8859-1 high characters are emitted as single bytes,
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
208 i.e., are NOT encoded in UTF-8 - this option is intended for non-UTF-8
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
209 environments.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
210
805
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
211 -u option extends the potential output character repertoire to all of Unicode,
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
212 and changes the output encoding to UTF-8.
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
213
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
214 Regardless of whether the source message character set is GSM7 or UCS-2 and
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
215 irrespective of -e or -u options, any backslash characters are always escaped
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
216 as \\, and any CR characters are represented as \r. Additional backslash
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
217 escape encodings depend on the source message character set:
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
218
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
219 * If the source message character set is GSM7, the following additional
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
220 backslash escapes can be emitted:
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
221
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
222 - In the absence of -u option, the Euro currency symbol is converted to \E;
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
223
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
224 - Any GSM7 escape characters (0x1B) that aren't part of a valid escape
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
225 sequence for [\]^ or {|}~ or \E are represented as \e;
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
226
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
227 - Any GSM7 characters that either can't be represented in the output character
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
228 set (ASCII or ISO 8859-1) or are outright invalid per GSM 03.38 are
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
229 represented as \xX, where xX is the original GSM7 code point in 2-digit
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
230 hexadecimal form between 00 and 7F;
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
231
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
232 - Invalid GSM7 escape sequences are emitted as \e\xX.
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
233
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
234 * If the source message character set is UCS-2, the following additional
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
235 backslash escapes can be emitted:
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
236
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
237 - Invalid UCS-2 characters falling onto control character code points are
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
238 emitted as \u00XX;
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
239
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
240 - UCS-2 characters that can't be represented in ASCII or ISO 8859-1 (when
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
241 running without -u option) are emitted as \uXXXX;
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
242
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
243 - If UTF-16 surrogate pairs are detected in the input, the encoded high-plane
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
244 Unicode character is reconstructed and emitted as \UXXXXXX in the absence
a43c5dc251dc doc/User-phone-tools: new sms-pdu-decode backslash escapes
Mychaela Falconia <falcon@freecalypso.org>
parents: 450
diff changeset
245 of -u option, or as the appropriate UTF-8 byte sequence with -u.
388
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
246
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
247 -h option causes the user data portion of every message to be displayed as a
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
248 raw hex dump; in the case of GSM7-encoded messages, this hex dump shows the
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
249 unpacked septets.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
250
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
251 Composing and sending outgoing SMS
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
252 ==================================
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
253
450
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
254 When used in the default PDU mode (which now works on all targets with our
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
255 current firmware and tools), the primary SMS sending/writing tool fcup-smsend
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
256 offers the following capabilities:
388
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
257
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
258 * Sending outgoing messages in either GSM7 or UCS-2 encoding;
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
259 * Sending either single or long (concatenated) SMS;
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
260 * Message body input in ASCII, ISO 8859-1 or UTF-8;
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
261 * Message body input either on the command line or on stdin;
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
262 * Any messages sent through this tool (single or concatenated) may be
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
263 multiline, i.e., may contain embedded newlines;
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
264 * Messages sent in GSM7 encoding can contain ASCII characters [\]^ and {|}~
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
265 - the tool is smart enough to do the necessary escape encoding.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
266
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
267 The default and preferred AT command interface mode for sending/writing SMS is
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
268 PDU mode, which works great when the GSM device provides a proper AT command
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
269 interface. However, when a message of maximum or near-maximum length is being
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
270 submitted to the modem in PDU mode, the hex string that needs to be sent is
450
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
271 quite long, and at the time when our FC User Phone Tools were first designed
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
272 and written, our AT-over-RVTMUX mechanism could not handle such long strings.
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
273 Because we sought to have at least limited SMS sending and writing support for
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
274 crippled Motorola and Pirelli targets, we also implemented text mode support in
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
275 fcup-smsend and fcup-smsendmult, enabled with the -t option. In this text (-t)
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
276 mode the following restrictions apply:
388
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
277
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
278 * Only single SMS can be sent, not concatenated;
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
279 * Only GSM7-encoded messages can be sent, not UCS-2;
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
280 * No multiline messages can be sent, i.e., no newlines in the message body;
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
281 * ASCII characters [\]^ and {|}~ won't be sent correctly - GSM 07.05 text mode
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
282 drops them.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
283
450
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
284 Now that we have extended our AT-over-RVTMUX mechanism to support longer strings
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
285 and gained full support for PDU mode on all targets, the above -t mode is no
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
286 longer necessary for any use case, as the default PDU mode is a proper superset
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
287 in functionality. However, support for this -t mode has been retained, as
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
288 removing software functionality for no good reason is not the way of FOSS.
388
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
289
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
290 The invokation syntax is as follows:
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
291
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
292 fcup-smsend [options] dest-addr [message]
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
293
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
294 The destination address must be given on the command line; the address digits
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
295 may be optionally followed by a comma and an address type byte, either decimal
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
296 or hexadecimal with 0x prefix. The default address type is 0x91 if the number
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
297 begins with a '+' or 0x81 otherwise. If the message body is given on the
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
298 command line, it must be given as a single argument; if no message body argument
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
299 is given, the message body will be read from stdin. Any trailing newlines are
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
300 stripped before SMS encoding.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
301
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
302 The following options are supported, in addition to the common target interface
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
303 options listed earlier:
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
304
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
305 -c Enables concatenated SMS. Concatenated SMS will be sent only
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
306 if the message body exceeds 160 GSM7 or 70 UCS-2 characters,
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
307 otherwise plain SMS will be sent whether -c is given or not -
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
308 but the -c option enables the possibility of sending
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
309 concatenated SMS.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
310
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
311 -C refno Enables concatenated SMS like -c, but also explicitly sets the
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
312 concatenated SMS reference number to be used. The number can
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
313 be either decimal or hexadecimal with 0x prefix.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
314
969
8cf7d41f2821 doc/User-phone-tools: document -e addition to fcup-smsend[mult]
Mychaela Falconia <falcon@freecalypso.org>
parents: 805
diff changeset
315 -e Allow message body input to use the same backslash escape
8cf7d41f2821 doc/User-phone-tools: document -e addition to fcup-smsend[mult]
Mychaela Falconia <falcon@freecalypso.org>
parents: 805
diff changeset
316 sequences that are emitted by sms-pdu-decode, described earlier
8cf7d41f2821 doc/User-phone-tools: document -e addition to fcup-smsend[mult]
Mychaela Falconia <falcon@freecalypso.org>
parents: 805
diff changeset
317 in this document. Without this option, any backslash characters
8cf7d41f2821 doc/User-phone-tools: document -e addition to fcup-smsend[mult]
Mychaela Falconia <falcon@freecalypso.org>
parents: 805
diff changeset
318 present in the message body input are interpreted literally; to
8cf7d41f2821 doc/User-phone-tools: document -e addition to fcup-smsend[mult]
Mychaela Falconia <falcon@freecalypso.org>
parents: 805
diff changeset
319 embed a literal backslash with -e, enter it as \\.
8cf7d41f2821 doc/User-phone-tools: document -e addition to fcup-smsend[mult]
Mychaela Falconia <falcon@freecalypso.org>
parents: 805
diff changeset
320
388
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
321 -q Concatenated SMS quiet mode. If -c is given without -q, the
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
322 tool prints a message on stdout indicating whether the message
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
323 was sent as single or concatenated, and in how many parts.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
324 -q suppresses this additional output.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
325
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
326 -t Use text mode instead of PDU mode on the AT command interface.
969
8cf7d41f2821 doc/User-phone-tools: document -e addition to fcup-smsend[mult]
Mychaela Falconia <falcon@freecalypso.org>
parents: 805
diff changeset
327 This option is incompatible with -c, with -e and with -U; it
8cf7d41f2821 doc/User-phone-tools: document -e addition to fcup-smsend[mult]
Mychaela Falconia <falcon@freecalypso.org>
parents: 805
diff changeset
328 also introduces some other restrictions listed above.
388
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
329
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
330 -u By default, if the message body input contains any 8-bit
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
331 characters, they are interpreted as ISO 8859-1. With -u they
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
332 are interpreted as UTF-8 instead. This option is only relevant
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
333 for GSM7 output encoding, and it is implemented by converting
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
334 the input first from UTF-8 to 8859-1, and then from 8859-1 to
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
335 GSM7 - thus all UTF-8 input characters must fall into the
969
8cf7d41f2821 doc/User-phone-tools: document -e addition to fcup-smsend[mult]
Mychaela Falconia <falcon@freecalypso.org>
parents: 805
diff changeset
336 8859-1 repertoire, and the only way to send GSM7-encoded
8cf7d41f2821 doc/User-phone-tools: document -e addition to fcup-smsend[mult]
Mychaela Falconia <falcon@freecalypso.org>
parents: 805
diff changeset
337 messages containing the few Greek letters or the Euro currency
8cf7d41f2821 doc/User-phone-tools: document -e addition to fcup-smsend[mult]
Mychaela Falconia <falcon@freecalypso.org>
parents: 805
diff changeset
338 symbol allowed by GSM 03.38 encoding is to use backslash escapes
8cf7d41f2821 doc/User-phone-tools: document -e addition to fcup-smsend[mult]
Mychaela Falconia <falcon@freecalypso.org>
parents: 805
diff changeset
339 with -e.
388
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
340
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
341 -U Send message in UCS-2 encoding instead of GSM7. Any 8-bit
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
342 characters in the message body input are interpreted as UTF-8,
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
343 and the entire Basic Multilingual Plane of Unicode is allowed.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
344
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
345 -w By default the outgoing message is sent out on the GSM network
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
346 with the AT+CMGS command. With this -w option, the message is
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
347 first written into SIM or future ME SMS storage with AT+CMGW,
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
348 then sent out on the GSM network with AT+CMSS.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
349
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
350 -W Write only, not send: the message is written into storage with
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
351 AT+CMGW and no further action is taken. The modem's +CMGW:
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
352 responses with message storage indices are forwarded to stdout.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
353 With this option the destination address argument can be a null
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
354 string or omitted altogether.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
355
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
356 Concatenated SMS reference numbers
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
357 ----------------------------------
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
358
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
359 Every concatenated SMS transmission needs a reference number, and this number
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
360 needs to increment from one concatenated SMS to the next, to help message
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
361 recipients sort out which is which. If the reference number is not given
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
362 explicitly with -C, fcup-smsend creates (opens with O_RDWR|O_CREAT) a file
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
363 named .concat_sms_refno in the invoking user's $HOME directory; automatically
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
364 incrementing reference numbers are maintained in this file. The initial seed
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
365 is an XOR of all bytes of the current time returned by gettimeofday(2),
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
366 followed by simple linear incrementing; these reference numbers do not need to
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
367 be random in any kind of cryptographically secure sense.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
368
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
369 fcup-smsendmult
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
370 ===============
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
371
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
372 As an alternative to sending concatenated SMS, one can use the fcup-smsendmult
969
8cf7d41f2821 doc/User-phone-tools: document -e addition to fcup-smsend[mult]
Mychaela Falconia <falcon@freecalypso.org>
parents: 805
diff changeset
373 utility to send several single (no UDH) messages in one batch. This utility
388
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
374 supports both text and PDU modes (PDU mode is still the preferred default when
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
375 it can be used), and when PDU mode is used, it supports both GSM7 and UCS-2
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
376 output encodings just like fcup-smsend. The messages to be sent are read from
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
377 stdin, and each input line produces a new message.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
378
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
379 The entire batch of messages can be sent to a single recipient, or each message
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
380 in the batch can have its own individual destination address. If the
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
381 destination address is given on the command line, each input line read from
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
382 stdin is just a message body; if no destination address is given on the command
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
383 line, each input line must have the following format:
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
384
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
385 <dest addr><white space><message body>
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
386
969
8cf7d41f2821 doc/User-phone-tools: document -e addition to fcup-smsend[mult]
Mychaela Falconia <falcon@freecalypso.org>
parents: 805
diff changeset
387 -e, -t, -u, -U, -w and -W command line options are unchanged from fcup-smsend.
388
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
388
450
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
389 This fcup-smsendmult method of sending batched SMS was originally envisioned as
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
390 an alternative to concatenated SMS for crippled hw targets that couldn't support
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
391 sending SMS in PDU mode, but that limitation has now been lifted. Because we
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
392 do not remove already-implemented functionality for no good reason, the tool
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
393 currently remains in search of new potential use cases.
388
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
394
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
395 fcup-smsendpdu
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
396 ==============
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
397
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
398 This utility sends out SMS PDUs that have been prepared externally; it only
450
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
399 works in PDU mode - originally it was limited to high-end FreeCalypso hardware
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
400 with a full AT command interface, but now we've got PDU mode working on all
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
401 targets. The PDUs to be sent out are read from stdin, one long hex string PDU
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
402 per line; one can send either a single message or a batch. Because the
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
403 destination address and all content details are encoded in the PDU, the tool
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
404 does not care if the messages are going to the same recipient or to different
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
405 recipients, nor does it care if they constitute a concatenated SMS transmission
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
406 or not. -w and -W options work the same way as in fcup-smsend and
b5235f8240b9 doc/User-phone-tools: update for SMS PDU mode working on all targets
Mychaela Falconia <falcon@freecalypso.org>
parents: 449
diff changeset
407 fcup-smsendmult.
388
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
408
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
409 fcup-smwrite
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
410 ============
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
411
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
412 This utility is a debug and development tool; it differs from fcup-smsendpdu in
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
413 the following ways:
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
414
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
415 * fcup-smsendpdu can send messages out with AT+CMGS, write them into memory
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
416 with AT+CMGW, or do a write-then-send sequence (-w option) with AT+CMGW
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
417 followed by AT+CMSS. fcup-smwrite only issues AT+CMGW commands.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
418
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
419 * fcup-smwrite passes a second argument to AT+CMGW that sets the message state
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
420 to any of the possible 4 values; fcup-smsend* -W put them in the "stored
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
421 unsent" state.
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
422
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
423 * The input to fcup-smsendpdu is just PDU hex strings; the input to
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
424 fcup-smwrite needs to have the same format as fcup-smdump output in order to
3d45660f78f0 doc/User-phone-tools article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
425 indicate what state each message should be written in.