€•¢‡      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ%/translations/zh_CN/usb/gadget_serial”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ%/translations/zh_TW/usb/gadget_serial”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ%/translations/it_IT/usb/gadget_serial”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ%/translations/ja_JP/usb/gadget_serial”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ%/translations/ko_KR/usb/gadget_serial”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒPortuguese (Brazilian)”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ%/translations/pt_BR/usb/gadget_serial”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh–sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ%/translations/sp_SP/usb/gadget_serial”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒLinux Gadget Serial Driver v2.0”h]”hŒLinux Gadget Serial Driver v2.0”…””}”(hh¼h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhh·h²hh³Œ?/var/lib/git/docbuild/linux/Documentation/usb/gadget_serial.rst”h´KubhŒ	paragraph”“”)”}”(hŒ
11/20/2004”h]”hŒ
11/20/2004”…””}”(hhÍh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khh·h²hubhÌ)”}”(hŒ(updated 8-May-2008 for v2.3)”h]”hŒ(updated 8-May-2008 for v2.3)”…””}”(hhÛh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khh·h²hubh¶)”}”(hhh]”(h»)”}”(hŒLicense and Disclaimer”h]”hŒLicense and Disclaimer”…””}”(hhìh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhhéh²hh³hÊh´KubhÌ)”}”(hŒïThis program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of
the License, or (at your option) any later version.”h]”hŒïThis program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of
the License, or (at your option) any later version.”…””}”(hhúh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khhéh²hubhÌ)”}”(hŒéThis program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.”h]”hŒéThis program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khhéh²hubhÌ)”}”(hŒÆYou should have received a copy of the GNU General Public
License along with this program; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston,
MA 02111-1307 USA.”h]”hŒÆYou should have received a copy of the GNU General Public
License along with this program; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston,
MA 02111-1307 USA.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khhéh²hubhÌ)”}”(hŒvThis document and the gadget serial driver itself are
Copyright (C) 2004 by Al Borchers (alborchers@steinerpoint.com).”h]”(hŒYThis document and the gadget serial driver itself are
Copyright (C) 2004 by Al Borchers (”…””}”(hj$  h²hh³Nh´NubhŒ	reference”“”)”}”(hŒalborchers@steinerpoint.com”h]”hŒalborchers@steinerpoint.com”…””}”(hj.  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œ"mailto:alborchers@steinerpoint.com”uh1j,  hj$  ubhŒ).”…””}”(hj$  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khhéh²hubhÌ)”}”(hŒzIf you have questions, problems, or suggestions for this driver
please contact Al Borchers at alborchers@steinerpoint.com.”h]”(hŒ^If you have questions, problems, or suggestions for this driver
please contact Al Borchers at ”…””}”(hjH  h²hh³Nh´Nubj-  )”}”(hŒalborchers@steinerpoint.com”h]”hŒalborchers@steinerpoint.com”…””}”(hjP  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œ"mailto:alborchers@steinerpoint.com”uh1j,  hjH  ubhŒ.”…””}”(hjH  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khhéh²hubeh}”(h]”Œlicense-and-disclaimer”ah ]”h"]”Œlicense and disclaimer”ah$]”h&]”uh1hµhh·h²hh³hÊh´Kubh¶)”}”(hhh]”(h»)”}”(hŒPrerequisites”h]”hŒPrerequisites”…””}”(hju  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjr  h²hh³hÊh´K#ubhÌ)”}”(hŒ½Versions of the gadget serial driver are available for the
2.4 Linux kernels, but this document assumes you are using
version 2.3 or later of the gadget serial driver in a 2.6
Linux kernel.”h]”hŒ½Versions of the gadget serial driver are available for the
2.4 Linux kernels, but this document assumes you are using
version 2.3 or later of the gadget serial driver in a 2.6
Linux kernel.”…””}”(hjƒ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K$hjr  h²hubhÌ)”}”(hX  This document assumes that you are familiar with Linux and
Windows and know how to configure and build Linux kernels, run
standard utilities, use minicom and HyperTerminal, and work with
USB and serial devices.  It also assumes you configure the Linux
gadget and usb drivers as modules.”h]”hX  This document assumes that you are familiar with Linux and
Windows and know how to configure and build Linux kernels, run
standard utilities, use minicom and HyperTerminal, and work with
USB and serial devices.  It also assumes you configure the Linux
gadget and usb drivers as modules.”…””}”(hj‘  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K)hjr  h²hubhÌ)”}”(hŒùWith version 2.3 of the driver, major and minor device nodes are
no longer statically defined.  Your Linux based system should mount
sysfs in /sys, and use "mdev" (in Busybox) or "udev" to make the
/dev nodes matching the sysfs /sys/class/tty files.”h]”hX  With version 2.3 of the driver, major and minor device nodes are
no longer statically defined.  Your Linux based system should mount
sysfs in /sys, and use â€œmdevâ€ (in Busybox) or â€œudevâ€ to make the
/dev nodes matching the sysfs /sys/class/tty files.”…””}”(hjŸ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K/hjr  h²hubeh}”(h]”Œprerequisites”ah ]”h"]”Œprerequisites”ah$]”h&]”uh1hµhh·h²hh³hÊh´K#ubh¶)”}”(hhh]”(h»)”}”(hŒOverview”h]”hŒOverview”…””}”(hj¸  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjµ  h²hh³hÊh´K7ubhÌ)”}”(hŒáThe gadget serial driver is a Linux USB gadget driver, a USB device
side driver.  It runs on a Linux system that has USB device side
hardware; for example, a PDA, an embedded Linux system, or a PC
with a USB development card.”h]”hŒáThe gadget serial driver is a Linux USB gadget driver, a USB device
side driver.  It runs on a Linux system that has USB device side
hardware; for example, a PDA, an embedded Linux system, or a PC
with a USB development card.”…””}”(hjÆ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K8hjµ  h²hubhÌ)”}”(hŒxThe gadget serial driver talks over USB to either a CDC ACM driver
or a generic USB serial driver running on a host PC::”h]”hŒwThe gadget serial driver talks over USB to either a CDC ACM driver
or a generic USB serial driver running on a host PC:”…””}”(hjÔ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K=hjµ  h²hubhŒliteral_block”“”)”}”(hXU   Host
 --------------------------------------
| Host-Side   CDC ACM       USB Host   |
| Operating |   or        | Controller |   USB
| System    | Generic USB | Driver     |--------
| (Linux or | Serial      | and        |        |
| Windows)    Driver        USB Stack  |        |
 --------------------------------------         |
                                                |
                                                |
                                                |
 Gadget                                         |
 --------------------------------------         |
| Gadget                   USB Periph. |        |
| Device-Side |  Gadget  | Controller  |        |
| Linux       |  Serial  | Driver      |--------
| Operating   |  Driver  | and         |
| System                   USB Stack   |
 --------------------------------------”h]”hXU   Host
 --------------------------------------
| Host-Side   CDC ACM       USB Host   |
| Operating |   or        | Controller |   USB
| System    | Generic USB | Driver     |--------
| (Linux or | Serial      | and        |        |
| Windows)    Driver        USB Stack  |        |
 --------------------------------------         |
                                                |
                                                |
                                                |
 Gadget                                         |
 --------------------------------------         |
| Gadget                   USB Periph. |        |
| Device-Side |  Gadget  | Controller  |        |
| Linux       |  Serial  | Driver      |--------
| Operating   |  Driver  | and         |
| System                   USB Stack   |
 --------------------------------------”…””}”hjä  sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1jâ  h³hÊh´K@hjµ  h²hubhÌ)”}”(hŒUOn the device-side Linux system, the gadget serial driver looks
like a serial device.”h]”hŒUOn the device-side Linux system, the gadget serial driver looks
like a serial device.”…””}”(hjô  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KThjµ  h²hubhÌ)”}”(hŒÚOn the host-side system, the gadget serial device looks like a
CDC ACM compliant class device or a simple vendor specific device
with bulk in and bulk out endpoints, and it is treated similarly
to other serial devices.”h]”hŒÚOn the host-side system, the gadget serial device looks like a
CDC ACM compliant class device or a simple vendor specific device
with bulk in and bulk out endpoints, and it is treated similarly
to other serial devices.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KWhjµ  h²hubhÌ)”}”(hX  The host side driver can potentially be any ACM compliant driver
or any driver that can talk to a device with a simple bulk in/out
interface.  Gadget serial has been tested with the Linux ACM driver,
the Windows usbser.sys ACM driver, and the Linux USB generic serial
driver.”h]”hX  The host side driver can potentially be any ACM compliant driver
or any driver that can talk to a device with a simple bulk in/out
interface.  Gadget serial has been tested with the Linux ACM driver,
the Windows usbser.sys ACM driver, and the Linux USB generic serial
driver.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K\hjµ  h²hubhÌ)”}”(hŒÑWith the gadget serial driver and the host side ACM or generic
serial driver running, you should be able to communicate between
the host and the gadget side systems as if they were connected by a
serial cable.”h]”hŒÑWith the gadget serial driver and the host side ACM or generic
serial driver running, you should be able to communicate between
the host and the gadget side systems as if they were connected by a
serial cable.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kbhjµ  h²hubhÌ)”}”(hŒ¢The gadget serial driver only provides simple unreliable data
communication.  It does not yet handle flow control or many other
features of normal serial devices.”h]”hŒ¢The gadget serial driver only provides simple unreliable data
communication.  It does not yet handle flow control or many other
features of normal serial devices.”…””}”(hj,  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kghjµ  h²hubeh}”(h]”Œoverview”ah ]”h"]”Œoverview”ah$]”h&]”uh1hµhh·h²hh³hÊh´K7ubh¶)”}”(hhh]”(h»)”}”(hŒ#Installing the Gadget Serial Driver”h]”hŒ#Installing the Gadget Serial Driver”…””}”(hjE  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjB  h²hh³hÊh´KmubhÌ)”}”(hXJ  To use the gadget serial driver you must configure the Linux gadget
side kernel for "Support for USB Gadgets", for a "USB Peripheral
Controller" (for example, net2280), and for the "Serial Gadget"
driver.  All this are listed under "USB Gadget Support" when
configuring the kernel.  Then rebuild and install the kernel or
modules.”h]”hXZ  To use the gadget serial driver you must configure the Linux gadget
side kernel for â€œSupport for USB Gadgetsâ€, for a â€œUSB Peripheral
Controllerâ€ (for example, net2280), and for the â€œSerial Gadgetâ€
driver.  All this are listed under â€œUSB Gadget Supportâ€ when
configuring the kernel.  Then rebuild and install the kernel or
modules.”…””}”(hjS  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KnhjB  h²hubhÌ)”}”(hŒwThen you must load the gadget serial driver.  To load it as an
ACM device (recommended for interoperability), do this::”h]”hŒvThen you must load the gadget serial driver.  To load it as an
ACM device (recommended for interoperability), do this:”…””}”(hja  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KuhjB  h²hubjã  )”}”(hŒmodprobe g_serial”h]”hŒmodprobe g_serial”…””}”hjo  sbah}”(h]”h ]”h"]”h$]”h&]”jò  jó  uh1jâ  h³hÊh´KxhjB  h²hubhÌ)”}”(hŒ=To load it as a vendor specific bulk in/out device, do this::”h]”hŒ<To load it as a vendor specific bulk in/out device, do this:”…””}”(hj}  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KzhjB  h²hubjã  )”}”(hŒmodprobe g_serial use_acm=0”h]”hŒmodprobe g_serial use_acm=0”…””}”hj‹  sbah}”(h]”h ]”h"]”h$]”h&]”jò  jó  uh1jâ  h³hÊh´K|hjB  h²hubhÌ)”}”(hŒÒThis will also automatically load the underlying gadget peripheral
controller driver.  This must be done each time you reboot the gadget
side Linux system.  You can add this to the start up scripts, if
desired.”h]”hŒÒThis will also automatically load the underlying gadget peripheral
controller driver.  This must be done each time you reboot the gadget
side Linux system.  You can add this to the start up scripts, if
desired.”…””}”(hj™  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K~hjB  h²hubhÌ)”}”(hŒŸYour system should use mdev (from busybox) or udev to make the
device nodes.  After this gadget driver has been set up you should
then see a /dev/ttyGS0 node::”h]”hŒžYour system should use mdev (from busybox) or udev to make the
device nodes.  After this gadget driver has been set up you should
then see a /dev/ttyGS0 node:”…””}”(hj§  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KƒhjB  h²hubjã  )”}”(hŒ_# ls -l /dev/ttyGS0 | cat
crw-rw----    1 root     root     253,   0 May  8 14:10 /dev/ttyGS0
#”h]”hŒ_# ls -l /dev/ttyGS0 | cat
crw-rw----    1 root     root     253,   0 May  8 14:10 /dev/ttyGS0
#”…””}”hjµ  sbah}”(h]”h ]”h"]”h$]”h&]”jò  jó  uh1jâ  h³hÊh´K‡hjB  h²hubhÌ)”}”(hŒ®Note that the major number (253, above) is system-specific.  If
you need to create /dev nodes by hand, the right numbers to use
will be in the /sys/class/tty/ttyGS0/dev file.”h]”hŒ®Note that the major number (253, above) is system-specific.  If
you need to create /dev nodes by hand, the right numbers to use
will be in the /sys/class/tty/ttyGS0/dev file.”…””}”(hjÃ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K‹hjB  h²hubhÌ)”}”(hŒÅWhen you link this gadget driver early, perhaps even statically,
you may want to set up an /etc/inittab entry to run "getty" on it.
The /dev/ttyGS0 line should work like most any other serial port.”h]”hŒÉWhen you link this gadget driver early, perhaps even statically,
you may want to set up an /etc/inittab entry to run â€œgettyâ€ on it.
The /dev/ttyGS0 line should work like most any other serial port.”…””}”(hjÑ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KhjB  h²hubhÌ)”}”(hXA  If gadget serial is loaded as an ACM device you will want to use
either the Windows or Linux ACM driver on the host side.  If gadget
serial is loaded as a bulk in/out device, you will want to use the
Linux generic serial driver on the host side.  Follow the appropriate
instructions below to install the host side driver.”h]”hXA  If gadget serial is loaded as an ACM device you will want to use
either the Windows or Linux ACM driver on the host side.  If gadget
serial is loaded as a bulk in/out device, you will want to use the
Linux generic serial driver on the host side.  Follow the appropriate
instructions below to install the host side driver.”…””}”(hjß  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K”hjB  h²hubeh}”(h]”Œ#installing-the-gadget-serial-driver”ah ]”h"]”Œ#installing the gadget serial driver”ah$]”h&]”uh1hµhh·h²hh³hÊh´Kmubh¶)”}”(hhh]”(h»)”}”(hŒ&Installing the Windows Host ACM Driver”h]”hŒ&Installing the Windows Host ACM Driver”…””}”(hjø  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjõ  h²hh³hÊh´KœubhÌ)”}”(hŒ–To use the Windows ACM driver you must have the "linux-cdc-acm.inf"
file (provided along this document) which supports all recent versions
of Windows.”h]”hŒšTo use the Windows ACM driver you must have the â€œlinux-cdc-acm.infâ€
file (provided along this document) which supports all recent versions
of Windows.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khjõ  h²hubhÌ)”}”(hX  When the gadget serial driver is loaded and the USB device connected
to the Windows host with a USB cable, Windows should recognize the
gadget serial device and ask for a driver.  Tell Windows to find the
driver in the folder that contains the "linux-cdc-acm.inf" file.”h]”hX  When the gadget serial driver is loaded and the USB device connected
to the Windows host with a USB cable, Windows should recognize the
gadget serial device and ask for a driver.  Tell Windows to find the
driver in the folder that contains the â€œlinux-cdc-acm.infâ€ file.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K¡hjõ  h²hubhÌ)”}”(hXë  For example, on Windows XP, when the gadget serial device is first
plugged in, the "Found New Hardware Wizard" starts up.  Select
"Install from a list or specific location (Advanced)", then on the
next screen select "Include this location in the search" and enter the
path or browse to the folder containing the "linux-cdc-acm.inf" file.
Windows will complain that the Gadget Serial driver has not passed
Windows Logo testing, but select "Continue anyway" and finish the
driver installation.”h]”hXÿ  For example, on Windows XP, when the gadget serial device is first
plugged in, the â€œFound New Hardware Wizardâ€ starts up.  Select
â€œInstall from a list or specific location (Advanced)â€, then on the
next screen select â€œInclude this location in the searchâ€ and enter the
path or browse to the folder containing the â€œlinux-cdc-acm.infâ€ file.
Windows will complain that the Gadget Serial driver has not passed
Windows Logo testing, but select â€œContinue anywayâ€ and finish the
driver installation.”…””}”(hj"  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K¦hjõ  h²hubhÌ)”}”(hŒËOn Windows XP, in the "Device Manager" (under "Control Panel",
"System", "Hardware") expand the "Ports (COM & LPT)" entry and you
should see "Gadget Serial" listed as the driver for one of the COM
ports.”h]”hŒãOn Windows XP, in the â€œDevice Managerâ€ (under â€œControl Panelâ€,
â€œSystemâ€, â€œHardwareâ€) expand the â€œPorts (COM & LPT)â€ entry and you
should see â€œGadget Serialâ€ listed as the driver for one of the COM
ports.”…””}”(hj0  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K¯hjõ  h²hubhÌ)”}”(hŒTo uninstall the Windows XP driver for "Gadget Serial", right click
on the "Gadget Serial" entry in the "Device Manager" and select
"Uninstall".”h]”hŒ To uninstall the Windows XP driver for â€œGadget Serialâ€, right click
on the â€œGadget Serialâ€ entry in the â€œDevice Managerâ€ and select
â€œUninstallâ€.”…””}”(hj>  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K´hjõ  h²hubeh}”(h]”Œ&installing-the-windows-host-acm-driver”ah ]”h"]”Œ&installing the windows host acm driver”ah$]”h&]”uh1hµhh·h²hh³hÊh´Kœubh¶)”}”(hhh]”(h»)”}”(hŒ$Installing the Linux Host ACM Driver”h]”hŒ$Installing the Linux Host ACM Driver”…””}”(hjW  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjT  h²hh³hÊh´KºubhÌ)”}”(hŒTo use the Linux ACM driver you must configure the Linux host side
kernel for "Support for Host-side USB" and for "USB Modem (CDC ACM)
support".”h]”hŒ˜To use the Linux ACM driver you must configure the Linux host side
kernel for â€œSupport for Host-side USBâ€ and for â€œUSB Modem (CDC ACM)
supportâ€.”…””}”(hje  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K»hjT  h²hubhÌ)”}”(hŒ¿Once the gadget serial driver is loaded and the USB device connected
to the Linux host with a USB cable, the host system should recognize
the gadget serial device.  For example, the command::”h]”hŒ¾Once the gadget serial driver is loaded and the USB device connected
to the Linux host with a USB cable, the host system should recognize
the gadget serial device.  For example, the command:”…””}”(hjs  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K¿hjT  h²hubjã  )”}”(hŒ!cat /sys/kernel/debug/usb/devices”h]”hŒ!cat /sys/kernel/debug/usb/devices”…””}”hj  sbah}”(h]”h ]”h"]”h$]”h&]”jò  jó  uh1jâ  h³hÊh´KÃhjT  h²hubhÌ)”}”(hŒ"should show something like this:::”h]”hŒ!should show something like this::”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KÅhjT  h²hubjã  )”}”(hX-  T:  Bus=01 Lev=01 Prnt=01 Port=01 Cnt=02 Dev#=  5 Spd=480 MxCh= 0
D:  Ver= 2.00 Cls=02(comm.) Sub=00 Prot=00 MxPS=64 #Cfgs=  1
P:  Vendor=0525 ProdID=a4a7 Rev= 2.01
S:  Manufacturer=Linux 2.6.8.1 with net2280
S:  Product=Gadget Serial
S:  SerialNumber=0
C:* #Ifs= 2 Cfg#= 2 Atr=c0 MxPwr=  2mA
I:  If#= 0 Alt= 0 #EPs= 1 Cls=02(comm.) Sub=02 Prot=01 Driver=acm
E:  Ad=83(I) Atr=03(Int.) MxPS=   8 Ivl=32ms
I:  If#= 1 Alt= 0 #EPs= 2 Cls=0a(data ) Sub=00 Prot=00 Driver=acm
E:  Ad=81(I) Atr=02(Bulk) MxPS= 512 Ivl=0ms
E:  Ad=02(O) Atr=02(Bulk) MxPS= 512 Ivl=0ms”h]”hX-  T:  Bus=01 Lev=01 Prnt=01 Port=01 Cnt=02 Dev#=  5 Spd=480 MxCh= 0
D:  Ver= 2.00 Cls=02(comm.) Sub=00 Prot=00 MxPS=64 #Cfgs=  1
P:  Vendor=0525 ProdID=a4a7 Rev= 2.01
S:  Manufacturer=Linux 2.6.8.1 with net2280
S:  Product=Gadget Serial
S:  SerialNumber=0
C:* #Ifs= 2 Cfg#= 2 Atr=c0 MxPwr=  2mA
I:  If#= 0 Alt= 0 #EPs= 1 Cls=02(comm.) Sub=02 Prot=01 Driver=acm
E:  Ad=83(I) Atr=03(Int.) MxPS=   8 Ivl=32ms
I:  If#= 1 Alt= 0 #EPs= 2 Cls=0a(data ) Sub=00 Prot=00 Driver=acm
E:  Ad=81(I) Atr=02(Bulk) MxPS= 512 Ivl=0ms
E:  Ad=02(O) Atr=02(Bulk) MxPS= 512 Ivl=0ms”…””}”hj  sbah}”(h]”h ]”h"]”h$]”h&]”jò  jó  uh1jâ  h³hÊh´KÇhjT  h²hubhÌ)”}”(hŒ¡If the host side Linux system is configured properly, the ACM driver
should be loaded automatically.  The command "lsmod" should show the
"acm" module is loaded.”h]”hŒ©If the host side Linux system is configured properly, the ACM driver
should be loaded automatically.  The command â€œlsmodâ€ should show the
â€œacmâ€ module is loaded.”…””}”(hj«  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KÔhjT  h²hubeh}”(h]”Œ$installing-the-linux-host-acm-driver”ah ]”h"]”Œ$installing the linux host acm driver”ah$]”h&]”uh1hµhh·h²hh³hÊh´Kºubh¶)”}”(hhh]”(h»)”}”(hŒ3Installing the Linux Host Generic USB Serial Driver”h]”hŒ3Installing the Linux Host Generic USB Serial Driver”…””}”(hjÄ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjÁ  h²hh³hÊh´KÚubhÌ)”}”(hŒÆTo use the Linux generic USB serial driver you must configure the
Linux host side kernel for "Support for Host-side USB", for "USB
Serial Converter support", and for the "USB Generic Serial Driver".”h]”hŒÒTo use the Linux generic USB serial driver you must configure the
Linux host side kernel for â€œSupport for Host-side USBâ€, for â€œUSB
Serial Converter supportâ€, and for the â€œUSB Generic Serial Driverâ€.”…””}”(hjÒ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KÛhjÁ  h²hubhÌ)”}”(hŒ¿Once the gadget serial driver is loaded and the USB device connected
to the Linux host with a USB cable, the host system should recognize
the gadget serial device.  For example, the command::”h]”hŒ¾Once the gadget serial driver is loaded and the USB device connected
to the Linux host with a USB cable, the host system should recognize
the gadget serial device.  For example, the command:”…””}”(hjà  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KßhjÁ  h²hubjã  )”}”(hŒ!cat /sys/kernel/debug/usb/devices”h]”hŒ!cat /sys/kernel/debug/usb/devices”…””}”hjî  sbah}”(h]”h ]”h"]”h$]”h&]”jò  jó  uh1jâ  h³hÊh´KãhjÁ  h²hubhÌ)”}”(hŒ"should show something like this:::”h]”hŒ!should show something like this::”…””}”(hjü  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KåhjÁ  h²hubjã  )”}”(hXÁ  T:  Bus=01 Lev=01 Prnt=01 Port=01 Cnt=02 Dev#=  6 Spd=480 MxCh= 0
D:  Ver= 2.00 Cls=ff(vend.) Sub=00 Prot=00 MxPS=64 #Cfgs=  1
P:  Vendor=0525 ProdID=a4a6 Rev= 2.01
S:  Manufacturer=Linux 2.6.8.1 with net2280
S:  Product=Gadget Serial
S:  SerialNumber=0
C:* #Ifs= 1 Cfg#= 1 Atr=c0 MxPwr=  2mA
I:  If#= 0 Alt= 0 #EPs= 2 Cls=0a(data ) Sub=00 Prot=00 Driver=serial
E:  Ad=81(I) Atr=02(Bulk) MxPS= 512 Ivl=0ms
E:  Ad=02(O) Atr=02(Bulk) MxPS= 512 Ivl=0ms”h]”hXÁ  T:  Bus=01 Lev=01 Prnt=01 Port=01 Cnt=02 Dev#=  6 Spd=480 MxCh= 0
D:  Ver= 2.00 Cls=ff(vend.) Sub=00 Prot=00 MxPS=64 #Cfgs=  1
P:  Vendor=0525 ProdID=a4a6 Rev= 2.01
S:  Manufacturer=Linux 2.6.8.1 with net2280
S:  Product=Gadget Serial
S:  SerialNumber=0
C:* #Ifs= 1 Cfg#= 1 Atr=c0 MxPwr=  2mA
I:  If#= 0 Alt= 0 #EPs= 2 Cls=0a(data ) Sub=00 Prot=00 Driver=serial
E:  Ad=81(I) Atr=02(Bulk) MxPS= 512 Ivl=0ms
E:  Ad=02(O) Atr=02(Bulk) MxPS= 512 Ivl=0ms”…””}”hj
  sbah}”(h]”h ]”h"]”h$]”h&]”jò  jó  uh1jâ  h³hÊh´KçhjÁ  h²hubhÌ)”}”(hŒ‡You must load the usbserial driver and explicitly set its parameters
to configure it to recognize the gadget serial device, like this::”h]”hŒ†You must load the usbserial driver and explicitly set its parameters
to configure it to recognize the gadget serial device, like this:”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KòhjÁ  h²hubjã  )”}”(hŒ>echo 0x0525 0xA4A6 >/sys/bus/usb-serial/drivers/generic/new_id”h]”hŒ>echo 0x0525 0xA4A6 >/sys/bus/usb-serial/drivers/generic/new_id”…””}”hj&  sbah}”(h]”h ]”h"]”h$]”h&]”jò  jó  uh1jâ  h³hÊh´KõhjÁ  h²hubhÌ)”}”(hŒ,The legacy way is to use module parameters::”h]”hŒ+The legacy way is to use module parameters:”…””}”(hj4  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K÷hjÁ  h²hubjã  )”}”(hŒ/modprobe usbserial vendor=0x0525 product=0xA4A6”h]”hŒ/modprobe usbserial vendor=0x0525 product=0xA4A6”…””}”hjB  sbah}”(h]”h ]”h"]”h$]”h&]”jò  jó  uh1jâ  h³hÊh´KùhjÁ  h²hubhÌ)”}”(hŒ“If everything is working, usbserial will print a message in the
system log saying something like "Gadget Serial converter now
attached to ttyUSB0".”h]”hŒ—If everything is working, usbserial will print a message in the
system log saying something like â€œGadget Serial converter now
attached to ttyUSB0â€.”…””}”(hjP  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KûhjÁ  h²hubeh}”(h]”Œ3installing-the-linux-host-generic-usb-serial-driver”ah ]”h"]”Œ3installing the linux host generic usb serial driver”ah$]”h&]”uh1hµhh·h²hh³hÊh´KÚubh¶)”}”(hhh]”(h»)”}”(hŒ%Testing with Minicom or HyperTerminal”h]”hŒ%Testing with Minicom or HyperTerminal”…””}”(hji  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjf  h²hh³hÊh´MubhÌ)”}”(hX  Once the gadget serial driver and the host driver are both installed,
and a USB cable connects the gadget device to the host, you should
be able to communicate over USB between the gadget and host systems.
You can use minicom or HyperTerminal to try this out.”h]”hX  Once the gadget serial driver and the host driver are both installed,
and a USB cable connects the gadget device to the host, you should
be able to communicate over USB between the gadget and host systems.
You can use minicom or HyperTerminal to try this out.”…””}”(hjw  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhjf  h²hubhÌ)”}”(hXC  On the gadget side run "minicom -s" to configure a new minicom
session.  Under "Serial port setup" set "/dev/ttygserial" as the
"Serial Device".  Set baud rate, data bits, parity, and stop bits,
to 9600, 8, none, and 1--these settings mostly do not matter.
Under "Modem and dialing" erase all the modem and dialing strings.”h]”hXW  On the gadget side run â€œminicom -sâ€ to configure a new minicom
session.  Under â€œSerial port setupâ€ set â€œ/dev/ttygserialâ€ as the
â€œSerial Deviceâ€.  Set baud rate, data bits, parity, and stop bits,
to 9600, 8, none, and 1--these settings mostly do not matter.
Under â€œModem and dialingâ€ erase all the modem and dialing strings.”…””}”(hj…  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhjf  h²hubhÌ)”}”(hŒÄOn a Linux host running the ACM driver, configure minicom similarly
but use "/dev/ttyACM0" as the "Serial Device".  (If you have other
ACM devices connected, change the device name appropriately.)”h]”hŒÌOn a Linux host running the ACM driver, configure minicom similarly
but use â€œ/dev/ttyACM0â€ as the â€œSerial Deviceâ€.  (If you have other
ACM devices connected, change the device name appropriately.)”…””}”(hj“  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhjf  h²hubhÌ)”}”(hŒÚOn a Linux host running the USB generic serial driver, configure
minicom similarly, but use "/dev/ttyUSB0" as the "Serial Device".
(If you have other USB serial devices connected, change the device
name appropriately.)”h]”hŒâOn a Linux host running the USB generic serial driver, configure
minicom similarly, but use â€œ/dev/ttyUSB0â€ as the â€œSerial Deviceâ€.
(If you have other USB serial devices connected, change the device
name appropriately.)”…””}”(hj¡  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhjf  h²hubhÌ)”}”(hX$  On a Windows host configure a new HyperTerminal session to use the
COM port assigned to Gadget Serial.  The "Port Settings" will be
set automatically when HyperTerminal connects to the gadget serial
device, so you can leave them set to the default values--these
settings mostly do not matter.”h]”hX(  On a Windows host configure a new HyperTerminal session to use the
COM port assigned to Gadget Serial.  The â€œPort Settingsâ€ will be
set automatically when HyperTerminal connects to the gadget serial
device, so you can leave them set to the default values--these
settings mostly do not matter.”…””}”(hj¯  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhjf  h²hubhÌ)”}”(hXb  With minicom configured and running on the gadget side and with
minicom or HyperTerminal configured and running on the host side,
you should be able to send data back and forth between the gadget
side and host side systems.  Anything you type on the terminal
window on the gadget side should appear in the terminal window on
the host side and vice versa.”h]”hXb  With minicom configured and running on the gadget side and with
minicom or HyperTerminal configured and running on the host side,
you should be able to send data back and forth between the gadget
side and host side systems.  Anything you type on the terminal
window on the gadget side should appear in the terminal window on
the host side and vice versa.”…””}”(hj½  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhjf  h²hubeh}”(h]”Œ%testing-with-minicom-or-hyperterminal”ah ]”h"]”Œ%testing with minicom or hyperterminal”ah$]”h&]”uh1hµhh·h²hh³hÊh´Mubeh}”(h]”Œlinux-gadget-serial-driver-v2-0”ah ]”h"]”Œlinux gadget serial driver v2.0”ah$]”h&]”uh1hµhhh²hh³hÊh´Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”hÊuh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(hºNŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”Œentry”Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”jþ  Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”hÊŒ_destination”NŒ_config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œimage_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(jØ  jÕ  jo  jl  j²  j¯  j?  j<  jò  jï  jQ  jN  j¾  j»  jc  j`  jÐ  jÍ  uŒ	nametypes”}”(jØ  ‰jo  ‰j²  ‰j?  ‰jò  ‰jQ  ‰j¾  ‰jc  ‰jÐ  ‰uh}”(jÕ  h·jl  héj¯  jr  j<  jµ  jï  jB  jN  jõ  j»  jT  j`  jÁ  jÍ  jf  uŒfootnote_refs”}”Œcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”Œ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nh²hub.