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