usb gaghet hid 模拟鼠标键盘的绝对值描述

调试模拟键盘鼠标花了我接近一周的时间，到处查找资料，结果东平西凑。靠上厕所的灵感，终于调通了，

主要注意的是绝对值坐标和相对坐标的表达不一样

最后在这里找到了答案，感谢21ic tanganrong 大虾的无私奉献，特作记录

鼠标使用绝对坐标，它的描述符的问题 - 书友会论坛 - 21ic电子技术开发论坛

详细解析

HID 报告描述 2_幕色夜行-CSDN博客

/*hid descriptor for a mouse*/

static struct hidg_func_descriptor kvm_mouse_data = {

.subclass = 0, /*NO SubClass*/

.protocol = 2, /*Mouse*/

.report_length = 6, //绝对值是6， 相对值是4不然打死调不通，实际很简单。但是没有全面了解协议是很难发现这些细节的

.report_desc_length = 126,//62,//104,

.report_desc={

#if 0

#else

0x05, 0x01, // USAGE_PAGE (Generic Desktop)

0x09, 0x02, // USAGE (Mouse)

0xa1, 0x01, // COLLECTION (Application)

0x09, 0x01, // USAGE (Pointer)

0xa1, 0x00, // COLLECTION (Physical)

0x85, 0x01, // REPORT_ID (1)

0x05, 0x09, // USAGE_PAGE (Button)

0x19, 0x01, // USAGE_MINIMUM (Button 1)

0x29, 0x03, // USAGE_MAXIMUM (Button 3)

0x15, 0x00, // LOGICAL_MINIMUM (0)

0x25, 0x01, // LOGICAL_MAXIMUM (1)

0x75, 0x01, // REPORT_SIZE (1)

0x95, 0x03, // REPORT_COUNT (3)

0x81, 0x02, // INPUT (Data,Var,Abs)

0x75, 0x05, // REPORT_SIZE (5)

0x95, 0x01, // REPORT_COUNT (1)

0x81, 0x01, // INPUT (Cnst,Ary,Abs)

0x05, 0x01, // USAGE_PAGE (Generic Desktop)

0x09, 0x30, // USAGE (X)

0x09, 0x31, // USAGE (Y)

0x15, 0x81, // LOGICAL_MINIMUM (-127)

0x25, 0x7f, // LOGICAL_MAXIMUM (127)

0x75, 0x08, // REPORT_SIZE (8)

0x95, 0x02, // REPORT_COUNT (2)

0x81, 0x06, // INPUT (Data,Var,Rel)

0xc0, // END_COLLECTION

0xc0, // END_COLLECTION

0x05, 0x01, // USAGE_PAGE (Generic Desktop)

0x09, 0x02, // USAGE (Mouse)

0xa1, 0x01, // COLLECTION (Application)

0x09, 0x01, // USAGE (Pointer)

0xa1, 0x00, // COLLECTION (Physical)

0x85, 0x02, // REPORT_ID (2)

0x05, 0x09, // USAGE_PAGE (Button)

0x19, 0x01, // USAGE_MINIMUM (Button 1)

0x29, 0x03, // USAGE_MAXIMUM (Button 3)

0x15, 0x00, // LOGICAL_MINIMUM (0)

0x25, 0x01, // LOGICAL_MAXIMUM (1)

0x75, 0x01, // REPORT_SIZE (1)

0x95, 0x03, // REPORT_COUNT (3)

0x81, 0x02, // INPUT (Data,Var,Abs)

0x75, 0x01, // REPORT_SIZE (1)

0x95, 0x05, // REPORT_COUNT (5)

0x81, 0x03, // INPUT (Cnst,Var,Abs)

0x05, 0x01, // USAGE_PAGE (Generic Desktop)

0x09, 0x30, // USAGE (X)

0x15, 0x00, // LOGICAL_MINIMUM (0)

0x26, 0xff, 0x7f, // LOGICAL_MAXIMUM (32767)

0x35, 0x00, // PHYSICAL_MINIMUM (0)

0x46, 0xff, 0x7f, // PHYSICAL_MAXIMUM (32767)

0x75, 0x10, // REPORT_SIZE (16)

0x95, 0x01, // REPORT_COUNT (1)

0x81, 0x02, // INPUT (Data,Var,Abs)

0x09, 0x31, // USAGE (Y)

0x15, 0x00, // LOGICAL_MINIMUM (0)

0x26, 0xff, 0x7f, // LOGICAL_MAXIMUM (32767)

0x35, 0x00, // PHYSICAL_MINIMUM (0)

0x46, 0xff, 0x7f, // PHYSICAL_MAXIMUM (32767)

0x75, 0x10, // REPORT_SIZE (16)

0x95, 0x01, // REPORT_COUNT (1)

0x81, 0x02, // INPUT (Data,Var,Abs)

0xc0, // END_COLLECTION

0xc0 // END_COLLECTION

#endif

}

};

复合键盘鼠标

1. //该报告描述符号由HID Descriptor tool生成
2. code ] = {
4. //-------------键盘部分报告描述符----------------
5. //表示用途页为通用桌面设备
6. 0x05, 0x01, // USAGE_PAGE (Generic Desktop)
8. //表示用途为键盘
9. 0x09, 0x06, // USAGE (Keyboard)
11. //表示应用集合，必须要以END_COLLECTION来结束它，见最后的END_COLLECTION
12. 0xa1, 0x01, // COLLECTION (Application)
14. //报告ID（报告ID 0是保留的）
15. 0x85, 0x01, //Report ID (1)
17. //表示用途页为按键
18. 0x05, 0x07, // USAGE_PAGE (Keyboard)
20. //用途最小值，这里为左ctrl键
21. 0x19, 0xe0, // USAGE_MINIMUM (Keyboard LeftControl)
22. //用途最大值，这里为右GUI键，即window键
23. 0x29, 0xe7, // USAGE_MAXIMUM (Keyboard Right GUI)
24. //逻辑最小值为0
25. 0x15, 0x00, // LOGICAL_MINIMUM (0)
26. //逻辑最大值为1
27. 0x25, 0x01, // LOGICAL_MAXIMUM (1)
28. //报告大小（即这个字段的宽度）为1bit，所以前面的逻辑最小值为0，逻辑最大值为1
29. 0x75, 0x01, // REPORT_SIZE (1)
30. //报告的个数为8，即总共有8个bits
31. 0x95, 0x08, // REPORT_COUNT (8)
32. //输入用，变量，值，绝对值。像键盘这类一般报告绝对值，
33. //而鼠标移动这样的则报告相对值，表示鼠标移动多少
34. 0x81, 0x02, // INPUT (Data,Var,Abs)
35. //上面这这几项描述了一个输入用的字段，总共为8个bits，每个bit表示一个按键
36. //分别从左ctrl键到右GUI键。这8个bits刚好构成一个字节，它位于报告的第一个字节。
37. //它的最低位，即bit-0对应着左ctrl键，如果返回的数据该位为1，则表示左ctrl键被按下，
38. //否则，左ctrl键没有按下。最高位，即bit-7表示右GUI键的按下情况。中间的几个位，
39. //需要根据HID协议中规定的用途页表（HID Usage Tables）来确定。这里通常用来表示
40. //特殊键，例如ctrl，shift，del键等
42. //这样的数据段个数为1
43. 0x95, 0x01, // REPORT_COUNT (1)
44. //每个段长度为8bits
45. 0x75, 0x08, // REPORT_SIZE (8)
46. //输入用，常量，值，绝对值
47. 0x81, 0x03, // INPUT (Cnst,Var,Abs)
49. //上面这8个bit是常量，设备必须返回0
51. //这样的数据段个数为5
52. 0x95, 0x05, // REPORT_COUNT (5)
53. //每个段大小为1bit
54. 0x75, 0x01, // REPORT_SIZE (1)
55. //用途是LED，即用来控制键盘上的LED用的，因此下面会说明它是输出用
56. 0x05, 0x08, // USAGE_PAGE (LEDs)
57. //用途最小值是Num Lock，即数字键锁定灯
58. 0x19, 0x01, // USAGE_MINIMUM (Num Lock)
59. //用途最大值是Kana，这个是什么灯我也不清楚^_^
60. 0x29, 0x05, // USAGE_MAXIMUM (Kana)
61. //如前面所说，这个字段是输出用的，用来控制LED。变量，值，绝对值。
62. //1表示灯亮，0表示灯灭
63. 0x91, 0x02, // OUTPUT (Data,Var,Abs)
65. //这样的数据段个数为1
66. 0x95, 0x01, // REPORT_COUNT (1)
67. //每个段大小为3bits
68. 0x75, 0x03, // REPORT_SIZE (3)
69. //输出用，常量，值，绝对
70. 0x91, 0x03, // OUTPUT (Cnst,Var,Abs)
71. //由于要按字节对齐，而前面控制LED的只用了5个bit，
72. //所以后面需要附加3个不用bit，设置为常量。
74. //报告个数为6
75. 0x95, 0x06, // REPORT_COUNT (6)
76. //每个段大小为8bits
77. 0x75, 0x08, // REPORT_SIZE (8)
78. //逻辑最小值0
79. 0x15, 0x00, // LOGICAL_MINIMUM (0)
80. //逻辑最大值255
81. 0x25, 0xFF, // LOGICAL_MAXIMUM (255)
82. //用途页为按键
83. 0x05, 0x07, // USAGE_PAGE (Keyboard)
84. //使用最小值为0
85. 0x19, 0x00, // USAGE_MINIMUM (Reserved (no event indicated))
86. //使用最大值为0x65
87. 0x29, 0x65, // USAGE_MAXIMUM (Keyboard Application)
88. //输入用，变量，数组，绝对值
89. 0x81, 0x00, // INPUT (Data,Ary,Abs)
90. //以上定义了6个8bit宽的数组，每个8bit（即一个字节）用来表示一个按键，所以可以同时
91. //有6个按键按下。没有按键按下时，全部返回0。如果按下的键太多，导致键盘扫描系统
92. //无法区分按键时，则全部返回0x01，即6个0x01。如果有一个键按下，则这6个字节中的第一
93. //个字节为相应的键值（具体的值参看HID Usage Tables），如果两个键按下，则第1、2两个
94. //字节分别为相应的键值，以次类推。
96. //关集合，跟上面的对应
97. 0xc0 , // END_COLLECTION
99. //-----------------------鼠标部分报告描述符----------------------------
100. 0x05, 0x01, // USAGE_PAGE (Generic Desktop)
101. 0x09, 0x02, // USAGE (Mouse)
102. 0xa1, 0x01, // COLLECTION (Application)
103. 0x85, 0x02, // 报告ID (2)
104. 0x09, 0x01, // USAGE (Pointer)
105. 0xa1, 0x00, // COLLECTION (Physical)
106. 0x05, 0x09, // USAGE_PAGE (Button)
107. 0x19, 0x01, // USAGE_MINIMUM (Button 1)
108. 0x29, 0x03, // USAGE_MAXIMUM (Button 3)
109. 0x15, 0x00, // LOGICAL_MINIMUM (0)
110. 0x25, 0x01, // LOGICAL_MAXIMUM (1)
111. 0x95, 0x03, // REPORT_COUNT (3)
112. 0x75, 0x01, // REPORT_SIZE (1)
113. 0x81, 0x02, // INPUT (Data,Var,Abs)
114. 0x95, 0x01, // REPORT_COUNT (1)
115. 0x75, 0x05, // REPORT_SIZE (5)
116. 0x81, 0x03, // INPUT (Cnst,Var,Abs)
117. 0x05, 0x01, // USAGE_PAGE (Generic Desktop)
118. 0x09, 0x30, // USAGE (X)
119. 0x09, 0x31, // USAGE (Y)
120. 0x09, 0x38, // USAGE (Wheel)
121. 0x15, 0x81, // LOGICAL_MINIMUM (-127)
122. 0x25, 0x7f, // LOGICAL_MAXIMUM (127)
123. 0x75, 0x08, // REPORT_SIZE (8)
124. 0x95, 0x03, // REPORT_COUNT (3)
125. 0x81, 0x06, // INPUT (Data,Var,Rel)
126. 0xc0, // END_COLLECTION
127. 0xc0 // END_COLLECTION
128. };

0x05, 0x01, // Usage Page (Generic Desktop)

0x04 代表是 Global 类的 Usage Page 功能，最位 2 位表示带多少个字节的数据，因为只带1 个数据，所以是 1，跟 0x04 组合起来就是 0x05 了。其他名称的意思都差不多，数值可以参照上一章的Generic Item Format

0x09, 0x02, // Usage (Mouse)

表示这是一个鼠标， Usage 是为了给对方解析数据时有个参照

0xA1, 0x01, // Collection (Application)

0xA1, 0x01 表示 CollectionApplication ; 0xA1, 0x00 表示 Collection Physical.表示下面所包含的是对 Mouse 的解释

0x85, 0x01, // Report Id (1)

该报告对应的 ID 是 1

0x09, 0x01, // Usage (Pointer)

这是个指针形式

0xA1, 0x00, // Collection (Physical)

下面所包含的是对指针的解释

0x05, 0x09, // Usage Page (Buttons)

下面定义的是按键

0x19, 0x01, // Usage Minimum (01) - Button 1

0x29, 0x03, // Usage Maximum (03) - Button 3

总共有 3 个按键

0x15, 0x00, // Logical Minimum (0)

0x25, 0x01, // Logical Maximum (1)

按键的值是 0 和 1，表示放开和按下

0x75, 0x01, // Report Size (1)

0x95, 0x03, // Report Count (3)

有 3 个 1 位，即用 3bits 分别对应三个按键

0x81, 0x02, // Input (Data, Variable,Absolute) - Button states

将这三个位加入本报告的数据中，这三位是可读写的绝对值

0x75, 0x05, // Report Size (5)

0x95, 0x01, // Report Count (1)

定义 1 个 5 位的数据

0x81, 0x01, // Input (Constant) - Padding or Reserved bits

将这个数据添加到本报告的数据中，主要是与前面 3 位组成一个字节，这 5 位是 Constant数据

0x05, 0x01, // Usage Page (Generic Desktop)

0x09, 0x30, // Usage (X)

0x09, 0x31, // Usage (Y)

0x09, 0x38, // Usage (Wheel)

下面定义的是 X,Y,Wheel 三个功能

0x15, 0x81, // Logical Minimum (-127)

0x25, 0x7F, // Logical Maximum (127)

X,Y,Wheel 的取值范围是-127~127

0x75, 0x08, // Report Size (8)

0x95, 0x03, // Report Count (3)

用三个字节来表示 x,y,wheel

0x81, 0x06, // Input (Data, Variable, Relative) - X & Y coordinate

将这三个字节添加到本报告中

0xC0, // End Collection

0xC0, // End Collection

以下是hid鼠标数据的生成，支持相对和绝对坐标鼠标数据

func generateMouseWheelReport(absolute bool, buttons [3]bool, axis [2]int, wheel uint8) (report []byte, err error) {
	var outdata [7]byte
	if absolute {
		outdata[0] = 0x02
	} else {
		outdata[0] = 0x01
	}
	if buttons[0] {
		outdata[1] |= BUTTON1
	}
	if buttons[1] {
		outdata[1] |= BUTTON2
	}
	if buttons[2] {
		outdata[1] |= BUTTON3
	}
	if absolute {
		binary.LittleEndian.PutUint16(outdata[2:], uint16(axis[0]))
		binary.LittleEndian.PutUint16(outdata[4:], uint16(axis[1]))
		outdata[6] = wheel
	} else {
		outdata[2] = uint8(axis[0])
		outdata[3] = uint8(axis[1])
	}
	return outdata[:], nil
}