User`s guide

restar t
Purpose Restore program counter to entry point for current program
Syntax restart(cc,timeout)
restart(cc)
Description restart(cc,timeout) halts the process or immediately and resets
the program counter (PC) to the program entry point for the loaded
program. Use
run to execute the program after you use restart.
restart does not execute the program after resetting the PC. timeout
allows you to specify how long restart waits for the processor to stop
and return the PC to the program entry p oint. Specify the value for
timeout in seconds. After you use restart, the restart routine returns
after resetting the PC or after
timeout seconds elapse, whichever comes
first. If the timeou t perio d expires ,
restart returns a timeout error.
restart(cc) halts the processor immediately and resets the PC to the
program entry point for the loaded program. U se
run to execute the
program after you use
restart. restart does not execute the program
after resetting the PC. When you o mit the
timeout argument, restart
uses the g lobal default timeout period defined in cc to determine how
long to wait for the processor to stop and the PC to be reset to the
program entry point.
Using restart with Multiprocessor Boards
When your board c ontains more than one processor, restart calls the
processor restarting function for e ach processo r represented by
cc,
restarting the program loaded on each processor.
This is the same as calling
restart for each processor individually
through
ticcs obje cts for each one.
Examples When y ou are d eve lo ping algorithms for your processor, restart
becomes a particularly useful function. Rather than resetting the
processor after each algorithm test, use the
restart function to return
the program counter to the program entry point. Because
restart
restores your local variables to their initial settings, but d oes not reset
the processor, you are ready to rerun your algorithm with new values.
7-139