nsdsp_debug_single_step
nsdsp_debug_multi_step nsdsp_debug_request_halt nsdsp_debug_check_for_halt nsdsp_debug_wait_for_halt nsdsp_debug_get_pc nsdsp_debug_get_soft_bp nsdsp_debug_is_partitioned nsdsp_debug_can_swap nsdsp_debug_is_swapped nsdsp_debug_is_boot_swapped nsdsp_debug_get_flash_word nsdsp_debug_check_for_app nsdsp_debug_get_app_word nsdsp_debug_enable_exec_bp nsdsp_debug_enable_read_bp nsdsp_debug_enable_write_bp nsdsp_debug_disable_bp nsdsp_debug_enable_soft_bp nsdsp_debug_disable_soft_bp nsdsp_debug_read_ram nsdsp_debug_read_rom nsdsp_debug_read_reg nsdsp_debug_read_bp_state nsdsp_debug_read_cp0 nsdsp_debug_read_stack nsdsp_debug_check_for_data nsdsp_debug_wait_for_data nsdsp_debug_fetch_data nsdsp_debug_fetch_data_nb nsdsp_debug_fetch_word nsdsp_debug_fetch_flash_word nsdsp_debug_fetch_float nsdsp_debug_fetch_double nsdsp_debug_fetch_stack nsdsp_debug_fetch_bp_state nsdsp_debug_write_ram nsdsp_debug_write_reg nsdsp_debug_write_float_reg nsdsp_debug_write_double_regnsdsp_debug_single_step
This function executes a single target instruction and halts.
Syntax
int nsdsp_debug_single_step(
nsdsp_session_t session
);
Parameters
session - a reference to the Debug Session Object obtained with nsdsp_session_program_for_debug or nsdsp_start_debug_session function
Return
The function returns non-zero if the single step command has been succesfully queued, or zero otherwise
Notes
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 instruction only queues a command. The command will be sent to NSDSP when you queue enough commands to fill the buffer or when you call nsdsp_session_flush.
Even though single step executes only a single instruction and returns very fast, it must be treated as a regular run. After executing the single step, you need to wait for halt. If you want to execute several steps at a time, consider nsdsp_debug_multi_step function.
Minimum library version - 163
© 2007-2025 Northern Software Inc. All Rights Reserved.