mirror of
https://github.com/edk2-porting/linux-next.git
synced 2024-12-27 14:43:58 +08:00
970e248649
Usage of /etc/modprobe.conf file was deprecated by module-init-tools and is no longer parsed by new kmod tool. References to this file are replaced in Documentation, comments and Kconfig according to the context. There are also some references to the old /etc/modules.conf from 2.4 kernels that are being removed. Signed-off-by: Lucas De Marchi <lucas.demarchi@profusion.mobi> Acked-by: Takashi Iwai <tiwai@suse.de> Acked-by: Mauro Carvalho Chehab <mchehab@redhat.com> Signed-off-by: Randy Dunlap <rdunlap@xenotime.net> Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
190 lines
7.6 KiB
Plaintext
190 lines
7.6 KiB
Plaintext
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 a /etc/modprobe.d/*.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
|
|
switches of *all* of the Rocketport cards.
|
|
|
|
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.
|
|
|
|
In order to distinguish each of the card from the others, each card
|
|
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
|
|
identifying what I/O addresses are being used by devices on your
|
|
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
|
|
|
|
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
|
|
|
|
|