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

libusb介绍及简单使用:等您坐沙发呢!

发表评论

表情
还能输入210个字