share/man/man4/man4.hp300/dcl.4

   1 .\"     $NetBSD: dcl.4,v 1.11 2003/11/15 21:45:52 mbw 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
  43 98628A serial communications link
  44 .Sh SYNOPSIS
  45 .Cd "dcl0 at dio? scode ? flags 0x1"
  46 .Sh DESCRIPTION
  47 The 98628A is a buffered
  48 .Tn EIA
  49 .Tn RS-232C
  50 .Pf ( Tn CCITT
  51 .Tn V.28 )
  52 communications interface.
  53 It has one port with full modem control.
  54 .Pp
  55 Input and output for each line may set to one of following baud rates;
  56 0, 50, 75, 110, 134.5, 150, 200, 300, 600, 1200, 1800, 2400, 4800,
  57 9600, 19200.
  58 .Pp
  59 An optional argument
  60 .Ar flags
  61 may be set to 1 if the line should be treated as hard-wired with
  62 carrier always present, or to 0 if modem control is desired.
  63 .Pp
  64 Use
  65 .Tn HP
  66 cable "98626 \*[Am] 98628 opts.002,
  67 .Tn RS232-C
  68 .Tn DCE CABLE ,
  69 5061-4216" to attach non-modem devices.
  70 Use
  71 .Tn HP
  72 cable "98626 \*[Am] 98628 opts.001,
  73 .Tn RS232-C
  74 .Tn DTE CABLE ,
  75 5061-4215" to attach modems.
  76 .Pp
  77 The 98628A has a 256 byte input silo and a 256 output silo. Input interrupts
  78 happen on a per character basis.
  79 .Pp
  80 The high water and low water marks in the kernel tty routines are completely
  81 inappropriate for a device like this with a large input buffer.  Don't use
  82 tandem mode if possible.  A fast system can handle input at 19.2K baud without
  83 receive overflow.
  84 .Pp
  85 For output to devices that make heavy use of
  86 .Tn XON/XOFF
  87 a write size of less
  88 than 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.
  96 Where the errors are encoded:
  97 .Bd -unfilled -offset indent
  98 0x06 card failure
  99 0x0d uart receive overflow
 100 0x0e receive overflow
 101 0x0f missing external clock
 102 0x10 cts false too long
 103 0x11 lost carrier
 104 0x12 activity timeout
 105 0x13 connection not established
 106 0x19 illegal databits/parity
 107 0x1a register address out of range
 108 0x1b register value out of range
 109 0x-- unknown error
 110 .Ed
 111 .El
 112 .Sh SEE ALSO
 113 .Xr tty 4
 114 .Sh BUGS
 115 The
 116 .Nm
 117 device is not actually supported in
 118 .Nx .
 119 This man page is only for information purposes in case someone wishes
 120 to port the driver from 4.3BSD.
 121 .Pp
 122 Breaks received at a faster rate than 1 break every second will be
 123 recognized as a single break.
 124 .Pp
 125 Console use is not supported.
 126 .Pp
 127 The
 128 .Tn RS-422/423/499 ,
 129 .Tn MTS-DSN/DL
 130 modes of the card are not supported.