windows xp 驱动开发(七)WDK源码 UsbSamp例子的编译及使用

 转载请标明是引用于 http://blog.csdn.net/chenyujing1234

参考文章: http://msdn.microsoft.com/zh-cn/library/windows/hardware/ff544747

欢迎大家提出意见,一起讨论!

 需要源码的请独与我联系.

一、例子介绍

 UsbSamp是你安装完WinDDK后自带的一个USB例子,在D:\WINDDK\7600.16385.1\src\usb\usbsamp下.

 

演示了如何通过WDF将大量及等时的数据传送到一个通用的USB设备。

此例子是针对Intel 82930 USB测试板。它包含一个控制台的应用程序来初始化

传送并获得在设备的I/O endpoints上的信息。它也演示了如果用基于GUID的设备名和

pips名。

 

二、编译例子：

1、usbsamp_new.SYS文件的编译

我是通过新建一个DDK Project工程，（方法参考 http://blog.csdn.net/chenyujing1234/article/details/7565364）

 

删除新建时产生的文件，然后把D:\WINDDK\7600.16385.1\src\usb\usbsamp\sys下的.c .h  .rc文件拷到我们的工程目录下，编组成工程：

 

sources内容如下：

# $Id$
TARGETNAME=usbsamp_new
TARGETPATH=obj
TARGETTYPE=DRIVER



KMDF_VERSION_MAJOR=1

MSC_WARNING_LEVEL=/W4 /WX



# Create browse info
#BROWSER_INFO=1
#BROWSERFILE=<some path>



# Additional defines for the C/C++ preprocessor
C_DEFINES=$(C_DEFINES)

INCLUDES=D:\WINDDK\7600.16385.1\inc\wdf\kmdf\1.9

TARGETLIBS=D:\WINDDK\7600.16385.1\lib\wxp\i386\usbd.lib

SOURCES=SOURCES= \
     driver.c  \
     device.c  \
     queue.c  \
     bulkrwr.c  \
     isorwr.c  \
     usbsamp.rc

 

 

这里不得不提一下编译出错:

1>Linking Executable - objchk_win7_x86\i386\usbsamp_new.sys
1>1>errors in directory e:\g2\fft\usbdri~1\usbsam~1\usbsam~1
1>1>e:\g2\fft\usbdri~1\usbsam~1\usbsam~1\isorwr.obj : error LNK2019: unresolved external symbol _WdfFunctions referenced in function _ReadWriteIsochEndPoints@16
1>1>e:\g2\fft\usbdri~1\usbsam~1\usbsam~1\driver.obj : error LNK2001: unresolved external symbol _WdfFunctions
1>1>e:\g2\fft\usbdri~1\usbsam~1\usbsam~1\device.obj : error LNK2001: unresolved external symbol _WdfFunctions
1>1>e:\g2\fft\usbdri~1\usbsam~1\usbsam~1\queue.obj : error LNK2001: unresolved external symbol _WdfFunctions
1>1>e:\g2\fft\usbdri~1\usbsam~1\usbsam~1\bulkrwr.obj : error LNK2001: unresolved external symbol _WdfFunctions
1>1>e:\g2\fft\usbdri~1\usbsam~1\usbsam~1\isorwr.obj : error LNK2001: unresolved external symbol _WdfDriverGlobals
1>1>e:\g2\fft\usbdri~1\usbsam~1\usbsam~1\driver.obj : error LNK2001: unresolved external symbol _WdfDriverGlobals
1>1>e:\g2\fft\usbdri~1\usbsam~1\usbsam~1\device.obj : error LNK2001: unresolved external symbol _WdfDriverGlobals
1>1>e:\g2\fft\usbdri~1\usbsam~1\usbsam~1\queue.obj : error LNK2001: unresolved external symbol _WdfDriverGlobals
1>1>e:\g2\fft\usbdri~1\usbsam~1\usbsam~1\bulkrwr.obj : error LNK2019: unresolved external symbol _WdfDriverGlobals referenced in function _ReadWriteBulkEndPoints@16
1>1>e:\g2\fft\usbdri~1\usbsam~1\usbsam~1\objchk_win7_x86\i386\usbsamp_new.sys : error LNK1120: 2 unresolved externals

如果大家把此错误在网上搜索，一般都没有人解答。

解决方法是在sources里添加以下选项：

 

KMDF_VERSION_MAJOR=1

MSC_WARNING_LEVEL=/W4 /WX

 ==================================================================================================

编译产生了我们想要的sys文件

 

2、usbsamp.exe文件的编译

新建一个DDK Project工程，模板选择Native Application

把D:\WINDDK\7600.16385.1\src\usb\usbsamp\exe下的testapp.c与testapp.rc组织进工程

sources内容为：

# $Id$
TARGETNAME=usbsamp
TARGETTYPE=PROGRAM

_NT_TARGET_VERSION= $(_NT_TARGET_VERSION_WINXP)

USE_MSVCRT=1


UMTYPE=console
UMBASE=0x01000000

# Create browse info
#BROWSER_INFO=1
#BROWSERFILE=<some path>

# Additional defines for the C/C++ preprocessor
C_DEFINES=$(C_DEFINES)

# If you uncomment the following line, the linker will not use buffer overflow
# checking for the entry point and so on. Leave it commented if possible.
#BUFFER_OVERFLOW_CHECKS=0

INCLUDES=$(DDK_INC_PATH);$(CRT_INC_PATH);$(SDK_INC_PATH);$(IFSKIT_INC)	\
		..\..\usbsamp_new\usbsamp_new


TARGETLIBS=D:\WINDDK\7600.16385.1\lib\wxp\i386\usbd.lib	\
          D:\WINDDK\7600.16385.1\lib\wxp\i386\setupapi.lib

SOURCES=      \
        testapp.c  \
        testapp.rc

编译后得到

 

三、安装驱动

确保你已经有.inf文件，且文件中有相关设备的VID/PID、描述text。如果没有自己编辑。

这里我用系统自带的GenInf工具来产生.inf文件.

 

自动产生usbsamp.inf文件后右击选择安装即可。

 

 

On Windows XP and later:

1. "Found New Hardware Wizard" dialog box will appear. Here select the radio button labeled "Install from a list of specific location (Advanced)" and then hit the "Next" button.

2. In the following screen select the radio button labeled " Search the best driver in these locations" and then select "Include this location in the search path" and specify the target media or the directory where the INF and SYS files are copied and then hit the "Next" button.

3. The system will scan the directory and pick up the matching INF and start the installation. You will get a Hardware Installation Warning dialog stating that your driver has not passed Windows Logo Testing. Hit "Continue Anyway" button.

4. The system will copy the KMDF coinstaller (wdfcoinstallerMMmmm.dll), driver, INF file, load the driver and start the device. If every thing goes fine, you will get "Completing the Found New Hardware Wizard". Hit the "Finish" button and the installation is complete.

5. You should be able to see the device in the Device manager under "Universal Serial Bus controllers"

Testing

You can use usbsamp.exe to test the device. This console application enumerates the interface registered by the driver and opens the device to send read, write or ioctl requests based on the command line options.

usbsamp.exe -u <-- Will dump all the descriptors and endpoint information.

usbsamp.exe -r 1024 -w 1024 -c 100 -v <-- This command first writes 1024 bytes of data to bulk out endpoint (pipe1), and then reads 1024 bytes from bulk in endpoint (pipe1), and compares the read buffer with write buffer to see if they match. If the buffer contents match, it performs this operation 100 times.

To read and write to bulk endpoints you can run one or more of these commands simultaneously. The driver is multi-thread safe so it can handle multiple request at a time.

usbsamp.exe -r 65536 <--- by default, the device reads pipe0

usbsamp.exe -w 65536 <--- by default, the device write to pipe1

usbsamp.exe -r 65536 -i pipe02 <--- read 65536 bytes from pipe02

usbsamp.exe -w 65536 -o pipe03 <--- write 65536 bytes to pipe03

To read and write to Isochronous endpoints you can run one or more of these commands simultaneously.

usbsamp.exe -r 510 -i pipe04

usbsamp.exe -w 510 -o pipe05

usbsamp.exe -w 10245 -o pipe05 -r 1024 -i pipe04 -c 100 -v

扩展阅读