原文地址:LibUSB-Win32程序介绍
作者:死亡骑士
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)
引用图片
l
l
l
l
l
LibUsb-Win32是由http://libusb-win32.sourceforge.net发布的,遵守GNU
通过使用七个函数,就可以与USB设备进行简单通信了,通信的主要流程可分为以下四步:
1)
2)
3)
4)
//----------------------------------------------------------
![[转载]LibUSB-Win32程序介绍 [转载]LibUSB-Win32程序介绍](https://i-blog.csdnimg.cn/blog_migrate/a4c26d1e5885305701be709a3d33442f.gif)
![[转载]LibUSB-Win32程序介绍 [转载]LibUSB-Win32程序介绍](https://i-blog.csdnimg.cn/blog_migrate/a4c26d1e5885305701be709a3d33442f.gif)
![[转载]LibUSB-Win32程序介绍 [转载]LibUSB-Win32程序介绍](https://i-blog.csdnimg.cn/blog_migrate/a4c26d1e5885305701be709a3d33442f.gif)
CD
CMD
![[转载]LibUSB-Win32程序介绍 [转载]LibUSB-Win32程序介绍](https://i-blog.csdnimg.cn/blog_migrate/a4c26d1e5885305701be709a3d33442f.gif)
![[转载]LibUSB-Win32程序介绍 [转载]LibUSB-Win32程序介绍](https://i-blog.csdnimg.cn/blog_migrate/a4c26d1e5885305701be709a3d33442f.gif)
运行testlibusb-win测试下设备。报错!
![[转载]LibUSB-Win32程序介绍 [转载]LibUSB-Win32程序介绍](https://i-blog.csdnimg.cn/blog_migrate/a4c26d1e5885305701be709a3d33442f.gif)
R6034错误,这个错误是因为没有将资源清单嵌入到libusb0.dll中。我们可以使用mt工具将资源清单嵌入到exe或dll中。因为libusb-win32提供的工程文件默认配置是没有生成清单文件的,所以我们还要设置一下。
libusb-dll项目属性页->链接器->清单文件;把
开始->Microsoft
cd
mt.exe
![[转载]LibUSB-Win32程序介绍 [转载]LibUSB-Win32程序介绍](https://i-blog.csdnimg.cn/blog_migrate/a4c26d1e5885305701be709a3d33442f.gif)