FreeCalypso > hg > freecalypso-tools
diff doc/User-phone-tools @ 969:8cf7d41f2821
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 |
line wrap: on
line diff
--- 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 @@ <dest addr><white space><message body> --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