Documentation/usb/gadget_serial.rst

2 Linux Gadget Serial Driver v2.0
27 This document and the gadget serial driver itself are
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
45 gadget and usb drivers as modules.
56 The gadget serial driver is a Linux USB gadget driver, a USB device
61 The gadget serial driver talks over USB to either a CDC ACM driver
75    Gadget                                         |
77   | Gadget                   USB Periph. |        |
78   | Device-Side |  Gadget  | Controller  |        |
84 On the device-side Linux system, the gadget serial driver looks
87 On the host-side system, the gadget serial device looks like a
94 interface.  Gadget serial has been tested with the Linux ACM driver,
98 With the gadget serial driver and the host side ACM or generic
100 the host and the gadget side systems as if they were connected by a
103 The gadget serial driver only provides simple unreliable data
108 Installing the Gadget Serial Driver
110 To use the gadget serial driver you must configure the Linux gadget
112 Controller" (for example, net2280), and for the "Serial 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
126 This will also automatically load the underlying gadget peripheral
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,
148 If gadget serial is loaded as an ACM device you will want to use
149 either the Windows or Linux ACM driver on the host side.  If gadget
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
166 For example, on Windows XP, when the gadget serial device is first
171 Windows will complain that the Gadget Serial driver has not passed
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
181 on the "Gadget Serial" entry in the "Device Manager" and select
191 Once the gadget serial driver is loaded and the USB device connected
193 the gadget serial device.  For example, the command::
203   S:  Product=Gadget Serial
223 Once the gadget serial driver is loaded and the USB device connected
225 the gadget serial device.  For example, the command::
235   S:  Product=Gadget Serial
243 to configure it to recognize the gadget serial device, like this::
252 system log saying something like "Gadget Serial converter now
258 Once the gadget serial driver and the host driver are both installed,
259 and a USB cable connects the gadget device to the host, you should
260 be able to communicate over USB between the gadget and host systems.
263 On the gadget side run "minicom -s" to configure a new minicom
279 COM port assigned to Gadget Serial.  The "Port Settings" will be
280 set automatically when HyperTerminal connects to the gadget serial
284 With minicom configured and running on the gadget side and with
286 you should be able to send data back and forth between the gadget
288 window on the gadget side should appear in the terminal window on