以添加 camera按键为例(红色是需要添加的)
一、kernel键值定义
(1)键扫描码
ScanCode是由linux的Input驱动框架定义的整数类型,可参考input.h头文件,即getevent得到的键值。
#define KEY_Q 16
#define KEY_W 17
#define KEY_E 18
#define KEY_R 19
#define KEY_T 20
#define KEY_CAMERA 199
(2)键盘布局文件(*.kl)
将input event报的键值转换成具体键盘对应的按键供android上层使用,时通过键盘布局文件(*.kl)完成转换的。放在/system/usr/keylayout/下面
而qwert.kl中定义如下:
ScanCode + 字符串值
key 16 Q
key 17 W
key 18 E
key 19 R
key 20 T
其中ScanCode 是驱动报的值(即驱动input.h中定义的键值 )
A:添加kl文件:
abcxxxx.kl(文件名须与input 的device设备的name一致)
Key 199 CAMERA
【199为 驱动定义的scanCode ,CAMERA 为Android中 KEYCODES[]定义按键对应的keylabel字符】
注:
1)kl文件须与键盘输入的input 的devic 的名称一致,否则EventHub在加载设备时因找不到对应的kl 而加载默认的qwert.kl,导致键值转换错误
2)kl中的scanCode 和android 中定义的keylabel字符必须对应,否则会转换错误。keyMapper在转换时是根据scanCode,来确定对应的按键字符,再根据此字符在KEYCODES中的位置来确定对应android中的键值。
B:kl文件添加到system
将kl文件(通常)放在/device/qcom/XXX/(XXX为项目名称)
(1) AndroidBoard.mk 添加:
include $(CLERA_VARS)
LOCAL_MODULE := abcxxxx.kl
LOCAL_MODULE_TARGS := optional eng
LOCAL_MODULE_CLASS := ETC
LOCAL_SRC_FILES := $(LOCAL_MODULE)
LOCAL_MODULE_PATH := $(TARGET_OUT_KEYLAYOUT)
include $(BUILD_PREBUILT)
(2)/device/qcom/common/base.mk添加
KEYPAD += abcxxxx.kl
注:不加会导致kl文件不被打包进/system/usr/keylayout/
二、Android 中添加按键
(1)定义按键对应的key label
在KEYCODES[]数组的最后添加按键的key label,
即:
static const KeycodeLabel KEYCODES[] = {
…
DEFINE_KEYCODE(HELP)
DEFINE_KEYCODE(CAMERA )
};
注:
位置
Android 4.4 以前版本 frameworks/base/include/ui/KeycodeLabels.h
Android 4.4 在framework/native/include/input/KeyCodelabels.h
Android5.0 以后在framework/native/include/input/InputEventLabels.h
(2)定义keyCode
A: native 定义(keycodes.h)
enum {
………
AKEYCODE_HELP = 259,
AKEYCODE_CAMERA = 260
};
注:
1)位置:frameworks/base/include/android/keycodes.h
2)此处keycode的定义的值即是 上面key label定义在KEYCODES数组中的位置(index),否则会映射错误
B:JAVA 定义(KeyEvent.java定义键值)
public static final int KEYCODE_HELP = 259;
public static final int KEYCODE_CAMERA = 260;
修改LAST_KEYCODE
private static final int LAST_KEYCODE = KEYCODE_CAMERA;
注:
1)位置:frameworks/base/core/java/android/view/KeyEvent.java
2)此处的key code必须与native定义的一致
C:资源文件(attrs.xml)添加keycode
注:
1)位置:frameworks\base\core\res\res\values\attrs.xml
影响到API则需要调用 make update-api 然后就可以使用了。
三、问题debug
按键映射出错或 unknown,排查步骤如下:
- 用 getevent 确认驱动是否报按键值,是否正确
- 看kl文件名是否正确?【参见1.2.A】
- 看kl文件是否正确加载,dumpsys input 查看KeyLayoutFile是否正确
- 看native定义的key code是否与key label 在KEYCODES[]数组的位置对应
- 看java层key code定义是否与native定义一致
dumpsys input 看 KeyLayoutFile如下:
2:abcxxxx
Classes: 0x00000001
Path: /dev/input/event7
Descriptor: 0ea3e722ddb6fa78cd53a54fc262828fb3df6ca7
Location: ALSA
ControllerNumber: 0
UniqueId:
Identifier: bus=0x0000, vendor=0x0000, product=0x0000, version=0x0000
KeyLayoutFile: /system/usr/keylayout/abcxxxx.kl
KeyCharacterMapFile: /system/usr/keychars/Generic.kcm
ConfigurationFile:
HaveKeyboardLayoutOverlay: false