uCon HomePage

Script Cmd: CONNECT


CONNECT {backend_connection_type | close} [connection-specific-arguments]...

This command allows a script to configure/reconfigure the backend connection.

Valid backend connection types are: comport, telnet and plink

comport connection-specific-arguments:

{port #} {baud} [bytesize (def=8)] [parity (def=NONE)] [stopbits (def=1)] [flowctrl (def=NONE)]

Note that a comport number of "NONE" is valid and taken to mean that the user wishes to disconnect uCon from any backend. In this case, the specified baudrate is just ignored (but must be present).

Typical baud settings:110, 300, 600, 1200, 2400, 4800, 9600, 14400, 19200, 38400, 57600, 115200
Valid parity settings:NONE, EVEN, ODD, MARK, SPACE
Valid stopbit settings:1, 1.5, 2
Valid flowctrl settings:NONE, DTRDSR, RTSCTS, XONXOFF

Examples:

CONNECT comport 1 38400
CONNECT comport NONE 38400
CONNECT comport 2 9600 8 NONE 1 NONE

This will also set the shell variable COMPORT to the specified port number.

Note: as of Apr 2022, if the 'port #' argument is "NEXT", then CONNECT will return the next available COM port (if any).

telnet connection-specific-arguments:

{IP/name} [port #]
(default: port 23)

This will also set the shell variables TELNETBACKEND_IP and TELNETBACKEND_PORT if the connection is successful.

plink connection-specific-arguments:

string passed to plink
typically formatted as user@sysname (i.e. [email protected])

close

No arguments, just close whatever connection was previously opened.