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

关于这个项目不用多说

介绍

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驱动安装。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。

 

从官网下载源码项目：

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 Files\Inno Setup 5\ISCC.exe(optional)
6.        Line81 IMPLIB=C:\Program Files\Borland\CBuilder6\Bin\implib.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 */

#ifndef DDK_DIR

#define DDK_DIR "D:/WinDDK/7600.16385.1"

#endif

/* embed libusb0 driver files from thefollowing location */

#ifndef LIBUSB0_DIR

#define LIBUSB0_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-win32\projects\Win32\Debug\inf-wizard\inf-wizard.exe : fatal error LNK1120: 3 个无法解析的外部命令 

 

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

 

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

 

 

感谢

kook_pudding

 

1   在 libwdi(static) 下面的SouorceFiles下面添加现有文件 pki.c 文件 ，就解决了

 2   安装VS2008的时候 千万记得展开C++安装选项啊，妈的 x64编译器默认不给安装....................

 

 

--------------------------------附一篇翻译过来的说明------------------------

 来自：http://blog.csdn.net/ahc2013/article/details/8683227

libusb-win32介绍

2013-03-17 11:53 1593人阅读 评论(0) 收藏 举报

 分类：

usb（14） 

1.介绍

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

 

2.API

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

 

设备和接口

libusb API将打开的设备绑定到一个特定的接口。这就意味着如果你想在一个设备上请求更多的接口，就必须打开这个设备多次，这样通过调用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的基本最小单位为毫秒

在linux libusb-0.1中（仅支持同步API），timeout=0表示无限的。linusb-win32 1.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。

 

报告错误代码

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

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

#define EPERM       1   /* Operation not permitted */

#define ENOENT      2   /* No entry, ENOFILE, no such file or directory */

#define ESRCH       3   /* No such process */

#define EINTR       4   /* Interrupted function call */

#define EIO     5   /* Input/output error */

#define ENXIO       6   /* No such device or address */

#define E2BIG       7   /* Arg list too long */

#define ENOEXEC     8   /* Exec format error */

#define EBADF       9   /* Bad file descriptor */

#define ECHILD      10  /* No child processes */

#define EAGAIN      11  /* Resource temporarily unavailable */

#define ENOMEM      12  /* Not enough space */

#define EACCES      13  /* Permission denied */

#define EFAULT      14  /* Bad address */

#define EBUSY       16  /* strerror reports "Resource device" */

#define EEXIST      17  /* File exists */

#define EXDEV       18  /* Improper link (cross-device link?) */

#define ENODEV      19  /* No such device */

#define ENOTDIR     20  /* Not a directory */

#define EISDIR      21  /* Is a directory */

#define EINVAL      22  /* Invalid argument */

#define ENFILE      23  /* Too many open files in system */

#define EMFILE      24  /* Too many open files */

#define ENOTTY      25  /* Inappropriate I/O control operation */

#define EFBIG       27  /* File too large */

#define ENOSPC      28  /* No space left on device */

#define ESPIPE      29  /* Invalid seek (seek on a pipe?) */

#define EROFS       30  /* Read-only file system */

#define EMLINK      31  /* Too many links */

#define EPIPE       32  /* Broken pipe */

#define EDOM        33  /* Domain error (math functions) */

#define ERANGE      34  /* Result too large (possibly too small) */

#define EDEADLK     36      /* Resource deadlock avoided */

#define ENAMETOOLONG    38  /* Filename too long */

#define ENOLCK      39  /* No locks available */

#define ENOSYS      40  /* Function not implemented */

#define ENOTEMPTY   41  /* Directory not empty */

 

 

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就可以得到信息的调试信息。

0 LOG_OFF

1 LOG_ERROR

2 LOG_WARNING

3 LOG_INFO

4 LOG_DEBUG

 

3.2 设备操作

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

 

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也支持其他的传输类型：控制传输、中断传输、批量传输等。

 

int usb_isochronous_setup_async(usb_dev_handle *dev, void **context, unsigned char ep, int pktsize);

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

 

int usb_bulk_setup_async(usb_dev_handle *dev, void **context, unsigned char ep);

int usb_bulk_setup_async(usb_dev_handle *dev, void **context, unsigned char ep);

int usb_submit_async(void *context, char *bytes, int size);

int usb_reap_async(void *context, int timeout);等待请求完成，返回读写成功的字节数或者失败的返回值。

int usb_reap_async_nocancel(void *context, int timeout);

int usb_cancel_async(void *context);取消

int usb_free_async(void **context);

 

使用示例：

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

struct usb_bus *busses;

usb_init();

usb_find_busses();

usb_find_devices();

busses = usb_get_busses();

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

struct usb_bus *bus;

 int c, i, a;

 for (bus = busses; bus; bus = bus->next) {

     struct usb_device *dev;

     for (dev = bus->devices; dev; dev = dev->next) {

         /* Check if this device is a printer */

         if (dev->descriptor.bDeviceClass == 7) {

             /* Open the device, claim the interface and do your processing */

             ...

         }

         for (c = 0; c < dev->descriptor.bNumConfigurations; c++) { /* Loop through all of the configurations */

             /* Loop through all of the interfaces */

             for (i = 0; i < dev->config[c].bNumInterfaces; i++) {

                 /* Loop through all of the alternate settings */

                 for (a = 0; a < dev->config[c].interface[i].num_altsetting; a++) {

                     /* Check if this interface is a printer */

                     if (dev->config[c].interface[i].altsetting[a].bInterfaceClass == 7) {

                     /* Open the device, set the alternate setting, claim the interface and do your processing */

                        ...

                     }

                 }

             }

         }

     }

 }