FreeCalypso > hg > freecalypso-tools
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 |