How to add a new key on android

[Description]

How to add a new key on android ICS/ICS2

[Solution]

1.在DCT tool keypad list 文件增加新按键的选项
alps\mediatek\source\dct\Keypad_YuSu.cmp中添加新键，如SMS快捷键KEY_SYMKEY_SMS
KEY_0

2.打开DCT tool 在keypad矩阵中在相应定义的按键位中添加新按键，如SMS，然后Save

3.修改linux 键盘码文件input.h
由于preloader\uboot\kernel\factory 等情况分开使用，相应的文件路径下的input.h都应该修改为新按键增加键码值 kernel\include\linux\input.h
bionic\libc\kernel\common\linux\input.h
external\kernel-headers\original\linux\input.h
external\qemu\linux_keycodes.h
mediatek\plaform\mt6575\preloader\src\drivers\inc\linux\input.h
Mediatek\plaform\mt6575\uboot\inc\linux\input.h

如KEY_SMS

define KEY_SMS 252

4.增加keypad layout文件键盘映射，linux和android key映射

mediatek\config\mt6575-kpd.kl
如：
key 252 SMS

注意所用版本和项目使用的KL文件，在adb shell中进入system/usr/keylyout/可以看到所用的KL，可以修改确认使用的KL

一般定义在kpd.c 的新按键会使用mtk-kpd.kl，也就是注册input设备为mtk-kpd的会使用mtk-kpd.kl

新增加设备名称的时候一般会使用generic.kl和qwerty.kl

generic.kl 和qwerty.kl 在alps/frameworks/base/data/keyboards/

mtk-kpd.kl在mediatek/config//

其中252 是linux键码，SMS是android识别key值 如果是需要唤醒系统，还需要增加WAKE
如果新按键是全键盘的一些生僻字符，修改： mediatek\config\mt6575-kpd.kcm

5.修改Java识别keycode

framework/base/include/ui/KeyCodelabels.h
KEYCODES数据结构后面增加
{"SMS",220}

framework/base/native/include/android/KeyCodes.h
在按键定义项增加AKEYCODE_SMS = 220;

6.修改Java 键盘事件

framework/base/core/java/android/view/keyevent.java

/**
*@hide
*/
public static final int KEYCODE_SMS =220;

最后的按键为新增的
private static final int LAST_KEYCODE ==KEYCODE_SMS;

以上/**/注释的code是android 非开放API或变量定义的时候，需要添加Java Doc的识别，否则要运行make update-api才能build通过

如果是系统按键，修改framework/base/libs/ui/input.cpp
isSystemKey()增加case AKEYCODE_SMS:

7.修改XML文件描述符framework/base/core/res/res/values/attr.xml

8.增加测试验证log在android

framework\base\policy\src\com\android\internal\polidy\impl\phoneWindowManager.java
在interceptKeyBeforeDispatching()增加
if(keycode== KeyEvent.KEYCODE_SMS){
log.d(TAG, "interceptKeyTi KEYCODE_SMS
keyCode="+ keyCode + " down=" + down + " repeatCount=" + repeatCount + “ keyguardOn=” + keyguardOn + “ mHomePressed=” + mHomePressed + “ cancled=” + canceled)

9.可以抓log确认，或者增加测试APK检测

Kernal log:
<4>[253.828234]kpd: register = fffe ffff ffff ffff ff
<4>[253.828825]kpd: (pressed) HW keycode = 0
<4>[253.829348]kpd: report Linux keycode = 252

<4>[253.829857]kpd: save new keymap state
<4>[254.030814]kpd: register = ffff ffff ffff ffff ff
<4>[254.031405]kpd: (released) HW keycode = 0
<4>[254.031936]kpd: report Linux keycode = 252

<4>[254.032445]kpd: save new keymap state
Android log:
WindowManager: interceptKeyTq keycode=220
screenIsOn=true keyguardActive=false policyFlags = #2000000 down =false canceled = false
D WindowManager: interceptKeyTi keyCode=220
down=false repeatCount=0 keyguardOn=false mHomePressed=false canceled=false
D WindowManager: interceptKeyTi KEYCODE_SMS keyCode=220
down=false repeatCount=0 keyguardOn=false mHomePressed=false canceled=false

p.s.并不是所有的linux keycode framework都会支持处理，如果您需要增加很多按键，就可能超出256（如Touch Panel的手势识别会用到很到键）
inputreader.cpp的KeyboardInputMapper这个class的process函数会先判断是否是isKeyboardOrGamepadKey.这里面会对按键的大小进行判断，条件是：1.小于2722.大于3523.大于等于256且小于2724.大于等于288且小于320满足其一即可。否则会拦截掉，不会往inputDispatcher和phonewindowmanager.java走