FreeCalypso > hg > freecalypso-tools

comparison doc/Target-utils @ 787:ae237e4e8d9b

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
doc/Target-utils: simagent addition documented
author Mychaela Falconia <falcon@freecalypso.org>
date Sat, 13 Mar 2021 23:27:58 +0000
parents 72feb9763de4
children
comparison
equal deleted inserted replaced
786:b761029f9c03 787:ae237e4e8d9b
20 dspdump Calypso DSP ROM dump tool 20 dspdump Calypso DSP ROM dump tool
21 helloapp Hello-world program 21 helloapp Hello-world program
22 loadagent Flash manipulation and XRAM loading agent 22 loadagent Flash manipulation and XRAM loading agent
23 lunadrv Driver for FreeCalypso Luna LCD 23 lunadrv Driver for FreeCalypso Luna LCD
24 pirexplore Pirelli DP-L10 hardware exploration program 24 pirexplore Pirelli DP-L10 hardware exploration program
25 simtest Low-level exerciser for the SIM interface hardware 25 simagent SIM interface agent to be used by fc-simint and fc-simtool
26 simtest Previous low-level exerciser for the SIM interface hardware
26 27
27 Aside from c139explore which is built as a binary to be loaded via fc-compalram 28 Aside from c139explore which is built as a binary to be loaded via fc-compalram
28 (Compal's bootloader protocol), all of the above programs are built as S-record 29 (Compal's bootloader protocol), all of the above programs are built as S-record
29 images to be loaded via fc-iram. Once loaded via the respective serial code 30 images to be loaded via fc-iram. Once loaded via the respective serial code
30 download protocol, each of the listed programs runs interactively, listening 31 download protocol, each of the listed programs runs interactively, listening
168 to be able to perform a soft poweroff operation, i.e., to return the Calypso 169 to be able to perform a soft poweroff operation, i.e., to return the Calypso
169 phone or modem to its switched-off state after flashing or various standalone 170 phone or modem to its switched-off state after flashing or various standalone
170 debug operations, but once implemented, this same ABB SPI communication 171 debug operations, but once implemented, this same ABB SPI communication
171 infrastructure is also used in model-specific hardware exploration utilities 172 infrastructure is also used in model-specific hardware exploration utilities
172 for functions like keypad backlight and vibrator control which are implemented 173 for functions like keypad backlight and vibrator control which are implemented
173 via the ABB on some models, and it is used in simtest to control the part of 174 via the ABB on some models, and it is used in simagent and simtest to control
174 the SIM interface that resides in the Iota ABB. 175 the part of the SIM interface that resides in the Iota ABB.
175 176
176 Aside from specialized programs like c139explore that are specific to target 177 Aside from specialized programs like c139explore that are specific to target
177 devices known to use the Iota ABB, most target-utils programs do not execute 178 devices known to use the Iota ABB, most target-utils programs do not execute
178 any ABB or SPI communication code (not even initialization) until they receive 179 any ABB or SPI communication code (not even initialization) until they receive
179 one of the ABB commands: abbinit, abbr, abbw or poweroff. This way if someone 180 one of the ABB commands: abbinit, abbr, abbw or poweroff. This way if someone
180 comes across a Calypso device that has a different ABB type or needs to debug a 181 comes across a Calypso device that has a different ABB type or needs to debug a
181 board with broken ABB communication, one can explore other functions without 182 board with broken ABB communication, one can explore other functions without
182 touching ABB commands. (simtest is another exception: even though it is not 183 touching ABB commands. (simagent and simtest constitute another exception:
183 specific to one particular target device like c139explore, its main function of 184 even though these programs aren't specific to one particular target device like
184 exercising the SIM interface depends on the Iota ABB, thus it is restricted to 185 c139explore, their main function of exercising the SIM interface depends on the
185 Calypso+Iota targets.) 186 Iota ABB, thus they are restricted to Calypso+Iota targets.)
186 187
187 The abb_init() function invoked by the abbinit command may be invoked multiple 188 The abb_init() function invoked by the abbinit command may be invoked multiple
188 times: it maintains an internal flag remembering if the initialization steps 189 times: it maintains an internal flag remembering if the initialization steps
189 have already been done or not, and repeated invokations do nothing. User- 190 have already been done or not, and repeated invokations do nothing. User-
190 friendly abbr, abbw and poweroff commands invoke abb_init() internally, but the 191 friendly abbr, abbw and poweroff commands invoke abb_init() internally, but the