nsdsp_debug_enable_write

Cart Contact NSDSP Home

Northern Software NSDSP Programmer Interface Library C Interface Reference Debug Session Object nsdsp_debug_get_info nsdsp_debug_get_slave_info nsdsp_debug_run 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_reg

nsdsp_debug_enable_write_bp

This function enables a write breakpoint.

Syntax

int nsdsp_debug_enable_write_bp(
        nsdsp_session_t   session,
        int               bp,
        unsigned int      addr,
        unsigned int      value,
        unsigned int      count,
        unsigned int      flags
);

Parameters

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

bp - the id of a hardware breakpoint

addr - the data memory address. Writing from this address should halt the target

value - a specific value. NSDSP_BP_USE_VALUE flag is set, the breakpoint will halt the target only if the value written to memory matches the specified value.

count - the counter. If specified, the breakpoint must be triggered the specified number of times before the halt occurs. If not used, specify zero.

flags - a combination of the following flags:

Flag	Constant	Meaning
0x00000000	NSDSP_BP_DATA_SPACE	The breakpoint address refers to data space
0x00000010	NSDSP_BP_PROG_SPACE	PIC24 and dsPIC33 only: The breakpoint address refers to program space
0x00000020	NSDSP_BP_Y_SPACE	dsPIC33 only: The breakpoint address refers to Y space
0x00000000	NSDSP_BP_ANY_SIZE	The breakpoint does not depend on the size of the accesses
0x00000100	NSDSP_BP_8	Only 8-bit memory accesses trigger the breakpoint
0x00000200	NSDSP_BP_16	Only 16-bit memory accesses trigger the breakpoint
0x00000400	NSDSP_BP_32	Only 32-bit memory accesses trigger the breakpoint
0x00000800	NSDSP_BP_USE_VALUE	the breakpoint will trigger only if the value written to memory matches the specified value

Return

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

Notes

Not all breakpoints support halt on write. Not all breakpoints support counters. Not all breakpoints support various flags. To check breakpoint capabilities, use mcu_bp_class_cap function.

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.

Minimum library version - 163

Northern Software Home NSDSP Contact Us Purchase/View Cart