以下是 MTK 平台 Keypad（键盘）配置的中文详解及操作指南：

一、配置核心文件

1. dts 文件

   • 路径：kernel-4.19/arch/arm/boot/dts/{project_name}.dts
   • 配置位置：&keypad 节点

     &keypad {
     compatible = "mediatek,mt6577-keypad";
     keypad,rows = <4>;
     keypad,columns = <4>;
     debounce-time = <20>;    /* 消抖时间 (ms) */
     key-map = <
        115 114 139 0      /* ROW0: KEY_VOLUMEUP, KEY_VOLUMEDOWN, ... */
        158 0   0   0      /* ROW1: KEY_BACK */
        0   0   0   0
        0   0   0   0
     >;
     status = "okay";
     };

2. DCT 工具 (for legacy platforms)

   • 路径：mediatek/source/dct/DrvGen.exe
   • 文件：{project}.dws → Keypad 标签页
     • 设置行数 (ROW)、列数 (COL)
     • 映射每个按键的 GPIO引脚 和 键值 (Key Code)

二、关键参数说明

三、键值映射规则

• 矩阵位置映射：
  key-map 数据按 行 顺序排列，每个位置对应 键盘码 (Key Code)。

  key-map = <
    KEY_VOLUP  KEY_VOLDOWN  KEY_POWER  0
    KEY_HOME   0            0          0
    ...
  >;

  对应硬件矩阵：

  ROW0: KEY_VOLUP (COL0), KEY_VOLDOWN (COL1), ...
  ROW1: KEY_HOME (COL0), ...

• 常用键值（Linux 标准）：

  KEY_HOME    102  // Home键
  KEY_BACK    158  // 返回键
  KEY_VOLUP   115  // 音量+
  KEY_VOLDOWN 114  // 音量-
  KEY_POWER   116  // 电源键

四、GPIO 引脚配置

在 dts 或 dws 中需定义：

• 所有 ROW/COL GPIO 设置为 GPIO 输入模式。
• 添加 GPIO 内部上拉（避免悬空干扰）：

  &pio {
    kpd_default: keypad_default {
        pins_cmd_dat {
            pinmux = <
                PINMUX_GPIO0__FUNC_GPIO0  /* ROW0 */
                PINMUX_GPIO1__FUNC_GPIO1  /* ROW1 */
                ...                       /* COL pins */
            >;
            input-enable;
            bias-pull-up;                /* 内部上拉 */
        };
    };
  };

五、调试与问题排查

1. 日志检查

   • 查看内核启动日志：
     dmesg | grep -i keypad
   • 确认驱动加载状态：status = "okay" 是否生效。

2. 按键无响应

   • 检查 GPIO 配置（是否错配为其他功能，如 I2C）。
   • 用万用表测量 按键触发时的电平变化（ROW/COL 短路）。

3. 按键错乱

   • 确认 key-map 顺序是否与硬件矩阵一致。
   • 检查 消抖时间（过小会导致连击，过大反应迟钝）。

4. 无法唤醒系统

   • 配置 wakeup-source 属性：

     &keypad {
      wakeup-source;
     };

   • 确认驱动中注册了 wakeup 事件。

六、高级配置（特殊需求）

1. 自定义扫描频率
   修改驱动中的扫描间隔（需修改内核代码）：

   // kernel-4.19/drivers/input/keyboard/mtk_pmic_keys.c
   #define SCAN_INTERVAL 20 // 修改扫描时间 (ms)

2. 多语言键值映射
   在 Android KeyLayout 文件中适配不同键盘布局：
   /system/usr/keylayout/Generic.kl

3. 组合键功能
   通过驱动检测 多个键同时按下，上报组合键值。

总结：
MTK Keypad 配置核心在于 矩阵行列定义 + GPIO绑定 + 键值映射表。通过 DTS/DWS 正确配置后，结合硬件电路验证信号即可完成调试。遇到异常时，优先检查 dmesg 日志和 GPIO 状态。