ZMK固件中Charlieplex矩阵键盘中断失效问题分析

问题背景

在ZMK固件项目中，使用Charlieplex矩阵键盘时发现一个异常现象：尽管已经正确配置了中断引脚，键盘却仍然持续轮询矩阵状态，导致中断功能失效。这个问题会影响键盘的响应速度和功耗表现。

技术原理

Charlieplex矩阵是一种高效利用GPIO引脚驱动多个LED或检测多个按键的技术。在ZMK固件中，kscan_gpio_charlieplex驱动负责处理这种矩阵的扫描工作，支持两种工作模式：

1. 轮询模式：定期主动扫描矩阵状态
2. 中断模式：当按键状态变化时通过中断触发扫描

理想情况下，配置了中断引脚后，系统应该使用中断模式以提高效率。

问题根源分析

通过深入代码分析，发现问题出在驱动初始化阶段的条件判断逻辑上：

1. 在驱动初始化时，use_interrupt标志位被错误地设置为0，导致始终使用轮询模式
2. 根本原因是COND_POLL_AND_INTR宏的使用条件过于严格
3. 该宏要求同时存在使用轮询和中断的设备才会设置use_interrupt
4. 对于单一设备配置，这个条件永远无法满足

解决方案

经过技术分析，提出了以下改进方案：

1. 将条件判断从COND_POLL_AND_INTR改为COND_THIS_INTERRUPT
2. 新方案会独立判断每个设备的中断配置情况
3. 对于配置了中断引脚的设备，会正确启用中断模式
4. 对于未配置中断的设备，仍保持轮询模式

这种修改保持了原有功能的同时，解决了单一设备中断失效的问题。

技术影响

该修复带来的主要改进包括：

1. 正确支持中断模式，降低系统功耗
2. 提高按键响应速度
3. 保持向后兼容性，不影响现有配置
4. 优化资源利用率，减少不必要的轮询开销

实现验证

在实际硬件环境中，该修复方案已经得到验证：

1. 中断功能恢复正常工作
2. 系统稳定性良好
3. 功耗表现符合预期
4. 按键响应延迟显著降低

总结

这个案例展示了嵌入式系统中中断处理机制的重要性，以及在多条件判断时需要考虑各种边界情况。通过深入分析问题根源并针对性地修改条件判断逻辑，成功解决了Charlieplex矩阵键盘的中断失效问题，为ZMK固件的键盘驱动提供了更可靠的中断支持。