基于Wio Terminal的无线空中鼠标：IMU传感器融合与蓝牙HID实战

1. 项目缘起当开发板不再满足于“开发”作为一名嵌入式开发者和硬件爱好者我手头总有几个“吃灰”的开发板。Wio Terminal 就是其中之一它集成了屏幕、按键、传感器和无线模块功能强大但完成几个示例项目后它就静静地躺在角落了。直到有一天我在调试一台没有外接鼠标的迷你主机或者更常见的是在沙发上用电视盒子浏览网页时那种对“无线空中鼠标”的渴望变得无比强烈。市面上当然有现成的演示空中鼠标或PPT翻页笔的方案但要么功能单一要么价格不菲。看着手边的 Wio Terminal一个想法冒了出来它自带三轴加速度计和陀螺仪IMU、多个按键、甚至还有蓝牙这不就是一个完美的“鼠标”硬件原型吗为什么不能把它变成一个完全可定制、可编程的无线鼠标呢这个想法不仅仅是为了“废物利用”更是对嵌入式设备功能边界的一次有趣探索。它涉及到传感器数据采集、姿态解算、数据滤波、HID人机接口设备协议模拟以及无线通信是一个综合性极强的实战项目。于是我决定动手将 Wio Terminal 变身为一个功能齐全的无线鼠标。这个过程不仅让我对IMU数据处理和HID协议有了更深的理解还踩了不少坑积累了一套从数据“毛刺”到平滑光标移动的完整解决方案。下面我就把这次改造的详细过程、核心原理和避坑经验分享出来。2. 硬件核心Wio Terminal 的“鼠标”潜质解剖要把 Wio Terminal 变成鼠标我们首先得清楚它身上有哪些“零件”可供我们驱使。这不是简单的软件模拟而是硬件能力的重新定义。2.1 传感器部分姿态感知的基石Wio Terminal 板载了 LIS3DHTR 三轴加速度计和 ICM-42607 六轴IMU包含三轴陀螺仪和三轴加速度计。这是我们实现空中鼠标或姿态控制鼠标的核心。加速度计测量的是物体在三个轴向上受到的“力”包括重力。当设备静止时加速度计主要测量的是重力加速度在各个轴上的分量我们可以借此计算出设备相对于水平面的倾斜角度俯仰和横滚。但用它来直接计算位移或速度会非常不准确因为它对任何微小的震动都非常敏感积分后会产生巨大的漂移。陀螺仪测量的是物体绕三个轴旋转的角速度。它对旋转运动非常敏感可以通过积分角速度来得到角度变化。但陀螺仪也存在漂移问题长时间积分后即使设备静止计算出的角度也会慢慢偏离真实值。所以单独使用任一种传感器都无法获得稳定、可靠的姿态数据。这正是我们项目中需要解决的首要算法问题。2.2 输入设备超越普通鼠标的交互维度一个标准的鼠标有左键、右键、滚轮。Wio Terminal 在这方面可谓“豪华”物理按键正面有三个可编程按键侧面还有两个。这足以映射左键、右键、中键甚至还能多出两个自定义键如前进、后退。五向摇杆这简直是一个“摇杆按键”的复合体。除了可以模拟鼠标移动通过摇杆方向其按下动作本身就可以作为一个独立的按键使用例如映射为DPI切换。光传感器与红外发射器虽然不直接用于鼠标功能但可以开发一些智能交互比如检测到用户拿起设备时自动唤醒鼠标模式或者用作简单的遥控器。屏幕这是最大的亮点。我们可以用它来实时显示鼠标电量、连接状态、当前DPI灵敏度、甚至是一个小小的光标预览。这是任何商业鼠标都无法提供的可视化反馈。2.3 无线连接摆脱线缆的束缚Wio Terminal 集成了 Realtek RTL8720DN 芯片同时支持 WiFi 和蓝牙 5.0。对于鼠标应用蓝牙是更理想的选择因为它功耗相对较低且与电脑、手机、平板等设备的兼容性极好。我们需要让 Wio Terminal 通过蓝牙模拟成一个标准的 HID 鼠标设备这样无需安装任何驱动主机就能即连即用。2.4 供电与续航Wio Terminal 自带锂离子电池充电管理电路和一块 200mAh 的电池。对于持续运行的鼠标来说这块电池偏小。一个重要的改造点或使用建议就是外接一块更大容量的电池通过其 Grove 接口或直接焊接并优化代码以进入低功耗模式例如通过加速度计检测静止状态自动进入睡眠。3. 核心算法从传感器数据到稳定光标移动这是整个项目的技术心脏。如何把原始的、充满噪声的 IMU 数据转换成稳定、跟手的光标移动指令直接读取原始数据并映射是行不通的你会得到一个疯狂跳动、完全无法控制的光标。3.1 数据采集与预处理首先我们需要以较高的频率例如100Hz读取加速度计和陀螺仪的原始数据。这些数据通常带有高频噪声和固定的零点漂移。第一步是进行简单的软件滤波比如一个移动平均滤波器来平滑数据。// 示例简单的移动平均滤波伪代码 #define FILTER_SIZE 5 float accelXBuffer[FILTER_SIZE]; int bufferIndex 0; float applyLowPassFilter(float newValue, float *buffer) { buffer[bufferIndex] newValue; bufferIndex (bufferIndex 1) % FILTER_SIZE; float sum 0; for(int i0; iFILTER_SIZE; i) { sum buffer[i]; } return sum / FILTER_SIZE; }3.2 姿态解算互补滤波器的实战应用如前所述加速度计在静态时测角度准但动态时噪声大陀螺仪测动态旋转准但会漂移。互补滤波器Complementary Filter是一种巧妙且计算量小的融合算法它利用高频特性好的陀螺仪和低频特性好的加速度计取长补短。其核心思想可以理解为用陀螺仪积分得到的角度作为主体但用加速度计计算出的角度不断去“纠正”陀螺仪的长期漂移。公式通常如下当前估计角度 α * (上一刻估计角度 陀螺仪角速度 * Δt) (1 - α) * 加速度计角度其中α是一个介于0和1之间的滤波系数通常取0.98左右。Δt是采样时间间隔。(上一刻估计角度 陀螺仪角速度 * Δt)是陀螺仪的积分结果响应快但会漂移。加速度计角度是通过atan2(accelY, accelZ)等公式从加速度数据中计算出来的假设一个轴朝下在静态时非常准确但动态时噪声大。α接近1表示更信任陀螺仪高频(1-α)很小表示只用一点点加速度计的数据去修正低频漂移。在我的实现中我分别对俯仰角Pitch和横滚角Roll应用了互补滤波器。这样我就得到了一个相对稳定、响应及时的设备姿态角度。3.3 从姿态到光标位移映射策略得到稳定的俯仰和横滚角后如何映射到屏幕上的光标移动定义零位让 Wio Terminal 保持一个你感觉舒适的握持姿势按下某个校准键比如摇杆按下将此时的俯仰角和横滚角记录为pitch_zero和roll_zero。计算角度差在后续操作中实时计算当前角度与零位的差值delta_pitch current_pitch - pitch_zero,delta_roll current_roll - roll_zero。映射为移动速度这是关键。不要直接将角度差映射为光标位置那会使得光标移动非常生硬且难以控制。正确的方法是将角度差映射为光标的移动速度。当设备倾斜角度很小时光标缓慢移动倾斜角度越大光标移动速度成比例增加可以设置一个非线性曲线如指数关系让微调更精准大范围移动更快。这模拟了真实鼠标的“速度控制”模式而不是“位置控制”模式体验上自然得多。生成HID报告将计算出的 X 轴速度通常对应delta_roll和 Y 轴速度对应-delta_pitch注意屏幕Y轴方向与俯仰角方向通常相反填充到蓝牙 HID 鼠标报告数据结构中并发送给主机。4. 软件实现蓝牙HID与功能集成有了算法核心我们需要用代码将其实现并让电脑识别为鼠标。4.1 开发环境与库选择我使用 Arduino IDE 进行开发因为它对 Wio Terminal 的支持非常完善。关键库包括Seeed_Arduino_LIS3DHTR和Seeed_Arduino_ICM42607用于读取IMU数据。Seeed_Arduino_rpcUnified/Seeed_Arduino_rpcBLE或Adafruit_BluefruitSPI用于实现蓝牙 HID 功能。Wio Terminal 的官方库正在向 RPC 框架迁移但 Adafruit 的库在 HID 描述符定制上可能更灵活。我最终选择了基于 RPC 框架的 BLE HID 方案。4.2 模拟蓝牙HID设备要让电脑识别Wio Terminal 需要广播自己是一个 HID 设备并提供正确的 HID 描述符。描述符定义了设备类型鼠标、报告格式包含哪些数据按钮状态、X位移、Y位移、滚轮等。// 这是一个简化的HID鼠标报告描述符示例它定义了报告包含1字节按钮2字节X位移2字节Y位移1字节滚轮。 static const uint8_t hidReportDescriptor[] { 0x05, 0x01, // Usage Page (Generic Desktop) 0x09, 0x02, // Usage (Mouse) 0xA1, 0x01, // Collection (Application) 0x09, 0x01, // Usage (Pointer) 0xA1, 0x00, // Collection (Physical) // 按钮 8位 0x05, 0x09, // Usage Page (Button) 0x19, 0x01, // Usage Minimum (Button 1) 0x29, 0x08, // Usage Maximum (Button 8) 0x15, 0x00, // Logical Minimum (0) 0x25, 0x01, // Logical Maximum (1) 0x95, 0x08, // Report Count (8) 0x75, 0x01, // Report Size (1) 0x81, 0x02, // Input (Data,Var,Abs) // 填充 8位 0x95, 0x01, // Report Count (1) 0x75, 0x08, // Report Size (8) 0x81, 0x03, // Input (Const,Var,Abs) // X轴 16位 0x05, 0x01, // Usage Page (Generic Desktop) 0x09, 0x30, // Usage (X) 0x16, 0x01, 0x80, // Logical Minimum (-32767) 0x26, 0xFF, 0x7F, // Logical Maximum (32767) 0x75, 0x10, // Report Size (16) 0x95, 0x01, // Report Count (1) 0x81, 0x06, // Input (Data,Var,Rel) // Rel代表相对位移 // Y轴 16位 0x09, 0x31, // Usage (Y) 0x81, 0x06, // Input (Data,Var,Rel) // 滚轮 8位 0x09, 0x38, // Usage (Wheel) 0x15, 0x81, // Logical Minimum (-127) 0x25, 0x7F, // Logical Maximum (127) 0x75, 0x08, // Report Size (8) 0x95, 0x01, // Report Count (1) 0x81, 0x06, // Input (Data,Var,Rel) 0xC0, // End Collection 0xC0 // End Collection };在 Arduino 代码中我们需要初始化 BLE设置设备名称为“Wio Mouse”并添加 HID 服务。然后在主循环中不断执行传感器读取、数据处理最后将生成的 X/Y 速度值和按钮状态打包成一个 HID 报告通过BLEHID().mouseReport()类似的函数发送出去。4.3 按键与屏幕功能集成按键映射在loop()函数中检测各个按键和摇杆的按下状态将其转换为对应的鼠标按钮位MOUSE_LEFT,MOUSE_RIGHT,MOUSE_MIDDLE并填入 HID 报告。摇杆除了按下作为中键其 X/Y 方向读数可以作为一种备用或精确模式下的光标控制方式直接映射为相对位移。屏幕显示使用 TFT 库可以创建一个简单的界面显示电池图标通过读取模拟引脚电压估算、蓝牙连接状态、当前灵敏度档位等。这大大提升了产品的完成度和可交互性。5. 调优与避坑从“能用”到“好用”把基础功能跑通只是第一步让这个自制鼠标达到“好用”甚至“跟手”的程度需要大量的调优和问题解决。5.1 光标漂移与抖动处理这是最常见的问题。即使使用了互补滤波器在完全静止时光标可能仍会缓慢移动或轻微抖动。死区设置在角度差delta_pitch和delta_roll的绝对值小于一个很小的阈值如0.5度时直接将其视为0不产生任何光标移动。这能有效消除手部微小颤抖带来的影响。速度曲线优化不要使用简单的线性映射。尝试使用指数或自定义的 S 型曲线进行映射。在小角度区间映射出的速度增长很慢便于精细操作在大角度区间速度增长加快便于快速移动光标。这类似于游戏鼠标的灵敏度调节。传感器校准上电后让设备在水平桌面静止几秒钟自动采集这段时间内加速度计和陀螺仪的平均值作为零偏校准值并在后续计算中减去。这能消除硬件本身的微小偏差。5.2 蓝牙连接稳定与功耗连接间隔BLE 连接参数中的“连接间隔”决定了设备与主机通信的频率。间隔太短如7.5ms功耗高但响应快间隔太长如100ms会有明显延迟。对于鼠标20-30ms是一个不错的平衡点。需要在代码中尝试请求主机调整连接参数。功耗优化这是让电池续航更久的关键。实现一个“睡眠-唤醒”机制当加速度计连续一段时间检测到的运动幅度非常小设备静止时让 MCU 进入深度睡眠模式并关闭蓝牙广播。当检测到较大运动时用户拿起设备通过中断唤醒 MCU重新初始化蓝牙并快速连接。Wio Terminal 的 IMU 本身支持运动中断功能可以很好地利用这一点。5.3 握持体验与零位校准空中鼠标的握持姿势因人而异。固定的零位不适合所有人。动态零位我实现了一个长按某个按键如侧面按键进入“零位校准模式”的功能。此时屏幕提示“请保持舒适握姿并按下摇杆”用户调整好姿势后按下摇杆新的零位就被记录到EEPROM中下次开机自动加载。多种控制模式除了主要的“姿态控制模式”还可以通过按键切换为“摇杆控制模式”适合精细作图或“混合模式”摇杆控制移动姿态控制用于快速大范围移动。通过屏幕菜单可以方便地切换。5.4 应对不同操作系统的主机一个隐藏的坑是不同操作系统Windows, macOS, Linux对蓝牙 HID 报告的处理可能有细微差别。例如某些系统下滚轮速度的缩放比例不同。我的解决方案是在代码中增加一个“操作系统选择”菜单通过屏幕设置针对不同系统应用不同的速度乘数或报告格式微调确保体验一致。6. 功能扩展与进阶玩法当基础鼠标功能稳定后Wio Terminal 的潜力才真正开始展现。6.1 多媒体与快捷键控制多余的按键可以轻松映射为键盘媒体键如播放/暂停、音量加减、下一曲等。这需要 Wio Terminal 同时模拟 HID 键盘设备复合设备。在 HID 描述符中同时包含鼠标和键盘的描述符即可实现。这样它就成了一个集鼠标、演示笔、媒体控制器于一身的设备。6.2 手势识别利用 IMU 数据序列可以识别简单的手势。例如快速翻腕识别为“返回桌面”或“切换应用”的快捷键模拟 WinD 或 CmdTab。画圈识别为调节系统音量。双击机身通过检测特定的加速度脉冲模式实现鼠标“双击”或执行自定义命令。这需要引入简单的手势识别算法如动态时间规整 DTW 或更简单的阈值时序判断虽然会增加复杂度但可玩性极高。6.3 与Home Assistant等智能家居联动Wio Terminal 支持 WiFi。我们可以让它连接家庭网络在检测到特定手势或按下特定组合键时通过 MQTT 或 REST API 向 Home Assistant 发送指令从而控制灯光、空调等智能设备。这时它就从一个人机交互设备升级为了一个可穿戴的智能家居遥控器。6.4 开源与社区改进我将这个项目的核心代码和配置文件开源在了 GitHub 上。社区的力量是巨大的已经有朋友贡献了基于更复杂滤波算法如卡尔曼滤波的版本提供了更好的姿态稳定性也有人增加了对 USB HID 模式的支持通过 USB-C 线直连电脑作为有线鼠标使用零延迟。这种可扩展性正是开源硬件项目的魅力所在。将 Wio Terminal 改造成鼠标远不止是一个简单的“模拟输入设备”项目。它贯穿了传感器融合、实时滤波、无线通信、协议模拟、低功耗设计和用户体验优化等多个嵌入式开发的核心领域。过程中遇到的每一个问题——光标抖动、连接不稳定、功耗过高——都迫使你去深入理解底层原理而不是停留在调用API的层面。最终得到的不仅是一个独一无二的、完全按自己习惯定制的外设更是一套解决复杂系统问题的实战经验。如果你手头也有闲置的开发板不妨尝试一下这个项目它带给你的收获肯定会超过一个鼠标本身的价值。