Blame view

Documentation/serial/rocket.txt 7.57 KB
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
  Comtrol(tm) RocketPort(R)/RocketModem(TM) Series 
  Device Driver for the Linux Operating System
  
  =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  
  PRODUCT OVERVIEW
  ----------------
  
  This driver provides a loadable kernel driver for the Comtrol RocketPort
  and RocketModem PCI boards. These boards provide, 2, 4, 8, 16, or 32 
  high-speed serial ports or modems.  This driver supports up to a combination
  of four RocketPort or RocketModems boards in one machine simultaneously.
  This file assumes that you are using the RocketPort driver which is
  integrated into the kernel sources.  
  
  The driver can also be installed as an external module using the usual 
  "make;make install" routine.  This external module driver, obtainable 
  from the Comtrol website listed below, is useful for updating the driver
  or installing it into kernels which do not have the driver configured
  into them.  Installations instructions for the external module
  are in the included README and HW_INSTALL files.
  
  RocketPort ISA and RocketModem II PCI boards currently are only supported by
  this driver in module form.
  
  The RocketPort ISA board requires I/O ports to be configured by the DIP
  switches on the board.  See the section "ISA Rocketport Boards" below for
  information on how to set the DIP switches.
  
  You pass the I/O port to the driver using the following module parameters:
  
  board1 :	I/O port for the first ISA board
  board2 :	I/O port for the second ISA board
  board3 :	I/O port for the third ISA board
  board4 :	I/O port for the fourth ISA board
  
  There is a set of utilities and scripts provided with the external driver
  ( downloadable from http://www.comtrol.com ) that ease the configuration and
  setup of the ISA cards.
  
  The RocketModem II PCI boards require firmware to be loaded into the card
  before it will function.  The driver has only been tested as a module for this
  board.
  
  =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  
  INSTALLATION PROCEDURES
  -----------------------
  
  RocketPort/RocketModem PCI cards require no driver configuration, they are 
  automatically detected and configured.
  
  The RocketPort driver can be installed as a module (recommended) or built 
  into the kernel. This is selected, as for other drivers, through the `make config`
  command from the root of the Linux source tree during the kernel build process. 
  
  The RocketPort/RocketModem serial ports installed by this driver are assigned
  device major number 46, and will be named /dev/ttyRx, where x is the port number 
  starting at zero (ex. /dev/ttyR0, /devttyR1, ...).  If you have multiple cards
  installed in the system, the mapping of port names to serial ports is displayed
  in the system log at /var/log/messages.
  
  If installed as a module, the module must be loaded.  This can be done
  manually by entering "modprobe rocket".  To have the module loaded automatically
  upon system boot, edit the /etc/modprobe.conf file and add the line
  "alias char-major-46 rocket".
  
  In order to use the ports, their device names (nodes) must be created with mknod.
  This is only required once, the system will retain the names once created.  To 
  create the RocketPort/RocketModem device names, use the command 
  "mknod /dev/ttyRx c 46 x" where x is the port number starting at zero.  For example:
  
  >mknod /dev/ttyR0 c 46 0
  >mknod /dev/ttyR1 c 46 1
  >mknod /dev/ttyR2 c 46 2  
  
  The Linux script MAKEDEV will create the first 16 ttyRx device names (nodes)
  for you:
  
  >/dev/MAKEDEV ttyR
  
  =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  
  ISA Rocketport Boards
  ---------------------
  
  You must assign and configure the I/O addresses used by the ISA Rocketport
  card before installing and using it.  This is done by setting a set of DIP
  switches on the Rocketport board.
  
  
  SETTING THE I/O ADDRESS
  -----------------------
  
  Before installing RocketPort(R) or RocketPort RA boards, you must find
  a range of I/O addresses for it to use. The first RocketPort card
  requires a 68-byte contiguous block of I/O addresses, starting at one
  of the following: 0x100h, 0x140h, 0x180h, 0x200h, 0x240h, 0x280h,
  0x300h, 0x340h, 0x380h.  This I/O address must be reflected in the DIP
53cb47268   Matt LaPlante   Fix typos in Docu...
100
  switches of *all* of the Rocketport cards.
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
101
102
103
104
105
106
107
108
  
  The second, third, and fourth RocketPort cards require a 64-byte
  contiguous block of I/O addresses, starting at one of the following
  I/O addresses: 0x100h, 0x140h, 0x180h, 0x1C0h, 0x200h, 0x240h, 0x280h,
  0x2C0h, 0x300h, 0x340h, 0x380h, 0x3C0h.  The I/O address used by the
  second, third, and fourth Rocketport cards (if present) are set via
  software control.  The DIP switch settings for the I/O address must be
  set to the value of the first Rocketport cards.
fff9289b2   Matt LaPlante   Fix typos in Docu...
109
  In order to distinguish each of the card from the others, each card
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
110
111
112
113
114
115
116
117
118
119
120
121
  must have a unique board ID set on the dip switches.  The first
  Rocketport board must be set with the DIP switches corresponding to
  the first board, the second board must be set with the DIP switches
  corresponding to the second board, etc.  IMPORTANT: The board ID is
  the only place where the DIP switch settings should differ between the
  various Rocketport boards in a system.
  
  The I/O address range used by any of the RocketPort cards must not
  conflict with any other cards in the system, including other
  RocketPort cards.  Below, you will find a list of commonly used I/O
  address ranges which may be in use by other devices in your system.
  On a Linux system, "cat /proc/ioports" will also be helpful in
fff9289b2   Matt LaPlante   Fix typos in Docu...
122
  identifying what I/O addresses are being used by devices on your
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
  system.
  
  Remember, the FIRST RocketPort uses 68 I/O addresses.  So, if you set it
  for 0x100, it will occupy 0x100 to 0x143.  This would mean that you
  CAN NOT set the second, third or fourth board for address 0x140 since
  the first 4 bytes of that range are used by the first board.  You would
  need to set the second, third, or fourth board to one of the next available
  blocks such as 0x180.
  
  =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  
  RocketPort and RocketPort RA SW1 Settings:
  
            +-------------------------------+
            | 8 | 7 | 6 | 5 | 4 | 3 | 2 | 1 |
            +-------+-------+---------------+
            | Unused| Card  | I/O Port Block|
            +-------------------------------+
  
  DIP Switches                             DIP Switches
  7    8                                   6    5
  ===================                      ===================
  On   On   UNUSED, MUST BE ON.            On   On   First Card    <==== Default
                                           On   Off  Second Card
                                           Off  On   Third Card
                                           Off  Off  Fourth Card
  
  DIP Switches         I/O Address Range
  4    3    2    1     Used by the First Card
  =====================================
  On   Off  On   Off   100-143
  On   Off  Off  On    140-183
  On   Off  Off  Off   180-1C3       <==== Default
  Off  On   On   Off   200-243
  Off  On   Off  On    240-283
  Off  On   Off  Off   280-2C3
  Off  Off  On   Off   300-343
  Off  Off  Off  On    340-383
  Off  Off  Off  Off   380-3C3
  
  =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  
  REPORTING BUGS
  --------------
  
  For technical support, please provide the following
  information: Driver version, kernel release, distribution of
  kernel, and type of board you are using. Error messages and log
  printouts port configuration details are especially helpful.
  
  USA
      Phone: (612) 494-4100
        FAX: (612) 494-4199
      email: support@comtrol.com
  
  Comtrol Europe
      Phone: +44 (0) 1 869 323-220
        FAX: +44 (0) 1 869 323-211
      email: support@comtrol.co.uk
  
  Web:	http://www.comtrol.com
  FTP:	ftp.comtrol.com
  
  =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-