HIDAPI无法识别并连接USB HID设备的问题咨询与解决

我尝试用Python的hidapi模块控制一款USB HID设备（气象站RF收发器加密狗），但既打不开设备，调用hid.enumerate()也找不到它。不过用pyusb能找到并连接设备，查看描述符后发现：设备的接口类是0x03（HID类），但设备类也设为了0x03，而非HID规范要求的0x00（规范要求在接口层指定HID类）。

想请教几个问题：

1. 这款设备是不是不符合HID规范？
2. 这会不会是hidapi识别不到它的唯一原因？
3. 我观察到设备表现和常规HID设备没区别，而且已经用pyusb通过控制传输读到了接口的HID描述符。如果问题确实出在设备类上，有没有办法让hidapi忽略这个错误的设备类，直接连接设备？我更想用hidapi而不是pyusb。

设备描述符信息 #

DEVICE ID 6666:5555 on Bus 001 Address 001 =================
 bLength                :   0x12 (18 bytes)
 bDescriptorType        :    0x1 Device
 bcdUSB                 :  0x200 USB 2.0
 bDeviceClass           :    0x3 
 bDeviceSubClass        :    0x0
 bDeviceProtocol        :   0xff
 bMaxPacketSize0        :   0x40 (64 bytes)
 idVendor               : 0x6666
 idProduct              : 0x5555
 bcdDevice              :  0x100 Device 1.0
 iManufacturer          :    0x1 LA CROSSE TECHNOLOGY
 iProduct               :    0x2 Weather Direct Light Wireless Device
 iSerialNumber          :    0x3 0123456
 bNumConfigurations     :    0x1
  CONFIGURATION 1: 30 mA ===================================
   bLength              :    0x9 (9 bytes)
   bDescriptorType      :    0x2 Configuration
   wTotalLength         :   0x22 (34 bytes)
   bNumInterfaces       :    0x1
   bConfigurationValue  :    0x1
   iConfiguration       :    0x0 
   bmAttributes         :   0x80 Bus Powered
   bMaxPower            :    0xf (30 mA)
    INTERFACE 0: Human Interface Device ====================
     bLength            :    0x9 (9 bytes)
     bDescriptorType    :    0x4 Interface
     bInterfaceNumber   :    0x0
     bAlternateSetting  :    0x0
     bNumEndpoints      :    0x1
     bInterfaceClass    :    0x3 Human Interface Device
     bInterfaceSubClass :    0x0
     bInterfaceProtocol :    0x0
     iInterface         :    0x0 
      ENDPOINT 0x81: Interrupt IN ==========================
       bLength          :    0x7 (7 bytes)
       bDescriptorType  :    0x5 Endpoint
       bEndpointAddress :   0x81 IN
       bmAttributes     :    0x3 Interrupt
       wMaxPacketSize   :   0x40 (64 bytes)
       bInterval        :   0x20

1. 设备是否不符合HID规范？ #

是的，这款设备违反了USB HID规范。根据USB官方文档，HID设备必须将设备类（bDeviceClass）设为0x00，然后在接口层（bInterfaceClass）指定0x03（HID类）。直接在设备层设置HID类的做法属于非标准实现，不符合规范要求。

2. 这是不是hidapi识别不到设备的唯一原因？ #

大概率是核心原因，但不能完全排除其他小概率问题。hidapi枚举设备时，通常会严格遵循USB规范的过滤逻辑——只识别设备类为0x00且接口类为0x03的设备，部分平台甚至会直接过滤设备类为0x03的设备（这类设备会被系统直接归类为HID，但hidapi的枚举逻辑不兼容这种非标准设置）。从你用pyusb能正常读取HID描述符来看，硬件层面没有问题，所以设备类错误是导致hidapi识别失败的主要原因。

3. 如何让hidapi忽略设备类错误并连接设备？ #

有几种可行的解决办法：

• 修改hidapi源码重新编译：找到hidapi中hid_enumerate函数里的设备类判断逻辑，移除对bDeviceClass的检查，只保留接口类为0x03的判断，重新编译hidapi库后安装对应的Python绑定。
• 通过设备路径直接打开：部分平台的hidapi支持直接通过系统设备路径打开设备，不需要依赖枚举结果。你可以先用pyusb获取设备的系统路径（比如Linux下的/dev/hidrawX、Windows下的设备路径），再调用hid.open_path()方法直接连接。
• 使用社区修改版hidapi：有些社区分支针对这类非标准HID设备修改了hidapi，去掉了设备类的严格检查，可以查找并使用这类版本。

这些方法都属于兼容非标准设备的临时方案，可能存在平台兼容性差异，需要根据你使用的操作系统（Windows/Linux/macOS）调整具体实现。

内容的提问来源于stack exchange，提问作者gugelhüpf