# HG changeset patch # User Mychaela Falconia # Date 1693593474 0 # Node ID 8cf7d41f282178486ab5a5e4ace65e763dcdd793 # Parent ec736c59845c1f9653cc6e67873672bd55316c47 doc/User-phone-tools: document -e addition to fcup-smsend[mult] diff -r ec736c59845c -r 8cf7d41f2821 doc/User-phone-tools --- a/doc/User-phone-tools Fri Sep 01 17:32:54 2023 +0000 +++ b/doc/User-phone-tools Fri Sep 01 18:37:54 2023 +0000 @@ -312,14 +312,20 @@ concatenated SMS reference number to be used. The number can be either decimal or hexadecimal with 0x prefix. +-e Allow message body input to use the same backslash escape + sequences that are emitted by sms-pdu-decode, described earlier + in this document. Without this option, any backslash characters + present in the message body input are interpreted literally; to + embed a literal backslash with -e, enter it as \\. + -q Concatenated SMS quiet mode. If -c is given without -q, the tool prints a message on stdout indicating whether the message was sent as single or concatenated, and in how many parts. -q suppresses this additional output. -t Use text mode instead of PDU mode on the AT command interface. - This option is incompatible with -c and with -U, and introduces - other restrictions listed above. + This option is incompatible with -c, with -e and with -U; it + also introduces some other restrictions listed above. -u By default, if the message body input contains any 8-bit characters, they are interpreted as ISO 8859-1. With -u they @@ -327,9 +333,10 @@ for GSM7 output encoding, and it is implemented by converting the input first from UTF-8 to 8859-1, and then from 8859-1 to GSM7 - thus all UTF-8 input characters must fall into the - 8859-1 repertoire, and it is not currently possible to send - GSM7-encoded messages containing the few Greek letters or the - Euro currency symbol allowed by GSM 03.38 encoding. + 8859-1 repertoire, and the only way to send GSM7-encoded + messages containing the few Greek letters or the Euro currency + symbol allowed by GSM 03.38 encoding is to use backslash escapes + with -e. -U Send message in UCS-2 encoding instead of GSM7. Any 8-bit characters in the message body input are interpreted as UTF-8, @@ -363,7 +370,7 @@ =============== As an alternative to sending concatenated SMS, one can use the fcup-smsendmult -utility to send several single (no UDH) messages in one batch. This utlity +utility to send several single (no UDH) messages in one batch. This utility supports both text and PDU modes (PDU mode is still the preferred default when it can be used), and when PDU mode is used, it supports both GSM7 and UCS-2 output encodings just like fcup-smsend. The messages to be sent are read from @@ -377,7 +384,7 @@ --t, -u, -U, -w and -W command line options are unchanged from fcup-smsend. +-e, -t, -u, -U, -w and -W command line options are unchanged from fcup-smsend. This fcup-smsendmult method of sending batched SMS was originally envisioned as an alternative to concatenated SMS for crippled hw targets that couldn't support