从Windows的fileapi.h迁移到Ubuntu的hidapi后HID设备读取数据异常

核心差异点：HID报告ID的处理差异 #

Windows下使用CreateFile读取HID设备时，若设备采用无报告ID的HID报告格式，ReadFile返回的数据直接从实际有效数据开始，不包含报告ID字节；而Linux下的hidapi（无论使用libusb还是hidraw后端）会默认将报告ID作为返回缓冲区的第一个字节（即使设备无报告ID，该字节通常为0）。这会导致你后续的字节组合逻辑完全错位。

排查步骤 #

1. 对比原始字节数据
   在Windows和Linux下分别打印读取到的data_buffer前10个字节，确认是否存在以下情况：

   • Linux下data_buffer[0]为报告ID（通常是0），而Windows下data_buffer[0]是实际数据的第一个字节
   • 后续字节在Linux下整体向后偏移1位与Windows数据匹配

2. 验证读取字节数
   检查hid_read_timeout的返回值（读取到的字节数），与Windows下num_bytes_read对比：

   int bytes_read = hid_read_timeout(this->device_handle, data_buffer.get(), 65, 5000);
   if (bytes_read <= 0) {
       // 处理读取错误或超时
   }
   

   若Linux下返回65字节、Windows下返回64字节，进一步说明Linux多了1个报告ID字节。

修复方案 #

针对报告ID的差异，调整数据处理逻辑：

• 方式1：平台区分处理

  #ifdef __linux__
  // Linux下跳过第一个报告ID字节
  int data_offset = 1;
  #else
  // Windows下直接从0开始
  int data_offset = 0;
  #endif
  
  // 后续组合逻辑加上偏移
  unsigned char high_byte = data_buffer[i + data_offset];
  unsigned char low_byte = data_buffer[i + 1 + data_offset];
  uint16_t t = ((uint16_t)high_byte << 8) | low_byte;
  

• 方式2：自动检测报告ID
  如果设备可能存在带/不带报告ID的情况，可以通过读取设备的报告描述符判断是否包含报告ID，或者对比Linux下data_buffer[0]是否为0（无报告ID设备的默认值）来动态调整偏移。

其他可能的排查方向 #

• 确认hidapi版本：使用最新版hidapi（>=0.14.0），旧版本可能存在跨平台兼容性bug
• 检查设备权限：Linux下确保当前用户有权限访问HID设备（可通过添加udev规则解决，比如创建/etc/udev/rules.d/99-hid.rules，内容为SUBSYSTEM=="hidraw", ATTRS{idVendor}=="xxxx", ATTRS{idProduct}=="yyyy", MODE="0666"，替换xxxx/yyyy为你的设备VID/PID）
• 验证字节序：虽然x86架构都是小端，但可通过打印单个uint16_t值的原始字节，确认设备输出的字节顺序是否在跨平台下被正确读取（hidapi应原样返回设备字节，此情况概率较低）

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