Home > Support > Knowledge Base > Knowledge Base Article

Setting TTY Options

Solution:

AccelePort and RealPort UNIX device driver packages include a command, ditty, which is a superset of stty, and may be used to set and display the device options for Digi AccelePort devices.

The general command format is:

   ditty [-a] [-n ttyname] [option(s)] [ttyname]

In AIX, substitute the command, stty-digi, for ditty:

   /usr/lbin/tty/stty-digi [-a] [-n ttyname] [option(s)] [ttyname]

When using RealPort for AIX or DG/UX, substitute the command, stty-ncxa, for ditty:

   stty-ncxa [-a] [-n ttyname] [option(s)] [ttyname]

When using RealPort for Linux, substitute the command, ditty-rp, for ditty:

   ditty-rp [-a] [-n ttyname] [option(s)] [ttyname]

With no options, ditty displays all Digi special driver settings, modem signals, and all standard parameters displayed by stty(1) for the TTY device referenced by standard input.

Command options are provided to change flow control settings, set transparent print options, force modem control lines, and display all TTY settings. Any unrecognized options are passed to stty(1) for interpretation.

ditty commands may be executed from the command line, or placed in a startup script to be run whenever the system is booted.

The options are:

-a Display all of the unique Digi option settings, as well as all of the standard TTY settings reported by stty -a.
-n ttyname Set and display options for the given TTY device, instead of standard input. This option may be specified multiple times to perform the same operation on multiple TTYs.
ttyname Set and display options for the specified TTY device. Replace ttyname with the TTY pathname (such as /dev/ttya01s, /dev/term/a01 or /dev/dty/a001s, depending on your operating system). This option may be used on a modem control line when no carrier is present.

The following options specify transient actions to be performed immediately:

break Send a 250 MS break signal out on the TTY line.
clear

Clear the tbusy flag in the channel structure to free the port.

NOTE: This option is supported only in UnixWare, OpenServer and Solaris operating systems.

cspeed n

Set the port speed to n bps, where n is an integer value. Available only on Xr, Xem and Xp adapters.

NOTE: This option is supported only in UnixWare, OpenServer, Solaris and HP-UX operating systems. Because the cspeed option is sticky and not transient on HP-UX systems, and only the AccelePort Xp adapter supports cspeed in HP-UX, HP-UX users should refer to the cspeed entry under the sticky options below.

flush Immediately flush (discard) TTY input and output.
flushin Flush TTY input only.
flushout Flush TTY output only.

The following options specify actions which are not sticky, meaning that the changes are cancelled when the device is closed, and that the device will use the default values the next time it is opened.

stopout Stop output exactly as if an XOFF character were received.
startout Restart stopped output exactly as if an XON character were received.
stopin Activate flow control to stop input.
startin Release flow control to resume stopped input.
[-]dtr Raise [drop] the DTR modem control line, unless DTR hardware flow control is selected.
[-]rts Raise [drop] the RTS modem control line, unless RTS hardware flow control is selected.

The following options are sticky—the effects continue until the system is rebooted or until the options are changed.

[-]printer

Forces the port to stay open so that non-sticky parameters such as baud rate and flow control are not reset to default values.

NOTES:

  • This option is supported only in UnixWare, OpenServer and Solaris operating systems.
  • This option is not supported by RealPort.
[-]fastcook

Perform cooked output processing on the adapter itself to minimize use of host resources.

NOTES:

  • This option is supported only in OpenServer and AIX operating systems.
  • This option is not supported by RealPort.
[-]fastbaud Alter the baud rate tables to permit the use of data rates that are beyond the range supported by the operating system. See fastbaud Data Rate Mapping, at the end of this page.
[-]rtspace Enable [disable] RTS hardware input flow control, so RTS drops to pause remote transmission.
[-]ctspace Enable [disable] CTS hardware output flow control, so local transmission pauses when CTS drops.
[-]dsrpace Enable [disable] DSR hardware output flow control, so local transmission pauses when DSR drops.
[-]dcdpace Enable [disable] DCD hardware output flow control, so local transmission pauses when DCD drops.
[-]dtrpace Enable [disable] DTR hardware input flow control, so DTR drops to pause remote transmission.
[-]forcedcd Disable [re-enable] carrier sense, so the TTY may be opened and used even when carrier is not present.
edelay n edelay is a tunable parameter used to set the number of milliseconds of delay between the time the first character arrives after a period of no characters and notification of its arrival to the host. This is also referred to as the wakeup rate between the host adapter software (FEP/OS) and the host device driver. This has the advantage of reducing host overhead by allowing the host to process larger blocks of incoming data.

Larger edelay values result in more characters being sent in a given time period. This will reduce host processor overhead and increase overall system throughput.

Smaller edelay values result in fewer characters being sent in a given time period. This will increase character response time and increase host processor overhead.

The default value for edelay is 100. This is a good value for normal TTY activity like typing. For some applications like uucp, decreasing the edelay value may increase character throughput, but will result in increased host (system) overhead. For applications receiving continuous input at high speeds, increasing edelay will result in lowering host overhead and increasing overall system throughput. A value of 250 is reasonable.

 NOTES:

  • This option is supported only in UnixWare, OpenServer and AIX operating systems.
  • This option is not supported by RealPort.
startc c Sets the XON flow control character. The character may be given as a decimal, octal or hexadecimal number. Octal numbers are recognized by the presence of a leading zero, and hexadecimal numbers are denoted by a leading "0x". For example, the standard XON character, , can be entered as "17" (decimal), "021" (octal) or "0x11" (hexadecimal).
stopc c Sets the XOFF flow control character. The character may be given as a decimal, octal, or hexadecimal number (see startc, above, for format of octal and hexadecimal numbers).
astartc c Sets auxiliary XON flow control character. The character may be given as a decimal, octal, or hexadecimal number (see startc, above, for format of octal and hexadecimal numbers).

Note: This option is not supported in Solaris.

astopc c Sets auxiliary XOFF flow control character. The character may be given as a decimal, octal, or hexadecimal number (see startc, above, for format of octal and hexadecimal numbers).

Note: This option is not supported in Solaris.

[-]aixon Enables auxiliary flow control, so that two unique characters are used for XON and XOFF. If both XOFF characters are received, transmission will not resume until both XON characters are received.
maxcps n Sets the maximum Characters Per Second (CPS) rate at which characters are output to the transparent print device. The rate chosen should be just below the average print speed. If the number is too low, printer speed will be reduced. If the number is too high, the printer will resort to flow control, and user entry on the terminal will be correspondingly impaired. Default is 100 CPS.
maxchar n Sets the maximum number of transparent print characters the driver will place in the output queue. Reducing this number increases system overhead; increasing this number delays operator keystroke echo times when the transparent printer is in use. Default is 50 characters.
bufsize n Sets the driver’s estimate of the size of the transparent printer’s input buffer. After a period of inactivity, the driver bursts this many characters to the transparent printer before reducing to the maxcps rate selected above. Default is 100 characters.
onstr "s" Defines the terminal escape sequence to direct subsequent data to the transparent printer.

s is a string of ASCII characters, enclosed in quotes, that command the terminal to enter transparent printing mode. An arbitrary octal character xxx may be given as \xxx.

For example, the sequence [5i would be entered as: "\033[5i".

offstr "s" Defines the terminal escape sequence to stop directing data to the printer.

s is a string of ASCII characters, enclosed in quotes, that command the terminal to enter transparent printing mode. An arbitrary octal character xxx may be given as \xxx.

For example, the sequence [5i would be entered as: "\033[5i".

term t Sets the transparent printer on/off strings to values found in the internal default table. Internal defaults are used for the following terminals: adm31, ansi, dg200, dg210, hz1500, mc5, microterm, multiterm, pcterm, tvi, vp-a2, vp-60, vt52, vt100, vt220, wyse30, wyse50, wyse60, or wyse75. If the terminal type is not found in the internal default table, then ditty reads the terminfo entry for the terminal type and sets transparent print on/off strings to values given by the mc5/mc4 attributes found there.
cspeed n Set the port speed to n bps, where n is an integer value.

For HP-UX, this option is valid only for AccelePort Xp adapters. This option is also supported in the UnixWare, OpenServer and Solaris operating systems. Because the cspeed option is transient and not sticky in these operating systems, UnixWare, OpenServer and Solaris users should refer to the cspeed entry under the transient options above.

fastbaud Data Rate Mapping

Use the table below to see how setting fastbaud affects data rates for standard AccelePort and RealPort products. Select one of the links below to view a table of fastbaud data rates for: 

Note: Fastbaud for AccelePort Xp products is not supported under Linux. Linux users should use stty to set baudrates as high as 921600 or use the setserial command for setting arbitrary baudrates.

AccelePort fastbaud Data Rates

  Xp Xe Xr, Xem, EPC/X Xr 920 C/X
Specified Data Rate: Data Rate Mapped to: Data Rate Mapped to: Data Rate Mapped to: Data Rate Mapped to: Data Rate Mapped to:
50
57600
57600
57600
57600
57600
75
76800
76800
76800
76800
75
110
115200
115200
115200
115200
115200
134
131657
14400
14400
14400
14400
150
153600
28800
57600
57600
57600
200
230400
200
230400
230400
200
300
460800
300
76800
76800
300
600
921600
600
115200
115200
115200
1200

N/A

1200
230400
230400
1200
1800

N/A

1800
28800
28800
28800
2400
2400
2400
2400
460800
2400
4800
4800
4800
4800
921600
4800
9600
9600
9600
9600
9600
9600
19200
19200
19200
19200
19200
19200
38400
38400
38400
38400
38400
38400

RealPort fastbaud Data Rates

The table below contains the fastbaud data rates available for RealPort. All other fastbaud data rates for RealPort are unmapped.

Specified Data Rate: Data Rate Mapped to:
50
57600
75
76800
110
115200
134
131657
150
153600
200
230400
300
460800

 


Contact a Digi expert and get started today! CONTACT US

Desktop Site