libusb

### libusb 使用教程与文档概述 libusb 是一个用于访问和控制 USB 设备的跨平台库，支持多种操作系统，包括 Linux、Windows 和 macOS。它提供了一套统一的 API 接口，使得开发者可以编写与平台无关的 USB 通信程序。以下内容涵盖了 libusb 的使用方法、文档资源以及常见问题的解决方案。 #### 1. libusb 安装与配置 在 Linux 系统中，可以通过源码安装 libusb。通常需要下载 `libusb-1.0.9.tar.bz2` 和 `libusb-compat-0.1.4.tar.bz2`，其中后者用于兼容旧版本的 libusb 接口[^1]。安装步骤如下： ```bash tar -xjf libusb-1.0.9.tar.bz2 cd libusb-1.0.9 ./configure make sudo make install ``` 对于依赖管理，可以使用包管理器安装，例如在 Debian/Ubuntu 上： ```bash sudo apt install libusb-1.0-0 ``` 在 Windows 上，可以通过 vcpkg 或 MSYS2 安装 libusb。 #### 2. libusb API 使用示例 libusb 提供了丰富的 API 用于设备查找、配置和数据传输。以下是一个简单的示例代码，展示如何列出所有连接的 USB 设备： ```c #include <libusb-1.0/libusb.h> #include <stdio.h> int main() { libusb_context *ctx = NULL; libusb_device **devs; ssize_t cnt; libusb_init(&ctx); cnt = libusb_get_device_list(ctx, &devs); for (ssize_t i = 0; i < cnt; i++) { struct libusb_device_descriptor desc; int r = libusb_get_device_descriptor(devs[i], &desc); if (r < 0) { fprintf(stderr, "Failed to get device descriptor\n"); continue; } printf("Device %d: ID %04x:%04x\n", (int)i, desc.idVendor, desc.idProduct); } libusb_free_device_list(devs, 1); libusb_exit(ctx); return 0; } ``` 编译时需要链接 libusb： ```bash gcc -o list_usb list_usb.c -lusb-1.0 ``` #### 3. libusb 文档与学习资源 官方文档主要集中在 [libusb.info](http://libusb.info) 网站上，该网站提供了完整的 API 文档、开发指南和示例代码。对于开发者来说，理解 libusb 的异步 I/O 模型、设备生命周期管理和错误处理机制是非常重要的[^1]。 #### 4. 常见问题与解决方案 - **设备无法识别**：确保设备驱动程序正确安装，并且设备处于活动状态。可以通过 `lsusb` 命令检查设备是否被系统识别[^4]。 - **权限问题**：在 Linux 上，可能需要将用户添加到 `plugdev` 组以获得访问 USB 设备的权限。 - **API 调用失败**：检查返回值以获取错误信息，使用 `libusb_error_name()` 函数可以将错误码转换为可读字符串。 - **兼容性问题**：旧版本的 libusb（如 0.1.x）与新版本（1.0.x）存在 API 差异，建议使用 `libusb-compat` 包来维持兼容性[^1]。 #### 5. 高级开发与集成 对于嵌入式系统，如 STM32 微控制器，可以使用轻量级 USB 设备栈实现与 libusb 的集成。该项目提供了跨平台兼容性、易于集成的 HAL 库支持以及详细的文档和示例代码，帮助开发者快速上手[^3]。 ###