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_get_flash_word
This function returns a value of flash word that was programmed by nsdsp_session_program_for_debug function.
Syntax
unsigned int nsdsp_debug_get_flash_word(
nsdsp_session_t session,
unsigned int addr
);
Parameters
session - a reference to the Debug Session Object obtained with nsdsp_session_program_for_debug or nsdsp_start_debug_session function
addr - the address of the flash word. The address must be appropriately aligned:
| Target Device | Alignment Requirements |
|---|---|
| PIC12,PIC16 | none |
| PIC18 | 16-bit |
| PIC24,dsPIC33 | 16-bit |
| PIC32 | 32-bit |
Return
The function returns the flash word.
In PIC32, this function returns a 32-bit word from 4-byte aligned address. If PIC32 uses microMIPS, the instructions may be 2-byte or 4-byte long and are not aligned to 4-byte boundaries. Therefore, the word you retrieve may not represent a single instruction.
Notes
The value returned by this function may differ from the actual flash contents if the device has re-programmed flash through self-programming. To get actual flash value, use nsdsp_debug_read_rom and nsdsp_debug_fetch_flash_word functions. However, not all devices support reading flash.
Minimum library version - 163
© 2007-2025 Northern Software Inc. All Rights Reserved.