User`s guide

run
state String Run Action
'tofunc'
Run the program from the current position of
the program counter to the start of a specied
function
functionname.
'tohalt'
Changes the state of a running process to
runtohalt, and wa its for the p rocess or to halt
before returning. Use this when you want to
stop a running process cleanly. If the processor
is already stopped when you use this state
setting,
run returns immediately.
To allow you to specify how long run waits f or the processor to start
executing the loaded program before returning, the input argument
timeout lets you set the waiting period in seconds.
After you use
run, the routine returns after conrming that the program
started to execute, or after
timeout seconds elapses, whichever comes
rst. If the timeout period expires,
run returns a timeout error.
run(cc,'main') resets the program counter in your project then runs
the program linked to
cc until the counter reaches the start of main.
run(cc,'tofunc','functionname') runs the program from the
current position of the program counter until the counter reaches the
function
functionname.Comparethistorun(cc,'main') which resets
the program counter before executing the program. Using the
tofunc
option does not reset the program counter.
Using run with Multiprocessor Boards
When yo ur board contains m ore than one processor, run calls the
program running function for each processor represented by
cc, running
the program loaded on each processor.
Thisisthesameascalling
run for each p rocessor individually through
ticcs objects for each one. The other informationaboutrunonasingle
processor applies to each processor in the multiple processor cases.
7-142