FreeCalypso > hg > freecalypso-tools

comparison doc/User-phone-tools @ 969:8cf7d41f2821

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
doc/User-phone-tools: document -e addition to fcup-smsend[mult]
author Mychaela Falconia <falcon@freecalypso.org>
date Fri, 01 Sep 2023 18:37:54 +0000
parents a43c5dc251dc
children
comparison
equal deleted inserted replaced
968:ec736c59845c 969:8cf7d41f2821
310 310
311 -C refno Enables concatenated SMS like -c, but also explicitly sets the 311 -C refno Enables concatenated SMS like -c, but also explicitly sets the
312 concatenated SMS reference number to be used. The number can 312 concatenated SMS reference number to be used. The number can
313 be either decimal or hexadecimal with 0x prefix. 313 be either decimal or hexadecimal with 0x prefix.
314 314
315 -e Allow message body input to use the same backslash escape
316 sequences that are emitted by sms-pdu-decode, described earlier
317 in this document. Without this option, any backslash characters
318 present in the message body input are interpreted literally; to
319 embed a literal backslash with -e, enter it as \\.
320
315 -q Concatenated SMS quiet mode. If -c is given without -q, the 321 -q Concatenated SMS quiet mode. If -c is given without -q, the
316 tool prints a message on stdout indicating whether the message 322 tool prints a message on stdout indicating whether the message
317 was sent as single or concatenated, and in how many parts. 323 was sent as single or concatenated, and in how many parts.
318 -q suppresses this additional output. 324 -q suppresses this additional output.
319 325
320 -t Use text mode instead of PDU mode on the AT command interface. 326 -t Use text mode instead of PDU mode on the AT command interface.
321 This option is incompatible with -c and with -U, and introduces 327 This option is incompatible with -c, with -e and with -U; it
322 other restrictions listed above. 328 also introduces some other restrictions listed above.
323 329
324 -u By default, if the message body input contains any 8-bit 330 -u By default, if the message body input contains any 8-bit
325 characters, they are interpreted as ISO 8859-1. With -u they 331 characters, they are interpreted as ISO 8859-1. With -u they
326 are interpreted as UTF-8 instead. This option is only relevant 332 are interpreted as UTF-8 instead. This option is only relevant
327 for GSM7 output encoding, and it is implemented by converting 333 for GSM7 output encoding, and it is implemented by converting
328 the input first from UTF-8 to 8859-1, and then from 8859-1 to 334 the input first from UTF-8 to 8859-1, and then from 8859-1 to
329 GSM7 - thus all UTF-8 input characters must fall into the 335 GSM7 - thus all UTF-8 input characters must fall into the
330 8859-1 repertoire, and it is not currently possible to send 336 8859-1 repertoire, and the only way to send GSM7-encoded
331 GSM7-encoded messages containing the few Greek letters or the 337 messages containing the few Greek letters or the Euro currency
332 Euro currency symbol allowed by GSM 03.38 encoding. 338 symbol allowed by GSM 03.38 encoding is to use backslash escapes
339 with -e.
333 340
334 -U Send message in UCS-2 encoding instead of GSM7. Any 8-bit 341 -U Send message in UCS-2 encoding instead of GSM7. Any 8-bit
335 characters in the message body input are interpreted as UTF-8, 342 characters in the message body input are interpreted as UTF-8,
336 and the entire Basic Multilingual Plane of Unicode is allowed. 343 and the entire Basic Multilingual Plane of Unicode is allowed.
337 344
361 368
362 fcup-smsendmult 369 fcup-smsendmult
363 =============== 370 ===============
364 371
365 As an alternative to sending concatenated SMS, one can use the fcup-smsendmult 372 As an alternative to sending concatenated SMS, one can use the fcup-smsendmult
366 utility to send several single (no UDH) messages in one batch. This utlity 373 utility to send several single (no UDH) messages in one batch. This utility
367 supports both text and PDU modes (PDU mode is still the preferred default when 374 supports both text and PDU modes (PDU mode is still the preferred default when
368 it can be used), and when PDU mode is used, it supports both GSM7 and UCS-2 375 it can be used), and when PDU mode is used, it supports both GSM7 and UCS-2
369 output encodings just like fcup-smsend. The messages to be sent are read from 376 output encodings just like fcup-smsend. The messages to be sent are read from
370 stdin, and each input line produces a new message. 377 stdin, and each input line produces a new message.
371 378
375 stdin is just a message body; if no destination address is given on the command 382 stdin is just a message body; if no destination address is given on the command
376 line, each input line must have the following format: 383 line, each input line must have the following format:
377 384
378 <dest addr><white space><message body> 385 <dest addr><white space><message body>
379 386
380 -t, -u, -U, -w and -W command line options are unchanged from fcup-smsend. 387 -e, -t, -u, -U, -w and -W command line options are unchanged from fcup-smsend.
381 388
382 This fcup-smsendmult method of sending batched SMS was originally envisioned as 389 This fcup-smsendmult method of sending batched SMS was originally envisioned as
383 an alternative to concatenated SMS for crippled hw targets that couldn't support 390 an alternative to concatenated SMS for crippled hw targets that couldn't support
384 sending SMS in PDU mode, but that limitation has now been lifted. Because we 391 sending SMS in PDU mode, but that limitation has now been lifted. Because we
385 do not remove already-implemented functionality for no good reason, the tool 392 do not remove already-implemented functionality for no good reason, the tool