Windows下PyUSB与TMCM-6110步进电机控制器通信故障排查

背景 #

Windows下使用PyUSB与Trinamic TMCM-6110步进电机控制器通信时出现异常，厂商IDE可正常工作，具体情况如下：

• 设备已被识别，libusb安装正常，idVendor与idProduct参数无误
• 需发送的9字节指令格式正确（示例：绝对移动电机0至12800步，字节序列为b'\x01\x04\x01\x00\x00\x00\x32\x01\x39'，Python显示为b'\x01\x04\x01\x00\x00\x002\x019'，二者完全一致）
• 假设端点地址为3，执行写入操作时触发以下两组错误：

错误信息 #

Error 1 #

Traceback (most recent call last):
  File "C:\Tilman\Programs\Python37\lib\site-packages\usb\core.py", line 223, in get_interface_and_endpoint
    return self._ep_info[endpoint_address]
KeyError: 3

Error 2 #

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "Trinamic.py", line 13, in <module>
    dev.write(3,cmd)
  File "C:\Test\Programs\Python37\lib\site-packages\usb\core.py", line 940, in write
    intf, ep = self._ctx.setup_request(self, endpoint)
  File "C:\Test\Programs\Python37\lib\site-packages\usb\core.py", line 102, in wrapper
    return f(self, *args, **kwargs)
  File "C:\Test\Programs\Python37\lib\site-packages\usb\core.py", line 215, in setup_request
    intf, ep = self.get_interface_and_endpoint(device, endpoint_address)
  File "C:\Test\Programs\Python37\lib\site-packages\usb\core.py", line 102, in wrapper
    return f(self, *args, **kwargs)
  File "C:\Test\Programs\Python37\lib\site-packages\usb\core.py", line 225, in get_interface_and_endpoint
    for intf in self.get_active_configuration(device):
  File "C:\Test\Programs\Python37\lib\site-packages\usb\core.py", line 102, in wrapper
    return f(self, *args, **kwargs)
  File "C:\Test\Programs\Python37\lib\site-packages\usb\core.py", line 236, in get_active_configuration
    self.managed_open()
  File "C:\Test\Programs\Python37\lib\site-packages\usb\core.py", line 102, in wrapper
    return f(self, *args, **kwargs)
  File "C:\Test\Programs\Python37\lib\site-packages\usb\core.py", line 120, in managed_open
    self.handle = self.backend.open_device(self.dev)
  File "C:\Test\Programs\Python37\lib\site-packages\usb\backend\libusb1.py", line 786, in open_device
    return _DeviceHandle(dev)
  File "C:\Test\Programs\Python37\lib\site-packages\usb\backend\libusb1.py", line 643, in __init__
    _check(_lib.libusb_open(self.devid, byref(self.handle)))
  File "C:\Test\Programs\Python37\lib\site-packages\usb\backend\libusb1.py", line 593, in _check
    raise NotImplementedError(_strerror(ret))
NotImplementedError: Operation not supported or unimplemented on this platform

问题 #

1. Error1中的KeyError:3含义是什么？3是否为错误的端点地址？
2. Error2中的“Operation not supported or unimplemented on this platform”错误含义是什么？如何修复？
3. 还需检查或尝试哪些操作以定位问题？
4. 为何各类通信接口（RS232、RS485、USB、LAN等）的示例无法直接正常运行？

解答 #

1. KeyError:3的含义及端点地址问题 #

KeyError:3表示PyUSB在当前设备的端点列表中找不到地址为3的端点，大概率是你假设的端点地址错误。不要仅依赖print(dev)的输出，用以下代码枚举设备所有实际存在的端点：

for cfg in dev:
    for intf in cfg:
        for ep in intf:
            print(f"端点地址: {ep.bEndpointAddress}, 方向: {'输入' if ep.bEndpointAddress & 0x80 else '输出'}")

运行后即可获取设备真实的端点地址，选择对应的输出端点进行写入操作。

2. 平台不支持操作的错误原因及修复 #

这个错误在Windows环境下常见，主要有两个原因及对应修复方式：

• 设备被系统官方驱动占用：厂商IDE能正常工作，说明系统已加载设备的官方驱动，libusb无法获取设备控制权。使用Zadig工具将设备驱动替换为libusb-win32或libusbK，替换前需关闭厂商IDE。
• PyUSB后端兼容性问题：Python3.7搭配的libusb后端可能存在版本兼容问题，可尝试更换为pywinusb（Windows专用USB库），或升级PyUSB与libusb至最新版本。

3. 额外排查操作 #

• 确认设备配置与接口：部分USB设备需先设置活动配置、声称接口才能通信，添加以下代码步骤：

  dev.set_configuration()  # 设置活动配置
  intf = dev.get_active_configuration()[(0,0)]  # 根据实际枚举结果调整接口索引
  dev.claim_interface(intf)
  

• 使用USB调试工具：通过usbview、libusb_debug等工具查看设备实时状态，确认端点、配置是否正确，以及设备是否被其他进程占用。
• 数据包对比：抓取厂商IDE发送的USB数据包，与PyUSB发送的数据包对比，检查指令格式、端点选择是否存在差异。

4. 通信接口示例无法直接运行的原因 #

这类问题非常普遍，核心原因包括：

• 厂商文档滞后或错误：多数示例为几年前编写，适配的库版本、系统环境与当前不符。
• 权限与驱动问题：不同系统对通信设备的权限要求不同，Windows可能需要管理员权限，Linux需配置udev规则；部分设备需替换驱动才能被第三方库识别。
• 设备参数不匹配：示例中的idVendor、idProduct、端点地址、通信协议参数（如波特率）可能与你的具体设备型号不一致。
• 依赖库API变更：旧版本库的API在新版本中发生变化，导致示例代码无法兼容。

内容的提问来源于stack exchange，提问作者theozh