HID USB 控制传输 (Windows)

【问题标题】：HID USB control transfer (Windows)HID USB 控制传输 (Windows)
【发布时间】：2017-12-20 08:57:47
【问题描述】：

最近，我开始学习如何在 Windows 10 上与 HID 设备进行通信。

但我有几个问题。

根据Window的文档，HidD_SetOutputReport必须将ReportBuffer参数的第一个字节设置为报告ID或0x00。

由于我设备的 HID 报告描述符已经声明了一些报告 id，所以当我使用 HidD_setoutputreport 而不是 0x00 时，我必须设置报告 id？

当我使用报告 ID 0x80 作为 buf[0] 时，例如：0x80 0x02 0x00 ....... 0x00（我的 Capabilities.OutputReportByteLength 是 64）

我的代码是ret = HidD_SetOutputReport(handle->device_handle, buf2, 65)

但我总是这样发送数据（Bus Hound）：

64 输出 80 02 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ............. 4.1.0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ...... 4.1.16

00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ...... 4.1.32

00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ...... 4.1.48

我认为它应该发送buf[1] to buf[64]而不是buf[0] to buf[63]，所以我尝试了ret = HidD_SetOutputReport(handle->device_handle, buf2, 64)，但结果是一样的。

这是我的 INPUT 和 OUTPUT 的 HID 报告描述符：

使用页面（通用桌面）05 01

逻辑最小值 (0) 15 00

使用（操纵杆）09 04

收集（应用）A1 01

报告 ID (48) 85 30

使用页面（通用桌面）05 01

使用页面（按钮）05 09

最低使用量（按钮 1）19 01

使用最大值（按钮 10）29 0A

逻辑最小值 (0) 15 00

逻辑最大值 (1) 25 01

报告大小 (1) 75 01

报告计数 (10) 95 0A

单位指数 (0) 55 00

单位（无）65 00

输入 (Data,Var,Abs,NWrp,Lin,Pref,NNul,Bit) 81 02

使用页面（按钮）05 09

最低使用量（按钮 11）19 0B

使用最大值（按钮 14）29 0E

逻辑最小值 (0) 15 00

逻辑最大值 (1) 25 01

报告大小 (1) 75 01

报告数 (4) 95 04

输入 (Data,Var,Abs,NWrp,Lin,Pref,NNul,Bit) 81 02

报告大小 (1) 75 01

报告数 (2) 95 02

输入（Cnst,Var,Abs,NWrp,Lin,Pref,NNul,Bit）81 03

用法（通用桌面：指针）0B 01 00 01 00

集合（物理）A1 00

   Usage (Generic Desktop:X)    0B 30 00 01 00

   Usage (Generic Desktop:Y)    0B 31 00 01 00

   Usage (Generic Desktop:Z)    0B 32 00 01 00

   Usage (Generic Desktop:Rz)    0B 35 00 01 00

   Logical Minimum (0)    15 00

   Logical Maximum (65535)    27 FF FF 00 00

   Report Size (16)    75 10

   Report Count (4)    95 04

   Input (Data,Var,Abs,NWrp,Lin,Pref,NNul,Bit)    81 02

结束集合C0

用法（通用桌面：帽子开关）0B 39 00 01 00

逻辑最小值 (0) 15 00

逻辑最大值 (7) 25 07

物理最小值 (0) 35 00

物理最大值 (315) 46 3B 01

单位（英转：度）65 14

报告大小 (4) 75 04

报告数 (1) 95 01

输入 (Data,Var,Abs,NWrp,Lin,Pref,NNul,Bit) 81 02

使用页面（按钮）05 09

最低使用量（按钮 15）19 0F

使用最大值（按钮 18）29 12

逻辑最小值 (0) 15 00

逻辑最大值 (1) 25 01

报告大小 (1) 75 01

报告数 (4) 95 04

输入 (Data,Var,Abs,NWrp,Lin,Pref,NNul,Bit) 81 02

报告大小 (8) 75 08

报告数 (52) 95 34

输入（Cnst,Var,Abs,NWrp,Lin,Pref,NNul,Bit）81 03

使用页面（供应商定义 1）06 00 FF

报告 ID (33) 85 21

使用情况（供应商定义 1）09 01

报告大小 (8) 75 08

报告数 (63) 95 3F

输入（Cnst,Var,Abs,NWrp,Lin,Pref,NNul,Bit）81 03

报告 ID (129) 85 81

使用情况（供应商定义 2）09 02

报告大小 (8) 75 08

报告数 (63) 95 3F

输入（Cnst,Var,Abs,NWrp,Lin,Pref,NNul,Bit）81 03

报告 ID (1) 85 01

使用情况（供应商定义 3）09 03

报告大小 (8) 75 08

报告数 (63) 95 3F

输出 (Cnst,Var,Abs,NWrp,Lin,Pref,NNul,Vol,Bit) 91 83

报告 ID (16) 85 10

使用情况（供应商定义 4）09 04

报告大小 (8) 75 08

报告数 (63) 95 3F

输出 (Cnst,Var,Abs,NWrp,Lin,Pref,NNul,Vol,Bit) 91 83

报告 ID (128) 85 80

使用（供应商定义 5）09 05

报告大小 (8) 75 08

报告数 (63) 95 3F

输出 (Cnst,Var,Abs,NWrp,Lin,Pref,NNul,Vol,Bit) 91 83

报告 ID (130) 85 82

使用（供应商定义 6）09 06

报告大小 (8) 75 08

报告数 (63) 95 3F

输出 (Cnst,Var,Abs,NWrp,Lin,Pref,NNul,Vol,Bit) 91 83

结束集合C0

【问题讨论】：

  • 如果您有两个问题，请提出两个问题。如果有人回答了第一部分，StackOverflow 的首页会显示该问题已经回答，您可能无法在第二部分得到回复。
  • Ted，你能发布完整的报告描述符吗？
  • @MSalters 我很抱歉
  • @aja 我已经更新了！
  • 我无法真正评论 Windows API（我从未使用过它），但我知道如果您在 HID 报告描述符中指定报告 ID，则报告 ID 占据第一个字节您的数据包的其余部分是您的有效负载，否则您的数据包是所有有效负载并且不会发送 REPORT_ID。在您的情况下，您的 RD 指定了 REPORT_ID 和 63 字节的有效负载，因此我将指定长度为 64，并将 REPORT_ID 放在第一个字节中。您是否检查了 HidD_SetOutputReport 调用的返回值？ （只是好奇）。

标签： c++ windows usb hid hidapi


【解决方案1】：

我无法真正评论 Windows API（我从未使用过它），但我 知道如果您在 HID 报告描述符中指定报告 ID 然后报告 id 占据数据包的第一个字节，其余的 数据包的有效负载是您的有效负载，否则您的数据包是所有有效负载并且 没有发送 REPORT_ID。在您的情况下，您的 RD 指定一个 REPORT_ID 和 63 字节有效载荷，所以我指定长度为 64，然后将 第一个字节中的 REPORT_ID。

报告 id 被传输到端点，以便它知道如何 解读每份报告

我已经检查了你的报告描述，我可以提出一些可以减少未来悲伤的机会的调整。

  • 从输入报告中删除 52 字节的填充。无论如何，它只会被主机忽略，因此无需从您的设备发送。
  • 使用较短的使用代码来减小报告描述符的大小。如果您的设备内存不足，这可能很重要。
  • 在不需要时重置物理单位。如果您不这样做，那么物理单位将适用于所有后续项目 - 这可能不合适（例如，长度以英寸为单位的开/关开关）。为此，我使用 PUSH 保存全局变量并使用 POP 稍后在方便的时候恢复它们。
  • 在您的 OUTPUT 报告中指定 DATA（非 CONSTANT）。我真的不确定这是否有什么不同，但你永远不会知道，一些未来的 USB 驱动程序可能会选择在发送数据包之前将任何 CONSTANT 字段设置为空值，这会导致痛苦。

执行上述操作后，报告描述符大小从 203 字节减少到仅 133 字节：

//--------------------------------------------------------------------------------
// Report descriptor data in hex (length 133 bytes)
//--------------------------------------------------------------------------------


// 05011409 04A10185 30050925 017501A4 1901290A 950A8102 190B290E 95048102
// 95028103 05010901 A0093009 31093209 3527FFFF 00007510 95048102 C0093925
// 0734463B 01651475 04950181 02B4190F 29129504 810226FF 00750895 3F0600FF
// 85210901 81028581 09028102 85010903 91828510 09049182 85800905 91828582
// 09069182 C0      


//--------------------------------------------------------------------------------
// Decoded Application Collection
//--------------------------------------------------------------------------------

/*
05 01        (GLOBAL) USAGE_PAGE         0x0001 Generic Desktop Page 
14           (GLOBAL) LOGICAL_MINIMUM    (0) <-- Redundant: LOGICAL_MINIMUM is already 0 
09 04        (LOCAL)  USAGE              0x00010004 Joystick (CA=Application Collection) 
A1 01        (MAIN)   COLLECTION         0x00000001 Application (Usage=0x00010004: Page=Generic Desktop Page, Usage=Joystick, Type=CA)
85 30          (GLOBAL) REPORT_ID          0x30 (48) '0' 
05 09          (GLOBAL) USAGE_PAGE         0x0009 Button Page 
25 01          (GLOBAL) LOGICAL_MAXIMUM    0x01 (1)  
75 01          (GLOBAL) REPORT_SIZE        0x01 (1) Number of bits per field  
A4             (GLOBAL) PUSH               USAGE_PAGE=0x0009 LOGICAL(MIN=0,MAX=1) PHYSICAL(MIN=0,MAX=0) UNIT(0x0,EXP=0) REPORT(ID=0x30,SIZE=1,COUNT=0)
19 01          (LOCAL)  USAGE_MINIMUM      0x00090001 Button 1 Primary/trigger (MULTI=Selector, On/Off, Momentary, or One Shot) 
29 0A          (LOCAL)  USAGE_MAXIMUM      0x0009000A Button 10 (MULTI=Selector, On/Off, Momentary, or One Shot) 
95 0A          (GLOBAL) REPORT_COUNT       0x0A (10) Number of fields  
81 02          (MAIN)   INPUT              0x00000002 (10 fields x 1 bit) 0=Data 1=Variable 0=Absolute 0=NoWrap 0=Linear 0=PrefState 0=NoNull 0=NonVolatile 0=Bitmap 
19 0B          (LOCAL)  USAGE_MINIMUM      0x0009000B Button 11 (MULTI=Selector, On/Off, Momentary, or One Shot) 
29 0E          (LOCAL)  USAGE_MAXIMUM      0x0009000E Button 14 (MULTI=Selector, On/Off, Momentary, or One Shot) 
95 04          (GLOBAL) REPORT_COUNT       0x04 (4) Number of fields  
81 02          (MAIN)   INPUT              0x00000002 (4 fields x 1 bit) 0=Data 1=Variable 0=Absolute 0=NoWrap 0=Linear 0=PrefState 0=NoNull 0=NonVolatile 0=Bitmap 
95 02          (GLOBAL) REPORT_COUNT       0x02 (2) Number of fields  
81 03          (MAIN)   INPUT              0x00000003 (2 fields x 1 bit) 1=Constant 1=Variable 0=Absolute 0=NoWrap 0=Linear 0=PrefState 0=NoNull 0=NonVolatile 0=Bitmap 
05 01          (GLOBAL) USAGE_PAGE         0x0001 Generic Desktop Page 
09 01          (LOCAL)  USAGE              0x00010001 Pointer (CP=Physical Collection) 
A0             (MAIN)   COLLECTION         0x00000000 Physical (Usage=0x00010001: Page=Generic Desktop Page, Usage=Pointer, Type=CP)
09 30            (LOCAL)  USAGE              0x00010030 X (DV=Dynamic Value) 
09 31            (LOCAL)  USAGE              0x00010031 Y (DV=Dynamic Value) 
09 32            (LOCAL)  USAGE              0x00010032 Z (DV=Dynamic Value) 
09 35            (LOCAL)  USAGE              0x00010035 Rz (DV=Dynamic Value) 
27 FFFF0000      (GLOBAL) LOGICAL_MAXIMUM    0x0000FFFF (65535)  
75 10            (GLOBAL) REPORT_SIZE        0x10 (16) Number of bits per field  
95 04            (GLOBAL) REPORT_COUNT       0x04 (4) Number of fields  
81 02            (MAIN)   INPUT              0x00000002 (4 fields x 16 bits) 0=Data 1=Variable 0=Absolute 0=NoWrap 0=Linear 0=PrefState 0=NoNull 0=NonVolatile 0=Bitmap 
C0             (MAIN)   END_COLLECTION     Physical 
09 39          (LOCAL)  USAGE              0x00010039 Hat switch (DV=Dynamic Value) 
25 07          (GLOBAL) LOGICAL_MAXIMUM    0x07 (7)  
34             (GLOBAL) PHYSICAL_MINIMUM   (0) <-- Redundant: PHYSICAL_MINIMUM is already 0 
46 3B01        (GLOBAL) PHYSICAL_MAXIMUM   0x013B (315)  
65 14          (GLOBAL) UNIT               0x00000014 Rotation in degrees [1° units] (4=System=English Rotation, 1=Rotation=Degrees) 
75 04          (GLOBAL) REPORT_SIZE        0x04 (4) Number of bits per field  
95 01          (GLOBAL) REPORT_COUNT       0x01 (1) Number of fields  
81 02          (MAIN)   INPUT              0x00000002 (1 field x 4 bits) 0=Data 1=Variable 0=Absolute 0=NoWrap 0=Linear 0=PrefState 0=NoNull 0=NonVolatile 0=Bitmap 
B4             (GLOBAL) POP                USAGE_PAGE=0x0009 LOGICAL(MIN=0,MAX=1) PHYSICAL(MIN=0,MAX=0) UNIT(0x0,EXP=0) REPORT(ID=0x30,SIZE=1,COUNT=0)
19 0F          (LOCAL)  USAGE_MINIMUM      0x0009000F Button 15 (MULTI=Selector, On/Off, Momentary, or One Shot) 
29 12          (LOCAL)  USAGE_MAXIMUM      0x00090012 Button 18 (MULTI=Selector, On/Off, Momentary, or One Shot) 
95 04          (GLOBAL) REPORT_COUNT       0x04 (4) Number of fields  
81 02          (MAIN)   INPUT              0x00000002 (4 fields x 1 bit) 0=Data 1=Variable 0=Absolute 0=NoWrap 0=Linear 0=PrefState 0=NoNull 0=NonVolatile 0=Bitmap 
26 FF00        (GLOBAL) LOGICAL_MAXIMUM    0x00FF (255)  
75 08          (GLOBAL) REPORT_SIZE        0x08 (8) Number of bits per field  
95 3F          (GLOBAL) REPORT_COUNT       0x3F (63) Number of fields  
06 00FF        (GLOBAL) USAGE_PAGE         0xFF00 Vendor-defined 
85 21          (GLOBAL) REPORT_ID          0x21 (33) 
09 01          (LOCAL)  USAGE              0xFF000001 <-- Warning: Undocumented usage
81 02          (MAIN)   INPUT              0x00000002 (63 fields x 8 bits) 0=Data 1=Variable 0=Absolute 0=NoWrap 0=Linear 0=PrefState 0=NoNull 0=NonVolatile 0=Bitmap 
85 81          (GLOBAL) REPORT_ID          0x81 (129) 
09 02          (LOCAL)  USAGE              0xFF000002 <-- Warning: Undocumented usage
81 02          (MAIN)   INPUT              0x00000002 (63 fields x 8 bits) 0=Data 1=Variable 0=Absolute 0=NoWrap 0=Linear 0=PrefState 0=NoNull 0=NonVolatile 0=Bitmap 
85 01          (GLOBAL) REPORT_ID          0x01 (1) 
09 03          (LOCAL)  USAGE              0xFF000003 <-- Warning: Undocumented usage
91 82          (MAIN)   OUTPUT             0x00000082 (63 fields x 8 bits) 0=Data 1=Variable 0=Absolute 0=NoWrap 0=Linear 0=PrefState 0=NoNull 1=Volatile 0=Bitmap 
85 10          (GLOBAL) REPORT_ID          0x10 (16) 
09 04          (LOCAL)  USAGE              0xFF000004 <-- Warning: Undocumented usage
91 82          (MAIN)   OUTPUT             0x00000082 (63 fields x 8 bits) 0=Data 1=Variable 0=Absolute 0=NoWrap 0=Linear 0=PrefState 0=NoNull 1=Volatile 0=Bitmap 
85 80          (GLOBAL) REPORT_ID          0x80 (128) 
09 05          (LOCAL)  USAGE              0xFF000005 <-- Warning: Undocumented usage
91 82          (MAIN)   OUTPUT             0x00000082 (63 fields x 8 bits) 0=Data 1=Variable 0=Absolute 0=NoWrap 0=Linear 0=PrefState 0=NoNull 1=Volatile 0=Bitmap 
85 82          (GLOBAL) REPORT_ID          0x82 (130) 
09 06          (LOCAL)  USAGE              0xFF000006 <-- Warning: Undocumented usage
91 82          (MAIN)   OUTPUT             0x00000082 (63 fields x 8 bits) 0=Data 1=Variable 0=Absolute 0=NoWrap 0=Linear 0=PrefState 0=NoNull 1=Volatile 0=Bitmap 
C0           (MAIN)   END_COLLECTION     Application 
*/

//--------------------------------------------------------------------------------
// Button Page inputReport 30 (Device --> Host)
//--------------------------------------------------------------------------------

typedef struct
{
  uint8_t  reportId;                                 // Report ID = 0x30 (48) '0'
                                                     // Collection: Joystick
  uint8_t  BTN_JoystickButton1 : 1;                  // Usage 0x00090001: Button 1 Primary/trigger, Value = 0 to 1
  uint8_t  BTN_JoystickButton2 : 1;                  // Usage 0x00090002: Button 2 Secondary, Value = 0 to 1
  uint8_t  BTN_JoystickButton3 : 1;                  // Usage 0x00090003: Button 3 Tertiary, Value = 0 to 1
  uint8_t  BTN_JoystickButton4 : 1;                  // Usage 0x00090004: Button 4, Value = 0 to 1
  uint8_t  BTN_JoystickButton5 : 1;                  // Usage 0x00090005: Button 5, Value = 0 to 1
  uint8_t  BTN_JoystickButton6 : 1;                  // Usage 0x00090006: Button 6, Value = 0 to 1
  uint8_t  BTN_JoystickButton7 : 1;                  // Usage 0x00090007: Button 7, Value = 0 to 1
  uint8_t  BTN_JoystickButton8 : 1;                  // Usage 0x00090008: Button 8, Value = 0 to 1
  uint8_t  BTN_JoystickButton9 : 1;                  // Usage 0x00090009: Button 9, Value = 0 to 1
  uint8_t  BTN_JoystickButton10 : 1;                 // Usage 0x0009000A: Button 10, Value = 0 to 1
  uint8_t  BTN_JoystickButton11 : 1;                 // Usage 0x0009000B: Button 11, Value = 0 to 1
  uint8_t  BTN_JoystickButton12 : 1;                 // Usage 0x0009000C: Button 12, Value = 0 to 1
  uint8_t  BTN_JoystickButton13 : 1;                 // Usage 0x0009000D: Button 13, Value = 0 to 1
  uint8_t  BTN_JoystickButton14 : 1;                 // Usage 0x0009000E: Button 14, Value = 0 to 1
  uint8_t  : 1;                                      // Pad
  uint8_t  : 1;                                      // Pad
                                                     // Collection: Joystick Pointer
  uint16_t GD_JoystickPointerX;                      // Usage 0x00010030: X, Value = 0 to 65535
  uint16_t GD_JoystickPointerY;                      // Usage 0x00010031: Y, Value = 0 to 65535
  uint16_t GD_JoystickPointerZ;                      // Usage 0x00010032: Z, Value = 0 to 65535
  uint16_t GD_JoystickPointerRz;                     // Usage 0x00010035: Rz, Value = 0 to 65535
                                                     // Collection: Joystick
  uint8_t  GD_JoystickHatSwitch : 4;                 // Usage 0x00010039: Hat switch, Value = 0 to 7, Physical = Value x 45 in degrees
  uint8_t  BTN_JoystickButton15 : 1;                 // Usage 0x0009000F: Button 15, Value = 0 to 1
  uint8_t  BTN_JoystickButton16 : 1;                 // Usage 0x00090010: Button 16, Value = 0 to 1
  uint8_t  BTN_JoystickButton17 : 1;                 // Usage 0x00090011: Button 17, Value = 0 to 1
  uint8_t  BTN_JoystickButton18 : 1;                 // Usage 0x00090012: Button 18, Value = 0 to 1
} inputReport30_t;


//--------------------------------------------------------------------------------
// Vendor-defined inputReport 21 (Device --> Host)
//--------------------------------------------------------------------------------

typedef struct
{
  uint8_t  reportId;                                 // Report ID = 0x21 (33)
  uint8_t  VEN_Joystick0001[63];                     // Usage 0xFF000001: , Value = 0 to 255
} inputReport21_t;


//--------------------------------------------------------------------------------
// Vendor-defined inputReport 81 (Device --> Host)
//--------------------------------------------------------------------------------

typedef struct
{
  uint8_t  reportId;                                 // Report ID = 0x81 (129)
  uint8_t  VEN_Joystick0002[63];                     // Usage 0xFF000002: , Value = 0 to 255
} inputReport81_t;


//--------------------------------------------------------------------------------
// Vendor-defined outputReport 01 (Device <-- Host)
//--------------------------------------------------------------------------------

typedef struct
{
  uint8_t  reportId;                                 // Report ID = 0x01 (1)
                                                     // Collection: Joystick
  uint8_t  VEN_Joystick0003[63];                     // Usage 0xFF000003: , Value = 0 to 255
} outputReport01_t;


//--------------------------------------------------------------------------------
// Vendor-defined outputReport 10 (Device <-- Host)
//--------------------------------------------------------------------------------

typedef struct
{
  uint8_t  reportId;                                 // Report ID = 0x10 (16)
  uint8_t  VEN_Joystick0004[63];                     // Usage 0xFF000004: , Value = 0 to 255
} outputReport10_t;


//--------------------------------------------------------------------------------
// Vendor-defined outputReport 80 (Device <-- Host)
//--------------------------------------------------------------------------------

typedef struct
{
  uint8_t  reportId;                                 // Report ID = 0x80 (128)
  uint8_t  VEN_Joystick0005[63];                     // Usage 0xFF000005: , Value = 0 to 255
} outputReport80_t;


//--------------------------------------------------------------------------------
// Vendor-defined outputReport 82 (Device <-- Host)
//--------------------------------------------------------------------------------

typedef struct
{
  uint8_t  reportId;                                 // Report ID = 0x82 (130)
  uint8_t  VEN_Joystick0006[63];                     // Usage 0xFF000006: , Value = 0 to 255
} outputReport82_t;

【讨论】：

  • 谢谢，我使用这个报表描述符只是想做一些逆向工程，所以我必须模仿所有这些报表ID。无论如何，感谢您的耐心并检查我所有的报告:)
猜你喜欢
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
  • 2013-11-24
相关资源
最近更新 更多
热门标签
Java Python linux javascript Mysql C# Docker 算法 前端 SpringBoot Redis Vue spring 设计模式 .net core .net kubernetes c++ 数据库 数据结构 大数据 js 机器学习 微服务 Android Go 程序员 面试 JVM ASP.net core 云原生 人工智能 后端 PHP git CSS golang k8s Nginx Django mybatis 深度学习 多线程 React 架构 devops 爬虫 云计算 Spring Boot LeetCode