LINUX嵌入式模拟键盘 2022-05-21

简介

使用嵌入式设备，通过otg接口连接电脑主机，可以简单的实现键鼠的模拟。

最终的效果：将一个设备插在电脑上，可通过设备中的程序模拟成键盘/鼠标，从而被主机识别，并以此来操控主机。

参考文章：
http://trac.gateworks.com/wiki/linux/OTG
https://www.kernel.org/doc/html/latest/usb/gadget_configfs.html
http://www.usbzh.com/
参考代码：
https://www.kernel.org/doc/Documentation/usb/gadget_hid.txt
https://github.com/nesto-software/USBProxy

环境说明

嵌入式设备：有OTG接口（不是普通的U口），linux操作系统，内核版本4.19（更旧的版本没试过），内核支持configfs，hid相关的gadget（例如g_hid\f_hid等）,如果要同时支持键盘鼠标，可能需要内核支持libcomposite。

主机：winXP/win7/win10/winServer/ubuntu/centos已测，但有些win7遇到过问题，具体原因不详,可能和windows自身的驱动有关。

设备和主机的连接方式：嵌入式设备OTG接口和PC的USB接口做连接，线缆型号和嵌入式设备的OTG接口有关。例如树莓派，可直接将U口插在主机。

实现相关

linux C、configfs

实现步骤

使用键盘举例说明，鼠标大同小异，差别仅在于report相关信息

1.枚举

枚举过程可通过手动命令实现，亦可调用libusbgx-master（git搜索即可）的api，原理相同
（1）挂载，挂载的目录随意，参考已有文章大多数放在/sys/kernel/config目录下，此时目录下以生成和设备硬件配套的相关目录。一般是usb_gadget.

# mount -t configfs none /sys/kernel/config

（2）创建gadget目录,创建目录后系统自动生成文件在该目录下

# mkdir -p /sys/kernel/config/usb_gadget/my_gadget

（3）填充厂商ID/产品ID/等，这些数据随意一些即可

# echo 0x1234 > /sys/kernel/config/usb_gadget/my_gadget/idVendor
# echo 0x5678 > /sys/kernel/config/usb_gadget/my_gadget/idProduct
....

(4)创建hid-键盘相关文件,创建好文件夹后，自动生成hid相关的配置文件以共填充

# cd /sys/kernel/config/usb_gadget/my_gadget/functions
# mkdir hid.keyboard
# cd hid.keyboard
# ls
//dev  protocol  report_desc  report_length  subclass

(5)填充配置文件，可参考已有的真实设备。其中protocol=1标识键盘设备，subclass=1标识仅有一个接口描述符，report_length标识该hid设备每次发送的报表长度为8字节，report_desc标识该hid设备的报表描述符。
其中report_length的值根据report_desc得出。如何计算可参考libusb官网示例或USB中文网中的介绍。

# echo 1 > protocol   
# echo 1 > subclass
# echo 8 > report_length
# echo -ne \\x05\\x01\\x09\\x06\\xa1\\x01\\x05\\x07\\x19\\xe0\\x29\\xe7\\x15\\x00\\x25\\x01\\x75\\x01\\x95\\x08\\x81\\x02\\x95\\x01\\x75\\x08\\x81\\x03\\x95\\x05\\x75\\x01\\x05\\x08\\x19\\x01\\x29\\x05\\x91\\x02\\x95\\x01\\x75\\x03\\x91\\x03\\x95\\x06\\x75\\x08\\x15\\x00\\x25\\x65\\x05\\x07\\x19\\x00\\x29\\x65\\x81\\x00\\xc0 > report_desc

（6）创建配置描述符,在configs目录下自动生成相关的目录，例如b.1或c.1等，若没有可尝试自行创建

# cd /sys/kernel/config/usb_gadget/my_gadget/
# ln -s functions/hid.keyboard configs/c.1/

（7）使能，将设备（不同设备的udc名称不同）重新写入UDC文件，类似于重新上电，正常情况下，此时主机应已经枚举到键盘设备，例如windows可在设备和打印机中看到键盘设备。

# ls /sys/class/udc/
// fcc00000.dwc3
# echo fcc00000.dwc3 > UDC

2.数据交互

数据的交互由用户层的代码实现，通信手段是对文件/dev/hidgX文件的读写，如果在上述1-7步骤中仅软连接了一个设备，则是hidg0；如果软连接了多个设备，则根据文件名称的字典顺序依次是hidg0,hidg1等。
&