tcl.reset-port

Verb: Access/TCL, Releases: AP

Initializes specified port.

Syntax

reset-port port.number {(options} reset-port ttyname {(options}

Description

restarts suspended output and drains both the input and output terminal buffers.

No other characteristic of the device is altered. Restarting suspending output is useful when a port is stopped by a X-OFF and a X-ON was never sent.

'port.number' is the Pick port.number (pib) associated to the device to restart. This command may not be issued against its own port.

On AP/Unix implementations, the Pick process must be connected to the Pick virtual machine, otherwise the 'ttyname' form of the command must be specified. 'ttyname' is the device name to reset. This form can be used on any serial device on the system, even if not connected to the Pick virtual machine.

Raw Mode:

Normal Pick operations require that the device is used in 'raw' mode, i.e. where Unix does not do any pre- or post-processing to the data exchanged with the device. However, some Unix operations sometimes re-program the device and leave it in a state incompatible with Pick. The most common symptom is a 'double echo' (i.e. a command is echoed one character at a time, as usual, but, when pressing <return>, the command is displayed again and nothing happens). To correct this situation, issue a 'reset-port line (r)', which attempts to reset the device to a 'suitable' state.

Options

f Suspends output. This option acts as if the device had sent an X-OFF (i.e. <ctrl>+s). This option is specific to AP/Unix implementations.
i Drains input buffer. All characters waiting to be read from the device are removed. If no option is specified, this option is part of the default. This option is specific to AP/Unix implementations.
n Restarts output. This option acts as if the device had sent an X-ON (i.e. <ctrl>+q). If no option is specified, this option is part of the default. This option is specific to AP/Unix implementations.
o Drains output buffer. All characters waiting to be sent to the device are removed (lost). If no option is specified, this option is part of the default. This option is specific to AP/Unix implementations.
r Resets to 'raw' mode (see notes in 'Raw Mode'). This option is specific to AP/Unix implementations.

Example

reset-port 25
reset-port /dev/tty26

See Also

Command Name Type Description
tcl.set-baud Verb: Access Adjusts baud rate for specific port.
tcl.set-port Verb: Access Adjusts baud rate and communication parameters for specific port.
hung.port Definition
tcl.xonoff Verb: Access Toggles xon/xoff or data set ready.

User Comments

What do you think?

Share your experience or ask a question by using the form below.

Login to leave your comments.