nsconf - Command Line NSDSP Configuration Utility

nsconf is a command line utility which configures NSDSP chip. If you have installed NSDSP chip on your board it will allow you to tune NSDSP behaviour to your needs. You can run it as a part of automated border programming/testing script.

You can use the following parameters

Parameter	Description
-s serial	Specifies the serial number of the NSDSP chip. This lets you select a particular NSDSP when several ones are connected. This parameter is optional. If not specified, NSDSP will be selected randomly. You can use nsenum to display the list of serial numbers of the NSDSPs connected to the computer.
-p	Prints the current NSDSP settings before changing them. If this is the only specified parameter, nsconf prints the settings and exits.
-cx [0,1,3]	Controls the state of the PGC pin when NSDSP is in Unconnected mode. 0 - Low, 1 - High, 3 - High Impedance.
-ci [0,1,3]	Controls the state of the PGC pin when NSDSP is in Idle mode. 0 - Low, 1 - High, 3 - High Impedance.
-cs [0,1,3]	Controls the state of the PGC pin when NSDSP is in Suspended mode. 0 - Low, 1 - High, 3 - High Impedance.
-cu [0,1,3]	Controls the state of the PGC pin when NSDSP is in UART mode. 0 - Low, 1 - High, 3 - High Impedance.
-dx [0,1,3]	Controls the state of the PGDO pin when NSDSP is in Unconnected mode. 0 - Low, 1 - High, 3 - High Impedance.
-di [0,1,3]	Controls the state of the PGDO pin when NSDSP is in Idle mode. 0 - Low, 1 - High, 3 - High Impedance.
-ds [0,1,3]	Controls the state of the PGDO pin when NSDSP is in Suspended mode. 0 - Low, 1 - High, 3 - High Impedance.
-du [0,1,3]	Controls the state of the PGDO pin when NSDSP is in UART mode. 0 - Low, 1 - High, 3 - High Impedance.
-a [0,1]	Controls the state of the PGM/RTS/AMCLR pin when this pin is not in use. 0 - Low (the pin can be used as PGM or RTS), 1 - High (the pin can only be used as AMCLR).
-u mAmp	Amount of power requested from USB bus (in mA). If set to zero, NSDSP will report itself as a self-powered device.
-v volt	Target voltage. If set, specifies the voltage of the target PIC device. Must be set only if voltage is always at the same level. If voltage can vary, the Voltage parameter must be set to 0. The voltage may also be specified by the programming software, which overrides this setting. If voltage is not specified, NSDS assumes the voltage is high enough to perform bulk erase operations. If actual target voltage is below bulk erase threshold, such assumption will cause programming to fail.

Exit Code

If successful, nsconf returns with exit code 0. If an error occurs, nsconf prints an error message, which always starts from "ERROR:" and returns with exit code 1.

Examples

nsconf -s NSDSP100000000 -cx0 -ci0 -cs0 -cu1

This example configures PGC pin to go high when NSDSP enters UART mode. The PGC can be sensed by the target PIC device. When a software program on the Computer connects to NSDSP in UART mode, the target device can recognize the event and may start UART conversation.

nsconf -dx0 -di1 -ds1 -du1

This example configures PGDO pin to go high when NSDSP is connected to USB. This may be used to connect an indicator LED, which will be lit when a valid USB connection is established.

nsconf -a1 -v3.3

This example configures PGM/RTS/AMCLR pin to act as AMCLR, which lets NSDSP program two PICs on the same board. It also specifies that the target voltage is always 3.3V.

nsconf -u 0 -v 5

This example configures NSDSP to report as a self-powered device during USB enumeration. It also specifies that the target voltage is always 5V. This command could be used to configure NSDSP for board powered 5V circuit.