DeskHop项目鼠标速度配置问题解析与解决方案

问题背景

在DeskHop项目（一个允许用户在两台计算机间共享键盘鼠标的开源硬件项目）的实际使用中，用户报告了一个关于鼠标移动速度的配置问题。用户在使用Linux双屏桌面（板A）和Linux手机桌面（板B）时，发现尽管在user_config.h中设置了不同的X/Y轴速度因子（MOUSE_SPEED_A_FACTOR_X/Y和MOUSE_SPEED_B_FACTOR_X/Y），但实际鼠标行为与预期不符。

技术分析

鼠标速度配置机制

DeskHop项目通过以下配置参数控制不同输出端口的鼠标速度：

/* 板A输出值 */
#define MOUSE_SPEED_A_FACTOR_X 1
#define MOUSE_SPEED_A_FACTOR_Y 128

/* 板B输出值 */
#define MOUSE_SPEED_B_FACTOR_X 128
#define MOUSE_SPEED_B_FACTOR_Y 1

这些参数理论上应该独立控制每个输出端口在X轴和Y轴上的鼠标移动速度。然而，用户遇到的实际现象是：

1. 在双屏桌面（板A）上，水平移动过快而垂直移动过慢
2. 在手机桌面（板B）上，水平移动仍可更快，垂直移动正常

绝对坐标系统工作原理

DeskHop使用一个抽象的绝对坐标系统（0,0到32767,32767），这个空间会映射到实际的物理屏幕分辨率。这种映射由操作系统完成，理论上不应因屏幕分辨率不同而导致X/Y轴速度差异。

问题根源

经过排查，发现问题的根本原因在于配置信息的持久化存储。当用户从预编译镜像切换到自行编译的固件时，旧的配置信息可能未被正确清除，导致新配置无法生效。

解决方案

重置闪存配置

最有效的解决方法是执行配置重置操作：

1. 同时按下键盘的Right Shift + F12 + D组合键
2. 这将清除所有持久化的配置信息
3. 系统将恢复到user_config.h中定义的最新配置

配置建议

对于需要不同X/Y轴速度的场景，建议：

1. 根据屏幕宽高比设置速度因子比例
2. 例如，如果屏幕宽度是高度的3倍，可以设置X速度为Y速度的1/3
3. 对于手机等特殊屏幕，可尝试8(Y)和16(X)的比例

最佳实践

1. 固件升级流程：在切换不同版本固件（特别是从预编译切换到自行编译）时，建议先执行配置重置
2. 参数调优：从保守值开始（如10-20范围），逐步调整到理想速度
3. 隔离器检查：确认数字隔离器工作正常（LED会来回闪烁表示正常）
4. 配置验证：修改user_config.h后，确保重新编译并完整烧录固件

总结

DeskHop项目的鼠标速度配置问题通常源于配置信息的持久化存储机制。通过理解其绝对坐标系统的工作原理和掌握配置重置方法，用户可以有效地解决此类问题。对于特殊屏幕比例的设备，建议根据实际宽高比调整速度因子，而非使用极端值（如1和128），以获得更平滑的鼠标体验。