Libusb 中文介绍

Libusb 是一个开源的用户态 USB 库，允许开发者在应用程序中直接访问 USB 设备，无需编写内核驱动。支持跨平台（Linux、macOS、Windows、Android 等），提供同步/异步 API，是嵌入式开发、USB 协议分析等领域的常用工具。

核心功能：

1. 跨平台支持

   • Linux（通过 udev 或 usbfs）
   • Windows（需驱动如 libusb-win32 或 Zadig 生成的驱动）
   • macOS（原生支持）
   • Android（通过 USB Host API）

2. 传输模式

   • 同步 API：阻塞式传输（简单易用）
   • 异步 API：非阻塞 + 事件循环（高性能）

3. 协议支持
   所有 USB 传输类型：

   • 控制传输（Control Transfer）
   • 中断传输（Interrupt Transfer）
   • 批量传输（Bulk Transfer）
   • 等时传输（Isochronous Transfer）

4. 设备枚举与热插拔

   • 动态检测设备连接/断开
   • 按 VID/PID 过滤设备

使用流程：

1. 初始化库：

   libusb_context *ctx;
   libusb_init(&ctx);

2. 查找设备：

   libusb_device **dev_list;
   ssize_t cnt = libusb_get_device_list(ctx, &dev_list);
   libusb_device_handle *dev_handle = libusb_open_device_with_vid_pid(ctx, vid, pid);

3. 声明接口（需权限）：

   libusb_claim_interface(dev_handle, 0);  // 占用接口0

4. 数据传输（示例：批量写入）：

   unsigned char data[64] = {...};
   int transferred;
   libusb_bulk_transfer(dev_handle, endpoint_out, data, sizeof(data), &transferred, timeout);

5. 释放资源：

   libusb_release_interface(dev_handle, 0);
   libusb_close(dev_handle);
   libusb_exit(ctx);

常见问题：

1. 权限不足（Linux）
   解决方案：

   • 添加 udev 规则（示例）：

     SUBSYSTEM=="usb", ATTR{idVendor}=="1234", MODE="0666"

   • 或直接以 sudo 运行（不推荐）。

2. 设备被占用（如内核驱动）
   解决：解除内核驱动绑定：

   sudo echo -n "1-2" > /sys/bus/usb/drivers/usb/unbind  # 示例路径

3. Windows 驱动问题
   解决：使用 Zadig 生成 libusb 兼容驱动。

示例项目：

• 读取 USB 设备描述符：

  struct libusb_device_descriptor desc;
  libusb_get_device_descriptor(dev, &desc);
  printf("VID: 0x%04X, PID: 0x%04X\n", desc.idVendor, desc.idProduct);

• 异步传输：通过事件循环（libusb_handle_events）实现非阻塞操作。

资源推荐：

• 文档：libusb.info
• GitHub：libusb/libusb
• 工具：
  • USB 分析工具：Wireshark（支持 USB 抓包）
  • Windows 驱动安装：Zadig

深入学习可从官方示例代码（examples/ 目录）开始。