rocket.txt 7.6 KB

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