简介

PyUSB是一个Python库，它提供了对USB设备的访问接口，使得开发者可以使用Python语言来控制USB设备。无论是读取数据、发送指令，还是管理设备接口，PyUSB都能轻松应对。本教程将指导你如何安装PyUSB，以及如何使用它来控制USB设备。

安装PyUSB

在开始之前，请确保你的计算机上已经安装了Python环境。接下来，使用pip安装PyUSB库：

pip install pyusb

基本使用

1. 枚举USB设备

首先，我们需要枚举当前连接到计算机的所有USB设备。以下是一个简单的示例代码：

import pyusb

context = pyusb.Context()
devices = context.getDeviceList(skip_on_access_error=True)

for device in devices:
    print(f"设备ID: {device.getProductId()}")
    print(f"设备制造商: {device.manufacturer}")
    print(f"设备产品: {device.product}")
    print(f"设备序列号: {device.serial_number}")
    print("-" * 40)

这段代码会列出所有USB设备的基本属性。

2. 打开设备

一旦你找到了想要控制的设备，你可以打开它并选择一个配置：

# 假设我们找到了设备并存储了它的引用
device = devices[0]

# 打开设备
device.open()

# 选择配置（通常配置索引为0）
configuration = device.getConfiguration()

3. 选择接口和设置

在USB设备中，接口是通信的通道。以下是如何选择接口和设置的示例：

# 获取设备的第一个接口
interface = device.getInterface(0)

# 选择接口
device.claimInterface(interface)

4. 读写数据

现在，你可以向设备发送数据或从设备读取数据了。以下是一个发送和接收数据的示例：

# 发送数据到设备
endpoint_out = device.getEndpoint(1)
device.write(endpoint_out, b'Hello, USB device!')

# 从设备接收数据
endpoint_in = device.getEndpoint(129)
data = device.read(endpoint_in, 1024)  # 读取1024字节
print(f"接收到的数据: {data}")

5. 释放资源

操作完成后，不要忘记释放资源：

# 释放接口
device.releaseInterface(interface)

# 关闭设备
device.close()

# 释放上下文
context.dispose()

实际应用示例

假设你有一个USB温度传感器，你想要读取温度数据。以下是如何使用PyUSB来实现这一功能的示例：

# 假设温度传感器的设备ID和产品ID已知
device_id = 0x1234
product_id = 0x5678

# 枚举设备并找到温度传感器
for device in context.getDeviceList(skip_on_access_error=True):
    if device.getProductId() == product_id and device.getVendorId() == device_id:
        break

# 打开设备并选择配置
device.open()
device.setConfiguration()

# 选择接口和设置
interface = device.getInterface(0)
device.claimInterface(interface)

# 发送读取温度的指令
device.write(endpoint_out, b'\x01')  # 假设'\x01'是读取温度的指令

# 读取温度数据
temperature_data = device.read(endpoint_in, 2)  # 假设返回2字节数据

# 转换数据为温度值（根据传感器的协议）
temperature = convert_to_temperature(temperature_data)

print(f"当前温度: {temperature}°C")

# 释放资源
device.releaseInterface(interface)
device.close()
context.dispose()

注意事项

• 在与USB设备通信时，确保你了解设备的通信协议和数据格式。
• 在某些情况下，你可能需要管理员权限来访问USB设备。
• 确保在程序结束时释放所有资源，避免占用系统资源。

通过本教程，你应该已经学会了如何使用PyUSB来控制USB设备。现在，你可以开始探索更多高级功能，或者将PyUSB集成到你的项目中了。祝你编程愉快！