comparison rvinterf/asyncshell/helpfile @ 452:688380565e0f

rvinterf/asyncshell/helpfile: unterm addition documented
author Mychaela Falconia <falcon@freecalypso.org>
date Fri, 08 Feb 2019 02:14:53 +0000
parents 5e91b1c107eb
children fa6fee41f06e
comparison
equal deleted inserted replaced
451:10f4062e049b 452:688380565e0f
15 sp Send GPF system primitive to the target 15 sp Send GPF system primitive to the target
16 str Send arbitrary strings to ATI 16 str Send arbitrary strings to ATI
17 tch TCH commands, see help tch 17 tch TCH commands, see help tch
18 tch-dl Enable/disable TCH downlink forwarding on the target 18 tch-dl Enable/disable TCH downlink forwarding on the target
19 tgtreset Send reset/reboot ETM command packet to the target 19 tgtreset Send reset/reboot ETM command packet to the target
20 unterm Send unterminated strings to ATI
20 21
21 To get help on any command, type help and the command keyword. 22 To get help on any command, type help and the command keyword.
22 23
23 === at 24 === at
24 === AT 25 === AT
170 but it is available nonetheless. 171 but it is available nonetheless.
171 172
172 === tgtreset 173 === tgtreset
173 This command sends a reset/reboot request ETM command packet to the target. 174 This command sends a reset/reboot request ETM command packet to the target.
174 175
176 === unterm
177 unterm <arbitrary text>
178
179 This command sends everything after the unterm command keyword to the AT command
180 interpreter (ATI) in the target firmware via the FreeCalypso-defined "AT"
181 RVTMUX channel. Unlike the more classic str command, strings sent with unterm
182 are marked as unterminated, meaning that the receiving code in ATI will not
183 automatically add the usual terminating CR or ^Z at the end, and will instead
184 wait for a continuation. This mechanism allows long command or message strings
185 to be sent in pieces, with the first and any intermediate pieces sent as unterm
186 and the last piece sent with str, causing the entire string to be acted upon.
187 This unterm extension to the AT-over-RVTMUX mechanism was added to our Magnetite
188 and Selenite firmwares in early 2019, allowing this mechanism to be used for
189 sending and writing SMS in PDU mode, which requires longer strings than the
190 maximum that can be sent in one piece over RVTMUX.
191
192 Any time you send anything to ATI, fc-shell automatically performs the
193 equivalent of an enable ati command so you can see ATI's responses; any
194 asynchronous output from ATI is also enabled as a side effect.
195