安卓Keylayout按键唤醒：WAKE/WAKE_DROPPED失效后的新方法

问题背景 #

早前通过修改/vendor/usr/keylayouts/下的.kl文件，给按键添加WAKE或WAKE_DROPPED标识就能实现音量键唤醒系统，比如：

# /vendor/usr/keylayouts/MyKeyboard.kl
key 115 VOLUME_UP WAKE

但这套方法现在已经失效：WAKE标识会被系统直接忽略，用validatekeymaps工具验证WAKE_DROPPED时还会报错：

> validatekeymaps MyKeyboard.kl
Expected key flag label, got 'WAKE_DROPPED'.

把音量键映射成POWER键虽然能唤醒系统，但会彻底破坏音量调节的原有功能，显然不是理想方案。

现代安卓设置按键唤醒的正确方法 #

从Android 10（API 29）开始，.kl文件里的唤醒标识已经被废弃，目前有两种主流实现方式：

1. 使用keymap文件（.km）配置 #

安卓现在推荐用.km格式的keymap文件替代旧的.kl文件，直接在文件中给目标按键添加wake属性即可：

key {
    code = VOLUME_UP;
    label = "VOLUME_UP";
    wake = true; // 开启唤醒功能
}

将这个文件放到/vendor/usr/keymaps/目录下，替换或配合原有.kl文件使用，重启设备后就能生效，同时不会影响按键的原有功能。

2. 设备树（DT）层面配置 #

如果是定制ROM或者需要硬件级别的唤醒设置，可以在设备树的GPIO按键节点中添加wakeup-source属性：

gpio_keys {
    compatible = "gpio-keys";
    volume_up {
        label = "volume_up";
        gpios = <&gpio 10 0>; // 替换为实际GPIO引脚
        linux,code = <KEY_VOLUMEUP>;
        wakeup-source; // 标记此按键为系统唤醒源
    };
};

这种方式优先级更高，无需修改用户空间的配置文件，适合底层定制场景。

WAKE_DROPPED的替代方案 #

WAKE_DROPPED已经被完全移除，不再是有效的配置项。如果你的需求是按键唤醒系统但不把事件传递给上层应用，可以用以下两种方式实现：

• 在keymap文件中同时添加wake和block属性：

  key {
      code = VOLUME_UP;
      label = "VOLUME_UP";
      wake = true;
      block = true; // 阻止按键事件传递到上层应用
  };
  

• 或者在系统输入事件处理服务中添加自定义规则，过滤该按键的事件上报，只保留唤醒功能。

内容的提问来源于stack exchange，提问作者Dennis