nsdsp_debug_multi_step

This function executes a specified number of single steps and halts.

Syntax

int nsdsp_debug_multi_step(
        nsdsp_session_t   session,
        unsigned int      count
);

Parameters

session - a reference to the Debug Session Object obtained with nsdsp_session_program_for_debug or nsdsp_start_debug_session function

count - the number of single steps to execute.

Return

The function returns non-zero if the run command has been succesfully queued, or zero otherwise

Notes

From the target device point of view, this function is equivalent to calling nsdsp_debug_single_step function several times, however it is more efficient and, on some devices, may be thousands times faster than executing single steps one by one.

From the debugger point of view, this function must be treated the same as nsdsp_debug_run function, except the target does not halt at breakpoints, but executes a specified number of steps.

On some of the devices, single step may execute multiple instructions. For example, in PIC32, the branch instruction and the instruction in the delay slot always execute together. This must be factored in when calculating the number of steps to run.

If the target device uses ordered halting the command queue will freeze until the device halts. If the target device uses unordered halting NSDSP will continue processing the command queue while the device runs.

Minimum library version - 163