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)
|