halt - Halt program execution by processor

Syntax

IDEs

This function supports the following IDEs:

• Analog Devices VisualDSP++

• Eclipse IDE

• Green Hills MULTI

• Texas Instruments Code Composer Studio v3

Description

IDE_Obj.halt stops the program running on the processor. After you issue this command, MATLAB waits for a response from the processor that the processor has stopped. By default, the wait time is 10 seconds. If 10 seconds elapses before the response arrives, MATLAB returns an error. In this syntax, the timeout period defaults to the global timeout period specified in IDE_Obj. Use IDE_Obj.get to determine the global timeout period. However, the processor usually stops in spite of the error message.

To resume processing after you halt the processor, use run. Also, the IDE_Obj.read('pc') function can determine the memory address where the processor stopped after you use halt.

IDE_Obj.halt(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 processor to stop running. If the processor does not stop within the specified timeout period, the routine returns with a timeout error.

Examples

Use one of the provided demonstration programs to show how halt works. Load and run one of the demonstration projects. At the MATLAB prompt, check whether the program is running on the processor.

IDE_Obj.isrunning

ans =

     1

IDE_Obj.isrunning % Alternate syntax for checking the run status.

ans =

     1
IDE_Obj.halt % Stop the running application on the processor.
IDE_Obj.isrunning

ans =

     0

Issuing the halt stops the process on the processor. Checking in the IDE confirms that the process has stopped.

See Also

isrunning | reset | run

© 1984-2012- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS