配置路线
键值变化路径:
ScanCode --> Keycode Lable --> KeyCode Layout --> KeyLable --> Keycode – > KeyEvent
文件映射路径:
*.dtsi --> input-event-codes.h --> *.kl --> InputEventLable.h --> kecodes.h --> PhoneWindowManager.java
一、获取Scancode
当一个红外遥控器的某个按键未适配时,有多种方法查看这个按键的scancode。
- 在控制台输入
logcat
查看log,如:
meson-ir fe084040.ir: scancode 76 undefined
meson-ir fe084040.ir: no valid key to handle
如果已经适配了就会显示如下信息:
RemoteIME: keycode: 20, realAction: false
RemoteIME: keycode: 20, realAction: true
- 在控制台输入
dmesg -c
:
[ 3195.358431] meson-ir fe084040.ir: scancode 76 undefined
[ 3195.358479] meson-ir fe084040.ir: no valid key to handle
输入之后再按下按键,然后再输入一次dmesg -c就会显示上面的内容,如果适配了这个按键则不会有任何显示
3. 在控制台输入echo 8 > /proc/sys/kernel/printk
略
可以看到我上面未定义的物理码值是76,转换成十六进制后是4c
二、获取Customcode
不同款式的遥控器有不同的用户码,使用cat /sys/devices/virtual/remote/amremote/customcode
命令进行查看遥控器用户码,在串口执行该命令后,按下遥控器的任意键,再次执行该命令就可以看到你使用这款遥控器的用户码了。我这款遥控器的用户码为0x7984
三、Scancode和Customcode的映射文件DTSI
path:common/arch/arm64/boot/dts/amlogic/meson-ir-map.dtsi
按照里面原本的内容的样子添加,注意customcode改成你的遥控器的,里面面的映射如下:
customcode = <0x7984>;
release_delay = <80>;
size = <31>; /*keymap size*/
keymap = <REMOTE_KEY(0x12, KEY_POWER)
REMOTE_KEY(0x06, KEY_HOME)
REMOTE_KEY(0x1A, KEY_BACK)
REMOTE_KEY(0x10, KEY_VOLUMEUP)
前面的这个十六进制数就是scancode的十六进制,当然我们也可以看遥控器的规格书,上面会直接标注好scancode
后面的KEY_XXX需要在linux-event-codes.h文件中定义。
Path: external/u-boot/include/dt-bindings/input/linux-event-codes.h
#define KEY_BACK 158 /* AC Back */
#define KEY_FORWARD 159 /* AC Forward */
这个文件中后面那一列的数字则会在.kl文件中定义
进行到这里的时候,使用getevent -l再按下按键就已经能有相应的反馈了。
四、kl文件
4.1 getevent -l
无论是蓝牙遥控器还是红外遥控器,都需要确定其使用的kl (KeyLayoutFile)文件。在安卓shell 环境(串口控制台)执行命令确认kl 文件:getevent -l
。
首先会显示当前适配的遥控器列表
add device 1: /dev/input/event1
name: "cec_input"
add device 2: /dev/input/event4
name: "ir_keypad"
add device 3: /dev/input/event5
name: "ir_keypad1"
add device 4: /dev/input/event3
name: "gpio_keypad"
add device 5: /dev/input/event2
name: "vad_keypad"
add device 6: /dev/input/event0
name: "input_btrcu"
add device 7: /dev/input/event6
name: "adc_keypad"
以上内容代表了适配了七套遥控器,名称分别是"cec_input" “ir_keypad” 等
下面我们按下遥控器的某一个按键会出现下面的内容
/dev/input/event4: EV_KEY KEY_RIGHT DOWN
/dev/input/event4: EV_SYN SYN_REPORT 00000000
/dev/input/event4: EV_KEY KEY_RIGHT UP
/dev/input/event4: EV_SYN SYN_REPORT 00000000
前两行表示按键被按下,后两行表示按键被释放
EV_SYN: 用作分隔事件的标记。 事件可以在时间或空间上分开,例如使用多点触控协议。
EV_KEY: 用于描述键盘,按钮或其他类似键的设备的状态更改。
根据这里显示显示的event4我们可以知道我们的遥控设备为"ir_keypad"
4.2 dumpsys input
在前面我们看到我们按下按键时相应的是event4,我们可以使用cat /proc/bus/input/devices查看我们系统中连接的输入设备的详细信息。
I: Bus=0010 Vendor=0001 Product=0001 Version=0100
N: Name="ir_keypad"
P: Phys=keypad/input0
S: Sysfs=/devices/platform/fe084040.ir/input/input4
U: Uniq=
H: Handlers=rfkill mouse0 event4
B: PROP=0
B: EV=7
B: KEY=ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff 0 0 70000 ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff fffffffe
B: REL=103
从我们之前监听到的按键事件我们可以看到处理该按键的事件是event4,这里我们对应上的设备名应该是 “ir_keypad”
然后在(串口控制台)执行命令 dumpsys input,可以根据所连接的遥控器的名称找到遥控器对应的kl文件。
根据这个IR遥控器设备ir_keypad的设备名,我们找到了下面这段内容:
ir_keypad
Classes: 0x00000029
Path: /dev/input/event4
Enabled: true
Descriptor: d2c52ff0f656fac4cd7b7a118d575e0109a9fe1c
Location: keypad/input0
ControllerNumber: 0
UniqueId:
Identifier: bus=0x0010, vendor=0x0001, product=0x0001, version=0x0100
KeyLayoutFile: /vendor/usr/keylayout/Vendor_0001_Product_0001.kl
KeyCharacterMapFile: /system/usr/keychars/Generic.kcm
ConfigurationFile:
HaveKeyboardLayoutOverlay: false
VideoDevice: <none>
可以看到这里所用到的Android层映射文件为/vendor/usr/keylayout/Vendor_0001_Product_0001.kl
(这里的usr对于不同项目是不一样的)
我这里是device/amlogic/common/products/mbox/Vendor_0001_Product_0001.kl
4.3 踩过的坑请注意
当我找到我的device/amlogic/common/products/mbox/
目录下之后发现有多个kl文件
按理说应该是Vendor_0001_Product_0001.kl才对,但是实际上使用的却是Vendor_0001_Product_0002.kl文件,经过多方排查发现是因为在编译的时候mk文件对他进行了改动:
path:device/amlogic/common/products/mbox/sc2/device.mk
#use tv remote layout for mbox if livetv is built
ifeq ($(TARGET_BUILD_LIVETV), true)
PRODUCT_COPY_FILES += \
device/amlogic/common/products/mbox/Vendor_0001_Product_0002.kl:$(TARGET_COPY_OUT_VENDOR)/usr/keylayout/Vendor_0001_Product_0001.kl
else
PRODUCT_COPY_FILES += \
device/amlogic/common/products/mbox/Vendor_0001_Product_0001.kl:$(TARGET_COPY_OUT_VENDOR)/usr/keylayout/Vendor_0001_Product_0001.kl
endif
这里由于变量TARGET_BUILD_LIVETV的值为true,所以将Vendor_0001_Product_0002.kl文件的内容拷贝到了Vendor_0001_Product_0001.kl里面,所以虽然用的是0001但是其实改动需要在0002中进行。
4.4 改动kl文件
patch: device/amlogic/common/products/mbox/Vendor_0001_Product_0002.kl
key 158 BACK
key 139 MENU
key 102 HOME
前面的值是DTSI中的值,后面的是有底层文件与之相对应的。
进行到这里,按键功能就已经生效了,一般做到这里也就可以了。
继续往下追查这个值是在KeyLabel文件中定义的
五、KeyLabel文件
- Path:
frameworks/native/include/input/InputEventLabels.h
- Content:
DEFINE_KEYCODE(BACK),
再往下就是Keycode值的对应
六、Keycode
包含以下三个文件:
- Native
- Path:
frameworks/native/include/android/keycodes.h
- Content:
- Path:
AKEYCODE_BACK = 4,
- Java
- Path:
frameworks/base/core/java/android/view/KeyEvent.java
- Content
- Path:
public static final int KEYCODE_BACK = 4;
- Res
- Path:
frameworks/base/core/res/res/values/attrs.xml
- Content:
- Path:
<enum name="KEYCODE_BACK" value="4" />
现在,当你使用logcat -s RemoteIME命令就能够看到控制台输出了keycode,这个值就和我们上面的值对应上了
七、KeyEvent
当按键传到 fromworks 我们只需要更改 KeyEvent.java 来完成最后的按键定义,之后就是到 PhoneWindowManager.java 来实现按键功能实现拦截或继续传递。
- Path:
frameworks/base/services/core/java/com/android/server/policy/PhoneWindowManager.java
- Content:
onKeyDowncase KeyEvent.KEYCODE_YOUR_PRIVATE_KEY: {
//do sthreturn true;
}
总之
一般情况下按照dtsi–>linux-event-codes.h–>kl 的顺序来改就可以了,如果还出现其他问题则继续查看。