libusb介绍及简单使用

libusb是一个开源的用C实现的，应用程序与用户的USB设备进行通信的库。它是可移植的，对外使用统一的API，支持Windows、macOS、Linux、Android。它是用户模式(user-mode)，应用程序与USB设备通信不需要高权限，但是在Android下好像有些接口需要root权限才能调用成功。它支持所有版本的USB协议。它的License是LGPL，源码地址在https://github.com/libusb/libusb，最新发布版本为1.0.23。

libusb特性：

(1).支持所有的传输类型(control/bulk/interrupt/isochronous)。

(2).传输接口包括同步和异步。

(3).线程安全。

(4).在一些平台上支持热插拔(Hotplug)。

libusb中的接口通常在成功时返回0，在失败时返回负值。

libusb使用stderr记录所有日志(log)。默认情况下，日志记录设置为NONE，将不产生任何输出。除非在编译源码时禁用了日志记录，否则任何应用程序对libusb_set_option(ctx, LIBUSB_OPTION_LOG_LEVEL, level)的调用或在应用程序外部对环境变量LIBUSB_DEBUG的设置都可能生成日志记录。log消息是非结构化的，它与调用接口返回的错误码没有一一对应的关系。

在Windows上编译步骤：在源码的msvc目录下有各种版本的vs工程，2013、2017等等。这里以vs2013为例，打开libusb_2013.sln，然后点击”重新生成解决方案”，便会生成动态库、静态库、及一些二进制文件。仿照原工程所需文件及配置，这里在OpenCV_Test的基础上新加一个libusb工程，编译生成libusb静态库。

在Linux上编译步骤：执行以下命令即可：

  

   

    

     

    
    

     

      ./autogen.sh
     
    
   

    

     

    
    

     

      make
     
    
  

以下为获取PC机上usb设备信息的测试代码：

  

   

    

     

    
    

     

      #include "funset.hpp"
     
    
   

    

     

    
    

     

      #include <libusb.h>
     
    
   

    

     

    
    

     
 
     
    
   

    

     

    
    

     

      int test_libusb_get_devices_list()
     
    
   

    

     

    
    

     

      {
     
    
   

    

     

    
    

     
	
      // reference: examples/listdevs.c
     
    
   

    

     

    
    

     
	
      int ret = libusb_init(
      nullptr);
     
    
   

    

     

    
    

     
	
      if (ret != 
      0) {
     
    
   

    

     

    
    

     
		
      fprintf(
      stderr, 
      "fail to init: %d\n", ret);
     
    
   

    

     

    
    

     
		
      return 
      -1;
     
    
   

    

     

    
    

     

      	}
     
    
   

    

     

    
    

     
 
     
    
   

    

     

    
    

     

      	libusb_device** devs = 
      nullptr;
     
    
   

    

     

    
    

     
	
      ssize_t count = libusb_get_device_list(
      nullptr, &devs);
     
    
   

    

     

    
    

     
	
      if (count < 
      0) {
     
    
   

    

     

    
    

     
		
      fprintf(
      stderr, 
      "fail to get device list: %d\n", count);
     
    
   

    

     

    
    

     

      		libusb_exit(
      nullptr);
     
    
   

    

     

    
    

     
		
      return 
      -1;
     
    
   

    

     

    
    

     

      	}
     
    
   

    

     

    
    

     
 
     
    
   

    

     

    
    

     

      	libusb_device* dev = 
      nullptr;
     
    
   

    

     

    
    

     
	
      int i = 
      0;
     
    
   

    

     

    
    

     
 
     
    
   

    

     

    
    

     
	
      while ((dev = devs[i++]) != 
      nullptr) {
     
    
   

    

     

    
    

     
		
      struct libusb_device_descriptor desc;
     
    
   

    

     

    
    

     

      		ret = libusb_get_device_descriptor(dev, &desc);
     
    
   

    

     

    
    

     
		
      if (ret < 
      0) {
     
    
   

    

     

    
    

     
			
      fprintf(
      stderr, 
      "fail to get device descriptor: %d\n", ret);
     
    
   

    

     

    
    

     
			
      return 
      -1;
     
    
   

    

     

    
    

     

      		}
     
    
   

    

     

    
    

     
 
     
    
   

    

     

    
    

     
		
      fprintf(
      stdout, 
      "%04x:%04x (bus: %d, device: %d) ",
     
    
   

    

     

    
    

     

      			desc.idVendor, desc.idProduct, libusb_get_bus_number(dev), libusb_get_device_address(dev));
     
    
   

    

     

    
    

     
 
     
    
   

    

     

    
    

     
		
      uint8_t path[
      8];
     
    
   

    

     

    
    

     

      		ret = libusb_get_port_numbers(dev, path, 
      sizeof(path));
     
    
   

    

     

    
    

     
		
      if (ret > 
      0) {
     
    
   

    

     

    
    

     
			
      fprintf(
      stdout, 
      "path: %d", path[
      0]);
     
    
   

    

     

    
    

     
			
      for (
      int j = 
      1; j < ret; ++j)
     
    
   

    

     

    
    

     
				
      fprintf(
      stdout, 
      ".%d", path[j]);
     
    
   

    

     

    
    

     

      		}
     
    
   

    

     

    
    

     
		
      fprintf(
      stdout, 
      "\n");
     
    
   

    

     

    
    

     

      	}
     
    
   

    

     

    
    

     
 
     
    
   

    

     

    
    

     

      	libusb_free_device_list(devs, 
      1);
     
    
   

    

     

    
    

     

      	libusb_exit(
      nullptr);
     
    
   

    

     

    
    

     
 
     
    
   

    

     

    
    

     
	
      return 
      0;
     
    
   

    

     

    
    

     

      }
     
    
  

Windows上执行结果如下：

Linux上执行结果如下：

GitHub：https://github.com//fengbingchun/OpenCV_Test