93 lines
3.1 KiB
Groff
93 lines
3.1 KiB
Groff
.TH DMD5620 1
|
|
.SH NAME
|
|
dmd5620 \- AT&T DMD 5620 Terminal Emulator
|
|
.SH SYNOPSIS
|
|
.B dmd5620
|
|
[\fB\--help\fR]
|
|
[\fB\--version\fR]
|
|
[\fB\--shell\fR \fISHELL\fR|\fB\--device\fR \fIDEVICE\fR]
|
|
[\fB\--nvram\fR \fIFILE\fR]
|
|
[\fB\--firmware\fR \fI"VERSION"\fR]
|
|
.SH DESCRIPTION
|
|
.B dmd5620
|
|
AT&T DMD 5620 Terminal emulator with support for XT layers protocol.
|
|
.SH OPTIONS
|
|
.TP
|
|
.BR \-h ", " \-\-help
|
|
Displays help and exits.
|
|
.TP
|
|
.BR \-v ", " \-\-version
|
|
Displays version and exits.
|
|
.TP
|
|
.BR \-s ", " \-\-shell " " \fISHELL\fR
|
|
Execute the program \fISHELL\fR, e.g. "/bin/sh".
|
|
.TP
|
|
.BR \-d ", " \-\-device " " \fIDEVICE\fR
|
|
Connect to physical device \fIDEVICE\fR, e.g. "/dev/ttyS0" or
|
|
"/dev/pts/1".
|
|
.TP
|
|
.BR \-n ", " \-\-nvram " " \fIFILE\fR
|
|
Store NVRAM state in file \fIFILE\fR. No default.
|
|
.TP
|
|
.BR \-f ", " \-\-firmware " " \fI"VERSION"\fR
|
|
Select firmare version. \fI"VERSION"\fR is a string, and must
|
|
be one of either \fB"8;7;3"\fR or \fB"8;7;5"\fR. The default version
|
|
if not specified is \fB"8;7;5"\fR.
|
|
.SH KEYMAP
|
|
.TP
|
|
.BR F1\-F8
|
|
Terminal F1 through F8 keys
|
|
.TP
|
|
.BR F9
|
|
Terminal SETUP key
|
|
.TP
|
|
.BR SHIFT\+F9
|
|
Terminal RESET key
|
|
.TP
|
|
.SH CONNECTING TO VIRTUAL SERIAL PORTS
|
|
The \fB\-\-device\fR option can be used with \fBsocat\fR to set up a
|
|
virtual serial port to a SIMH instance. For example:
|
|
.P
|
|
.EX
|
|
$ socat -d -d pty,raw,echo=0 TCP:192.168.0.100:8888
|
|
.EE
|
|
.P
|
|
This command on Linux will open a virtual serial port connected to
|
|
\fB192.168.80.100\fR on port \fB8888\fR. The port device will be
|
|
something like \fB/dev/pts/1\fR, and the \fB\-\-device\fR flag can
|
|
then be used to connect to this virtual serial port.
|
|
.SH USING SVR3 LAYERS
|
|
One of the primary featuers of dmd5620 is support for the System V Release 3
|
|
\fIlayers\fR program. Real DMD5620 terminals were hard-wired directly
|
|
to hosts using serial ports, and have no notion of networks.
|
|
.PP
|
|
In order to use dmd5620 with a networked System V Release 3 over a network,
|
|
either using \fItelnet\fR or \fIssh\fR, you must enable "encoding" on the
|
|
terminal.
|
|
.PP
|
|
To enable encoding, first press F9 (the \fISETUP\fR key) and then select "Host
|
|
Options", either with the mouse or by pressing F2. Next, select toggle
|
|
"Encoding Off" to "Encoding On" either with the mouse or by pressing F3.
|
|
.PP
|
|
"Encoding" will ensure that telnet and SSH control characters are properly
|
|
escaped.
|
|
.SH SAVING NVRAM
|
|
All terminal settings are forgotten on shutdown. To save terminal
|
|
settings, the contents of NVRAM must be stored in a file using
|
|
the \fB\-\-nvram\fR flag.
|
|
.PP
|
|
\fINote that the NVRAM format is different between firmware versions!\fR
|
|
Using the same NVRAM file on an \fB8;7;5\fR firmware terminal
|
|
and an \fB8;7;3\fR firwmare terminal is NOT SUPPORTED and will result
|
|
in undesirable behavior!
|
|
.SH KNOWN ISSUES
|
|
.IP \(bu 3
|
|
System V Release 3 \fIlayers\fR does not work when using Telnet to connect to a
|
|
real or simulated 3B2 using AT&T/WINS TCP/IP. This can be worked around by
|
|
connecting to a simulated serial port (e.g. Console, Contty, or PORTS)
|
|
listening for Telnet connections.
|
|
.IP \(bu 3
|
|
Timing is not fully accurate, and can lead to dropped XT packets when
|
|
using \fIlayers\fR on a simulated PORTS serial port.
|
|
.RE
|