FreeCalypso > hg > freecalypso-tools

comparison doc/User-phone-tools @ 449:b1864e3f8fb4

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
CHANGES & doc/User-phone-tools: documented AT-over-RVT long strings extension and the current broken state found in Mot C139 testing
author Mychaela Falconia <falcon@freecalypso.org>
date Wed, 16 Jan 2019 01:21:29 +0000
parents 3d45660f78f0
children b5235f8240b9
comparison
equal deleted inserted replaced
448:261c1b6d936e 449:b1864e3f8fb4
68 the project is to build our own end user phone handset (a Libre Dumbphone) 68 the project is to build our own end user phone handset (a Libre Dumbphone)
69 that will also provide a full-featured AT command interface on its USB port 69 that will also provide a full-featured AT command interface on its USB port
70 via a built-in CP2102 or FT232R chip. 70 via a built-in CP2102 or FT232R chip.
71 71
72 * As a dirty hack, one can run FreeCalypso GSM fw on some alien hw targets, 72 * As a dirty hack, one can run FreeCalypso GSM fw on some alien hw targets,
73 currently Motorola C139 and Pirelli DP-L10. In this hacked-up configuration 73 currently Motorola C1xx and Pirelli DP-L10. In this hacked-up configuration
74 there is no dedicated UART available for a standard AT command interface, but 74 there is no dedicated UART available for a standard AT command interface, but
75 there is a hack that allows a limited subset of AT commands to be passed over 75 there is a hack that allows a limited subset of AT commands to be passed over
76 the RVTMUX binary packet interface provided by the running FreeCalypso GSM fw. 76 the RVTMUX binary packet interface provided by the running FreeCalypso GSM fw.
77 Our fcup-* tools can work with such targets to a limited extent. 77 Our fcup-* tools can work with such targets to a limited extent.
78 78
79 The AT-over-RVTMUX mechanism was originally invented back in 2015 as a 79 The AT-over-RVTMUX mechanism was originally invented back in 2015 as a
80 development aid, and was never intended for production use or to support any 80 development aid, and was never intended for production use or to support any
81 kind of end user functionality. One of its limitations is that the strings 81 kind of end user functionality. One of the limitations of its original
82 that are sent to ATI via this interface are limited to 254 characters, whereas 82 incarnation was that the strings that are sent to ATI via this interface were
83 sending or writing SMS in hex format requires longer strings. As a result, SMS 83 limited to 254 characters, whereas sending or writing SMS in hex format
84 sending and writing functionality via fcup-smsend* is limited when a crippled 84 requires longer strings. As of early 2019, this limitation has been lifted:
85 Motorola or Pirelli hw target is used instead of proper FreeCalypso hardware. 85 our Magnetite and Selenite firmwares from 20190109 onward support an extended
86 version of our AT-over-RVTMUX hack that allows longer strings to be sent in
87 pieces, and the present version of our FC User Phone Tools suite will send the
88 strings it generates via this extended mechanism whenever they exceed the old
89 254 character limit. However, please be aware that FC firmware for Mot C1xx
90 phones is still a purely unsupported offering for the sake of the community, it
91 is NOT our main project direction, and this fw configuration does *not* receive
92 the same level of development support and testing as our FCDEV3B modem product.
93 A test of SMS sending functionality via the newly extended AT-over-RVTMUX
94 interface on a Mot C139 phone using our current (as of this writing) 20190109
95 firmware revealed that something is still broken, and we do not currently have
96 a business case to justify allocating more developer time to investigate those
97 issues. In contrast, our FCDEV3B modem running our current 20190112 firmware
98 is rock solid, and all SMS functions work flawlessly going through the standard
99 AT command interface on the dedicated UART.
86 100
87 All fcup-* tools take the following common command line options for selecting 101 All fcup-* tools take the following common command line options for selecting
88 the AT command target interface: 102 the AT command target interface:
89 103
90 -B baud Valid only when -p is also given; selects a different baud rate 104 -B baud Valid only when -p is also given; selects a different baud rate
207 unpacked septets. 221 unpacked septets.
208 222
209 Composing and sending outgoing SMS 223 Composing and sending outgoing SMS
210 ================================== 224 ==================================
211 225
226 [2019 update: this section has not yet been updated for the new reality that
227 sending maximum-length SMS in PDU mode over RVTMUX is now possible, but please
228 see the earlier notes about this functionality still not working quite right
229 when tested on a Mot C139 phone. Until further updates, please stick to using
230 PDU mode over the classic AT command channel over the dedicated UART on
231 FCDEV3B hardware.]
232
212 When used with a FreeCalypso GSM device that offers the full AT command 233 When used with a FreeCalypso GSM device that offers the full AT command
213 interface (currently only the FCDEV3B modem), the primary SMS sending/writing 234 interface (currently only the FCDEV3B modem), the primary SMS sending/writing
214 tool fcup-smsend offers the following capabilities: 235 tool fcup-smsend offers the following capabilities:
215 236
216 * Sending outgoing messages in either GSM7 or UCS-2 encoding; 237 * Sending outgoing messages in either GSM7 or UCS-2 encoding;