NSDSP Object

NSDSP object represents a connection to an NSDSP programmer. The object is used as a passive storage for various settings. These settings are enacted only when you create an NSDSP Session object.

Type

typedef struct nsdsp *nsdsp_t;

nsdsp_t is an opaque reference to an NSDSP object. It is passed to all functions dealing with NSDSP objects.

Creation and Destruction

To create an NSDSP object call nsdsp_connect function. Do not connect multiple NSDSP objects to the same NSDSP programmer simultaneously.

When an NSDSP object is no longer needed, it must be freed using nsdsp_free function.

Getting Information

nsdsp_get_serial and nsdsp_get_version functions return information about one of the NSDSP programmer.

Adjusting Voltages

nsdsp_adjust_vdd and nsdsp_adjust_vpp allow adjusting voltages supplied by the NSDSP programmer if the programmer supports this functionality. The functions not only specify voltage settings. They connect to the programmer and block until the voltage level is set.

Specifying Settings

The settings below are used by Session objects. The settings do not affect the currently active Session objects, if any. Each setting affects only the sessions created after the setting was set.

nsdsp_set_rate function controls communication speeds and applies to all types of sessions.

The nsdsp_use_alt_mclr, nsdsp_use_method, nsdsp_ignore_eeprom, nsdsp_ignore_uid, nsdsp_allow_otp, nsdsp_config_jtag, nsdsp_config_debug, nsdsp_config_lvp, nsdsp_config_cksw, nsdsp_config_wdt, and nsdsp_reset_after_prog functions control programming sessions.

The nsdsp_set_debug_magic, nsdsp_set_debug_rom, nsdsp_set_debug_ram, and nsdsp_set_debug_cores functions control debugging sessions.

nsdsp_set_flow_control function enables flow control for UART sessions.

Starting Sessions

nsdsp_start_prog_session starts a programming session which can be used to run canned algorithms - program (for production or for debug), bulk erase, verification, and reading.

nsdsp_start_debug_session starts a debug session on a chip programmed for debug.

nsdsp_start_spi_session starts an SPI session which can be used for SPI and pin manipulation.

nsdsp_start_uart_session starts an UART session which can be used for UART communications on UART pins.

Only one session may be active at any time. Before starting a new session, you need to close the previous session by calling nsdsp_end_session function.