share/man/man4/tcom.4

   1 .\"     $NetBSD: tcom.4,v 1.6 2003/08/07 10:31:03 agc Exp $
   2 .\"
   3 .\" Copyright (c) 1998 The NetBSD Foundation, Inc.
   4 .\" All rights reserved.
   5 .\"
   6 .\" This code is derived from software contributed to The NetBSD Foundation
   7 .\" by Eric S. Hvozda.
   8 .\"
   9 .\" Redistribution and use in source and binary forms, with or without
  10 .\" modification, are permitted provided that the following conditions
  11 .\" are met:
  12 .\" 1. Redistributions of source code must retain the above copyright
  13 .\"    notice, this list of conditions and the following disclaimer.
  14 .\" 2. Redistributions in binary form must reproduce the above copyright
  15 .\"    notice, this list of conditions and the following disclaimer in the
  16 .\"    documentation and/or other materials provided with the distribution.
  17 .\"
  18 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
  19 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  20 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  21 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
  22 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  23 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  24 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  25 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  26 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  27 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  28 .\" POSSIBILITY OF SUCH DAMAGE.
  29 .\"
  30 .\"
  31 .\" Copyright (c) 1990, 1991 The Regents of the University of California.
  32 .\" All rights reserved.
  33 .\"
  34 .\" This code is derived from software contributed to Berkeley by
  35 .\" the Systems Programming Group of the University of Utah Computer
  36 .\" Science Department.
  37 .\" Redistribution and use in source and binary forms, with or without
  38 .\" modification, are permitted provided that the following conditions
  39 .\" are met:
  40 .\" 1. Redistributions of source code must retain the above copyright
  41 .\"    notice, this list of conditions and the following disclaimer.
  42 .\" 2. Redistributions in binary form must reproduce the above copyright
  43 .\"    notice, this list of conditions and the following disclaimer in the
  44 .\"    documentation and/or other materials provided with the distribution.
  45 .\" 3. Neither the name of the University nor the names of its contributors
  46 .\"    may be used to endorse or promote products derived from this software
  47 .\"    without specific prior written permission.
  48 .\"
  49 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  50 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  51 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  52 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  53 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  54 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  55 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  56 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  57 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  58 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  59 .\" SUCH DAMAGE.
  60 .\"
  61 .\"     from: @(#)dca.4 5.2 (Berkeley) 3/27/91
  62 .\"     from: Id: com.4,v 1.1 1993/08/06 11:19:07 cgd Exp
  63 .\"
  64 .Dd May 20, 1998
  65 .Dt TCOM 4
  66 .Os
  67 .Sh NAME
  68 .Nm tcom
  69 .Nd
  70 multiplexing serial communications interface
  71 .Sh SYNOPSIS
  72 For 4-port TC-400 series boards:
  73 .Pp
  74 .Cd "tcom0 at isa? port 0x100 irq 5"
  75 .Cd "com2 at tcom? slave ?"
  76 .Cd "com3 at tcom? slave ?"
  77 .Cd "com4 at tcom? slave ?"
  78 .Cd "com5 at tcom? slave ?"
  79 .Pp
  80 For 8-port TC-800 series boards:
  81 .Pp
  82 .Cd "tcom0 at isa? port 0x100 irq 5"
  83 .Cd "com2 at tcom? slave ?"
  84 .Cd "com3 at tcom? slave ?"
  85 .Cd "com4 at tcom? slave ?"
  86 .Cd "com5 at tcom? slave ?"
  87 .Cd "com6 at tcom? slave ?"
  88 .Cd "com7 at tcom? slave ?"
  89 .Cd "com8 at tcom? slave ?"
  90 .Cd "com9 at tcom? slave ?"
  91 .Sh DESCRIPTION
  92 The
  93 .Nm tcom
  94 driver provides support for the Byte Runner Technologies TC-400
  95 and TC-800 series boards that multiplex together up to four or eight
  96 .Tn EIA
  97 .Tn RS-232C
  98 .Pf ( Tn CCITT
  99 .Tn V.28 )
 100 communications interfaces.
 101 .Pp
 102 Each
 103 .Nm
 104 device is the master device for up to eight
 105 .Nm com
 106 devices.  The kernel configuration specifies these
 107 .Nm com
 108 devices as slave devices of the
 109 .Nm
 110 device, as shown in the synopsis.  The slave ID given for each
 111 .Nm com
 112 device determines which bit in the interrupt multiplexing register is
 113 tested to find interrupts for that device.
 114 The
 115 .Tn port
 116 specification for the
 117 .Nm
 118 device is used to compute the base addresses for the
 119 .Nm com
 120 subdevices and the port for the interrupt multiplexing register.
 121 .Pp
 122 Not all possible configuration options are currently supported (for
 123 example, speeds beyond 115200 baud are not currently supported).
 124 .Sh FILES
 125 .Bl -tag -width Pa
 126 .It Pa /dev/tty??
 127 .El
 128 .Sh SEE ALSO
 129 .Xr com 4
 130 .Sh HISTORY
 131 The
 132 .Nm
 133 driver was written by Jukka Marin.