Libusb-win32编程方法

Libusb-win32编程方法
Libusb-win32使用主要是两个方面，一个是编写程序的时候调用Libusb-win32提供的API函数，另一个是编译的时候要调用相应的库文件；进入C:\Users\sun\Desktop\libusb-win32-bin-1.2.6.0\lib，可以看到Libusb-win32根据不同的编译方法提供了不同的库文件，可根据自己的编译环境调用相应的库文件;

一、首先说明库文件调用方法，本人使用的是QT软件，编译语言是c和c++，编译器为GCC，调用库的方法如下：（windows下QT安装和配置在另一篇文档里介绍）
将C:\Users\sun\Desktop\libusb-win32-bin-1.2.6.0\lib\gcc文件夹下的libusb.a文件拷贝到工程目录文件夹下，打开工程文件，在文件里加上LIBS += ../libusb.a，添加库文件，库文件的路径要写对，否则调用不成功

二、编写程序
首先将C:\Users\sun\Desktop\libusb-win32-bin-1.2.6.0\include中的lusb0_usb.h添加到项目中；
编写程序有个流程，这方面网上很多介绍资料，下面简单介绍下；
在C:\Users\sun\Desktop\libusb-win32-bin-1.2.6.0\examples文件夹下面有个bulk.c文件，里面涉及到了usb四种通信方式的控制传输和批量传输，其他两种传输方法类似，可自行研究。

1.首先调用下面三个函数：
usb_init(); /* initialize the library */
usb_find_busses(); /* find all busses */
usb_find_devices(); /* find all connected devices */
这三个函数是所有操作前就必须调用的，用来初始化库，遍历总线和设备；
2.打开设备；
调用了下面的函数，这个函数要自己实现，不是库文件里的，功能是遍历所有的总线和设备，根据VID和PID识别到自己的设备，然后调用usb_open库函数，打开该设备，返回一个设备句柄，用来下面的读写操作；

usb_dev_handle *open_dev(void)
{
    struct usb_bus *bus;
    struct usb_device *dev;

    for (bus = usb_get_busses(); bus; bus = bus->next)
    {
        for (dev = bus->devices; dev; dev = dev->next)
        {
            if (dev->descriptor.idVendor == MY_VID
                    && dev->descriptor.idProduct == MY_PID)
            {
                return usb_open(dev);
            }
        }
    }
    return NULL;
}

3.根据从机的驱动来做相应的初始化操作，一般是设置从机的配置和接口（从机功能单元有配置，接口，端口，端口是最小单位，是用来发送和接收数据的功能单元，资料很多，不详细介绍）
（1）调用int usb_set_configuration(usb_dev_handle *dev, int configuration);函数进行从设备的配置，需要从设别的支持，如果从设备只有一个配置或者使用者使用默认设置，在从设备初始化的过程中，设置设备的配置可以省略；返回值小于0表示配置失败；
（2）调用int usb_claim_interface(usb_dev_handle *dev, int interface);来配置接口，这一步一般都是要的，返回值小于0表示配置失败；

上面的初始化操作只是用户调用libusb-win32时的初始化流程，像读取设备信息这类操作电脑已经帮我们完成，
初始化设备完成，我们就可以调用相应的库函数对设备进行读写和控制操作了；
Bulk.c中给出了控制传输和批量传输例子，其中批量传输给了同步和非同步两种方式，控制传输代码如下：
ret = usb_control_msg(dev, USB_TYPE_VENDOR | USB_RECIP_DEVICE | USB_ENDPOINT_IN,
14, /* set/get test */
1, /* test type */
MY_INTF, /* interface id */
tmp, 1, 1000);
usb公用配置值协议里面有介绍，可参考协议来配置；保留值需要有从设备支持才能生效；
同步传输只要调用一个库函数即可：

    int usb_bulk_write(usb_dev_handle *dev, int ep, char *bytes, int size, int timeout);

    int usb_bulk_read(usb_dev_handle *dev, int ep, char *bytes, int size, int timeout);

这有两个地方需要注意，
1.批量传输的断点分输出端点和输入端点，使用的时候不可以搞混，想查看自己设备有哪些端点还有端点信息，可以通过C:\Users\sun\Desktop\libusb-win32-bin-1.2.6.0\bin\x86目录下面的testlibusb-win.exe获得，（这是32位机下的，64位机可在相应目录下找到该文件）：


上图中图示部分为端点号，一个输出端点，一个输入端点，根据从设备确定；
2.第二个要注意的地方是，usb批量传输时，如果传输的数据小于从设备设置的端点缓存大小，则每次传输的数据都应该是8的整数倍，如果发送数据的大小不是8的整数倍，最后的字节收到的时候会有错误；
而且传输的数据都应该以字符’\0’结束，字符串的话默认后面都有’\0’，如果是其他数据，则要认为的加上’\0’；
异步传输代码如下：

/*
* Read/Write using async transfer functions.
*
* NOTE: This function waits for the transfer to complete essentially making
* it a sync transfer function so it only serves as an example of how one might
* implement async transfers into thier own code.
*/
static int transfer_bulk_async(usb_dev_handle *dev,
                               int ep,
                               char *bytes,
                               int size,
                               int timeout)
{
    // Each async transfer requires it's own context. A transfer
    // context can be re-used.  When no longer needed they must be
    // freed with usb_free_async().
    //
    void* async_context = NULL;
    int ret;

    // Setup the async transfer.  This only needs to be done once
    // for multiple submit/reaps. (more below)
    //
    ret = usb_bulk_setup_async(dev, &async_context, ep);
    if (ret < 0)
    {
        printf("error usb_bulk_setup_async:\n%s\n", usb_strerror());
        goto Done;
    }

    // Submit this transfer.  This function returns immediately and the
    // transfer is on it's way to the device.
    //
    ret = usb_submit_async(async_context, bytes, size);
    if (ret < 0)
    {
        printf("error usb_submit_async:\n%s\n", usb_strerror());
        usb_free_async(&async_context);
        goto Done;
    }

    // Wait for the transfer to complete.  If it doesn't complete in the
    // specified time it is cancelled.  see also usb_reap_async_nocancel().
    //
    ret = usb_reap_async(async_context, timeout);

    // Free the context.
    usb_free_async(&async_context);

Done:
    return ret;
}