xref: /netbsd-src/share/man/man4/man4.hp300/dcl.4 (revision 01869ca4d24a86379a68731bf9706a9f0820fe4e)
1.\"	$NetBSD: dcl.4,v 1.13 2017/07/03 21:30:59 wiz 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. Neither the name of the University nor the names of its contributors
19.\"    may be used to endorse or promote products derived from this software
20.\"    without specific prior written permission.
21.\"
22.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
23.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
26.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32.\" SUCH DAMAGE.
33.\"
34.\"     from: @(#)dcl.4	8.1 (Berkeley) 6/9/93
35.\"
36.Dd November 15, 2003
37.Dt DCL 4 hp300
38.Os
39.Sh NAME
40.Nm dcl
41.Nd
42.Tn HP
4398628A serial communications link
44.Sh SYNOPSIS
45.Cd "dcl0 at dio? scode ? flags 0x1"
46.Sh DESCRIPTION
47The 98628A is a buffered
48.Tn EIA
49.Tn RS-232C
50.Pf ( Tn CCITT
51.Tn V.28 )
52communications interface.
53It has one port with full modem control.
54.Pp
55Input and output for each line may set to one of following baud rates;
560, 50, 75, 110, 134.5, 150, 200, 300, 600, 1200, 1800, 2400, 4800,
579600, 19200.
58.Pp
59An optional argument
60.Ar flags
61may be set to 1 if the line should be treated as hard-wired with
62carrier always present, or to 0 if modem control is desired.
63.Pp
64Use
65.Tn HP
66cable "98626 & 98628 opts.002,
67.Tn RS232-C
68.Tn DCE CABLE ,
695061-4216" to attach non-modem devices.
70Use
71.Tn HP
72cable "98626 & 98628 opts.001,
73.Tn RS232-C
74.Tn DTE CABLE ,
755061-4215" to attach modems.
76.Pp
77The 98628A has a 256 byte input silo and a 256 output silo. Input interrupts
78happen on a per character basis.
79.Pp
80The high water and low water marks in the kernel tty routines are completely
81inappropriate for a device like this with a large input buffer.  Don't use
82tandem mode if possible.  A fast system can handle input at 19.2K baud without
83receive overflow.
84.Pp
85For output to devices that make heavy use of
86.Tn XON/XOFF
87a write size of less
88than 256 will improve performance marginally.
89.Sh FILES
90.Bl -tag -width /dev/ttyl[0-9] -compact
91.It Pa /dev/ttyl[0-9]
92.El
93.Sh DIAGNOSTICS
94.Bl -diag
95.It dcl%d: error 0x%x RESET CARD.
96Where the errors are encoded:
97.Bd -unfilled -offset indent
980x06 card failure
990x0d uart receive overflow
1000x0e receive overflow
1010x0f missing external clock
1020x10 cts false too long
1030x11 lost carrier
1040x12 activity timeout
1050x13 connection not established
1060x19 illegal databits/parity
1070x1a register address out of range
1080x1b register value out of range
1090x-- unknown error
110.Ed
111.El
112.Sh SEE ALSO
113.Xr tty 4
114.Sh BUGS
115The
116.Nm
117device is not actually supported in
118.Nx .
119This man page is only for information purposes in case someone wishes
120to port the driver from 4.3BSD.
121.Pp
122Breaks received at a faster rate than 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