share/man/man4/rp.4

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