ZMK固件中HID通信协议的探索与实践

背景介绍

ZMK固件项目团队近期针对HID通信协议在Studio开发环境中的应用进行了深入探索。HID(Human Interface Device)作为人机交互设备的通用协议，在键盘固件开发中扮演着重要角色。团队需要验证HID协议在不同操作系统和传输方式下的兼容性表现，为后续开发决策提供依据。

测试环境搭建

测试团队构建了专门的验证分支，包含一个简单的WebHID应用用于测试。测试方法包括：

1. 从特定分支构建固件
2. 运行本地测试服务器运行测试应用
3. 在浏览器中访问测试页面并连接设备
4. 监控控制台日志以确认通信状态

在Linux系统上，还需要配置udev规则以允许用户直接访问HID设备，规则针对USB和BLE两种连接方式分别设置。

跨平台兼容性验证

测试覆盖了多个主流操作系统平台：

• Linux系统：通过WebHID和原生HID工具验证
• Windows系统：主要测试Edge和Chrome浏览器的WebHID支持
• macOS系统：验证Chrome浏览器和原生HID功能
• iPadOS和ChromeOS：作为移动端代表进行测试

测试同时考虑了USB和BLE两种物理连接方式，记录了各平台的特殊行为和限制。

发现的问题与挑战

在测试过程中，团队发现了几个关键问题：

1. 安全性问题：HID协议在某些平台(如Linux)上存在安全隐患，任何用户空间程序都可能读取HID报告，存在潜在的键盘记录风险。

2. 平台限制：特别是iOS/iPadOS系统对HID访问有严格限制，难以实现预期功能。

3. 设备识别问题：Linux系统中无法基于报告描述符中的使用页面对单个输入设备应用udev规则，导致权限控制不够精细。

技术方案演进

基于测试结果，团队决定采用更灵活的通信方案：

1. 抽象传输层：设计可适配多种底层传输协议的抽象层
2. 支持多种传输方式：
   • USB CDC ACM串行通信
   • 自定义GATT服务实现BLE串行通信
   • 保留未来支持原始HID协议的扩展能力
3. RPC工作流：在传输层之上实现统一的远程过程调用机制

这种设计既解决了当前平台兼容性问题，又为未来技术演进保留了空间。

结论与展望

通过本次验证，ZMK团队确认了HID协议在实际应用中的局限性，并提出了更完善的解决方案。新的通信架构将显著提升Studio开发环境的跨平台兼容性和安全性。团队将继续完善RPC协议细节，为开发者提供更稳定、安全的开发体验。

这种基于实际测试结果进行架构演进的方法，体现了ZMK项目对工程质量的重视和对开发者体验的关注，为开源固件开发树立了良好典范。