By Toradex 胡珊逢

1). 简介

触摸屏，无论是电阻式还是电容式，在嵌入式领域有着广泛的使用。配合设计优秀的 GUI，能够给用户带来很好的体验。很多时候，触摸屏在使用之前都需要进行校准，并且当外界的温度发生变化时，可能需要重新校准。对于电容屏还会受到静电的干扰。因此在工业设备上，为了保证输入的准确性，矩阵键盘仍被广泛地使用。

控制器通过轮询矩阵键盘的行列GPIO获取按键的情况。Linux 是一种多任务非实时操作系统，其他任务的执行会影响到矩阵键盘轮询，从而导致按键识别出现错误。本文所演示的嵌入式平台基于NXP iMX6 SoC，带有一个键盘控制器KPP，除了能够实现轮询矩阵键盘外，还支持自带上拉电阻、消抖、多按键识别、长按等功能。用户可以直接GPIO连接到按键上，无需添加电阻和二极管。如果使用二极管，还可以支持更多的按键组合。默认的KPP 最大支持8*8矩阵键盘。

Toradex 的 iMX6计算机模块，根据不同的系列支持部分按键，Colibri iMX6 为 5*5，Apalis iMX6为7*6。下面我们将以Colibri iMX6 Linux 4.1.41为例，介绍矩阵键盘的应用。

本文所演示的平台来自于Toradex Colibri iMX6嵌入式平台，其支持的最大矩阵键盘为5*5，而Toradex另一个产品系列Apalis系列则最大支持7*6。

2). 准备

a).Colibri iMX6 ARM核心版配合Colibri Evaluation Board载板，连接调试串口到开发主机，具体操作方法可以参考这里。

b).Colibri iMX6操作系统使用Toradex Linux Release V2.7b3，下载和更新方法请参考这里。

3). 配置KPP驱动并测试

a). 默认配置下，KPP 驱动并没有开启，需要修改imx6dl-colibri-eval-v3.dts和imx6qdl-colibri.dtsi device tree 文件。你可以直接使用下面的补丁，修改矩阵键盘的配置。

ftp://ftp.toradex.cn/Documents/ApplicationNote/resources/matrix_keypad.patch

b). 然后重新生成dtb文件，并更新到Colibri iMX6后重启。

--------------------------------

$ make imx6dl-colibri-eval-v3.dtb

--------------------------------

c). 在启动日志中可以看到 KPP 驱动被加载

--------------------------------

root@colibri-imx6:/dev/input# dmesg|grepkpp

[    1.551426] input: 20b8000.kpp as /devices/soc0/soc/2000000.aips-bus/20b8000.kpp/input/input0

--------------------------------

d). Linux输入设备识别KPP

--------------------------------

root@colibri-imx6:~# xinput

? Virtual core pointer                           id=2 [master pointer  (3)]

?? Virtual core XTEST pointer                  id=4 [slave  pointer  (2)]

??stmpe-ts     id=8 [slave  pointer  (2)]

? Virtual core keyboard                         id=3 [master keyboard (2)]

? Virtual core XTEST keyboard                    id=5 [slave  keyboard (3)]

?gpio-keys                               id=6 [slave  keyboard (3)]

?20b8000.kpp         id=7 [slave  keyboard (3)]

--------------------------------

e). 根据在 device tree 中的GPIO 配置，短接任一对 ROW 和 KEY 的引脚，即可模拟按键。

--------------------------------

pinctrl_kpp: kppgrp {

fsl,pins = <

                 MX6QDL_PAD_KEY_ROW2__KEY_ROW2 0x1b010      /*SODIMM 186*/

                 MX6QDL_PAD_KEY_ROW4__KEY_ROW4 0x1b010     /*SODIMM188*/

                 MX6QDL_PAD_CSI0_DAT5__KEY_ROW5 0x1b010      /*SODIMM155*/

                 MX6QDL_PAD_GPIO_2__KEY_ROW6 0x1b010             /*SODIMM180*/

                 MX6QDL_PAD_GPIO_5__KEY_ROW7 0x1b010/*SODIMM176*/

                 MX6QDL_PAD_KEY_COL2__KEY_COL2 0x110b0/*SODIMM184*/

                 MX6QDL_PAD_KEY_COL4__KEY_COL4 0x110b0/*SODIMM178*/

                 MX6QDL_PAD_GPIO_19__KEY_COL5 0x110b0/*SODIMM168*/

                 MX6QDL_PAD_CSI0_DAT6__KEY_COL6 0x110b0/*SODIMM157*/

                 MX6QDL_PAD_GPIO_4__KEY_COL7 0x110b0/*SODIMM174*/

>;

--------------------------------

f). 通过evtest命令，查看按下的键值，以及是否属于长按等信息。

--------------------------------

root@colibri-imx6:~# evtest

No device specified, trying to scan all of /dev/input/event*

Available devices:

/dev/input/event0:      20b8000.kpp

/dev/input/event1:      stmpe-ts

/dev/input/event2:      gpio-keys

Select the device event number [0-2]: 0

Input driver version is 1.0.1

Input device ID: bus 0x19 vendor 0x0 product 0x0 version 0x0

Input device name: "20b8000.kpp"

......

Testing ... (interrupt to exit)

Event: time 1502961213.623148, type 4 (EV_MSC), code 4 (MSC_SCAN), value 12

Event: time 1502961213.623148, type 1 (EV_KEY), code 2 (KEY_1), value 1

Event: time 1502961213.623148, -------------- SYN_REPORT ------------

Event: time 1502961213.873096, type 1 (EV_KEY), code 2 (KEY_1), value 2

Event: time 1502961213.873096, -------------- SYN_REPORT ------------

Event: time 1502961213.913117, type 1 (EV_KEY), code 2 (KEY_1), value 2

Event: time 1502961213.913117, -------------- SYN_REPORT ------------

Event: time 1502961213.953088, type 1 (EV_KEY), code 2 (KEY_1), value 2

Event: time 1502961213.953088, -------------- SYN_REPORT ------------

Event: time 1502961213.963156, type 4 (EV_MSC), code 4 (MSC_SCAN), value 12

Event: time 1502961213.963156, type 1 (EV_KEY), code 2 (KEY_1), value 0

--------------------------------

4). KPP应用程序开发示例

a). 在应用程序中，用structinput_event读取按键的信息。

--------------------------------

structinput_event {

structtimeval time;

__u16 type;//类型

__u16 code;//键值

__s32 value;//按下还是释放

};

--------------------------------

b). 具体请参考下面的源码

ftp://ftp.toradex.cn/Documents/ApplicationNote/resources/maxtrix_keypad_test.c

// input_event中读取按下键值以及按下、保持、释放动作。

--------------------------------

root@colibri-imx6:~# ./maxtrix_keypad_test

25 keys.

Press any key.

Key press

Code: 7

Key release

Code: 7

Key press

Code: 7

Key hold

Code: 7

Key hold

Code: 7

Key hold

Code: 7

Key hold

Code: 7

Key hold

Code: 7

Key release

Code: 7

--------------------------------

5). 总结

KPP 还具有其他功能，利于识别组合键、消除 ghost key等，矩阵键盘电路也需要做一些修改，如使用二极管，具体的参考IMX6SDLRM文档中Chapter 39Keypad Port (KPP)章节。