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