C Interface Reference

The NSDSP Interface Library is language independent. Here, the functions exported from the library are described in terms of C language.

If you want to use the library in C, you must include the "nsdspif.h" file:

#include "nsdspif.h"

Calling conventions

On Windows, stdcall (WINAPI) calling conventions are used.

On other platforms, C calling conventions are used

Character set

On Windows, the functions dealing with strings are exported in two versions, one with _a suffix for ASCII and another with _w suffix for Unicode. If UNICODE is defined, the "nsdspif.h" will map function names to Unicode, otherwise it will use ASCII. The char* type is corrected to LPSTR/LPCSTR or LPWSTR/LPCWSTR accordingly.

On other platforms, only ASCII functions are provided. If you need to convert to or from Unicode string, always use UTF-8 encoding.

Objects

The objects are referenced by variables of special types. These types are pointers to opaque structures. All these types are defined in "nsdspif.h". For example the nsdsp_session_t references the Session object and is defined as follows:

typedef struct nsdsp_session *nsdsp_session_t;

The objects themselves are hosted within the library. For the majority of functions, the reference to the object is passed as a first parameter.

The functions are grouped by categories depending on the object they operate upon.

General Functions

Hex Map Object

Hex Block Structure

MCU Object

NSDSP List Object

NSDSP Object

Session Object

Debug Session Object

Debug Info Object