MATLAB Link for Code Composer Studio Development Tools

halt

Terminate execution of a process running on the target

Syntax

• halt(cc,timeout)
  

Description

halt(cc,timeout) immediately stops program execution by the processor. After the processor stops, halt returns to the host. timeout defines, in seconds, how long the host waits for the target processor to stop running. To resume processing after you halt the processor, use run. Also, the read(cc,'pc') function can determine the memory address where the processor stopped after you use halt.

timeout defines the maximum time the routine waits for the processor to stop. If the processor does not stop within the specified timeout period, the routine returns with a timeout error.

halt(cc) immediately stops program execution by the processor. After the processor stops, halt returns to the host. In this syntax, the timeout period defaults to the global timeout period specified in cc. Use get(cc) to determine the global timeout period.

Examples

Use one of the provided demonstration programs to show how halt works. From the CCS IDE demonstration programs, load and run volume.out.

At the MATLAB prompt create a link to CCS IDE

• cc = ccsdsp
  

Check whether the program volume.out is running on the processor.

• isrunning(cc)
  
  ans =
  
       1
  
  cc.isrunning % Alternate syntax for checking the run status.
  
  ans =
  
       1
  halt(cc) % Stop the running application on the processor.
  isrunning(cc)
  
  ans =
  
       0
  

Issuing the halt stopped the process on the target. Checking in CCS IDE shows that the process has stopped.

See Also
ccsdsp, isrunning, run

goto

info