ZMK固件中kscan-composite驱动唤醒功能问题解析

问题背景

在ZMK固件开发过程中，开发者发现使用kscan-composite驱动合并多个键盘扫描驱动时，设备无法从深度睡眠状态被按键唤醒。该问题表现为：当使用kscan-composite组合kscan-gpio-matrix和kscan-gpio-direct驱动时，虽然各子驱动都配置了唤醒源属性，但按键无法唤醒处于深度睡眠的设备。

技术分析

kscan-composite驱动的主要功能是整合多个子驱动的键盘扫描事件，并管理它们的启用/禁用状态。问题可能源于以下几个方面：

1. 唤醒事件传递机制：子驱动产生的唤醒事件可能没有被正确传递给复合驱动
2. 电源管理状态：设备进入深度睡眠时，子驱动可能被错误地禁用
3. 属性继承：复合驱动可能没有正确处理子驱动的唤醒源属性

解决方案

通过分析问题，开发者提出了修复方案，主要涉及以下几个方面：

1. 唤醒源属性处理：确保复合驱动正确识别和处理子驱动的唤醒源配置
2. 电源管理集成：在设备电源状态变化时，正确维护子驱动的状态
3. 事件传递机制：保证子驱动的唤醒事件能够通过复合驱动传递到系统

实际应用验证

在实际应用中，开发者验证了修复方案的有效性。测试结果表明：

• 当使用修复后的kscan-composite驱动时，设备能够正常从深度睡眠状态被按键唤醒
• 唤醒功能与直接使用单个kscan-gpio-matrix或kscan-gpio-direct驱动时的表现一致
• 复合驱动的所有功能（包括按键扫描和事件处理）均正常工作

配置注意事项

为确保kscan-composite驱动的唤醒功能正常工作，开发者需要注意以下配置要点：

1. 必须在设备树中为复合驱动和所有子驱动都明确设置wakeup-source属性
2. 各子驱动的GPIO配置需要符合唤醒源的要求（如正确的上下拉设置）
3. 复合驱动的行列配置需要与子驱动匹配

总结

kscan-composite驱动的唤醒功能问题通过合理的修复方案得到了解决。这一改进使得开发者能够安全地使用复合键盘扫描驱动，同时保持设备的低功耗特性。对于需要组合多种键盘扫描方式的ZMK项目，这提供了更大的设计灵活性和可靠性。