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