HID报告描述符中的ReportID

HID（Human Interface Device）报告描述符是USB设备描述符的一种，用于定义人机接口设备（如键盘、鼠标、游戏手柄等）与主机之间的通信方式和数据格式。Report Descriptor包含了设备的所有输入、输出和特征报告的详细信息。

基础概念

• Report ID：报告ID是一个字节值，用于区分不同的报告。每个报告可以有一个唯一的Report ID，这样主机就可以请求特定的报告。
• 描述符：描述符是USB设备用来向主机描述自身特性和功能的数据结构。

相关优势

• 灵活性：通过不同的Report ID，设备可以发送多种类型的报告，增加了设备的功能性和灵活性。
• 效率：主机可以精确地请求所需的数据报告，减少了不必要的数据传输，提高了通信效率。

类型

• 输入报告：包含设备状态变化的信息，如按键被按下。
• 输出报告：包含主机发送到设备的控制命令，如LED灯的控制。
• 特征报告：包含设备的配置信息，如可用的按键数量。

应用场景

• 多键无冲键盘：通过不同的Report ID区分不同的按键组合，实现多键同时按下而不冲突。
• 多功能游戏手柄：通过Report ID区分不同的输入模式，如模拟摇杆和方向键。

可能遇到的问题及解决方法

问题：设备报告的数据不正确或不完整

• 原因：可能是Report Descriptor配置错误，或者硬件故障。
• 解决方法：
  • 检查Report Descriptor的定义，确保所有必需的报告项都已正确配置。
  • 使用USB分析工具检查设备与主机之间的通信数据，确认数据传输是否正确。
  • 检查硬件连接和状态，确保没有物理损坏。

问题：设备无法识别Report ID

• 原因：可能是Report ID未正确设置，或者主机不支持该Report ID。
• 解决方法：
  • 确保在Report Descriptor中正确设置了Report ID。
  • 检查主机端的驱动程序，确保它支持设备使用的Report ID。

示例代码

以下是一个简单的HID报告描述符示例，定义了一个具有两个按键的键盘设备：

const unsigned char hid_report_descriptor[] = {
    0x05, 0x01,       // USAGE_PAGE (Generic Desktop)
    0x09, 0x06,       // USAGE (Keyboard)
    0xa1, 0x01,       // COLLECTION (Application)
    0x05, 0x07,       // USAGE_PAGE (Keyboard)
    0x19, 0xe0,       // USAGE_MINIMUM (Keyboard LeftControl)
    0x29, 0xe7,       // USAGE_MAXIMUM (Keyboard Right GUI)
    0x15, 0x00,       // LOGICAL_MINIMUM (0)
    0x25, 0x01,       // LOGICAL_MAXIMUM (1)
    0x75, 0x01,       // REPORT_SIZE (1)
    0x95, 0x02,       // REPORT_COUNT (2)
    0x81, 0x02,       // INPUT (Data,Var,Abs)
    0x95, 0x01,       // REPORT_COUNT (1)
    0x75, 0x08,       // REPORT_SIZE (8)
    0x81, 0x03,       // INPUT (Cnst,Var,Abs)
    0xc0                // END_COLLECTION
};

参考链接

• USB HID Specification

通过以上信息，您可以更好地理解HID报告描述符中的Report ID及其相关概念和应用。