深入了解sendevent

一、发送事件是什么

sendevent 是一个命令行工具，用于向输入子系统发送事件，通常被用于模拟硬件操作（如按键，触摸等）或测试应用程序的交互性。在安卓平台中，sendevent 发送事件是通过 /dev/input/eventX 的文件接口完成的。

sendevent 的语法如下：

sendevent <事件输入&gs; {type} <类型&gs; {code} <代码&gs; {value} <数值&gs;

其中 “事件输入” 指定发送事件的设备路径，通常是“/dev/input/eventX”，其中 X 是设备编号。type 代表事件的类型，例如 EV_KEY、EV_ABS 等。code 表示事件的代码，例如键值、绝对坐标轴值等。value 表示事件值，例如 0/1 表示按下或松开的键或触摸事件。

以下代码示例演示了如何使用 sendevent 发送一个模拟的键盘事件：

# 设置该事件发送到 /dev/input/event0 设备上
echo -n "sendevent /dev/input/event0" > /dev/tty
# 模拟按下 "a" 键
echo -n "0001 0039 00000001" > /dev/tty
# 模拟松开 "a" 键
echo -n "0001 0039 00000000" > /dev/tty

二、典型的sendevent使用场景

sendevent 是一个非常灵活的工具，可以发送各种各样的事件，被广泛地用于 Android 系统内部的自动化测试、事件注入等方面。以下是 sendevent 常见的使用场景：

1. 模拟按键事件

在 Android 系统中，按键事件是通过 /dev/input/eventX 设备发送的，通过 sendevent 可以模拟对硬件按键的操作。例如，以下代码演示了如何模拟按下 HOME 键的操作：

# 设置该事件发送到 /dev/input/event1 设备上
echo -n "sendevent /dev/input/event1" > /dev/tty
# 按下home键
echo -n "0001 102 00000001" > /dev/tty
# 松开home键
echo -n "0001 102 00000000" > /dev/tty

2.模拟触摸事件

在 Android 平台中，通过模拟输入的方式可以实现对触摸屏幕的模拟，同时还可以模拟屏幕多点触摸操作。envenatest 是一个工具，可以帮助我们测试触摸屏幕的性能和响应速度。

以下是一个模拟多点触摸的实现代码示例：

# 设置该事件发送到 /dev/input/event0 设备上
echo -n "sendevent /dev/input/event0" > /dev/tty
# 发送触摸屏幕按下事件
echo -n "0003 0039 00000029" > /dev/tty
echo -n "0003 0035 0000057f" > /dev/tty
echo -n "0003 0036 000007c5" > /dev/tty
echo -n "0003 0030 00000008" > /dev/tty
echo -n "0003 003a 0000014c" > /dev/tty
echo -n "0000 0000 00000000" > /dev/tty
# 发送触摸屏幕松开事件
echo -n "0003 0039 00000029" > /dev/tty
echo -n "0003 0035 0000057f" > /dev/tty
echo -n "0003 0036 000007c5" > /dev/tty
echo -n "0003 0030 00000008" > /dev/tty
echo -n "0003 003a 0000014c" > /dev/tty
echo -n "0000 0000 00000000" > /dev/tty

3.自动化测试

自动化测试是将测试过程自动化的一种方法，它能够更快更准确地执行测试，并在重复测试时避免疏漏。在 Android 平台的自动化测试中，sendevent 可以被用来模拟各种硬件事件，从而测试应用程序的交互性。

下面的代码演示了如何使用 sendevent 进行自动化测试，模拟向下滑动一个列表：

# 设置该事件发送到 /dev/input/event0 设备上
echo -n "sendevent /dev/input/event0" > /dev/tty
# 发送触摸屏幕按下事件
echo -n "0003 0039 00000029" > /dev/tty
echo -n "0003 0035 0000057f" > /dev/tty
echo -n "0003 0036 000007c5" > /dev/tty
echo -n "0003 0030 00000008" > /dev/tty
echo -n "0003 003a 0000014c" > /dev/tty
echo -n "0000 0000 00000000" > /dev/tty
# 发送触摸屏幕移动事件
echo -n "0003 0039 00000029" > /dev/tty
echo -n "0003 0035 0000057f" > /dev/tty
echo -n "0003 0036 000007c5" > /dev/tty
echo -n "0003 0030 00000008" > /dev/tty
echo -n "0003 003a 000000ac" > /dev/tty
echo -n "0000 0000 00000000" > /dev/tty
# 发送触摸屏幕松开事件
echo -n "0003 0039 00000029" > /dev/tty
echo -n "0003 0035 0000057f" > /dev/tty
echo -n "0003 0036 000007c5" > /dev/tty
echo -n "0003 0030 00000000" > /dev/tty
echo -n "0003 003a 00000000" > /dev/tty
echo -n "0000 0000 00000000" > /dev/tty

三、 sendevent使用技巧

1. 使用脚本简化操作

我们可以通过编写脚本，将 sendevent 的执行过程自动化，让操作更简单方便。以下脚本演示了如何通过按键操作关闭 Android 设备：

#!/system/bin/sh
# 设置该事件发送到 /dev/input/event2 设备上
dev=/dev/input/event2
# POWER
echo -ne "\x01\x74\x01\x00000001" > $dev
echo -ne "\x01\x74\x00\x00000000" > $dev
sleep 2
# VOLUME_DOWN
echo -ne "\x01\x73\x01\x00000001" > $dev
echo -ne "\x01\x73\x00\x00000000" > $dev
sleep 1
echo -ne "\x01\x73\x01\x00000001" > $dev
echo -ne "\x01\x73\x00\x00000000" > $dev
sleep 2
# 等待设备关闭完成
while true
do
    dumpsys power | grep mScreenOn=false
    if [ $? -eq 0 ]
    then
        echo "Device is shutdown."
        exit 0
    fi
    sleep 1
done

上述脚本通过发送按键事件完成了“长按 POWER 键 -> 按下音量减键 -> 松开音量减键 -> 再按下音量减键 -> 松开音量减键”的组合操作，最终完成了安全关闭 Android 设备的功能。

2. 调试触摸屏幕问题

当我们在使用触摸屏幕设备时，发现屏幕没有响应或者出现了其他异常问题时，可以通过 sendevent 发送触摸屏幕事件来确定是否是硬件问题。以下是一个演示代码示例：

#!/system/bin/sh
# 设置该事件发送到 /dev/input/event2 设备上
dev=/dev/input/event2
# 发送触摸屏幕按下事件
echo -ne "\x03\x39\x29\x03\x35\x7f\x03\x36\xc5\x03\x0b\x01\x00\x00\x03\x30\x08\x03\x3a\x4c\x00\x00\x00\x00\x00\x00" > $dev
# 发送触摸屏幕移动事件
echo -ne "\x03\x39\x29\x03\x35\x7f\x03\x36\xc5\x03\x0b\x00\x00\x11\xfe\x03\x30\x08\x03\x3a\x4c\x00\x00\x00\x00\x00\x00" > $dev
# 发送触摸屏幕松开事件
echo -ne "\x03\x39\x29\x03\x35\x7f\x03\x36\xc5\x03\x0b\x00\x00\x00\x00\x03\x30\x00\x03\x3a\x00\x00\x00\x00\x00\x00" > $dev

以上脚本模拟了一个从左上角开始触摸、移动到屏幕中间并且松开的过程，通过手指改变松开的位置获取更多信息。

3. 利用sendevent注入事件

sendevent 的最常见用途是注入事件，例如，将游戏手柄配置为键盘映射设备。通过将手柄的操作映射到按键事件上，使得手柄可以在不依赖游戏控制器的情况下完成游戏操作。

以下是示例代码演示了如何将二代Nintendo Switch（手持设备）的joycons映射为ASCII码值：

#!/system/bin/sh
# 切换到目录/data/local/tmp
cd  /data/local/tmp
# 安装进程并获取root shell权限
/system/bin/busybox cp /data/app/com.termux-*/com.termux* /data/local/tmp/
/system/bin/chmod +x com.termux*
./com.termux*
# 创建设备节点/dev/uinput
echo "Creating /dev/uinput device ..."
mknod /dev/uinput c 10 223
chmod 666 /dev/uinput
# 注入事件
echo "Injecting events ..."
echo "Press Ctrl + c to exit ..."
cat /dev/input/event3 | su -c "sendevent /dev/input/event5" &
cat /dev/input/event4 | su -c "sendevent /dev/input/event5" &
cat /dev/input/event6 | su -c "sendevent /dev/input/event5" &
exit 0

四、结论

sendevent 是一个非常灵活的工具，可以模拟各类事件，并被广泛地用于 Android 系统内部的自动化测试、事件注入等方面。通过使用脚本库、调试工具以及事件注入特性，可以更高效方便地使用它。