USB组合设备——带鼠标功能的键盘

Posted tyustli

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了USB组合设备——带鼠标功能的键盘相关的知识,希望对你有一定的参考价值。

文章目录

  • 复合设备:Compound Device 内嵌 Hub 和多个 Function,每个 Function 都相当于一个独立的 USB 外设,有自己的 PID/VID/DID。
  • 组合设备:Composite Device 内只有一个 Function,只有一套 PID/VID/DID。
    这里使用组合设备来实现

带鼠标功能的键盘

要实现带鼠标功能的键盘有两种方式

  • 一个接口,但是使用两个应用集合和两个报告
  • 两个接口,分别实现键盘和鼠标

一个接口实现

设备描述符,配置描述符,HID 描述符 (注意报告描述符的长度) 和端点描述符等保持不变,唯一不同的是报告描述符和报告描述符的长度。

报告描述符示例

端点 0 最大包长为 64,分包传输如下

0x5 0x1 0x9 0x6 0xa1 0x1 0x85 0x1 0x5 0x7 0x19 0xe0 0x29 0xe7 0x15 0x0 0x25 0x1 0x95 0x8 0x75 0x1 0x81 0x2 0x95 0x1 0x75 0x8 0x81 0x1 0x5 0x8 0x19 0x1 0x29 0x5 0x95 0x5 0x75 0x1 0x91 0x2 0x95 0x1 0x75 0x3 0x91 0x1 0x5 0x7 0x19 0x0 0x2a 0xff 0x0 0x15 0x0 0x26 0xff 0x0 0x95 0x6 0x75 0x8
0x81 0x0 0xc0 0x5 0x1 0x9 0x2 0xa1 0x1 0x85 0x2 0x9 0x1 0xa1 0x0 0x5 0x9 0x19 0x1 0x29 0x5 0x15 0x0 0x25 0x1 0x95 0x5 0x75 0x1 0x81 0x2 0x95 0x1 0x75 0x3 0x81 0x1 0x5 0x1 0x9 0x30 0x9 0x31 0x15 0x81 0x25 0x7f 0x95 0x2 0x75 0x8 0x81 0x6 0x9 0x38 0x15 0x81 0x25 0x7f 0x95 0x1 0x75 0x8 0x81
:0x6 0x5 0xc 0xa 0x38 0x2 0x15 0x81 0x25 0x7f 0x95 0x1 0x75 0x8 0x81 0x6 0xc0 0xc0 0x5 0xc 0x9 0x1 0xa1 0x1 0x85 0x3 0x15 0x0 0x26 0xff 0x3 0x19 0x0 0x2a 0xff 0x3 0x95 0x1 0x75 0x10 0x81 0x0 0xc0 0x5 0x1 0x9 0x5 0xa1 0x1 0x85 0x4 0x5 0x1 0x9 0x30 0x9 0x31 0x9 0x32 0x9 0x35 0x9 0x33 0x9
0x34 0x15 0x81 0x25 0x7f 0x95 0x6 0x75 0x8 0x81 0x2 0x5 0x1 0x9 0x39 0x15 0x1 0x25 0x8 0x35 0x0 0x46 0x3b 0x1 0x95 0x1 0x75 0x8 0x81 0x2 0x5 0x9 0x19 0x1 0x29 0x20 0x15 0x0 0x25 0x1 0x95 0x20 0x75 0x1 0x81 0x2 0xc0

上述报告描述符设置了四个报告

  • KEYBOARD:ID 为 1
  • MOUSE:ID 为 2
  • CONSUMER_CONTROL:ID 为 3
  • GAMEPAD:ID 为 4

报告返回时,报告的最低位指定报告 ID 即可

键盘的报告

例如键盘报告的返回, 最低位为 1

0x1 0x0 0x0 0x4 0x0 0x0 0x0 0x0 0x0
  • 0x01 表示键盘的报告
  • 0x04 表示 a 按下

鼠标的报告

鼠标报告的返回最低位为 2

0x2 0x0 0x5 0x5 0x0 0x0
  • 0x02 表示鼠标的报告
  • 0x05 表示 x 轴移动量
  • 0x05 表示 y 轴移动量

其他报告的返回类似。

两个接口实现

配置描述符集合结构

USB - 描述符之间的关系 中可以知道,多个接口实现时,一个接口实现鼠标,一个接口实现键盘,所以此时的配置描述符集合为


    配置描述符,
    接口 1 描述符
        接口描述符 (键盘接口),
        类特殊描述符 (HID 描述符 - 键盘),
        端点描述符 (键盘输入端点),
    接口 2 描述符
        接口描述符 (鼠标接口),
        类特殊描述符 (HID 描述符 - 鼠标),
        端点描述符 (鼠标输入端点)

配置描述符集合的实现

0x9 0x2 0x3b 0x0 0x2 0x1 0x0 0xa0 0x32 0x9 0x4 0x0 0x0 0x1 0x3 0x1 0x1 0x4 0x9 0x21 0x11 0x1 0x0 0x1 0x22 0x41 0x0 0x7 0x5 0x81 0x3 0x8 0x0 0xa 0x9 0x4 0x1 0x0 0x1 0x3 0x1 0x2 0x5 0x9 0x21 0x11 0x1 0x0 0x1 0x22 0x4d 0x0 0x7 0x5 0x82 0x3 0x8 0x0 0xa
  • 配置描述符 (0x9 0x2 0x3b 0x0 0x2 0x1 0x0 0xa0 0x32)
  • 键盘接口描述符
    • 接口描述符 (0x9 0x4 0x0 0x0 0x1 0x3 0x1 0x1 0x4)
    • 类特殊描述符 (HID 描述符:0x9 0x21 0x11 0x1 0x0 0x1 0x22 0x41 0x0)
    • 端点描述符 (0x7 0x5 0x81 0x3 0x8 0x0 0xa)
  • 鼠标接口描述符
    • 接口描述符 (0x9 0x4 0x1 0x0 0x1 0x3 0x1 0x2 0x5)
    • 类特殊描述符 (HID 描述符:0x9 0x21 0x11 0x1 0x0 0x1 0x22 0x4d 0x0)
    • 端点描述符 (0x7 0x5 0x82 0x3 0x8 0x0 0xa)

配置描述符的 bNumInterfaces(第五个数据) 的值为 2,表明有两个接口
接口描述符的 bInterfaceNumber(第三个数据) 表示接口的编号,从 0 开始。
接口描述符的 iInterface(最后一个数据) 表示接口字符串的索引,主机在获取字符串描述符时,需要根据索引返回相应的字符串。

接口 1 字符串描述符(索引为 4)

USB 控制端点收到的数据

0x80 0x6 0x4 0x3 0x9 0x4 0x4 0x0
  • bmRequestType:0x80
    • 数据传输方向为 1,device-to-host
    • 标准请求
    • 请求的接收者为设备
  • bRequest:0x06
    • GET_DESCRIPTOR 获取描述符请求
  • wValue:0x0304(LSB)
    • 低位:0x04 索引号,当前字符串索引为 4,表示获取接口 1 字符串。
    • 高位:0x03 描述符类型:3 表示字符串描述符
  • wIndex:0x0409(LSB)
    • 低位:0x09 主机使用获取到的语言 ID 0x0409。
    • 高位:0x04
  • wLength:0x04
    • 低位:0x04 请求返回的字节数为 0x04
    • 高位:0x00

设备返回给主机的数据

0x26 0x3 0x4b 0x0
  • 0x26:接口 1 字符串描述符长度为 0x26
  • 0x03:描述符类型,0x03 表示字符串描述符
  • 0x004b :描述符的数据,由于主机只请求了 4 字节数据,所以这里只填充 4 字节。

主机从返回的 0x26 知道了接口 1 字符串的长度,所以下次就会请求全部的长度

0x80 0x6 0x4 0x3 0x9 0x4 0x26 0x0
  • bmRequestType:0x80
    • 数据传输方向为 1,device-to-host
    • 标准请求
    • 请求的接收者为设备
  • bRequest:0x06
    • GET_DESCRIPTOR 获取描述符请求
  • wValue:0x0304(LSB)
    • 低位:0x04 索引号,当前字符串索引为 4,表示获取接口 1 字符串。
    • 高位:0x03 描述符类型:3 表示字符串描述符
  • wIndex:0x0409(LSB)
    • 低位:0x09 主机使用获取到的语言 ID 0x0409。
    • 高位:0x04
  • wLength:0x0026
    • 低位:0x26 请求返回的字节数为 0x26。
    • 高位:0x00

从机返回 0x26 个接口 1 字符串描述符

0x26 0x3 0x4b 0x0 0x65 0x0 0x79 0x0 0x62 0x0 0x6f 0x0 0x61 0x0 0x72 0x0 0x64 0x0 0x20 0x0 0x49 0x0 0x6e 0x0 0x74 0x0 0x65 0x0 0x72 0x0 0x66 0x0 0x61 0x0 0x63 0x0 0x65 0x0
  • 0x26:字符串描述符长度
  • 0x03:描述符类型为字符串描述符

接口 2 字符串描述符(索引为 5)

USB 控制端点收到的数据

0x80 0x6 0x5 0x3 0x9 0x4 0x4 0x0
  • bmRequestType:0x80
    • 数据传输方向为 1,device-to-host
    • 标准请求
    • 请求的接收者为设备
  • bRequest:0x06
    • GET_DESCRIPTOR 获取描述符请求
  • wValue:0x0305(LSB)
    • 低位:0x05 索引号,当前字符串索引为 5,表示获取接口 2 字符串。
    • 高位:0x03 描述符类型:3 表示字符串描述符
  • wIndex:0x0409(LSB)
    • 低位:0x09 主机使用获取到的语言 ID 0x0409。
    • 高位:0x04
  • wLength:0x04
    • 低位:0x04 请求返回的字节数为 0x04
    • 高位:0x00

设备返回给主机的数据

0x20 0x3 0x4d 0x0
  • 0x20:接口 2 字符串描述符长度为 0x20
  • 0x03:描述符类型,0x03 表示字符串描述符
  • 0x004d :描述符的数据,由于主机只请求了 4 字节数据,所以这里只填充 4 字节。
    主机从返回的 0x20 知道了接口 2 字符串的长度,所以下次就会请求全部的长度
0x80 0x6 0x5 0x3 0x9 0x4 0x20 0x0
  • bmRequestType:0x80
    • 数据传输方向为 1,device-to-host
    • 标准请求
    • 请求的接收者为设备
  • bRequest:0x06
    • GET_DESCRIPTOR 获取描述符请求
  • wValue:0x0305(LSB)
    • 低位:0x05 索引号,当前字符串索引为 5,表示获取接口 2 字符串。
    • 高位:0x03 描述符类型:3 表示字符串描述符
  • wIndex:0x0409(LSB)
    • 低位:0x09 主机使用获取到的语言 ID 0x0409。
    • 高位:0x04
  • wLength:0x0020
    • 低位:0x20 请求返回的字节数为 0x20。
    • 高位:0x00

从机返回 0x20 个接口 2 字符串描述符

0x20 0x3 0x4d 0x0 0x6f 0x0 0x75 0x0 0x73 0x0 0x65 0x0 0x20 0x0 0x49 0x0 0x6e 0x0 0x74 0x0 0x65 0x0 0x72 0x0 0x66 0x0 0x61 0x0 0x63 0x0 0x65 0x0
  • 0x20:字符串描述符长度
  • 0x03:描述符类型为字符串描述符

报告的返回

0x0 0x0 0x4 0x0 0x0 0x0 0x0 0x0
0x0 0x5 0x5 0x0 0x0

往对应的端点写数据即可。

附 STM32 枚举日志

suspend int
bus reset int
enum done int
rxflvl int
setup packed recvd
setup packed done
output ep int
h->d: 0x80 0x6 0x0 0x1 0x0 0x0 0x40 0x0
dcd xfer 12
input ep int
d->h :0x12 0x1 0x0 0x2 0x0 0x0 0x0 0x40 0xfe 0xca 0x8 0x40 0x0 0x1 0x1 0x2 0x3 0x1
turn off txfe
input ep int
edpt int send xfer complete event
dcd xfer 0
rxflvl int
ep 0 out packet recvd:

bus reset int
output ep int
send xfer complete event
enum done int
rxflvl int
setup packed recvd
setup packed done
output ep int
h->d: 0x0 0x5 0x5 0x0 0x0 0x0 0x0 0x0
dcd xfer 0
input ep int
edpt int send xfer complete event
rxflvl int
setup packed recvd
setup packed done
output ep int
h->d: 0x80 0x6 0x0 0x1 0x0 0x0 0x12 0x0
dcd xfer 12
input ep int
d->h :0x12 0x1 0x0 0x2 0x0 0x0 0x0 0x40 0xfe 0xca 0x8 0x40 0x0 0x1 0x1 0x2 0x3 0x1
turn off txfe
input ep int
edpt int send xfer complete event
dcd xfer 0
rxflvl int
ep 0 out packet recvd:

output ep int
send xfer complete event
rxflvl int
setup packed recvd
setup packed done
output ep int
h->d: 0x80 0x6 0x0 0x2 0x0 0x0 0xff 0x0
dcd xfer 3b
input ep int
d->h :0x9 0x2 0x3b 0x0 0x2 0x1 0x0 0xa0 0x32 0x9 0x4 0x0 0x0 0x1 0x3 0x1 0x1 0x4 0x9 0x21 0x11 0x1 0x0 0x1 0x22 0x41 0x0 0x7 0x5 0x81 0x3 0x8 0x0 0xa 0x9 0x4 0x1 0x0 0x1 0x3 0x1 0x2 0x5 0x9 0x21 0x11 0x1 0x0 0x1 0x22 0x4d 0x0 0x7 0x5 0x82 0x3 0x8 0x0 0xa
turn off txfe
input ep int
edpt int send xfer complete event
dcd xfer 0
rxflvl int
ep 0 out packet recvd:

setup packed recvd
setup packed done
output ep int
h->d: 0x80 0x6 0x3 0x3 0x9 0x4 0xff 0x0
send xfer complete event
dcd xfer e
input ep int
d->h :0xe 0x3 0x31 0x0 0x32 0x0 0x33 0x0 0x34 0x0 0x35 0x0 0x36 0x0
turn off txfe
input ep int
edpt int send xfer complete event
dcd xfer 0
rxflvl int
ep 0 out packet recvd:

setup packed recvd
setup packed done
output ep int
h->d: 0x80 0x6 0x0 0x3 0x0 0x0 0xff 0x0
send xfer complete event
dcd xfer 4
input ep int
d->h :0x4 0x3 0x9 0x4
turn off txfe
input ep int
edpt int send xfer complete event
dcd xfer 0
rxflvl int
ep 0 out packet recvd:

setup packed recvd
setup packed done
output ep int
h->d: 0x80 0x6 0x2 0x3 0x9 0x4 0xff 0x0
send xfer complete event
dcd xfer 1e
input ep int
d->h :0x1e 0x3 0x54 0x0 0x69 0x0 0x6e 0x0 0x79 0x0 0x55 0x0 0x53 0x0 0x42 0x0 0x20 0x0 0x44 0x0 0x65 0x0 0x76 0x0 0x69 0x0 0x63 0x0 0x65 0x0
turn off txfe
input ep int
edpt int send xfer complete event
dcd xfer 0
rxflvl int
ep 0 out packet recvd:

setup packed recvd
setup packed done
output ep int
h->d: 0x80 0x6 0x0 0x6 0x0 0x0 0xa 0x0
send xfer complete event
get device qualifier
stall ep0
rxflvl int
setup packed recvd
setup packed done
output ep int
h->d: 0x80 0x6 0x0 0x1 0x0 0x0 0x12 0x0
dcd xfer 12
input ep int
d->h :0x12 0x1 0x0 0x2 0x0 0x0 0x0 0x40 0xfe 0xca 0x8 0x40 0x0 0x1 0x1 0x2 0x3 0x1
turn off txfe
input ep int
edpt int send xfer complete event
dcd xfer 0
rxflvl int
ep 0 out packet recvd:

setup packed recvd
setup packed done
output ep int
h->d: 0x80 0x6 0x0 0x2 0x0 0x0 0x9 0x0
send xfer complete event
dcd xfer 9
input ep int
d->h :0x9 0x2 0x3b 0x0 0x2 0x1 0x0 0xa0 0x32
turn off txfe
input ep int
edpt int send xfer complete event
dcd xfer 0
rxflvl int
ep 0 out packet recvd:

setup packed recvd
setup packed done
output ep int
h->d: 0x80 0x6 0x0 0x2 0x0 0x0 0x3b 0x0
send xfer complete event
dcd xfer 3b
input ep int
d->h :0x9 0x2 0x3b 0x0 0x2 0x1 0x0 0xa0 0x32 0x9 0x4 0x0 0x0 0x1 0x3 0x1 0x1 0x4 0x9 0x21 0x11 0x1 0x0 0x1 0x22 0x41 0x0 0x7 0x5 0x81 0x3 0x8 0x0 0xa 0x9 0x4 0x1 0x0 0x1 0x3 0x1 0x2 0x5 0x9 0x21 0x11 0x1 0x0 0x1 0x22 0x4d 0x0 0x7 0x5 0x82 0x3 0x8 0x0 0xa
turn off txfe
input ep int
edpt int send xfer complete event
dcd xfer 0
rxflvl int
ep 0 out packet recvd:

setup packed recvd
setup packed done
output ep int
h->d: 0x0 0x9 0x1 0x0 0x0 0x0 0x0 0x0
send xfer complete event
edpt open
edpt open
dcd xfer 0
input ep int
edpt int send xfer complete event
rxflvl int
setup packed recvd
setup packed done
output ep int
h->d: 0x80 0x6 0x4 0x3 0x9 0x4 0x4 0x0
dcd xfer 4
input ep int
d->h :0x26 0x3 0x4b 0x0
turn off txfe
input ep int
edpt int send xfer complete event
dcd xfer 0
rxflvl int
ep 0 out packet recvd:

setup packed recvd
setup packed done
output ep int
h->d: 0x80 0x6 0x0 0x3 0x0 0x0 0xff 0x0
send xfer complete event
dcd xfer 4
input ep int
d->h :0x4 0x3 0x9 0x4
turn off txfe
input ep int
edpt int send xfer complete event
dcd xfer 0
rxflvl int
ep 0 out packet recvd:

setup packed recvd
setup packed done
output ep int
h->d: 0x80 0x6 0x4 0x3 0x9 0x4 0x26 0x0
send xfer complete event
dcd xfer 26
input ep int
d->h :0x26 0x3 0x4b 0x0 0x65 0x0 0x79 0x0 0x62 0x0 0x6f 0x0 0x61 0x0 0x72 0x0 0x64 0x0 0x20 0x0 0x49 0x0 0x6e 0x0 0x74 0x0 0x65 0x0 0x72 0x0 0x66 0x0 0x61 0x0 0x63 0x0 0x65 0x0
turn off txfe
input ep int
edpt int send xfer complete event
dcd xfer 0
rxflvl int
ep 0 out packet recvd:

setup packed recvd
setup packed done
output ep int
h->d: 0x80 0x6 0x0 0x3 0x0 0x0 0xff 0x0
send xfer complete event
dcd xfer 4
input ep int
d->h :0x4 0x3 0x9 0x4
turn off txfe
input ep int
edpt int send xfer complete event
dcd xfer 0
rxflvl int
ep 0 out packet recvd:

setup packed recvd
setup packed done
output ep int
h->d: 0x80 0x6 0x5 0x3 0x9 0x4 0x4 0x0
send xfer complete event
dcd xfer 4
input ep int
d->h :0x20 0x3 0x4d 0x0
turn off txfe
input ep int
edpt int send xfer complete event
dcd xfer 0
rxflvl int
ep 0 out packet recvd:

setup packed recvd
setup packed done
output ep int
h->d: 0x80 0x6 0x1 0x3 0x9 0x4 0xff 0x0
send xfer complete event
dcd xfer 10
input ep int
d->h :0x10 0x3 0x54 0x0 0x69 0x0 0x6e 0x0 0x79 0x0 0x55 0x0 0x53 0x0 0x42 0x0
turn off txfe
input ep int
edpt int send xfer complete event
dcd xfer 0
rxflvl int
ep 0 out packet recvd:

setup packed recvd
setup packed done
output ep int
h->d: 0x80 0x6 0x5 0x3 0x9 0x4 0x20 0x0
send xfer complete event
dcd xfer 20
input ep int
d->h :0x20 0x3 0x4d 0x0 0x6f 0x0 0x75 0x0 0x73 0x0 0x65 0x0 0x20 0x0 0x49 0x0 0x6e 0x0 0x74 0x0 0x65 0x0 0x72 0x0 0x66 0x0 0x61 0x0 0x63 0x0 0x65 0x0
turn off txfe
input ep int
edpt int send xfer complete event
dcd xfer 0
rxflvl int
ep 0 out packet recvd:

setup packed recvd
setup packed done
output ep int
h->d: 0x80 0x6 0x1 0x3 0x9 0x4 0xff 0x0
send xfer complete event
dcd xfer 10
input ep int
d->h :0x10 0x3 0x54 0x0 0x69 0x0 0x6e 0x0 0x79 0x0 0x55 0x0 0x53 0x0 0x42 0x0
turn off txfe
input ep int
edpt int send xfer complete event
dcd xfer 0
rxflvl int
ep 0 out packet recvd:

setup packed recvd
setup packed done
output ep int
h->d: 0x21 0xa 0x0 0x0 0x0 0x0 0x0 0x0
send xfer complete event
dcd xfer 0
input ep int
edpt int send xfer complete event
rxflvl int
setup packed recvd
setup packed done
output ep int
h->d: 0x80 0x6 0x2 0x3 0x9 0x4 0xff 0x0
dcd xfer 1e
input ep int
d->h :0x1e 0x3 0x54 0x0 0x69 0x0 0x6e 0x0 0x79 0x0 0x55 0x0 0x53 0x0 0x42 0x0 0x20 0x0 0x44 0x0 0x65 0x0 0x76 0x0 0x69 0x0 0x63 0x0 0x65 0x0
turn off txfe
input ep int
edpt int send xfer complete event
dcd xfer 0
rxflvl int
ep 0 out packet recvd:

setup packed recvd
setup packed done
output ep int
h->d: 0x81 0x6 0x0 0x22 0x0 0x0 0x81 0x0
send xfer complete event
dcd xfer 40
input ep int
d->h :0x5 0x1 0x9 0x6 0xa1 0x1 0x5 0x7 0x19 0xe0 0x29 0xe7 0x15 0x0 0x25 0x1 0x95 0x8 0x75 0x1 0x81 0x2 0x95 0x1 0x75 0x8 0x81 0x1 0x5 0x8 0x19 0x1 0x29 0x5 0x95 0x5 0x75 0x1 0x91 0x2 0x95 0x1 0x75 0x3 0x91 0x1 0x5 0x7 0x19 0x0 0x2a 0xff 
    参考技术A
            lspci可以看你的usb情况,lsmod 查查加载的模块,应该是usb什么什么的,
驱动应该是在/lib/modules/内核版本/kernel/drives/usb下,
当然另外还要mousedev模块吧。
我只是提供个思路,也没有试过安装本回答被提问者和网友采纳
参考技术B USB鼠标驱动在内核位置:kernel2.6.35.11/driver/hid/usbhid/usbmouse.c
USB键盘驱动在内核位置:kernel2.6.35.11/driver/hid/usbhid/usbkbd.c

以上是关于USB组合设备——带鼠标功能的键盘的主要内容,如果未能解决你的问题,请参考以下文章

USB驱动之Android usb鼠标驱动

公司电脑u *** 接口被限制怎么办

无线键盘开启按啥键

MicroPython开发板TPYBoard关于USB-HID的应用

电脑如何区分键盘USB和鼠标USB?

linux 输入设备驱动