Cart Contact NSDSP Home

nsdsp_debug_read_reg

This function reads the content of a CPU register.

Syntax

unsigned int nsdsp_debug_read_reg(
        nsdsp_session_t   session,
        unsigned int      reg
);

Parameters

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

reg - one of the constants listed in the nsdspif.h file. These constants are device specific and are named according to the following table:

Target Device Constant Syntax
PIC12,PIC16REG_PIC16_XXXX
PIC18REG_PIC18_XXXX
PIC24,dsPIC33C,dsPIC33E,dsPIC33FREG_PIC24_XXXX
dsPIC33AREG_PIC33_XXXX
PIC32REG_PIC32_XXXX

where XXXX is the name of the register.

Return

The function returns the size of the register in bytes, or zero in case of error.

Notes

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.

Once the data arrives, you can retrieve the value of the register with nsdsp_debug_fetch_word function.

If you are retrieving floating point registers, instead of nsdsp_debug_fetch_word function, call nsdsp_debug_fetch_float or nsdsp_debug_fetch_double

 

Minimum library version - 163

Northern Software Home NSDSP Contact Us Purchase/View Cart

© 2007-2025 Northern Software Inc. All Rights Reserved.