comparison doc/Target-utils @ 532:0b04f9b30ea1

doc/Target-utils: documented auto-abbinit in simtest
author Mychaela Falconia <falcon@freecalypso.org>
date Tue, 18 Jun 2019 06:00:07 +0000
parents 30bec872824a
children bdaa4e7c9c05
comparison
equal deleted inserted replaced
531:d36c793d71db 532:0b04f9b30ea1
175 devices known to use the Iota ABB, most target-utils programs do not execute 175 devices known to use the Iota ABB, most target-utils programs do not execute
176 any ABB or SPI communication code (not even initialization) until they receive 176 any ABB or SPI communication code (not even initialization) until they receive
177 one of the ABB commands: abbinit, abbr, abbw or poweroff. This way if someone 177 one of the ABB commands: abbinit, abbr, abbw or poweroff. This way if someone
178 comes across a Calypso device that has a different ABB type or needs to debug a 178 comes across a Calypso device that has a different ABB type or needs to debug a
179 board with broken ABB communication, one can explore other functions without 179 board with broken ABB communication, one can explore other functions without
180 touching ABB commands. 180 touching ABB commands. (simtest is another exception: even though it is not
181 specific to one particular target device like c139explore, its main function of
182 exercising the SIM interface depends on the Iota ABB, thus it is restricted to
183 Calypso+Iota targets.)
181 184
182 The abb_init() function invoked by the abbinit command may be invoked multiple 185 The abb_init() function invoked by the abbinit command may be invoked multiple
183 times: it maintains an internal flag remembering if the initialization steps 186 times: it maintains an internal flag remembering if the initialization steps
184 have already been done or not, and repeated invokations do nothing. User- 187 have already been done or not, and repeated invokations do nothing. User-
185 friendly abbr, abbw and poweroff commands invoke abb_init() internally, but the 188 friendly abbr, abbw and poweroff commands invoke abb_init() internally, but the