home *** CD-ROM | disk | FTP | other *** search
/ ftp.comtrol.com / 2014.07.ftp.comtrol.com.tar / ftp.comtrol.com / usb_sh_iii / install_doc / linux / rpusbsh2+3_linux_install.txt
Text File  |  2008-03-28  |  10KB  |  271 lines
  1. ROCKETPORT USB SERIAL HUB II (4-Port)
  2. ROCKETPORT USB SERIAL HUB III (8-Port)
  3. LINUX DRIVER INSTALLATION (32 and 64-Bit)
  4.  
  5.  
  6. This document describes how to:
  7. *  System requirements
  8. *  Check if the USB driver is available on your system
  9. *  If necessary, recompile the kernel with the USB driver
  10. *  Attach the ROcketPort USB Serial Hub
  11. *  Connecting serial devices
  12. *  Special notes
  13. *  Test results
  14. *  Technical support
  15.  
  16. For detailed specification or connector information, see 
  17. rpusbsh2+3_hw_guide.pdf on the CD or http://www.comtrol.com/
  18. support/download.asp?partnumber=2000476
  19.  
  20.  
  21. -------------------
  22. System Requirements
  23. -------------------
  24. The PC connected to the RocketPort USB Serial Hub must meet the following 
  25. requirements:
  26.  
  27. *  A Pentium-class CPU system with an available USB port (type A, flat 
  28.    connector, downstream). The RocketPort USB Serial Hub II supports 
  29.    USB 2.0 and is USB 1.0 and 1.1 compatible. The RocketPort USB Serial 
  30.    Hub III supports USB 1.0 and is USB 2.0 compatible.
  31.    
  32. *  Linux distribution including the Prolific driver (pl2303) in the kernel,
  33.    compiled in or loaded as a module.
  34.  
  35.  
  36. -------------------------------
  37. HOW TO CHECK FOR THE USB DRIVER
  38. -------------------------------
  39. The first installation step is to see if the USB driver is available on your 
  40. system.
  41.  
  42. 1.  Attach the USB cable from the RocketPort USB Serial Hub to a USB port on 
  43.     your computer.
  44.  
  45. 2.  Login to the root account.
  46.  
  47. 3.  At the command prompt, type ôdmesg | grep ttyUSBö 
  48.  
  49.     The following shows example results:
  50.  
  51.     usb 2-1.1: pl2303 converter now attached to ttyUSB0
  52.     usb 2-1.2: pl2303 converter now attached to ttyUSB1
  53.     usb 2-1.3.1: pl2303 converter now attached to ttyUSB2
  54.     usb 2-1.3.2: pl2303 converter now attached to ttyUSB3
  55.     usb 2-1.3.3.1: pl2303 converter now attached to ttyUSB4
  56.     usb 2-1.3.3.2: pl2303 converter now attached to ttyUSB5
  57.     usb 2-1.3.3.3: pl2303 converter now attached to ttyUSB6
  58.     usb 2-1.3.3.4: pl2303 converter now attached to ttyUSB7
  59.  
  60. 4.  If you do see ttyUSB0, ttyUSB1, etc., the kernel already has the driver 
  61.     built in or the module is loaded, and you are ready to use your RocketPort 
  62.     USB Serial Hub. 
  63.  
  64.     If you do not see anything in the output from the above command about 
  65.     ttyUSB devices, go to the next procedure, as your kernel does not have 
  66.     the correct drivers compiled in or loaded in via module.
  67.  
  68.  
  69. -----------------------------------------------
  70. HOW TO RECOMPILE THE KERNEL WITH THE USB DRIVER
  71. -----------------------------------------------
  72. To recompile your kernel to include the correct drivers, follow the 
  73. instructions below. 
  74.  
  75. Optionally, refer to the following HOWTO at: 
  76. http://www.digitalhermit.com/linux/Kernel-Build-HOWTO.html for detailed
  77. information about recompiling your kernel.
  78.  
  79. 1.  At the command prompt, type ôuname ûaö. Note the result, which is the 
  80.     running kernel.
  81.  
  82. 2.  At the command prompt, type ôcd /usr/srcö 
  83.  
  84. 3.  At the command prompt, type ôls ûlö. Note the result, there should be a 
  85.     symbolic link from the running kernel to a directory called linux. 
  86.     Make sure that this symbolic link is there, which is provided in the
  87.     output noted above and if the linux directory has lrwxrwxrwx as 
  88.     itÆs permissions, it is a symbolic link. The output will also show to
  89.     which directory it is linked. This should point to the running kernel. 
  90.     If it is, continue on to Step 5. If not, go to Step 4.
  91.  
  92. 4.  To change the symbolic link perform the appropriate steps:
  93.  
  94.     a.  At the command line type ôrm ûrf linuxö
  95.  
  96.     b.  At the command line type:
  97.  
  98.         32-bit systems: ôln ûs 2.6.18-gentoo/ linuxö
  99.         64-bit systems: ôln ûs 2.6.17-gentoo-r8/ linuxö
  100.  
  101.         This step depends upon what kernel you are running. Review results
  102.         from Step 1 in the command after ln ûs, which is the running kernel 
  103.         as seen from the ôuname ûaö.
  104.  
  105. 5.  At the command prompt, type ôcd linuxö.
  106.  
  107. 6.  At the command prompt, type ômake menuconfigö, which opens the menu for 
  108.     configuring your kernel.
  109.  
  110. 7.  In the menu system for configuring the kernel, enable the following within
  111.     your kernel, are as follows:
  112.  
  113.     Device Drivers
  114.            USB Support
  115.                   <*> Support for host side USB
  116.                           USB Serial Converter support
  117.                                   <*> USB Serial Converter Support
  118.                                   <*> Prolific 2303 Single Port Serial Driver
  119.  
  120.     Now that you have enabled the options you need in your kernel to support 
  121.     the RocketPort USB Serial Hub II and III, you are ready to compile the 
  122.     kernel. To do so, make sure that you are exiting the menu system. 
  123.     It is important to save your settings when prompted.
  124.  
  125. 8.  At the command line, type ômake && make modules_installö. This compiles
  126.     the new kernel and modules. 
  127.  
  128. 9.  At this point, the new kernel is compiled and ready to use, however it 
  129.     will need to be copied to /boot or wherever your distribution stores 
  130.     itÆs kernel. 
  131.  
  132.     To copy the kernel to /boot: 
  133.  
  134.     32-bit systems:
  135.     ôcp ./arch/i386/boot/bzImage /boot/kernel-2.6.18-gentooö
  136.  
  137.     64-bit systems:
  138.     ôcp ./arch/x86_64/boot/bzImage /boot/kernel-2.6.17-gentoo-r8ö
  139.  
  140. 10. Update your boot loader to make it aware of the new kernel. You can use 
  141.     lilo or Grub. ônano ûw /etc/lilo.confö brings up your current lilo 
  142.     configuration. Add another entry in the lilo.conf file for your new
  143.     kernel. The easiest way to add another entry, is to cut and paste a 
  144.     copy of the entry for the previous kernel and put that below the 
  145.     previous kernel entry itself, and then edit the copied text to fit
  146.     your kernel. 
  147.  
  148.     An example lilo.conf with the second entry (32-bit or 64-bit) added is 
  149.     below: 
  150.  
  151.     boot=/dev/hda
  152.     prompt
  153.     timeout=50
  154.     default=gentoo
  155.  
  156.     image=/boot/kernel-2.6.17-gentoo-r4
  157.       label=gentoo
  158.       read-only
  159.       root=/dev/hda6
  160.  
  161.     32-bit system example:
  162.     --------------
  163.     image=/boot/kernel-2.6.18-gentoo
  164.       label=gentoo2.6.18
  165.       read-only
  166.       root=/dev/hda6
  167.  
  168.     64-bit system example:
  169.     ----------------------
  170.     image=/boot/kernel-2.6.17-gentoo-r8
  171.       label=gentoo-r8
  172.       read-only
  173.       root=/dev/hda6
  174.  
  175. 11. At the command prompt, type ô/sbin/liloö. This updates the copy of lilo 
  176.     that is in the master boot record so that it is aware of the new kernel.
  177.  
  178. 12. Reboot your machine, at the command prompt, type ôhaltö or ôrebootö. 
  179.  
  180. Go to the next section, "Attaching the RocketPort USB Serial Hub."
  181.  
  182.  
  183. ---------------------------------------
  184. Attaching the RocketPort USB Serial Hub
  185. ---------------------------------------
  186. 1.  If you have not done so, bring the machine back up.
  187.  
  188. 2.  Attach the USB cable from the RocketPort USB Serial Hub to a USB port on 
  189.     your computer. The system detects the device and creates ttyUSB0 through 
  190.     ttyUSB3 (RocketPort USB Serial Hub II) or ttyUSB0 through ttyUSB7 
  191.     (RocketPort USB Serial Hub III).
  192.  
  193. The RocketPort Serial Hub is now ready to use with the additional tty ports 
  194. that it provides. 
  195.  
  196.  
  197. -------------------------
  198. Connecting Serial Devices
  199. -------------------------
  200. Use the following procedure to connect serial devices to the RocketPort USB 
  201. Serial Hub. If you need to build a cable, see the Hardware Guide on the CD
  202. or refer to http://www.comtrol.com/support/download.asp?partnumber=2000476.
  203.  
  204. 1.  Connect the serial device(s) to the serial port(s) on the RocketPort USB 
  205.     Serial Hub.
  206.  
  207. 2.  Disconnect the USB cable from the RocketPort USB Serial Hub upstream port. 
  208.     The USB port is located next to the serial ports. 
  209.  
  210. 3.  Reconnect the USB cable to the RocketPort USB Serial Hub upstream port. 
  211.     The PC automatically locates and configures each serial port on the 
  212.     RocketPort USB Serial Hub. 
  213.  
  214. -------------
  215. Special Notes
  216. -------------
  217. If you switch the serial devices that are connected to the RocketPort USB 
  218. Serial Hub II, make sure that you disconnect and reconnect the upstream cable 
  219. (USB type B, square shape) from the device. 
  220.  
  221.  
  222. -------
  223. Testing
  224. -------
  225. This driver was tested on the following versions:
  226.  
  227. *  32- bit system: Gentoo Linux, release 2006.1, kernel 2.6.18-gentoo, on a 
  228.    computer with an AMD Athlon 1 Ghz CPU, and 384MB of ram.
  229.  
  230. *  64 bit system: Gentoo Linux, release 2006.1, kernel 2.6.17-gentoo-r8, on a 
  231.    computer with an AMD64 Turion64 X2 TL-50 dual core CPU, and 2GB RAM.
  232.  
  233.  
  234. -----------------
  235. Technical Support
  236. -----------------
  237. You can contact Comtrol Technical Support using the following methods:
  238.  
  239. FAQ/Online:  http://www.comtrol.com/support/
  240. Downloads:   http://www.comtrol.com/support/download.asp
  241. Web site:    http://www.comtrol.com
  242. Phone        763.494.4100
  243.  
  244.  
  245. -----------------
  246. Trademark Notices
  247. -----------------
  248. Comtrol and RocketPort are registered trademarks of Comtrol Corporation.
  249. Pentium is a trademark of Intel Corporation.
  250. Linux is a registered trademark of Linus Torvalds.
  251. Prolific is a trademark of Prolific Technology Inc.
  252.  
  253. Other product names mentioned herein may be trademarks and/or registered 
  254. trademarks of their respective owners.
  255.  
  256. First Edition, March 28, 2008
  257. Copyright ⌐ 2008. Comtrol Corporation. 
  258. All Rights Reserved.
  259. Comtrol Corporation makes no representations or warranties with regard to 
  260. the contents of this document or to the suitability of the Comtrol product
  261. for any particular purpose. Specifications subject to change without 
  262. notice. Some software or features may not be available at the time of 
  263. publication. Contact your reseller for current product information.
  264.  
  265.  
  266. ------------------------------------
  267. Document Number: 2000475 V1.03 Rev A.
  268.  
  269.  
  270.  
  271.