nsuart - NSDS Command Line UART Terminal

nsuart is a command line interface to NSDSP UART. It puts NSDSP into UART mode and opens a connection. Everything written to its standard input is transmitted through the NSDSP UART port to the target device. Everything received from the target device through NSDSP UART port is printed on nsuart standard output.

nsuart may be used through other application or directly from command line prompt.

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.
-t	Disables VT100 emulation in Windows console. nsuart removes the ENABLE_VIRTUAL_TERMINAL_PROCESSING flag from the console settings. As a result, Windows console will display all the symbols received through UART as is. This only works on Windows 10 and later. This option is illegal on Linux and Mac.
-v	Ebables VT100 emulation in Windows console. nsuart sets the ENABLE_VIRTUAL_TERMINAL_PROCESSING flag from the console settings. As a result, Windows console will inspect all the characters received through UART and will search for VT100 control sequences, which can be used to change color, format text etc. This only works on Windows 10 and later. This option is illegal on Linux and Mac.
-f	Instructs nsuart to use hardware flow control using RTS/CTS pins.
baud rate	One of the following pre-set baud rates: 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200, 230400, 460800, 921600, 250k, 500k, 1M, 2M. The default is 9600.

 

Exit Code

If an error occurs, nsuart terminates with exit code 1. If there's an error with parameters, it shows usage information. If parameters are Ok, but an error occurs, it prints an error message, which always starts from "ERROR:" and returns with exit code 1. nsuart terminates with exit code 0 if it encounters the End of File condition on its stanard input.

 

Examples

nsuart

This example opens UART session at 9600 baud without flow control.

 

nsuart -f 1M

This example opens UART session at 1000000 baud with hardware flow control.

 

nsuart 250k < data.txt

This example transers the contents of the data.txt file to the target device with 250000 baud rate.

 

More information about UART.

Source code for NSDSP UART communications.