LibUSB-Win32

LibUSB-Win32程序介绍

 (2012-02-23 21:01:35)

转载▼

标签： 

杂谈

 

LibUSB-Win32是一个用于Windows操作系统（Win98SE、WinME、Win2k和WinXP）上的通用USB设备驱动程序。该驱动程序允许使用者在不写任何一行核心驱动程序代码的情况下，可以访问Windows系统上的任意一个USB设备。该驱动程序具有以下特点：

l         能够与任意一个已安装的USB设备进行通信

l         可被用作自己开发的USB设备的驱动程序

l         支持批量和中断传输

l         支持USB规范中定义的所有标准设备请求

l         支持USB设备制造商的自定义请求

LibUsb-Win32是由http://libusb-win32.sourceforge.net发布的，遵守GNU Lesser General Public License（LGPL）和GNU General Public License（GPL）许可协议。这些协议明确规定：允许LibUsb-Win32用于商业软件，而不只是开源软件。

通过使用七个函数，就可以与USB设备进行简单通信了，通信的主要流程可分为以下四步：

1)       调用usb_init函数，进行初始化。

2)       打开要进行通信的USB设备的句柄。首先依次调用usb_find_busses、usb_find_devices和usb_get_busses这三个函数，获得已找到的USB总线序列；然后通过链表遍历所有的USB设备，根据已知的要打开USB设备的ID（VID/PID），找到相应的USB设备；最后调用usb_open函数打开该USB设备（在这里假设总线上没有相同VID和PID的USB设备。如果总线上存在着相同VID和PID的设备，还需要进行其他条件判断，比如设备名称，以保证是打开的是期望的USB设备）。

3)       与USB设备进行通信。使用usb_control_msg函数，向USB设备读取数据或写入数据。

4)       关闭USB设备。完成所有操作后，调用usb_close函数关闭已经打开的USB设备。

//---------------------------------------------------------- 
    
    再来介绍一下编译工具。
    MSVC（KIT里带的工程文件是VS2008的，如果你使用VS2005或VC6的话，就要自建工程了，libusb-win32的工程比较复杂，不推荐。我使用的是Visual studio 2008 RTM 90天试用版的）
    BCC（如果你装了Borland C++ Builder的话，只要修改make.cfg，然后运行ddk_make文件夹下对应的批处理文件就可以了，这里我就不介绍了）
     上面两个都是用来编译libusb-win32的动态链接库、相关工具和DEMO程序的。我们还需要WINDDK来编译驱动，即生成libusb0.sys文件。从官方提供的make.cfg文件上来看，使用的是WINDDK 7600.16385.0（WINDOW XP及以上版本） WINDDK 6001.18002（WINDOWS 2000及以下版本）。我只在MICROSOFT的官网上找到最新的 WINDDK 7600.16385.1，所以，我用的是这个。

    有了VS2008和WINDDK，我们就可以开始下面的工作了。

    下载源码
     你可以去官网上直接下载源码，地址是http://sourceforge.net/projects/libusb-win32/files/
     也可以通过SVN工具从 https://libusb-win32.svn.sourceforge.net/svnroot/libusb-win32 libusb-win32 检出最新的源码，我使用的是SVN工具是TortoiseSVN。
     vs2008的项目文件位于projects文件夹中。我们来看一下


 (原文件名:libusb0.jpg) 引用图片

    总共有7个项目。
    inf-wizard——设备驱动安装信息文件生成向导。此向导可以扫描计算机上的USB设备，并可以获取你选择的设备的VID及PID生成inf文件。
    
    
 (原文件名:inf1.jpg) 引用图片


 (原文件名:inf2.jpg) 引用图片

    install-filter——filter驱动安装。filter driver 是驱动的高层境界，杀毒软件，防火墙，笔记本的多功能按键等等都会用到。
    libusb-dll——动态链接库,生成libusb0.dll。上面说的“7个函数”就封装在这里面。同时生成了libusb0.lib文件，供你的程序链接，这个文件实现了libusb0.dll的装载。
    libusb-sys——USB驱动,生成驱动文件libusb0.sys。大家不要误以为是VC++编译的,其实是makefile项目,WINDDK玩的借腹生子的把戏，借的VS的腹。
    testbulk——libusb-win32的 ”Hello,World!“。
    testlibusb——顾名思义，实现了libusb-win32驱动的设备的遍历并打印一部分设备描述信息。
    testlibusb-win——WINFORM版的testlibusb。

    编译
    既然工程都建好了，先编译再说，报错了再查错找错。按 F7 编译怎个解决方案。
    没有报错，但libusb-sys生成目录下也没有libusb0.sys文件。答案在这里，libusb-sys是靠WINDDK来编译链接的。这有点像我用VS2005的IDE配合WINAVR来开发AVR单片机一样的了。
    查看libusb-sys的项目属性页，在[配置属性]的[NMAKE]栏里，查看“生成命令行”。

CD "$(ProjectDir)..\ddk_make"
CMD /C make.cmd "arch=x86" "app=driver" "noclean=true" "outdir=$(OutDir)" "DIR_INTERMEDIATE=$(IntDir)" "debugmode=true"

    看来编译脚本是这个ddk_make文件夹下的make.cmd了。
    在这里
    SET MAKE_CFG=!DIR_LIBUSB_DDK!make.cfg
    查看这个make.cfg文件。
    打包的那些我就不说了，我们看看关键的两个东西。
    
    ; Default WinDDK directory(s) Adjust these values to match your environment
    ; (REQUIRED)
    WINDDK_BASE=Z:\WinDDK
    WINDDK_DIR=!WINDDK_BASE!\7600.16385.0\
    ;
    ; (optional)
    WINDDK_W2K_DIR=!WINDDK_BASE!\6001.18002\

    呵呵，WINDDK放在这。在这里我想八卦一下。看他们把WINDDK放在Z盘，我猜他们是不也是用虚拟机大法无限制的使用90天试用版的呢？呵呵，纯属猜测，如有雷同，实属巧合。

   把这两项改成你的WINDDK安装路径即可。比如我的是
   ; Default WinDDK directory(s) Adjust these values to match your environment
    ; (REQUIRED)
    WINDDK_BASE=E:\WinDDK
    WINDDK_DIR=!WINDDK_BASE!\7600.16385.1\
    ;
    ;没找到WINDDK6，也暂时不打算编译WINDOWS2000及以下版本的驱动，所以就注释掉了
    ; (optional)
    ；WINDDK_W2K_DIR=!WINDDK_BASE!\6001.18002\

    编译一下libusb-sys。error.h 和error.c 会报 warning C4819，有个时候，编译器会把这个warning当作error，使得不能成功编译，按编译器提示的方法，用VS2008重新保存一下这两个文件即可。OK。。
    
    为Virtual_COM_Port安装我们的这个驱动吧。先用inf-wizard生成inf文件。分别复制libusb0.sys和libusb0.dll至x86文件夹下。
    
   
 (原文件名:driverfile.jpg) 引用图片

 手动安装此驱动，这个就不用我多说了吧，大家都会。

 
 (原文件名:device.jpg) 引用图片

运行testlibusb-win测试下设备。报错！


 (原文件名:error.jpg) 引用图片

R6034错误，这个错误是因为没有将资源清单嵌入到libusb0.dll中。我们可以使用mt工具将资源清单嵌入到exe或dll中。因为libusb-win32提供的工程文件默认配置是没有生成清单文件的，所以我们还要设置一下。
libusb-dll项目属性页->链接器->清单文件；把 [生成清单] 设为 “是”，重新生成libusb-dll

开始->Microsoft Visual Studio 2008->Visual Studio Tools->Visual Studio 2008 兼容工具命令提示;

cd 入libusb-dll的生成目录

mt.exe –manifest libusb0.dll.manifest -outputresource:libusb0.dll;2


 (原文件名:cmd.jpg) 引用图片