通过gadget命令行生成hid设备
下面xxx自己根据需要修改,例如VID,PID,产品名称
const char *INSTALL_GADGET_CMDS[] = {"modprobe libcomposite","mkdir /sys/kernel/config/usb_gadget/g1","echo 'xxx' > /sys/kernel/config/usb_gadget/g1/idVendor","echo 'xxx' > /sys/kernel/config/usb_gadget/g1/idProduct","mkdir /sys/kernel/config/usb_gadget/g1/strings/0x409", // 设备信息目录"echo 'xxx' > /sys/kernel/config/usb_gadget/g1/strings/0x409/serialnumber", // 产品序列号"echo 'xxx' > /sys/kernel/config/usb_gadget/g1/strings/0x409/manufacturer", // 产品制造商"echo 'xxx' > /sys/kernel/config/usb_gadget/g1/strings/0x409/product", // 产品名字"mkdir /sys/kernel/config/usb_gadget/g1/configs/c.1", // 配置目录"mkdir /sys/kernel/config/usb_gadget/g1/configs/c.1/strings/0x409","echo 'config' > /sys/kernel/config/usb_gadget/g1/configs/c.1/strings/0x409/configuration","echo 0x80 > /sys/kernel/config/usb_gadget/g1/configs/c.1/bmAttributes","echo 100 > /sys/kernel/config/usb_gadget/g1/configs/c.1/MaxPower",// 下面这些functions下的目配置都是接口描述符配置,一个目录是一个接口// Touchscreen"mkdir -p /sys/kernel/config/usb_gadget/g1/functions/hid.usb0", // 功能描述"echo 1 > /sys/kernel/config/usb_gadget/g1/functions/hid.usb0/subclass","echo 0 > /sys/kernel/config/usb_gadget/g1/functions/hid.usb0/protocol","echo 12 > /sys/kernel/config/usb_gadget/g1/functions/hid.usb0/report_length", // hid report max size"echo '050d0904a1018501050d0922a102050d9501750609511500253f810209422501750195018102750195018103050195017510550e65110930260040350046a6148142093126004046a40b8142c0050d0922a102050d9501750609511500253f810209422501750195018102750195018103050195017510550e65110930260040350046a6148142093126004046a40b8142c0050d0954257f95017508810285020955250a75089501b102c0' | xxd " XXD_ARGS " > /sys/kernel/config/usb_gadget/g1/functions/hid.usb0/report_desc", // hid desc"ln -s /sys/kernel/config/usb_gadget/g1/functions/hid.usb0 /sys/kernel/config/usb_gadget/g1/configs/c.1", // 关联配置和功能文件"ls /sys/class/udc > /sys/kernel/config/usb_gadget/g1/UDC", // 启动设备
};const char *UNINSTALL_GADGET_CMDS[] = {"echo '' > /sys/kernel/config/usb_gadget/g1/UDC","rm /sys/kernel/config/usb_gadget/g1/configs/c.1/hid.usb0","rmdir /sys/kernel/config/usb_gadget/g1/configs/c.1/strings/0x409","rmdir /sys/kernel/config/usb_gadget/g1/configs/c.1","rmdir /sys/kernel/config/usb_gadget/g1/functions/hid.usb0","rmdir /sys/kernel/config/usb_gadget/g1/strings/0x409","rmdir /sys/kernel/config/usb_gadget/g1",
};
里面很长的那个字符串,是hid报告描述符,下面详细讲。
hid报告描述符
把上面hid报告描述符贴到 https://www.usbzh.com/tool/usb.html,可以分析出结构,我已经在关键位置加了注释。
0x05, 0x0D, // Usage Page (Digitizer)
0x09, 0x04, // Usage (Touch Screen) //触控屏0xA1, 0x01, // Collection (Application) //每一个collection相当于c++里面的花括号,里面是一个集合0x85, 0x01, // Report ID (1)0x05, 0x0D, // Usage Page (Digitizer)0x09, 0x22, // Usage (Finger)//下面是一个触控点的数据包,也就是第一个手指0xA1, 0x02, // Collection (Logical) //这里主要描述到时候上报数据的数据格式,例如触控id/坐标xy,占用几个bit这些信息0x05, 0x0D, // Usage Page (Digitizer)0x95, 0x01, // Report Count (1) 一段0x75, 0x06, // Report Size (6) 每段占用6个bit0x09, 0x51, // Usage (Contact Identifier) 每个触控点的触控ID0x15, 0x00, // Logical Minimum (0) 最小值0x25, 0x3F, // Logical Maximum (63) 最大值0x81, 0x02, // Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position) 需要用户输出0x09, 0x42, // Usage (Tip Switch) 这个点是按下还是松开0x25, 0x01, // Logical Maximum (1) 最大值1,前面定义了最小是00x75, 0x01, // Report Size (1) 每段占用1bit0x95, 0x01, // Report Count (1) 一段0x81, 0x02, // Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position) 需要用户输入0x75, 0x01, // Report Size (1) 每段占用1bit0x95, 0x01, // Report Count (1) 一段0x81, 0x03, // Input (Const,Var,Abs,No Wrap,Linear,Preferred State,No Null Position) const值,需要用户输入//上面 6+1+1刚好一个byte0x05, 0x01, // Usage Page (Generic Desktop Ctrls)0x95, 0x01, // Report Count (1) 一段0x75, 0x10, // Report Size (16) 每段占用16bit0x55, 0x0E, // Unit Exponent (-2)0x65, 0x11, // Unit (System: SI Linear, Length: Centimeter)0x09, 0x30, // Usage (X) x坐标0x26, 0x00, 0x40, // Logical Maximum (16384)0x35, 0x00, // Physical Minimum (0)0x46, 0xA6, 0x14, // Physical Maximum (5286)0x81, 0x42, // Input (Data,Var,Abs,No Wrap,Linear,Preferred State,Null State) 用户输入0x09, 0x31, // Usage (Y) y坐标0x26, 0x00, 0x40, // Logical Maximum (16384)0x46, 0xA4, 0x0B, // Physical Maximum (2980)0x81, 0x42, // Input (Data,Var,Abs,No Wrap,Linear,Preferred State,Null State) 用户输入//上面是xy坐标,每个占用2byte0xC0, // End Collection//下面也是一个触控点的数据包,也就是第二个手指,可以定义多个手指,这里只会影响一次发送给主机多少个数据,不影响多点触控//如果你10点同时触控,定义了两个手指,就会2-2-2-2-2发5次包,每次发两个手指,不影响多点触控0x05, 0x0D, // Usage Page (Digitizer)0x09, 0x22, // Usage (Finger)0xA1, 0x02, // Collection (Logical)0x05, 0x0D, // Usage Page (Digitizer)0x95, 0x01, // Report Count (1)0x75, 0x06, // Report Size (6)0x09, 0x51, // Usage (0x51)0x15, 0x00, // Logical Minimum (0)0x25, 0x3F, // Logical Maximum (63)0x81, 0x02, // Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)0x09, 0x42, // Usage (Tip Switch)0x25, 0x01, // Logical Maximum (1)0x75, 0x01, // Report Size (1)0x95, 0x01, // Report Count (1)0x81, 0x02, // Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)0x75, 0x01, // Report Size (1)0x95, 0x01, // Report Count (1)0x81, 0x03, // Input (Const,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)0x05, 0x01, // Usage Page (Generic Desktop Ctrls)0x95, 0x01, // Report Count (1)0x75, 0x10, // Report Size (16)0x55, 0x0E, // Unit Exponent (-2)0x65, 0x11, // Unit (System: SI Linear, Length: Centimeter)0x09, 0x30, // Usage (X)0x26, 0x00, 0x40, // Logical Maximum (16384)0x35, 0x00, // Physical Minimum (0)0x46, 0xA6, 0x14, // Physical Maximum (5286)0x81, 0x42, // Input (Data,Var,Abs,No Wrap,Linear,Preferred State,Null State)0x09, 0x31, // Usage (Y)0x26, 0x00, 0x40, // Logical Maximum (16384)0x46, 0xA4, 0x0B, // Physical Maximum (2980)0x81, 0x42, // Input (Data,Var,Abs,No Wrap,Linear,Preferred State,Null State)0xC0, // End Collection//下面是其他信息,安卓主机不需要这些信息也能正常多点触控,可是windows主机就一定需要这些0x05, 0x0D, // Usage Page (Digitizer)0x09, 0x54, // Usage (Contact Count) //这一帧总共多少个触控点0x25, 0x7F, // Logical Maximum (127)0x95, 0x01, // Report Count (1)0x75, 0x08, // Report Size (8) 8bit0x81, 0x02, // Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position) 需要用户输入0x85, 0x02, // Report ID (2)0x09, 0x55, // Usage (Contact Count Maximum) //最大支持多少点触控,这个很重要,没有这个你发多少个点去windows都不响应0x25, 0x0A, // Logical Maximum (10) 0x75, 0x08, // Report Size (8) 8bit0x95, 0x01, // Report Count (1)0xB1, 0x02, // Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile) 特性描述,这个下面详细分析
0xC0, // End Collection// 171 bytes
发送数据
按照上面的报告描述符,我们上报触控点的数据应该如下
buf[0]:报告ID
buf[1]:第一点ID(低6位) + 第一点触摸状态(bit 6):有触摸为1,无触摸为0,bit7不用管
buf[2]:第一点X坐标低8位
buf[3]:第一点X坐标高8位
buf[4]:第一点Y坐标低8位
buf[5]:第一点Y坐标高8位
buf[6]:第二点ID + 第二点触摸状态:有触摸为1,无触摸为0
buf[7]:第二点X坐标低8位
buf[8]:第二点X坐标高8位
buf[9]:第二点Y坐标低8位
buf[10]:第二点Y坐标高8位
buf[11]:第一个报告最后一个字节表示有效的触摸点数(包含按下状态和第一次松开),其他报告最后一个字节为0
可以看到这个buf长度12,也就是我们上面gadget配置的,这两个要对应,不然HID交互会异常
"echo 12 > /sys/kernel/config/usb_gadget/g1/functions/hid.usb0/report_length", // hid report max size
Windows支持多点触控
对于Windows支持多点触控,官网有详细描述:
https://learn.microsoft.com/zh-cn/windows-hardware/design/component-guidelines/touchscreen-required-hid-top-level-collections
所以最大触摸点数量的特性报告是必须要的
可是按上面报告描述符写了Contact Count Maximum,逻辑最大值10,windows还是不支持多点响应
0x25, 0x0A, // Logical Maximum (10)
通过Bus Hound抓包分析,左边是增加Contact Count Maximum描述的,右边是没有Contact Count Maximum描述的,
左边主机会发送一个GET REPORT包给设备,设备回复了00 00。
我猜测逻辑是:设备报告描述符里面有最大支持点数特性,所以主机询问设备支持多少点,设备需要回复值。可是我们设备回复了0,所以就不支持多点了,单点都不支持了。
找了个正常支持多点触控的平台,抓出来包如下,别人真的回复了02 0a,02就是报告ID,0a就是10点触控。证实了我的猜想。
如何发送这个最大支持点数?
由于我的代码使用的是命令行 gadget初始化设备,网上找了很久都没找到应用层如何设置这个回复包。
最后是在kernel代码里面,这个文件找到了回复逻辑
可以看到hid收到 HID_REQ_GET_REPORT 包后,直接回复了个全0的包。我不知道为什么kernel的逻辑这样写。
尝试把这里改成回复 02 0a,主机就响应多点了!!!
但是肯定不能直接这样改,现在定位到问题了,就是这个包如何回复,如何能在应用层回复。
继续研究,有知道的朋友可以评论区提点下。