### PyUSB Library Usage and Documentation PyUSB 是一个用于在 Python 中访问 USB 设备的库。它提供了一个简单而强大的接口来操作基于 `libusb` 的设备驱动程序[^1]。 #### 安装 PyUSB 要安装 PyUSB 库，可以使用 pip 工具执行以下命令： ```bash pip install pyusb ``` #### 基本概念 PyUSB 提供了一种抽象的方式来处理 USB 设备通信。以下是几个核心组件及其功能： - **Device**: 表示连接到系统的 USB 设备。 - **Configuration**: 描述设备的功能配置。 - **Interface**: 配置中的特定功能集。 - **Endpoint**: 数据传输的具体通道。 这些对象可以通过调用相应的 API 方法获取并交互。 #### 示例代码 下面是一个简单的例子，展示如何枚举所有可用的 USB 设备并打印其描述符信息： ```python import usb.core import usb.util # 查找所有 USB 设备 devices = usb.core.find(find_all=True) for device in devices: try: # 打印厂商ID和产品ID print(f"Vendor ID: {device.idVendor:#04x}, Product ID: {device.idProduct:#04x}") # 获取字符串描述符 manufacturer_string = usb.util.get_string(device, device.iManufacturer) product_string = usb.util.get_string(device, device.iProduct) serial_number = usb.util.get_string(device, device.iSerialNumber) print(f" Manufacturer: {manufacturer_string}") print(f" Product Name: {product_string}") print(f" Serial Number: {serial_number}\n") except Exception as e: print(f"Error accessing device: {e}") ``` 此脚本通过遍历所有已连接的 USB 设备，并尝试读取它们的制造商名称、产品名称以及序列号等信息。 #### 可移植性和兼容性 由于 PyUSB 构建于底层 `libusb` 之上，因此它的行为可能因操作系统不同而有所差异。例如，在 Windows 上通常需要额外安装 `libusb-win32` 或者更新版本的 `libusb` 驱动支持。对于跨平台开发而言，建议测试目标环境下的具体实现细节。 #### 文档资源链接 官方文档提供了详尽的教程和技术参考资料，可帮助开发者深入了解该库的各项特性与高级应用技巧。更多详情参见 [PyUSB GitHub Repository](https://github.com/pyusb/pyusb).