调试模拟键盘鼠标花了我接近一周的时间,到处查找资料,结果东平西凑。靠上厕所的灵感,终于调通了,
主要注意的是绝对值坐标和相对坐标的表达不一样
最后在这里找到了答案,感谢21ic tanganrong 大虾的无私奉献,特作记录
鼠标使用绝对坐标,它的描述符的问题 - 书友会论坛 - 21ic电子技术开发论坛
详细解析
/*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
}
};
复合键盘鼠标
- //该报告描述符号由HID Descriptor tool生成
- code ] = {
- //-------------键盘部分报告描述符----------------
- //表示用途页为通用桌面设备
- 0x05, 0x01, // USAGE_PAGE (Generic Desktop)
- //表示用途为键盘
- 0x09, 0x06, // USAGE (Keyboard)
- //表示应用集合,必须要以END_COLLECTION来结束它,见最后的END_COLLECTION
- 0xa1, 0x01, // COLLECTION (Application)
- //报告ID(报告ID 0是保留的)
- 0x85, 0x01, //Report ID (1)
- //表示用途页为按键
- 0x05, 0x07, // USAGE_PAGE (Keyboard)
- //用途最小值,这里为左ctrl键
- 0x19, 0xe0, // USAGE_MINIMUM (Keyboard LeftControl)
- //用途最大值,这里为右GUI键,即window键
- 0x29, 0xe7, // USAGE_MAXIMUM (Keyboard Right GUI)
- //逻辑最小值为0
- 0x15, 0x00, // LOGICAL_MINIMUM (0)
- //逻辑最大值为1
- 0x25, 0x01, // LOGICAL_MAXIMUM (1)
- //报告大小(即这个字段的宽度)为1bit,所以前面的逻辑最小值为0,逻辑最大值为1
- 0x75, 0x01, // REPORT_SIZE (1)
- //报告的个数为8,即总共有8个bits
- 0x95, 0x08, // REPORT_COUNT (8)
- //输入用,变量,值,绝对值。像键盘这类一般报告绝对值,
- //而鼠标移动这样的则报告相对值,表示鼠标移动多少
- 0x81, 0x02, // INPUT (Data,Var,Abs)
- //上面这这几项描述了一个输入用的字段,总共为8个bits,每个bit表示一个按键
- //分别从左ctrl键到右GUI键。这8个bits刚好构成一个字节,它位于报告的第一个字节。
- //它的最低位,即bit-0对应着左ctrl键,如果返回的数据该位为1,则表示左ctrl键被按下,
- //否则,左ctrl键没有按下。最高位,即bit-7表示右GUI键的按下情况。中间的几个位,
- //需要根据HID协议中规定的用途页表(HID Usage Tables)来确定。这里通常用来表示
- //特殊键,例如ctrl,shift,del键等
- //这样的数据段个数为1
- 0x95, 0x01, // REPORT_COUNT (1)
- //每个段长度为8bits
- 0x75, 0x08, // REPORT_SIZE (8)
- //输入用,常量,值,绝对值
- 0x81, 0x03, // INPUT (Cnst,Var,Abs)
- //上面这8个bit是常量,设备必须返回0
- //这样的数据段个数为5
- 0x95, 0x05, // REPORT_COUNT (5)
- //每个段大小为1bit
- 0x75, 0x01, // REPORT_SIZE (1)
- //用途是LED,即用来控制键盘上的LED用的,因此下面会说明它是输出用
- 0x05, 0x08, // USAGE_PAGE (LEDs)
- //用途最小值是Num Lock,即数字键锁定灯
- 0x19, 0x01, // USAGE_MINIMUM (Num Lock)
- //用途最大值是Kana,这个是什么灯我也不清楚^_^
- 0x29, 0x05, // USAGE_MAXIMUM (Kana)
- //如前面所说,这个字段是输出用的,用来控制LED。变量,值,绝对值。
- //1表示灯亮,0表示灯灭
- 0x91, 0x02, // OUTPUT (Data,Var,Abs)
- //这样的数据段个数为1
- 0x95, 0x01, // REPORT_COUNT (1)
- //每个段大小为3bits
- 0x75, 0x03, // REPORT_SIZE (3)
- //输出用,常量,值,绝对
- 0x91, 0x03, // OUTPUT (Cnst,Var,Abs)
- //由于要按字节对齐,而前面控制LED的只用了5个bit,
- //所以后面需要附加3个不用bit,设置为常量。
- //报告个数为6
- 0x95, 0x06, // REPORT_COUNT (6)
- //每个段大小为8bits
- 0x75, 0x08, // REPORT_SIZE (8)
- //逻辑最小值0
- 0x15, 0x00, // LOGICAL_MINIMUM (0)
- //逻辑最大值255
- 0x25, 0xFF, // LOGICAL_MAXIMUM (255)
- //用途页为按键
- 0x05, 0x07, // USAGE_PAGE (Keyboard)
- //使用最小值为0
- 0x19, 0x00, // USAGE_MINIMUM (Reserved (no event indicated))
- //使用最大值为0x65
- 0x29, 0x65, // USAGE_MAXIMUM (Keyboard Application)
- //输入用,变量,数组,绝对值
- 0x81, 0x00, // INPUT (Data,Ary,Abs)
- //以上定义了6个8bit宽的数组,每个8bit(即一个字节)用来表示一个按键,所以可以同时
- //有6个按键按下。没有按键按下时,全部返回0。如果按下的键太多,导致键盘扫描系统
- //无法区分按键时,则全部返回0x01,即6个0x01。如果有一个键按下,则这6个字节中的第一
- //个字节为相应的键值(具体的值参看HID Usage Tables),如果两个键按下,则第1、2两个
- //字节分别为相应的键值,以次类推。
- //关集合,跟上面的对应
- 0xc0 , // END_COLLECTION
- //-----------------------鼠标部分报告描述符----------------------------
- 0x05, 0x01, // USAGE_PAGE (Generic Desktop)
- 0x09, 0x02, // USAGE (Mouse)
- 0xa1, 0x01, // COLLECTION (Application)
- 0x85, 0x02, // 报告ID (2)
- 0x09, 0x01, // USAGE (Pointer)
- 0xa1, 0x00, // COLLECTION (Physical)
- 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)
- 0x95, 0x03, // REPORT_COUNT (3)
- 0x75, 0x01, // REPORT_SIZE (1)
- 0x81, 0x02, // INPUT (Data,Var,Abs)
- 0x95, 0x01, // REPORT_COUNT (1)
- 0x75, 0x05, // REPORT_SIZE (5)
- 0x81, 0x03, // INPUT (Cnst,Var,Abs)
- 0x05, 0x01, // USAGE_PAGE (Generic Desktop)
- 0x09, 0x30, // USAGE (X)
- 0x09, 0x31, // USAGE (Y)
- 0x09, 0x38, // USAGE (Wheel)
- 0x15, 0x81, // LOGICAL_MINIMUM (-127)
- 0x25, 0x7f, // LOGICAL_MAXIMUM (127)
- 0x75, 0x08, // REPORT_SIZE (8)
- 0x95, 0x03, // REPORT_COUNT (3)
- 0x81, 0x06, // INPUT (Data,Var,Rel)
- 0xc0, // END_COLLECTION
- 0xc0 // END_COLLECTION
- };
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
}