share/man/man4/rp.4

   1 .\" Copyright (c) 1995 Comtrol, Inc.
   2 .\" All rights reserved.
   3 .\"
   4 .\" $FreeBSD: src/share/man/man4/rp.4,v 1.2.2.2 2003/06/10 21:01:38 ceri Exp $
   5 .Dd November 15, 1995
   6 .Dt RP 4
   7 .Os
   8 .Sh NAME
   9 .Nm rp
  10 .Nd "driver for Comtrol RocketPort Intelligent Serial Port Cards"
  11 .Sh SYNOPSIS
  12 .Cd "device rp"
  13 .Cd "device rp0 at isa? port 0x180"
  14 .Sh DESCRIPTION
  15 This driver provides a kernel device driver for the
  16 .Tn RocketPort
  17 and
  18 .Tn RocketPort RA
  19 serial boards.
  20 These boards provide 8, 16, or 32 high-speed serial ports
  21 while requiring only 68 bytes of I/O space for all 8, 16,
  22 or 32 ports, and do not require an interrupt channel.
  23 This driver supports up to four
  24 .Tn RocketPort
  25 or
  26 .Tn RocketPort RA
  27 boards in one machine simultaneously.
  28 If you are using four 32 port
  29 .Tn RocketPort
  30 boards, you can put as many as 128 intelligent serial ports
  31 on your system.
  32 .Pp
  33 The
  34 .Nm
  35 driver supports the following speeds: 50, 75, 110, 134, 150,
  36 200, 300, 600, 1200, 1800, 2400, 4800, 9600, 19200, 38400, 7200,
  37 14400, 57600, 76800, 115200, and 230400.
  38 (You must use
  39 .Xr termios 4 ,
  40 rather than the old style ioctl interface to use non-traditional
  41 speeds.)
  42 .Pp
  43 An open on the
  44 .Nm
  45 driver will block until carrier is present, unless
  46 .Dv O_NONBLOCK
  47 or
  48 .Dv CLOCAL
  49 is set.
  50 .Sh HARDWARE CONFIGURATION
  51 The first
  52 .Tn RocketPort
  53 or
  54 .Tn RocketPort RA
  55 card requires a 68-byte contiguous block of I/O addresses,
  56 starting at one of the following:
  57 0x100h, 0x140h, 0x180h, 0x200h, 0x240h, 0x280h, 0x300h, 0x340h,
  58 0x380h.
  59 The second, third, and fourth
  60 .Tn RocketPort
  61 cards require only a
  62 64-byte contiguous block of I/O addresses, starting at one of the
  63 above address ranges.
  64 The I/O address range used by any of the
  65 .Tn RocketPort
  66 cards must not conflict with any other cards in the system,
  67 including other
  68 .Tn RocketPort
  69 cards.
  70 The starting range of the I/O ports used by each card
  71 must match with the I/O address specified in the kernel
  72 configuration file.
  73 .Pp
  74 Since the first
  75 .Tn RocketPort
  76 uses 68 I/O addresses, if the first card is
  77 set to use an I/O block starting at 0x100,
  78 it will occupy the I/O ports between 0x100 and 0x143.
  79 This means that the second, third, or fourth
  80 .Tn RocketPort
  81 board may not use the block of addresses starting at 0x140,
  82 since the first three I/O addresses of that range
  83 are used by the first board.
  84 This is an important point to keep in mind.
  85 .Pp
  86 The configuration of the
  87 .Tn RocketPort
  88 cards is done via the set of 8 DIP switches,
  89 labeled SW1 on the
  90 .Tn RocketPort
  91 card:
  92 .Bd -literal -offset indent
  93 +-------------------------------+
  94 | 8 | 7 | 6 | 5 | 4 | 3 | 2 | 1 |
  95 +-------+-------+---------------+
  96 | Unused| Card  | I/O Port Block|
  97 +-------------------------------+
  98 .Ed
  99 .Pp
 100 DIP switches 7 and 8 are unused, and must be left on.
 101 .Pp
 102 DIP switches 6 and 5 identify the card number of each
 103 .Tn RocketPort
 104 card.
 105 The first card installed in the system must have its DIP switches set
 106 as card number one; the second card installed in the system must have
 107 its DIP switches set as card number two; and so on.
 108 As shipped from
 109 the factory, DIP switches 6 and 5 are both on by default, indicating
 110 that this is the first card installed on the system:
 111 .Bd -literal -offset indent
 112 DIP Switches
 113 6    5
 114 ===================
 115 On   On   First Card
 116 On   Off  Second Card
 117 Off  On   Third Card
 118 Off  Off  Fourth Card
 119 .Ed
 120 .Pp
 121 DIP switches 4, 3, 2, and 1 indicate the I/O address range used by the
 122 first
 123 .Tn RocketPort
 124 card.
 125 If there are more than one
 126 .Tn RocketPort
 127 cards installed in a system,
 128 the second, third and fourth
 129 .Tn RocketPort
 130 cards must
 131 also be set to the I/O address range used by the first
 132 .Tn RocketPort
 133 card;
 134 all cards must have these DIP switches set identically
 135 for proper operation.
 136 As shipped from the factory, DIP switch 4 is on,
 137 and switches 3, 2, and 1 are off by default,
 138 indicating an I/O address range used by the first
 139 card which starts at 0x180 and extends to 0x1C3.
 140 .Bd -literal -offset indent
 141 DIP Switches         I/O Address Range
 142 4    3    2    1     Used by the First Card
 143 =====================================
 144 On   Off  On   Off   100-143
 145 On   Off  Off  On    140-183
 146 On   Off  Off  Off   180-1C3
 147 Off  On   On   Off   200-243
 148 Off  On   Off  On    240-283
 149 Off  On   Off  Off   280-2C3
 150 Off  Off  On   Off   300-343
 151 Off  Off  Off  On    340-383
 152 Off  Off  Off  Off   380-3C3
 153 .Ed
 154 .Sh FILES
 155 .Bl -tag -width ".Pa /dev/ttyR[RSTU][0-31]"
 156 .It Pa /dev/ttyR[RSTU][0-31]
 157 .El
 158 .Sh AUTHORS
 159 .An Theodore Ts'o Aq tytso@mit.edu
 160 .Pp
 161 This driver was written under contract for Comtrol Corporation.
 162 For dealer, distributor and other information regarding Comtrol
 163 .Tn RocketPort ,
 164 contact Comtrol Corporation at (800) 926-6876 or send email to
 165 .Aq info@comtrol.com .
 166 To report bugs for this driver, please send email to
 167 .Aq bug-bsdi-rocketport@comtrol.com .
 168 .Sh BUGS
 169 If incoming software flow control is enabled on a 486 or Pentium
 170 machine, and the flow control is very heavily exercised, on rare occasions
 171 a character will get dropped.
 172 This problem does not occur on a 386, and
 173 it is not currently known whether the bug is in the
 174 .Nm
 175 driver
 176 or in the
 177 .Bsx
 178 tty layer.
 179 .\" (Although my bet is that it's in the higher-level tty layer;
 180 .\" given the bugs I found while writing this driver, it's clear
 181 .\" the BSD software flow control code hasn't been tested very much
 182 .\" at all! -- TYT)