树莓派2B Buildroot系统下USB HID设备报-22错误如何解决

-22错误码的具体含义 #

Linux内核中返回值-22对应常量错误EINVAL，即无效参数。放到USB设备枚举场景下，这个错误的本质是：主机在和设备交互的过程中，收到的设备响应数据（包括各类描述符、标准请求应答）不符合USB协议规范，内核USB核心层/HID核心层校验不通过，直接终止枚举流程，不会绑定对应的HID驱动。
同接口下普通键盘、鼠标等商用HID设备可以正常工作，已经可以排除树莓派USB主机控制器故障、系统USB驱动裁剪错误、接口供电不足这类共性问题，故障点100%出在自研设备端。

完整USB错误码的查询路径 #

你不需要到外部站点查错误码，所有定义都在你当前Buildroot构建环境自带的Linux内核源码里：

• 通用基础错误码定义位置：include/uapi/asm-generic/errno-base.h，你碰到的EINVAL 22就在这个文件中，内核函数返回时加负号是内部约定写法
• USB子系统专属的扩展错误码定义位置：include/uapi/linux/usbdevice_fs.h、drivers/usb/core/hub.h
• 比查错误码表更高效的定位方式：直接顺着dmesg报错日志里打印的函数名，在drivers/usb/core/（USB核心枚举逻辑）、drivers/hid/hid-core.c（HID描述符解析逻辑）里找对应代码行，能直接看到触发-22返回值的具体校验规则，完全匹配你当前运行的内核版本，不存在文档和实际代码不一致的问题。

设备端针对性排查修复方向 #

按出现概率从高到低排序，优先查固件逻辑问题：

• 第一优先级查各类USB描述符合法性，这类问题占自研HID设备报EINVAL的90%以上：
  • 核对设备描述符、配置描述符、接口描述符、HID描述符的bLength字段值是否和规范要求的长度一致，HID描述符中标注的报告描述符长度是否和设备实际返回的字节数匹配
  • 核对HID报告描述符逻辑：检查逻辑最小/最大值范围、报告大小、报告计数的设置是否匹配，有没有出现声明的位长度和实际usage占用位长度不匹配的问题，未定义的Usage Page不要随意使用
  • 核对字符串描述符：如果实现了字符串描述符，必须使用UTF-16LE编码；如果没有实现字符串描述符，一定要把设备、配置、接口描述符中对应的字符串索引字段填0，不要留无效索引值触发内核读取失败
  • 核对端点0最大包长：全速USB设备端点0最大包长必须为8字节，高速USB设备端点0最大包长必须为64字节，这个值填错会在枚举最早期就触发报错
• 第二优先级查标准请求响应逻辑：
  可以在树莓派上启用usbmon模块抓枚举阶段的USB总线包，核对设备对GET_DESCRIPTOR、SET_ADDRESS、SET_CONFIGURATION这些标准请求的响应，检查是否存在响应STALL、返回字节数少于主机请求长度、响应超时后返回乱码的问题
• 第三优先级查硬件电气特性：
  测量D+、D-差分线的电平、上拉电阻阻值，排查枚举阶段是否存在信号抖动、阻抗不匹配导致的传输出错，这类问题会让主机收到的描述符数据出现位错误，校验失败也会返回EINVAL，整体出现概率远低于固件问题。

排查提速技巧：可以先把设备插到标准x86 Linux桌面系统上看dmesg输出，桌面版内核的USB调试日志通常没有被裁剪，会直接打印出是解析哪个描述符、哪个字段时触发的错误，不需要逐行扒源码定位。

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