share/man/man4/boca.4

   1 .\"     $NetBSD: boca.4,v 1.4 2001/09/11 17:54:20 wiz Exp $
   2 .\"
   3 .\" Copyright (c) 1990, 1991 The Regents of the University of California.
   4 .\" 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 .\" 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 .\" 3. Neither the name of the University nor the names of its contributors
  18 .\"    may be used to endorse or promote products derived from this software
  19 .\"    without specific prior written permission.
  20 .\"
  21 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  22 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  23 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  24 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  25 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  26 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  27 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  28 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  29 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  30 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  31 .\" SUCH DAMAGE.
  32 .\"
  33 .\"     from: @(#)dca.4 5.2 (Berkeley) 3/27/91
  34 .\"     from: Id: com.4,v 1.1 1993/08/06 11:19:07 cgd Exp
  35 .\"
  36 .Dd January 3, 1995
  37 .Dt BOCA 4
  38 .Os
  39 .Sh NAME
  40 .Nm boca
  41 .Nd
  42 multiplexing serial communications interface
  43 .Sh SYNOPSIS
  44 For 4-port BB1004 boards:
  45 .Pp
  46 .Cd "boca0 at isa? port 0x100 irq 5"
  47 .Cd "com2 at boca? slave ?"
  48 .Cd "com3 at boca? slave ?"
  49 .Cd "com4 at boca? slave ?"
  50 .Cd "com5 at boca? slave ?"
  51 .Pp
  52 For 8-port BB1008 boards:
  53 .Pp
  54 .Cd "boca0 at isa? port 0x100 irq 5"
  55 .Cd "com2 at boca? slave ?"
  56 .Cd "com3 at boca? slave ?"
  57 .Cd "com4 at boca? slave ?"
  58 .Cd "com5 at boca? slave ?"
  59 .Cd "com6 at boca? slave ?"
  60 .Cd "com7 at boca? slave ?"
  61 .Cd "com8 at boca? slave ?"
  62 .Cd "com9 at boca? slave ?"
  63 .Pp
  64 For 16-port BB2016 boards:
  65 .Pp
  66 .Cd "boca0 at isa? port 0x100 irq 5"
  67 .Cd "com2 at boca? slave ?"
  68 .Cd "com3 at boca? slave ?"
  69 .Cd "com4 at boca? slave ?"
  70 .Cd "com5 at boca? slave ?"
  71 .Cd "com6 at boca? slave ?"
  72 .Cd "com7 at boca? slave ?"
  73 .Cd "com8 at boca? slave ?"
  74 .Cd "com9 at boca? slave ?"
  75 .Cd "boca1 at isa? port 0x140 irq 5"
  76 .Cd "com10 at boca? slave ?"
  77 .Cd "com11 at boca? slave ?"
  78 .Cd "com12 at boca? slave ?"
  79 .Cd "com13 at boca? slave ?"
  80 .Cd "com14 at boca? slave ?"
  81 .Cd "com15 at boca? slave ?"
  82 .Cd "com16 at boca? slave ?"
  83 .Cd "com17 at boca? slave ?"
  84 .Pp
  85 (The BB2016 is functionally equivalent to two BB1008 boards,
  86 and is configured as such.)
  87 .Sh DESCRIPTION
  88 The
  89 .Nm boca
  90 driver provides support for BOCA Research BB1004, BB1008 and BB2016
  91 boards that multiplex together up to four, eight or sixteen
  92 .Tn EIA
  93 .Tn RS-232C
  94 .Pf ( Tn CCITT
  95 .Tn V.28 )
  96 communications interfaces.
  97 .Pp
  98 Each
  99 .Nm
 100 device is the master device for up to eight
 101 .Nm com
 102 devices.  The kernel configuration specifies these
 103 .Nm com
 104 devices as slave devices of the
 105 .Nm
 106 device, as shown in the synopsis.  The slave ID given for each
 107 .Nm com
 108 device determines which bit in the interrupt multiplexing register is
 109 tested to find interrupts for that device.
 110 The
 111 .Tn port
 112 specification for the
 113 .Nm
 114 device is used to compute the base addresses for the
 115 .Nm com
 116 subdevices and the port for the interrupt multiplexing register.
 117 .Sh FILES
 118 .Bl -tag -width Pa
 119 .It Pa /dev/tty??
 120 .El
 121 .Sh SEE ALSO
 122 .Xr com 4
 123 .Sh HISTORY
 124 The
 125 .Nm
 126 driver was written by Charles Hannum, based on the
 127 .Nm ast
 128 driver and source code from David Muir Sharnoff.  David wishes to
 129 acknowledge the assistance of Jason Venner in determining how to use
 130 the BOCA boards.