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