Documentation/usb/gadget_serial.rst

27 This document and the gadget serial driver itself are
30 If you have questions, problems, or suggestions for this driver
36 Versions of the gadget serial driver are available for the
38 version 2.3 or later of the gadget serial driver in a 2.6
47 With version 2.3 of the driver, major and minor device nodes are
56 The gadget serial driver is a Linux USB gadget driver, a USB device
57 side driver.  It runs on a Linux system that has USB device side
61 The gadget serial driver talks over USB to either a CDC ACM driver
62 or a generic USB serial driver running on a host PC::
84 On the device-side Linux system, the gadget serial driver looks
92 The host side driver can potentially be any ACM compliant driver
93 or any driver that can talk to a device with a simple bulk in/out
94 interface.  Gadget serial has been tested with the Linux ACM driver,
95 the Windows usbser.sys ACM driver, and the Linux USB generic serial
96 driver.
98 With the gadget serial driver and the host side ACM or generic
99 serial driver running, you should be able to communicate between
103 The gadget serial driver only provides simple unreliable data
110 To use the gadget serial driver you must configure the Linux gadget
113 driver.  All this are listed under "USB Gadget Support" when
117 Then you must load the gadget serial driver.  To load it as an
127 controller driver.  This must be done each time you reboot the gadget
132 device nodes.  After this gadget driver has been set up you should
143 When you link this gadget driver early, perhaps even statically,
149 either the Windows or Linux ACM driver on the host side.  If gadget
151 Linux generic serial driver on the host side.  Follow the appropriate
152 instructions below to install the host side driver.
157 To use the Windows ACM driver you must have the "linux-cdc-acm.inf"
161 When the gadget serial driver is loaded and the USB device connected
163 gadget serial device and ask for a driver.  Tell Windows to find the
164 driver in the folder that contains the "linux-cdc-acm.inf" file.
171 Windows will complain that the Gadget Serial driver has not passed
173 driver installation.
177 should see "Gadget Serial" listed as the driver for one of the COM
180 To uninstall the Windows XP driver for "Gadget Serial", right click
187 To use the Linux ACM driver you must configure the Linux host side
191 Once the gadget serial driver is loaded and the USB device connected
212 If the host side Linux system is configured properly, the ACM driver
219 To use the Linux generic USB serial driver you must configure the
223 Once the gadget serial driver is loaded and the USB device connected
242 You must load the usbserial driver and explicitly set its parameters
258 Once the gadget serial driver and the host driver are both installed,
269 On a Linux host running the ACM driver, configure minicom similarly
273 On a Linux host running the USB generic serial driver, configure