Android添加新按键

1、前言

在Android开发中可能会遇到添加新的按键的需求，本文将简单介绍如何在Android系统中完成一个新的按键的添加。

当系统有新的按键需要添加时，Linux内核下的键码到Android系统中键码是如何进行转换映射的？

2、内核添加设备节点

首先，我们需要在Linux内核添加新的按键值，在Linux内核中提供了按键的驱动程序gpio_keys.c，该驱动是基于设备树实现的，因此，先添加自己的设备节点，如下：

gpio_keys {
    status = "okay";
    compatible = "gpio-keys";
    #address-cells = <1>;
    #size-cells = <0>;
    input-name = "test-keys";
    pinctrl-names = "tlmm_gpio_key_active","tlmm_gpio_key_suspend";
    pinctrl-0 = <&gpio_key_active>;
    pinctrl-1 = <&gpio_key_suspend>;
    
    key1@1 {
        label = "key1";
        gpios = <&msm_gpio 96 1>;
        linux,code = <116>;
        linux,input-type = <1>;
    };
    
    key2@2 {
        label = "key2";
        gpios = <&msm_gpio 98 0>;
        linux,code = <102>;
        linux,input-type = <1>;
    };
};

在该设备树节点中，定义了两个按键，分别是key1（键码值为116）和key2（键码值为102），关于该设备节点的更详细介绍，可以查看下面的设备树绑定文档：

AOSP/kernel/Documentation/devicetree/bindings/gpio/gpio_keys.txt

关于Linux内核中的键码值定义在文件：

AOSP/kernel/include/uapi/linux/input.h

键码值如下所示：

#define KEY_RESERVED        0
#define KEY_ESC            1
#define KEY_1            2
#define KEY_2            3
#define KEY_3            4
#define KEY_4            5
#define KEY_5            6
#define KEY_6            7
#define KEY_7            8
...
...
...

添加设备树节点完成后，将Linux内核进行编译并烧写，查看新添加的设备节点是否已经添加完成：

$ cd/sys/class/input/input2/device
$ cat uevent

查看设备节点的uevent信息，如下所示，则在Linux内核中完成了新的按键设备节点添加：

3、键值上报到应用层

在上面，已经完成了Linux内核中按键的设备节点的添加，但是这仅仅是在Linux内核里面的键值，因此，我们需要修改按键的布局文件，并完成按键的键值上报到应用层。

（1）添加按键布局文件

按键布局文件是用来完成映射过程的，文件以kl结尾，用于将Linux内核中input子系统上报的键值转换成对应得按键值供Android系统上层使用，在下面的目录添加test-keys.kl文件：

AOSP/device/qcom/msm8909/

如下所示：

key 116   POWER
key 102   HOME

需要注意的是，按键布局文件的名称必须与input输入设备的名称一致，否则将EvenHub在加载设备时将找不到对应得kl文件而加载默认的kl文件，从而键值转换错误，在kl文件中，key是固定的，中间的数字代表的是Linux内核对应得键码。

接下来需要将按键的kl文件添加到系统中：

在AndroidBoard.mk中添加编译的命令，文件如下：

AOSP/device/qcom/msm8909/AndroidBoard.mk

添加的内容如下：

include $(CLEAR_VARS)
LOCAL_MODULE        := test-keys.kl
LOCAL_MODULE_TAGS    := optional eng
LOCAL_MODULE_CLASS    := ETC
LOCAL_SRC_FILES        := $(LOCAL_MODULE)
LOCAL_MODULE_PATH    := $(TARGET_OUT_KEYLAYOUT)
include $(BUILD_PREBUILT)

修改base.mk文件，否则该kl文件将不会被打包，文件如下：

AOSP/device/qcom/common/base.mk

添加内容如下：

# add new kl
KEYPAD += test-keys.kl

（2）Android上层添加按键

在上面，我们已经完成了按键布局文件的添加，接下来将在Android Framework层完成按键的添加。

需要注意的是，在实例中，关于POWER和HOME的按键，Android系统中默认已经定义了，如果需要添加新的，则需要自己完成定义：

首先需要添加按键对应得KeycodeLable，文件：

AOSP/frameworks/native/include/input/InputEventLabels.h

添加内容如下：

static const InputEventLabel KEYCODES[] = {
    ...
    ...

      DEFINE_KEYCODE(SYSTEM_NAVIGATION_LEFT),
      DEFINE_KEYCODE(SYSTEM_NAVIGATION_RIGHT),

    { NULL, 0 }
}；

接下来，进行键码定义，在文件：

AOSP/frameworks/native/include/android/keycodes.h

添加内容如下：

enum {
    ...
    ...
    /** fingerprint navigation key, left. */
    AKEYCODE_SYSTEM_NAVIGATION_LEFT = 282,
    /** fingerprint navigation key, right. */
    AKEYCODE_SYSTEM_NAVIGATION_RIGHT = 283
};

还需要修改java定义，在文件：

AOSP/frameworks/base/core/java/android/view/KeyEvent.java

添加内容如下：

public class KeyEvent extends InputEvent implements Parcelable {
    ...
    ...
    ...
    /** Key code constant: Consumed by the system for navigation left*/
    public static final int KEYCODE_SYSTEM_NAVIGATION_LEFT = 282;
    /** Key code constant: Consumed by the system for navigation right */
    public static final int KEYCODE_SYSTEM_NAVIGATION_RIGHT = 283;

    private static final int LAST_KEYCODE = KEYCODE_SYSTEM_NAVIGATION_RIGHT;
    ...
    ...
    ...
}

需要注意的是，该文件的键码必须与前面定义的一致。

接下来修改资源文件：

AOSP/frameworks/base/core/res/res/values/attrs.xml

到这里，Android系统添加新键值就完成了，接下来进行按键测试。

4、按键测试

将系统重新编译，并且将新的镜像进行烧写，使用下面命令查看，新的按键与布局文件：

# dumpsys input

输出如下：

从打印的结果来看，已经匹配上对应得keylayout文件，在上面的添加实例为POWER相应的键值，当按键被触发后，Android终端的屏幕将会被点亮，测试完成。