From: "Jüri Reitel" <juri.reitel@liewenthal.ee>
To: linux-kernel@vger.kernel.org
Subject: USB serial gadget documentation and gserial.inf
Date: Thu, 04 Dec 2008 10:22:22 +0200 [thread overview]
Message-ID: <4937933E.80207@liewenthal.ee> (raw)
Improve linux documentation and add better gserial.inf file, now users
will not have to find the usbser.sys by themselves
Signed-off-by: Kristjan Räts <kristjan.rats@liewenthal.ee>
Signed-off-by: Jüri Reitel <juri.reitel@liewenthal.ee>
diff --git a/Documentation/usb/gadget_serial.txt
b/Documentation/usb/gadget_serial.txt
index 9b22bd1..b25e1e8 100644
--- a/Documentation/usb/gadget_serial.txt
+++ b/Documentation/usb/gadget_serial.txt
@@ -162,8 +162,10 @@ Signature="$Windows NT$"
Class=Ports
ClassGuid={4D36E978-E325-11CE-BFC1-08002BE10318}
Provider=%LINUX%
-DriverVer=08/17/2004,0.0.2.0
+LayoutFile=layout.inf
+DriverVer=10/08/2008,1.0.2.0
; Copyright (C) 2004 Al Borchers (alborchers@steinerpoint.com)
+; Modified to use usbser.sys automatically from Windows installation
directory
[Manufacturer]
%LINUX%=GSerialDeviceList
@@ -172,14 +174,15 @@ DriverVer=08/17/2004,0.0.2.0
%GSERIAL%=GSerialInstall, USB\VID_0525&PID_A4A7
[DestinationDirs]
-DefaultDestDir=10,System32\Drivers
+DefaultDestDir=12
+GSerialCopyFilesFake=12
[GSerialInstall]
-CopyFiles=GSerialCopyFiles
+CopyFiles=GSerialCopyFilesFake
AddReg=GSerialAddReg
-[GSerialCopyFiles]
-usbser.sys
+[GSerialCopyFilesFake]
+usbser.sys,,,0x20
[GSerialAddReg]
HKR,,DevLoader,,*ntkern
@@ -193,8 +196,8 @@ AddService = usbser,0x0002,GSerialService
DisplayName = %GSERIAL_DISPLAY_NAME%
ServiceType = 1 ; SERVICE_KERNEL_DRIVER
StartType = 3 ; SERVICE_DEMAND_START
-ErrorControl = 1 ; SERVICE_ERROR_NORMAL
-ServiceBinary = %10%\System32\Drivers\usbser.sys
+ErrorControl = 0 ; SERVICE_ERROR_NORMAL
+ServiceBinary = %12%\usbser.sys
LoadOrderGroup = Base
[Strings]
@@ -203,37 +206,30 @@ GSERIAL = "Gadget Serial"
GSERIAL_DISPLAY_NAME = "USB Gadget Serial Driver"
-------------------- CUT HERE --------------------
-The "usbser.sys" file comes with various versions of Windows.
-For example, it can be found on Windows XP typically in
-
- C:\WINDOWS\Driver Cache\i386\driver.cab
-
-Or it can be found on the Windows 98SE CD in the "win98" folder
-in the "DRIVER11.CAB" through "DRIVER20.CAB" cab files. You will
-need the DOS "expand" program, the Cygwin "cabextract" program, or
-a similar program to unpack these cab files and extract "usbser.sys".
-
-For example, to extract "usbser.sys" into the current directory
-on Windows XP, open a DOS window and run a command like
-
- expand C:\WINDOWS\Driver~1\i386\driver.cab -F:usbser.sys .
-
-(Thanks to Nishant Kamat for pointing out this DOS command.)
+This inf file will tell windows to use its usbser.sys file.
+If the file usbser.sys is not yet installed, Windows will
+find and install it automatically. So there is no need to
+show the location of usbser.sys to Windows.
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 "gserial.inf" and "usbser.sys".
+gadget serial device and ask for a driver. Tell Windows to use the
+"gserial.inf" file.
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 "gserial.inf" and
-"usbser.sys". Windows will complain that the Gadget Serial driver
+enter the path or browse to the folder containing "gserial.inf".
+Windows will complain that the Gadget Serial driver
has not passed Windows Logo testing, but select "Continue anyway"
and finish the driver installation.
+Another way is to install the driver via Winows API function
+::SetupCopyOEMInf(_T("gserial.inf"), NULL, SPOST_PATH,
+ SP_COPY_DELETESOURCE | SP_COPY_NOOVERWRITE, NULL, 0, NULL, NULL
+);
+
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
next reply other threads:[~2008-12-04 8:33 UTC|newest]
Thread overview: 2+ messages / expand[flat|nested] mbox.gz Atom feed top
2008-12-04 8:22 Jüri Reitel [this message]
2008-12-10 5:56 ` USB serial gadget documentation and gserial.inf Greg KH
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=4937933E.80207@liewenthal.ee \
--to=juri.reitel@liewenthal.ee \
--cc=linux-kernel@vger.kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.