ZMK固件中Corne分体键盘软关机问题的分析与解决

问题背景

在ZMK固件项目中，Corne分体键盘用户报告了一个关于软关机功能的不稳定现象。当用户尝试通过按键组合触发软关机时，右侧键盘有时会保持开启状态，而左侧键盘能够正常关机。这个问题最初在之前的issue中被部分解决，但依然存在偶发性故障。

问题分析

通过调试日志分析，技术人员发现当问题发生时：

1. 左侧键盘触发了soft_off行为，但右侧键盘没有接收到相应事件
2. 在正常工作情况下，两侧键盘都能正确接收关机指令
3. 关键区别在于事件触发时机 - 问题通常发生在按键释放时触发事件

深入分析表明，问题根源在于分体键盘的中央设备(central)可能在完成向周边设备(peripheral)发送关机请求前就自行关机了，导致通信中断。

解决方案

技术人员提出了一个巧妙的修复方案：

1. 在软关机行为触发前添加100毫秒的延迟
2. 仅对中央设备(非周边设备)应用这个延迟
3. 修改位于app/src/behaviors/behavior_soft_off.c文件中的相关代码

具体实现如下：

if (hold_time > config->hold_time_ms) {
    if (!IS_SPLIT_PERIPHERAL) {
        k_usleep(100000);
    }
    zmk_pm_soft_off();
} else {
    LOG_INF("Not triggering soft off: held for %d and hold time is %d", hold_time,
            config->hold_time_ms);
}

技术原理

这个解决方案基于以下技术考量：

1. 分体键盘通信机制：ZMK的分体键盘通过蓝牙连接，中央设备负责协调两侧键盘的行为
2. 事件时序问题：添加延迟确保了中央设备有足够时间将关机指令传播到周边设备
3. 选择性延迟：只对中央设备添加延迟，避免周边设备不必要的等待
4. 时间窗口：100毫秒的延迟是经过测试的合理值，既能保证通信完成，又不会造成明显的用户体验延迟

验证与优化

经过实际测试，该解决方案表现稳定。进一步的优化建议包括：

1. 将条件判断从!IS_SPLIT_PERIPHERAL改为更明确的中央设备检查
2. 考虑将延迟时间作为可配置参数，以适应不同硬件环境
3. 在文档中添加关于分体键盘软关机行为的说明

总结

这个案例展示了在嵌入式系统和分体设备设计中时序控制的重要性。通过添加合理的通信延迟，确保了分布式系统中关键指令的可靠传递。这种解决方案不仅适用于ZMK固件中的软关机功能，也为类似的分体设备同步问题提供了参考思路。