xref: /netbsd-src/share/man/man4/man4.hp300/dcl.4 (revision 5f7096188587a2c7c95fa3c69b78e1ec9c7923d0)
1.\" Copyright (c) 1990, 1991 The Regents of the University of California.
2.\" All rights reserved.
3.\"
4.\" This code is derived from software contributed to Berkeley by
5.\" the Systems Programming Group of the University of Utah Computer
6.\" Science Department.
7.\" Redistribution and use in source and binary forms, with or without
8.\" modification, are permitted provided that the following conditions
9.\" are met:
10.\" 1. Redistributions of source code must retain the above copyright
11.\"    notice, this list of conditions and the following disclaimer.
12.\" 2. Redistributions in binary form must reproduce the above copyright
13.\"    notice, this list of conditions and the following disclaimer in the
14.\"    documentation and/or other materials provided with the distribution.
15.\" 3. All advertising materials mentioning features or use of this software
16.\"    must display the following acknowledgement:
17.\"	This product includes software developed by the University of
18.\"	California, Berkeley and its contributors.
19.\" 4. Neither the name of the University nor the names of its contributors
20.\"    may be used to endorse or promote products derived from this software
21.\"    without specific prior written permission.
22.\"
23.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
24.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
26.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
27.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
28.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
29.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
30.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
31.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
32.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33.\" SUCH DAMAGE.
34.\"
35.\"     from: @(#)dcl.4	5.2 (Berkeley) 3/27/91
36.\"	$Id: dcl.4,v 1.2 1993/08/01 07:56:35 mycroft Exp $
37.\"
38.Dd March 27, 1991
39.Dt DCL 4 hp300
40.Os
41.Sh NAME
42.Nm dcl
43.Nd
44.Tn HP
4598628A communications link
46.Sh SYNOPSIS
47.Cd "device dcl0 at scode? flags 0x1"
48.Sh DESCRIPTION
49The 98628A is a buffered
50.Tn EIA
51.Tn RS-232C
52.Pf ( Tn CCITT
53.Tn V.28 )
54communications interface.
55It has one port with full modem control.
56.Pp
57Input and output for each line may set to one of following baud rates;
580, 50, 75, 110, 134.5, 150, 200, 300, 600, 1200, 1800, 2400, 4800,
599600, 19200.
60.Pp
61An optional argument
62.Ar flags
63may be set to 1 if the line should be treated as hard-wired with
64carrier always present, or to 0 if modem control is desired.
65.Pp
66Use
67.Tn HP
68cable "98626 & 98628 opts.002,
69.Tn RS232-C
70.Tn DCE CABLE ,
715061-4216" to attach non-modem devices.
72Use
73.Tn HP
74cable "98626 & 98628 opts.001,
75.Tn RS232-C
76.Tn DTE CABLE ,
775061-4215" to attach modems.
78.Pp
79The 98628A has a 256 byte input silo and a 256 output silo. Input interrupts
80happen on a per character basis.
81.Pp
82The high water and low water marks in the kernel tty routines are completely
83inappropriate for a device like this with a large input buffer.  Don't use
84tandem mode if possible.  A fast system can handle input at 19.2K baud without
85receive overflow.
86.Pp
87For output to devices that make heavy use of
88.Tn XON/XOFF
89a write size of less
90then 256 will improve performance marginally.
91.Sh FILES
92.Bl -tag -width /dev/ttyl[0-9] -compact
93.It Pa /dev/ttyl[0-9]
94.El
95.Sh DIAGNOSTICS
96.Bl -diag
97.It dcl%d: error 0x%x RESET CARD.
98Where the errors are encoded:
99.Bd -unfilled -offset indent
1000x06 card failure
1010x0d uart receive overflow
1020x0e receive overflow
1030x0f missing external clock
1040x10 cts false too long
1050x11 lost carrier
1060x12 activity timeout
1070x13 connection not established
1080x19 illegal databits/parity
1090x1a register address out of range
1100x1b register value out of range
1110x-- unknown error
112.Ed
113.El
114.Sh SEE ALSO
115.Xr tty 4
116.Sh HISTORY
117The
118.Nm
119driver
120.Ud
121.Sh BUGS
122Breaks received at a faster rate then 1 break every second will be
123recognized as a single break.
124.Pp
125Console use is not supported.
126.Pp
127The
128.Tn RS-422/423/499 ,
129.Tn MTS-DSN/DL
130modes of the card are not supported.
131