fedora core 6 1.2949 + vserver 2.2.0
[linux-2.6.git] / Documentation / usb / usb-serial.txt
index d431f19..d61f6e7 100644 (file)
@@ -13,7 +13,6 @@ CONFIGURATION
   Currently the driver can handle up to 256 different serial interfaces at
   one time. 
 
-  If you are not using devfs:
     The major number that the driver uses is 188 so to use the driver,
     create the following nodes:
        mknod /dev/ttyUSB0 c 188 0
@@ -26,10 +25,6 @@ CONFIGURATION
        mknod /dev/ttyUSB254 c 188 254
        mknod /dev/ttyUSB255 c 188 255
 
-  If you are using devfs:
-    The devices supported by this driver will show up as
-    /dev/usb/tts/{0,1,...}
-
   When the device is connected and recognized by the driver, the driver
   will print to the system log, which node(s) the device has been bound
   to.
@@ -180,7 +175,7 @@ Keyspan USA-series Serial Adapters
   
   Current status:
     The USA-18X, USA-28X, USA-19, USA-19W and USA-49W are supported and
-    have been pretty throughly tested at various baud rates with 8-N-1
+    have been pretty thoroughly tested at various baud rates with 8-N-1
     character settings.  Other character lengths and parity setups are
     presently untested.
 
@@ -211,6 +206,62 @@ ZyXEL omni.net lcd plus ISDN TA
   azummo@towertech.it
 
 
+Cypress M8 CY4601 Family Serial Driver
+
+  This driver was in most part developed by Neil "koyama" Whelchel.  It
+  has been improved since that previous form to support dynamic serial
+  line settings and improved line handling.  The driver is for the most
+  part stable and has been tested on an smp machine. (dual p2)
+
+    Chipsets supported under CY4601 family:
+       
+               CY7C63723, CY7C63742, CY7C63743, CY7C64013
+
+    Devices supported:
+
+               -DeLorme's USB Earthmate (SiRF Star II lp arch)
+               -Cypress HID->COM RS232 adapter
+       
+               Note: Cypress Semiconductor claims no affiliation with the
+                       hid->com device.
+
+       Most devices using chipsets under the CY4601 family should
+     work with the driver.  As long as they stay true to the CY4601
+     usbserial specification.
+
+    Technical notes:
+
+        The Earthmate starts out at 4800 8N1 by default... the driver will
+       upon start init to this setting.  usbserial core provides the rest
+       of the termios settings, along with some custom termios so that the
+       output is in proper format and parsable.
+       
+       The device can be put into sirf mode by issuing NMEA command:
+               $PSRF100,<protocol>,<baud>,<databits>,<stopbits>,<parity>*CHECKSUM
+               $PSRF100,0,9600,8,1,0*0C
+
+               It should then be sufficient to change the port termios to match this
+               to begin communicating.
+
+       As far as I can tell it supports pretty much every sirf command as
+       documented online available with firmware 2.31, with some unknown
+       message ids.
+
+       The hid->com adapter can run at a maximum baud of 115200bps.  Please note
+       that the device has trouble or is incapable of raising line voltage properly.
+       It will be fine with null modem links, as long as you do not try to link two
+       together without hacking the adapter to set the line high.
+
+       The driver is smp safe.  Performance with the driver is rather low when using
+       it for transferring files.  This is being worked on, but I would be willing to
+       accept patches.  An urb queue or packet buffer would likely fit the bill here.
+
+       If you have any questions, problems, patches, feature requests, etc. you can
+       contact me here via email:
+                                       dignome@gmail.com
+               (your problems/patches can alternately be submitted to usb-devel)
+
+
 Digi AccelePort Driver
 
   This driver supports the Digi AccelePort USB 2 and 4 devices, 2 port
@@ -221,7 +272,7 @@ Digi AccelePort Driver
   work under SMP with the uhci driver.
 
   The driver is generally working, though we still have a few more ioctls
-  to implement and final testing and debugging to do.  The paralled port
+  to implement and final testing and debugging to do.  The parallel port
   on the USB 2 is supported as a serial to parallel converter; in other
   words, it appears as another USB serial port on Linux, even though
   physically it is really a parallel port.  The Digi Acceleport USB 8
@@ -246,7 +297,7 @@ Belkin USB Serial Adapter F5U103
       Parity       N,E,O,M,S
       Handshake    None, Software (XON/XOFF), Hardware (CTSRTS,CTSDTR)*
       Break        Set and clear
-      Line contr Input/Output query and control **
+      Line control Input/Output query and control **
 
       *  Hardware input flow control is only enabled for firmware
          levels above 2.06.  Read source code comments describing Belkin
@@ -258,7 +309,7 @@ Belkin USB Serial Adapter F5U103
          automatic hardware flow control.
 
   TO DO List:
-    -- Add true modem contol line query capability.  Currently tracks the
+    -- Add true modem control line query capability.  Currently tracks the
        states reported by the interrupt and the states requested.
     -- Add error reporting back to application for UART error conditions.
     -- Add support for flush ioctls.
@@ -343,10 +394,10 @@ REINER SCT cyberJack pinpad/e-com USB chipcard reader
 
 Prolific PL2303 Driver
 
-  This driver support any device that has the PL2303 chip from Prolific
+  This driver supports any device that has the PL2303 chip from Prolific
   in it.  This includes a number of single port USB to serial
   converters and USB GPS devices.  Devices from Aten (the UC-232) and
-  IO-Data work with this driver.
+  IO-Data work with this driver, as does the DCU-11 mobile-phone cable.
 
   For any questions or problems with this driver, please contact Greg
   Kroah-Hartman at greg@kroah.com
@@ -371,13 +422,12 @@ Options supported:
   debug                        - extra verbose debugging info
                          (default: 0; nonzero enables)
   use_lowlatency       - use low_latency flag to speed up tty layer
-                         when reading from from the device.
+                         when reading from the device.
                          (default: 0; nonzero enables)
 
   See http://www.uuhaus.de/linux/palmconnect.html for up-to-date
   information on this driver.
 
-
 Generic Serial driver
 
   If your device is not one of the above listed devices, compatible with