Skip to content

Instantly share code, notes, and snippets.

Show Gist options
  • Save SunRain/1745737 to your computer and use it in GitHub Desktop.
Save SunRain/1745737 to your computer and use it in GitHub Desktop.
android:添加usb键盘+按键布局和映射的修改
android下的按键布局和映射
这个笔记整理一下使用usb键盘遇到的问题,比如添加usb键盘的keylayout,添加按键,修改按键映射等。
本文参考了:
http://blog.csdn.net/kieven2008/archive/2011/03/26/6279975.aspx
http://blog.csdn.net/skdev/archive/2010/03/08/5355542.aspx
Android的用户输入系统,自下而上,分成如下部分:
1.驱动程序:/dev/input目录。负责report键值到上层。其中键值定义在input.h中;
2.根文件系统中,KeyLayout(按键布局)和KeyCharacterMap(按键字符映射):后缀名称分别为kl和kcm;如果使用usb全键盘,则使用/system/usr/keylayout/qwerty.kl.
3.EventHub: libui的一部分,实现了对驱动程序的控制。目录 android/frameworks/base/libs/ui/,读取RawEvent事件。
4.Java框架层的处理:有KeyInputDevice等类来处理EventHub传递上来的信息,这些信息通过RawInputEvent和KeyEvent来表示。
一般情况下,对于按键事件,以后者的形式传送给应用程序,而触摸屏和轨迹球事件以前者的形式转换形成MotionEvent事件传送给应用程序;
5.Android应用程序层:通过重载onKeyDown()和onkeyUp()等方法接收KeyEvent(按键事件),通过重载onTouchEvent()和onTrackballEvent()等方法接收MotionEvent(运动事件);
keyEvent的处理流程:
1、生成
存在这样一个线程,它不断地从driver读取Event,并把它放到RawEvent队列中。这个队列中的RawEvent既有按键,也有触摸、轨迹球等事件。
RawEvent队列中的每个RawEvent最后都会通过一系列转化,最终变为KeyEvent被发送给另外一个线程,即输入线程,也就是一个Activity的主线程。
2、传递
KeyEvent传递过程主要可以划分为三步:过滤器、View树、Activity
过滤器部分
主要对应着PhoneWindowManager.java中的interceptKeyTq和interceptKeyTi这两个方法。
它们的代码可以在frameworks/base/policy/base/phone/com/android/internal/policy/impl/PhoneWindowManager.java中看到。
这两个过滤器最大的不同就是interceptKeyTq用于RawEvent,而interceptKeyTi用于KeyEvent。
在一个没有实体键盘的机器上,Power键会被interceptKeyTq这个过滤器吃掉用来调用关机对话框或者使机器休眠。而Home键会被interceptKeyTi这个过滤器吃掉,用来把当前Activity切换到后台并把桌面程序切换到前台。所以,应用程序在View和Activity的onKeyDown/Up中是监听不到这两个按键的。除了这两个键以外的按键,都有机会继续前进。接下来,KeyEvent会先经过interceptKeyTi过滤器。
如果这个过滤器不吃掉的话,就会继续前进,进入View树。如果没有被哪个View吃掉的话,最后进入到Activity的onKeyDown/Up方法中。
当一个KeyEvent经过上面的过程还没有被吃掉的话,系统就会利用它做一些定制的功能。比如音量键被系统用来调整声音,多媒体按键用来控制媒体播放,搜索键用来快速打开搜索功能,返回键用来退出当前Activity等。
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
如果你的键盘是全键盘(包括了ALT、SHIFT、CAPS_LOCK功能键),基本上用Android默认的键盘映射文件qwerty.kcm,qwerty.kl就可以了。
如果你需要添加新的按键,或者需要修改按键的映射,就需要修改这两个文件了。
添加新的键盘
比如支持usb键盘,需要导入keylayout.
file: frameworks/base/libs/ui/EventHub.cpp
int EventHub::open_device(const char *deviceName)
{
//.................
// find the .kl file we need for this device
const char* root = getenv("ANDROID_ROOT");
snprintf(keylayoutFilename, sizeof(keylayoutFilename),
"%s/usr/keylayout/%s.kl", root, tmpfn);
bool defaultKeymap = false;
if (access(keylayoutFilename, R_OK)) {
snprintf(keylayoutFilename, sizeof(keylayoutFilename),
"%s/usr/keylayout/%s", root, "qwerty.kl");
defaultKeymap = true;
}
device->layoutMap->load(keylayoutFilename);
}
*********问题:这里在导入keylayout文件的时候,是指定路径,通过后缀获取的,所以kl文件名字不重要???
比如使用usb键盘,添加一个按键,物理按键是F1,对应android上的功能是SEARCH:
1 按下物理按键后,驱动通过接口input_report_key向上层input子系统report一个按键SCANCODE:#define KEY_F159 (定义在内核input.h中)
2 查找static const KeycodeLabel KEYCODES[](在文件frameworks/base/include/ui/KeycodeLabels.h中),得知我们需要的功能键的KEYCODE是“SEARCH”
3 在文件/system/usr/keylayout/qwerty.kl中添加下面一行,
key 59 SEARCH
重新启动即可:
总结:android按键消息通过二次转换:
1 将驱动report上来的SCANCODE,通过文件qwerty.kl的映射,得到KEYCODE字串;
2 通过二维表static const KeycodeLabel KEYCODES[],将上面的字符串转换成android 需要的键值信息。
如果是输入键,还需要查询keymap,得到相应的字符。
相关文件:
key scancode定义:
文件:include/linux/input.h
......
#define KEY_SPACE 57
#define KEY_CAPSLOCK 58
#define KEY_F1 59
#define KEY_F2 60
#define KEY_F3 61
#define KEY_F4 62
#define KEY_F5 63
#define KEY_F6 64
#define KEY_F7 65
#define KEY_F8 66
#define KEY_F9 67
#define KEY_F10 68
........
KEYLAYOUT 按键布局
文件:/system/usr/keylayout/qwerty.kl
文件格式:
key SCANCODE KEYCODE [FLAGS...]
第一列:key
第二列: SCANCODE是一个整数,是驱动里面定义的,在文件
第三列: KEYCODE 是一个字串,定义在你描述的布局文件frameworks/base/include/ui/KeycodeLabels.h
另外可以设置相关的FLAGS:
SHIFT: 当按下,自动加上SHIFT键值
ALT:当按下,自动加上ALT
CAPS:当按下,自动带上CAPS大写
WAKE:当按下,当设备进入睡眠的时候,按下这个键将唤醒,而且发送消息给应用层。
WAKE_DROPPED:当按下,且设备正处于睡眠,设备被唤醒,但是不发送消息给应用层。
关于SCANCODE,也无需查找驱动代码。在字符界面下可以使用命令getevent获取按键的scan code:
# getevent
/ $ getevent
add device 1: /dev/input/event4
name: "Fake Touchscreen"
add device 2: /dev/input/event0
name: "gpio-keys"
add device 3: /dev/input/event3
name: "Dell Dell USB Keyboard"
add device 4: /dev/input/event2
name: "PixArt USB Optical Mouse"
add device 5: /dev/input/event1
name: "twl4030_pwrbutton"
支持5种输入设备:触摸屏 GPIOkey usb键盘 usb鼠标 powerkey
点击usb键盘的按键“A”的打印信息:
/dev/input/event3: 0004 0004 00070004
/dev/input/event3: 0001 001e 00000001
/dev/input/event3: 0000 0000 00000000
/dev/input/event3: 0004 0004 00070004
/dev/input/event3: 0001 001e 00000000
/dev/input/event3: 0000 0000 00000000
按下一个GPIO按键的打印信息:
/dev/input/event0: 0001 0114 00000001
/dev/input/event0: 0000 0000 00000000
/dev/input/event0: 0001 0114 00000000
/dev/input/event0: 0000 0000 00000000
其中:
0001实际上是输入设备的类型。(USB键盘上的 0004 0004 00070004不太清楚是什么信息,大概是这个USB设备的各种ID信息吧)
0114是按键的SCANCODE,
00000001和00000000分别是按下和抬起的附加信息。
此文件部分内容如下:
.....
key 30 A
key 31 S
key 32 D
key 33 F
key 34 G
key 35 H
key 36 J
key 79 1
key 80 2
key 81 3
key 96 ENTER
key 69 NUM
key 56 ALT_LEFT
key 100 ALT_RIGHT
key 1 POWER
key 58 NUM
key 111 MUTE
key 1 BACK
key 59 SEARCH
.....
按键码:KEYCODE
frameworks/base/include/ui/KeycodeLabels.h
struct KeycodeLabel {
const char *literal; // KEYCODE
int value; //用于在keymap索引字符的value
};
static const KeycodeLabel KEYCODES[] = {
{ "SOFT_LEFT", 1 },
{ "SOFT_RIGHT", 2 },
{ "HOME", 3 },
{ "BACK", 4 },
{ "CALL", 5 },
{ "ENDCALL", 6 },
{ "0", 7 },
{ "1", 8 },
{ "2", 9 },
{ "3", 10 },
{ "4", 11 },
{ "A", 29 },
{ "B", 30 },
{ "C", 31 },
{ "SEARCH", 84 },
.............
}
字符映射
键字符映射位于:/system/usr/keychars/qwerty.kcm.bin,源文件是android/device/ti/omap3evm/qwerty.kcm
首先,需要理解kcm文件的格式:
# keycode display number base caps fn caps_fn
keycode:由kernel层发出,经*.kl键盘映射文件得到keycode;
base:META_KEY没有被激活时的状态,即MetaState==0时映射的字符;
caps:毫无疑问,是SHIFT或CAPS_LOCK被激活时的状态,此时MetaState==1时,映射的字符;
fn:ALT被激活,对应MetaState==2时映射的字符;
caps_fn:ALT,SHIFT或CAPS_LOCK同时被激活时映射的字符;此时MetaState==3;通过这种方式,实现了一键对应多个字符的输出,
How To修改字符映射:
比如现在的字符映射,is_shitf时按下“,”,映射的字符是“;”,见下面这行:
COMMA ',' ',' ',' ';' ';' '|'
但在usb全键盘里面,这里应该是字符“<”,所以修改这里即可。
注:META Keys:就是ALT、SHIFT、CAPS_LOCK。
[type=QWERTY]
# keycode display number base caps fn caps_fn
A 'A' '2' 'a' 'A' '#' 0x00
B 'B' '2' 'b' 'B' '<' 0x00
C 'C' '2' 'c' 'C' '9' 0x00E7
D 'D' '3' 'd' 'D' '5' 0x00
E 'E' '3' 'e' 'E' '2' 0x0301
F 'F' '3' 'f' 'F' '6' 0x00A5
G 'G' '4' 'g' 'G' '-' '_'
H 'H' '4' 'h' 'H' '[' '{'
I 'I' '4' 'i' 'I' '$' 0x0302
J 'J' '5' 'j' 'J' ']' '}'
K 'K' '5' 'k' 'K' '"' '~'
L 'L' '5' 'l' 'L' ''' '`'
M 'M' '6' 'm' 'M' '!' 0x00
N 'N' '6' 'n' 'N' '>' 0x0303
O 'O' '6' 'o' 'O' '(' 0x00
P 'P' '7' 'p' 'P' ')' 0x00
Q 'Q' '7' 'q' 'Q' '*' 0x0300
R 'R' '7' 'r' 'R' '3' 0x20AC
S 'S' '7' 's' 'S' '4' 0x00DF
T 'T' '8' 't' 'T' '+' 0x00A3
U 'U' '8' 'u' 'U' '&' 0x0308
V 'V' '8' 'v' 'V' '=' '^'
W 'W' '9' 'w' 'W' '1' 0x00
X 'X' '9' 'x' 'X' '8' 0xEF00
Y 'Y' '9' 'y' 'Y' '%' 0x00A1
Z 'Z' '9' 'z' 'Z' '7' 0x00
# on pc keyboards
COMMA ',' ',' ',' ';' ';' '|'
PERIOD '.' '.' '.' ':' ':' 0x2026
AT '@' '0' '@' '0' '0' 0x2022
SLASH '/' '/' '/' '?' '?' '\'
SPACE 0x20 0x20 0x20 0x20 0xEF01 0xEF01
ENTER 0xa 0xa 0xa 0xa 0xa 0xa
TAB 0x9 0x9 0x9 0x9 0x9 0x9
0 '0' '0' '0' ')' ')' ')'
1 '1' '1' '1' '!' '!' '!'
2 '2' '2' '2' '@' '@' '@'
3 '3' '3' '3' '#' '#' '#'
4 '4' '4' '4' '$' '$' '$'
5 '5' '5' '5' '%' '%' '%'
6 '6' '6' '6' '^' '^' '^'
7 '7' '7' '7' '&' '&' '&'
8 '8' '8' '8' '*' '*' '*'
9 '9' '9' '9' '(' '(' '('
GRAVE '`' '`' '`' '~' '`' '~'
MINUS '-' '-' '-' '_' '-' '_'
EQUALS '=' '=' '=' '+' '=' '+'
LEFT_BRACKET '[' '[' '[' '{' '[' '{'
RIGHT_BRACKET ']' ']' ']' '}' ']' '}'
BACKSLASH '\' '\' '\' '|' '\' '|'
SEMICOLON ';' ';' ';' ':' ';' ':'
APOSTROPHE ''' ''' ''' '"' ''' '"'
STAR '*' '*' '*' '*' '*' '*'
POUND '#' '#' '#' '#' '#' '#'
PLUS '+' '+' '+' '+' '+' '+'
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment