284 Chapter 12
Scan tools
do_reset
do_reset
do_reset performs one of four levels of reset on a node or complex. The
first argument is either a node ID, complex, or the keyword, all, which
resets all nodes. If no nodes are specified, the default is to reset all nodes
in contact with the teststation. If a node number is specified, the level
argument must be specified as well.
The second argument specified is the level of reset. All levels of reset are
expressed as numbers. If no level is specified then a “reset” level of 1 is
assumed.
The following reset levels are available:
1. JTAG controller SCUB reset, hard reset, clear options bits, and send
messages to ccmd
2. JTAG controller SCUB reset and system soft reset
3. JTAG controller SCUB reset
4. TOC reset
do_reset halts any scan activity taking place on the nodes. Larger
systems require more time to reset. Reset continues after this command
returns.
If the reset completes normally, do_reset returns zero. If the operation
cannot be completed, do_reset returns a nonzero exit code.
If clocks are not stopped, then do_reset may also change the boot
option after the reset. The boot options are as follows:
• OBP
• post_interactive
• spsdv
• tc_standalone
• tc_interactive
• loader
