Buy(Cart) Contact NSDSP Home

Gang Programmer Options

To open the Gang Options screen, click on the "Options" button.

Options Screenshot

Run on success

The "Run on success" field lets you specify a program (executable, batch file, shell script etc.) which will run upon successful completion of programming. This program will run after the target device is programmed and NSDSP is disconnected from the device.

When the program is invoked, two parameters are appended to the command line - the NSDSP serial number and the information extracted from the NSZ file. The later will be omitted if the NSZ file is not used. The program may use the NSDSP serial number passed through the command line to establish communications with NSDSP either through command line utilities or through SDK. You can use either UART, SPI, or bit-banging to communicate either to the target chip or to your test jig.

Your program must not modify the HEX file in any way. The HEX file is read only once, before first programming begins and then is held in memory. Therefore HEX file modifications will not have any effect on programming.

If multiple NSDSP programmers are connected, several instances of the program may run concurrently.

The output of the program is captured. If a log file is used, the output of the program is written to the log file. The output should not exceed 512 KBytes, or it will be truncated.

The exit code of the program determines the status reported to the user. If the exit code is zero, success is reported. If the exit code is not zero, or the program fails to run for any reason, failure is reported. Upon such failure, there will be no retries, even if retries are specified.

Run on failure

The "Run on failure" field lets you specify a program (executable, batch file, shell script etc.) which will run upon successful completion of programming. This program will run after the target device is programmed and NSDSP is disconnected from the device. If you specify retries, this program will only run once, after all the retries are complete.

When the program is invoked, two parameters are appended to the command line - the NSDSP serial number and the information extracted from the NSZ file. The later will be omitted if the NSZ file is not used. If multiple NSDSP programmers are connected, several instances of the program may run concurrently.

The output of the program is captured. If a log file is used, the output of the program is written to the log file. The output should not exceed 512 KBytes, or it will be truncated.

The exit code of the program is ignored and the failure is reported once the program finishes.

Log file

You can specify a log file which will log all the programming attempts using the plain text format. If you secify a "Run on success" or "Run on failure" scripts, the output of these scripts will be logged too.

If the log file exists, NSDSP Gang Programmer will append new records to the end of the file. Otherwise, a new file will be created. If there are errors while writing the log file (for example the target folder is not writable), these errors are not reported and the information being logged is lost.

Log writes are buffered and not commited to the disk immediately. Therefore, when a catastrophic event, such as power failure, kills NSDS Gang Programmer, the last part of the log may be lost.

Retries

NSDS Gang Programmer can automatically re-try programming in case of failure. You can specify the number of retries and time interval between retries. If retries are specified, the status will not be reported until all the retries are complete.

Only programming failures are retried. Other causes of failure, such as USB problems or problems with input files are reported immediately, without retries.

Persistance

If you want NSDS Gang Programmer to save the options for the next time, select "Remember these options for the next session". If you don't, NSDSP Gang Programming will use the options once, but will not save them for the next time.

If you select "Forget these options when I close the program" and then execute a lock, your settings will still be used for programming while the lock is in effect, but will be forgotten as soon as you release the lock.

Northern Software Home NSDSP Contact Us Purchase/Vew Cart

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