思享工具箱

libusb-win32 在visual studio2008中成功编译回忆录

摘要：
3)与USB设备进行通信。使用usb_control_msg函数，向USB设备读取数据或写入数据。完成所有操作后，调用usb_close函数关闭已经打开的USB设备。inf-wizard——设备驱动安装信息文件生成向导。libusb-dll——动态链接库,生成libusb0.dll。同时生成了libusb0.lib文件，供你的程序链接，这个文件实现了libusb0.dll的装载。libusb-sys——USB驱动,生成驱动文件libusb0.sys。

关于这个项目不用多说

介绍

libusb是一个针对usb通讯的库. 使用它, 你不需要知道操作系统的细节, 你只需要对USB有足够的了解即可. 它也不需要你写驱动, 所有的工作都可以在用户态完成. 使用方法很简单, 这里有一个示例:http://sourceforge.net/apps/trac/libusb-win32/wiki/libusbwin32_documentation#IV.Examples, 是不是很简单?

原理

libusb自己带有一个内核驱动, 名字叫libusb0.sys, 放在WINDOWSSYSTEM32DRIVERS里面. 用户程序调用libusb0.dll, dll会把任务交由驱动来完成. 这样保证用户态就能够完成USB通讯的作业.

具体做了什么, 可以通过下载项目的源文件来了解, 等我有时间的时候再看看吧.

安装方法

libusb现在有好几个版本. 主页面在这里:http://www.libusb.org/

  • 因为我们一般是进行工程应用, 选择相对稳定的版本: libusb-0.1.
  • 平台在windows下的话, 我们采用libusb-win32:http://www.libusb.org/wiki/libusb-win32
  • linux下一般已经添加到源里面去了, 查找libusb即可.

windows下安装方法:http://www.libusb.org/wiki/libusb-win32#Installation

里面有2种安装方式, Filter Driver Installation 和 Device Driver Installation, 前面一个可以说是开发环境, 后面可以说是发布驱动本身. 我们因为是做系统, 选择前面一个方式, 省得麻烦.

使用

LibUSB-Win32是一个用于Windows操作系统（Win98SE、WinME、Win2k和WinXP）上的通用USB设备驱动程序。该驱动程序允许使用者在不写任何一行核心驱动程序代码的情况下，可以访问Windows系统上的任意一个USB设备。该驱动程序具有以下特点：
l能够与任意一个已安装的USB设备进行通信
l可被用作自己开发的USB设备的驱动程序
l支持批量和中断传输
l支持USB规范中定义的所有标准设备请求
l支持USB设备制造商的自定义请求

通过使用几个函数，就可以与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设备。

inf-wizard——设备驱动安装信息文件生成向导。此向导可以扫描计算机上的USB设备，并可以获取你选择的设备的VID及PID 生成inf文件。

install-filter——filter驱动安装。filterdriver是驱动的高层境界，杀毒软件，防火墙，笔记本的多 功能按键等等都会用到。
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。

从官网下载源码项目：

http://libusb-win32.sourceforge.net

配置编译环境

win8.1/win7

winddk7.1

还有ddk_make 种的make.cfg 中所需的工具，一一下载并默认安装，配置

执行 winddk下的命令行编译。进入ddk_make 目录 make.cmd all----->可以编译出在windows下运行的程序文件。

好，命令可以编译。我们使用vs2008进行编译。日。。。。各种问题，

解决方法：

Libusb-win32-src-1.2.6.0的编译：（先编译出libusb.lib, libusb0.sys, install-filter.exe, istall-filter-win.exe, testlibusb.exe testlibusb-win.exe, libusb0.dll）
Step1) 修改ddk_make/make.cfg中的相关内容：
1. Line25 WINDDK_BASE =c:WinDDK
2. Line26 WINDDK_DIR=!WINDDK_BASE!7600.16385.1
3. Line29 注释掉
4. Line49 PACKAGE_ROOT_DIR = C:libusb-win32
5. Line76 ISCC=C:Program FilesInno Setup 5ISCC.exe(optional)
6. Line81 IMPLIB=C:Program FilesBorlandCBuilder6Binimplib.exe(optional)
Step2) 修改ddk_make/make.cmd
1. Line175 W2K 修改成WIN7
Step3) 在命令行cd至ddk_make，输入命令make.cmd “arch=x86”进行编译。make.cmd的其余参数的用法可以通过打开make.cmd文本查看该文件的line955-1017（ShowHelp）。

接着：

对应修改libwdi (static)项目下的config.h的目录路径如下：

/* embed WinUSB driver files from thefollowing DDK location */

#ifndefDDK_DIR

#defineDDK_DIR"D:/WinDDK/7600.16385.1"

#endif

/* embed libusb0 driver files from thefollowing location */

#ifndefLIBUSB0_DIR

#defineLIBUSB0_DIR"E:/libusb-win32"

（注意：如"C:/WinDDK/7600.16385.1"，注意所有地址符用”/”或者“\”，不要用“”！）

----------------------------------------------可以进行命令的方式的编译了-------------------------------------------------------

好，现在开始最他么头疼的是inf-wizard 这个项目。每次编译都：

13>libwdi (static).lib(libwdi.obj) : error LNK2019: 无法解析的外部符号 _SelfSignFile，该符号在函数 _wdi_prepare_driver@16 中被引用
13>libwdi (static).lib(libwdi.obj) : error LNK2019: 无法解析的外部符号 _CreateCat，该符号在函数 _wdi_prepare_driver@16 中被引用
13>libwdi (static).lib(libwdi.obj) : error LNK2019: 无法解析的外部符号 _AddCertToTrustedPublisher，该符号在函数 _wdi_install_trusted_certificate@8 中被引用
13>E:libusb-win32projectsWin32Debuginf-wizardinf-wizard.exe : fatal error LNK1120: 3 个无法解析的外部命令

最后找了N天，终于找到解决办法，原来官方的项目工程文件少了对 pki.c 这个文件的添加

libusb-win32 在visual studio2008中成功编译回忆录第1张

添加后，好，编译成功了。。。

libusb-win32 在visual studio2008中成功编译回忆录第2张

感谢

kook_pudding
1 在 libwdi(static) 下面的SouorceFiles下面添加现有文件 pki.c 文件 ，就解决了
2 安装VS2008的时候 千万记得展开C++安装选项啊，妈的 x64编译器默认不给安装....................
--------------------------------附一篇翻译过来的说明------------------------
来自：http://blog.csdn.net/ahc2013/article/details/8683227
2013-03-17 11:531593人阅读评论(0)收藏举报
libusb-win32 在visual studio2008中成功编译回忆录第3张分类：

1.介绍

这篇文档主要介绍libusbAPI工作的大致概况。适用于对usb2.0协议有一定了解的读者。如果对usb2.0不理解，可以从http://www.usb.org网站上下载usb2.0协议规格文档。libusb-0.1可以工作在linux、FreeBSD、NetBSD、OpenBSD、Darwin/MacosX、Solaris等操作系统下。libusb-win32的API不仅兼容libusb-0.1，而且好包含一些新的特性功能。

2.API

这些共应用程序调用使用的API相对比较精简，根据严格按照usb2.0的协议设计实现。

设备和接口

libusbAPI将打开的设备绑定到一个特定的接口。这就意味着如果你想在一个设备上请求更多的接口，就必须打开这个设备多次，这样通过调用usb_claim_interface()函数可以返回每个你想进行通信的接口的usb设备的句柄。

超时设定在libusb中通过被指定为毫秒级。

为了保持可移植性，libusb通常使用抽象和非抽象的结构体。

在最初版本的libusb0.1中，所有的功能函数都是同步实现的，这就意味着这些功能函数将会被阻塞来等待操作的完成或者在调用执行的应用程序返回之前timeout。libusb-win32增加了一些异步的API调用接口，libusb-1.0也开始支持异步API。

在libusb0.1中，函数有两种返回值，一种为usb_open函数返回打开的设备句柄handle，第二种为int型，当返回值大于等于0时表示成功，返回值小于0表示失败。

Timeout

timeout的基本最小单位为毫秒

在linuxlibusb-0.1中（仅支持同步API），timeout=0表示无限的。linusb-win321.2.4.7和以后最新的版本都支持这种API。像windows这种非实时操作系统，使用10ms或者100ms级timeout值并不是一个好方法。

当Timeout产生时的同步传输注意事项

同步API工作流程：

1.向底层驱动提交读请求

2.通过使用WaitForSingleobject()函数等待特定的timeout

1.如果一个timeout产生时，发送中止管道请求并返回-116

2.如果wait成功，通过GetOverlappedResults()函数获取传输结果并返回error或传输的数据长度。

当刚刚检测到timeout传输完成，整个传输也是失败的。

有两种方法可以避免这种情况：

1.使用异步传输，比如使用usb_reap_async_nocancel()函数

2.在其自己的线程内使用异步传输并将timeout设置为INFINITE。

报告错误代码

在WDKcrt_errno.h文件中标准的错误代码和一些MinGW的说明如下：

注意，并不是所有的错误代码都会被使用。

  1. #defineEPERM1/*Operationnotpermitted*/
  3. #defineENOENT2/*Noentry,ENOFILE,nosuchfileordirectory*/
  5. #defineESRCH3/*Nosuchprocess*/
  7. #defineEINTR4/*Interruptedfunctioncall*/
  9. #defineEIO5/*Input/outputerror*/
  11. #defineENXIO6/*Nosuchdeviceoraddress*/
  13. #defineE2BIG7/*Arglisttoolong*/
  15. #defineENOEXEC8/*Execformaterror*/
  17. #defineEBADF9/*Badfiledescriptor*/
  19. #defineECHILD10/*Nochildprocesses*/
  21. #defineEAGAIN11/*Resourcetemporarilyunavailable*/
  23. #defineENOMEM12/*Notenoughspace*/
  25. #defineEACCES13/*Permissiondenied*/
  27. #defineEFAULT14/*Badaddress*/
  29. #defineEBUSY16/*strerrorreports"Resourcedevice"*/
  31. #defineEEXIST17/*Fileexists*/
  33. #defineEXDEV18/*Improperlink(cross-devicelink?)*/
  35. #defineENODEV19/*Nosuchdevice*/
  37. #defineENOTDIR20/*Notadirectory*/
  39. #defineEISDIR21/*Isadirectory*/
  41. #defineEINVAL22/*Invalidargument*/
  43. #defineENFILE23/*Toomanyopenfilesinsystem*/
  45. #defineEMFILE24/*Toomanyopenfiles*/
  47. #defineENOTTY25/*InappropriateI/Ocontroloperation*/
  49. #defineEFBIG27/*Filetoolarge*/
  51. #defineENOSPC28/*Nospaceleftondevice*/
  53. #defineESPIPE29/*Invalidseek(seekonapipe?)*/
  55. #defineEROFS30/*Read-onlyfilesystem*/
  57. #defineEMLINK31/*Toomanylinks*/
  59. #defineEPIPE32/*Brokenpipe*/
  61. #defineEDOM33/*Domainerror(mathfunctions)*/
  63. #defineERANGE34/*Resulttoolarge(possiblytoosmall)*/
  65. #defineEDEADLK36/*Resourcedeadlockavoided*/
  67. #defineENAMETOOLONG38/*Filenametoolong*/
  69. #defineENOLCK39/*Nolocksavailable*/
  71. #defineENOSYS40/*Functionnotimplemented*/
  73. #defineENOTEMPTY41/*Directorynotempty*/

3.功能

3.1内核

这些函数主要包括libusb的内核，这些函数会被使用libusb的应用程序调用。

usb_init()

初始化libusb

正如其名，usb_init设置了一些内部结构体。usb_init必须在libusb的其他功能函数之前被调用。

usb_find_busses()

寻找系统中的usb总线

usb_find_busses()函数将会寻找在系统中的所有总线，返回总线的变化情况，先前调用该函数会返回新的总线和移除的总线的个数。

usb_find_devices()

扫描在usb总线上的所有设备

该函数会扫描在每条usb总线上的所有设备，该函数要在usb_find_busses()函数后调用。

usb_get_busses()

usb_set_debug()

该函数设置调试信息的信息级别，设置为4就可以得到信息的调试信息。

  1. 0LOG_OFF
  3. 1LOG_ERROR
  5. 2LOG_WARNING
  7. 3LOG_INFO
  9. 4LOG_DEBUG

3.2设备操作

该组函数主要是与设备相关的操作，如打开、关闭设备等一些usb标准的操作：设置配置、alternatesettings、clearinghalts和重启设备等。同时也会提供操作系统级的操作，如声明和释放接口。

usb_open()

打开一个usb设备，打开设备成功会返回一个句柄，以后的程序就可以通过该句柄来进行设备的通信。

usb_close()

关闭usb设备

返回0：关闭设备成功

小于0：关闭设备失败

usb_set_configuration()

根据配置描述符来设置一个使能的usb设备。

返回0：设置成功

小于0：设置失败

usb_set_altinterface()

设置当前接口的一个可选择的setting

usb_resetep()

reset端点

usb_clear_halt()

清除特定端点上的halt状态

usb_reset()

通过想下行端口发送一个RESET来重启连接该PORT的特定的设备

返回0：reset成功

小于0：reset失败

重新枚举

调用usb_reset设备重启后，设备会重新进行枚举成一个新设备并打开一个新句柄。

usb_claim_interface()

声明一个有操作系统相关的接口，接口的参数在描述符里的bInterfaceNumber字段里指定。

注意：在进行与该接口相关的操作之前，usb_claim_interface必须被首先调用。

返回值：

EBUSY：接口是不可用的

ENOMEM：没有足够的内存可用

usb_release_interface()

释放先前usb_claim_interface声明的接口

3.3控制传输

该组函数的主要功能是允许应用程序可以给默认的控制管道发送消息。

usb_control_msg()

给设备发送一个控制消息

usb_get_string()

重新从设备获取字符串描述符

usb_get_string_simple()

该函数是对usb_get_string()的封装，从设备重新获取设备描述符并将其转换成C语言格式的ASCII。

usb_get_descriptor()

通过设备默认的控制管道向设备重新获取设备描述符。

usb_get_descriptor_by_endpoint()

从端点识别的控制管道去获取设备描述符。

3.4.批量传输

该组函数允许应用程序通过批量传输管道向设备发送信息

usb_bulk_write()

向一个批量传输端点向设备写入数据

usb_bulk_read()

向一个批量传输端点向设备读取数据

3.5中断传输

该组函数允许应用程序通过中断传输管道向设备发送和接受数据。

usb_interrupt_write()

向一个中断端点写数据。该函数会向指定的端点发起一个中断写请求。

usb_interrupt_read()

向一个中断端点写数据。该函数会向指定的端点发起一个中断读请求。

3.6异步API和异步传输

libusb-win32通过异步API支持异步传输。libusb-win32异步传输API也支持其他的传输类型：控制传输、中断传输、批量传输等。

intusb_isochronous_setup_async(usb_dev_handle*dev,void**context,unsignedcharep,intpktsize);

为端点ep分配一个异步传输请求。

  1. intusb_bulk_setup_async(usb_dev_handle*dev,void**context,unsignedcharep);
  3. intusb_bulk_setup_async(usb_dev_handle*dev,void**context,unsignedcharep);
  5. intusb_submit_async(void*context,char*bytes,intsize);
  7. intusb_reap_async(void*context,inttimeout);等待请求完成，返回读写成功的字节数或者失败的返回值。
  9. intusb_reap_async_nocancel(void*context,inttimeout);
  11. intusb_cancel_async(void*context);取消
  13. intusb_free_async(void**context);

使用示例：

在使用设备之前，设备需要被扫描到，这可以通过扫描系统中的总线和usb总线上的设备来实现。

  1. structusb_bus*busses;
  3. usb_init();
  5. usb_find_busses();
  7. usb_find_devices();
  9. busses=usb_get_busses();

扫描到所有总线和总线上的设备后：

  1. structusb_bus*bus;
  3. intc,i,a;
  5. for(bus=busses;bus;bus=bus->next){
  7. structusb_device*dev;
  9. for(dev=bus->devices;dev;dev=dev->next){
  11. /*Checkifthisdeviceisaprinter*/
  13. if(dev->descriptor.bDeviceClass==7){
  15. /*Openthedevice,claimtheinterfaceanddoyourprocessing*/
  17. ...
  19. }
  21. for(c=0;c<dev->descriptor.bNumConfigurations;c++){/*Loopthroughalloftheconfigurations*/
  23. /*Loopthroughalloftheinterfaces*/
  25. for(i=0;i<dev->config[c].bNumInterfaces;i++){
  27. /*Loopthroughallofthealternatesettings*/
  29. for(a=0;a<dev->config[c].interface[i].num_altsetting;a++){
  31. /*Checkifthisinterfaceisaprinter*/
  33. if(dev->config[c].interface[i].altsetting[a].bInterfaceClass==7){
  35. /*Openthedevice,setthealternatesetting,claimtheinterfaceanddoyourprocessing*/
  37. ...
  39. }
  41. }
  43. }
  45. }
  47. }
  49. }

标签：#libusb#函数调用#编译程序#dev#usb接口#api接口 | 浏览：212 | 发布日期：

免责声明：文章转载自《libusb-win32 在visual studio2008中成功编译回忆录》仅用于学习参考。如对内容有疑问，请及时联系本站处理。

上篇前后端数据交互(六)——ajax 、fetch 和 axios 优缺点及比较sz/rz实现及cat binary文件时乱码问题下篇

宿迁高防，2C2G15M，22元/月；香港BGP，2C5G5M，25元/月 雨云优惠码：MjYwNzM=

相关文章

11-c++虚拟函数

虚拟函数 #include "stdio.h" class A{ 　　public: 　　　　void print() 　　　　{ 　　　　　　printf("%s","this is A "); 　　　　} }; class B:public A{ 　　public: 　　　　void print() 　　　　{ 　　　　　　printf("%s","...

Linux系统编程 —时序竞态

时序竞态 什么是时序竞态？将同一个程序执行两次，正常情况下，前后两次执行得到的结果应该是一样的。但由于系统资源竞争的原因，前后两次执行的结果有可能得到不一样的结果，这个现象就是时序竞态。 pause函数 函数原型： int pause(void); 函数作用： 进程调用pause函数时，会造成进程主动挂起（处于阻塞状态，并主动放弃CPU），并且等待信号将其...

ActiveX控件实现

本文源码与文档下载 本章目标： 完成本章学习后，您将能够： Ø了解什么是ActiveX控件 Ø掌握如何编写基于MFC的ActiveX控件 Ø掌握如何测试ActiveX控件 Ø掌握如何测试ActiveX控件 Ø了解ActiveX控件如何注册 重点：ActiveX控件的实现、测试及注册。 本章将介绍ActiveX控件的应用与工作原理。我...

Centos设置串口波特率

1、stty查看串口参数 stty -F /dev/ttyS0 -a查看串口1（/dev/ttyS0）当前的参数，包括波特率、数据位等。 2、stty设置串口参数 stty -F /dev/ttyS0 ispeed 115200 ospeed 115200 cs8 该命令将串口1（/dev/ttyS0）设置成115200波特率，8位数据模式。一般情况下设置...

iOS -NSOperation并发编程

http://www.cocoachina.com/game/20151201/14517.html  http://blog.csdn.net/qinlicang/article/details/42221585 本文是投稿文章，作者：RyanJIN（简书）对于iOS的并发编程, 用的最普遍的就是GCD了, GCD结合Block可以so easy的实现多...

WSGI详解

WSGI接口 了解了HTTP协议和HTML文档，我们其实就明白了一个Web应用的本质就是： 浏览器发送一个HTTP请求； 服务器收到请求，生成一个HTML文档； 服务器把HTML文档作为HTTP响应的Body发送给浏览器； 浏览器收到HTTP响应，从HTTP Body取出HTML文档并显示。 所以，最简单的Web应用就是先把HTML用文件保存好，用...

最新文章

随机推荐

思享工具箱导航