1. 项目概述与核心思路拆解1.1 这个项目到底在做什么把一块 MPU6050 六轴传感器绑在手指或者手背上通过 ESP32-C3 读取姿态数据再用 BLE 把数据发给电脑或手机让设备把姿态变化识别成鼠标移动和点击——这就是这个 DIY 无线鼠标项目的全部核心。听起来像是把鼠标戴在手上实际上它解决的是一个很具体的痛点传统鼠标需要一块平整的桌面和相对固定的手腕姿势长时间使用之后手腕、肩膀的疲劳感非常明显。空中鼠标Air Mouse的思路就是把手部动作直接映射成光标移动彻底摆脱桌面依赖。这个项目适合几类人一是想入门 ESP32-C3 和 BLE 通信的嵌入式新手因为它的硬件链路非常短传感器到 MCU 再到无线没有复杂的电源管理和外设二是对 MPU6050 姿态解算感兴趣但一直停留在看数据手册阶段的人这个项目会逼着你真正去处理零偏、噪声和姿态融合三是想做一个能拿得出手的创意作品的人空中鼠标的演示效果比点个 LED 强太多。我先把整个系统的数据流理清楚后面所有细节都围绕这条链路展开MPU6050 采集加速度和角速度 → ESP32-C3 通过 I2C 读取原始数据 → 姿态解算得到角度/角速度 → 映射为鼠标位移和按键事件 → BLE HID 协议上报给主机 → 主机操作系统识别为标准鼠标这条链路里MPU6050 和 ESP32-C3 之间是 I2CESP32-C3 和主机之间是 BLE HID。两个环节各有各的坑后面会逐个拆。1.2 为什么选 MPU6050 而不是别的传感器MPU6050 是一颗很老的芯片2011 年左右就出来了但它到今天仍然是 DIY 圈子里最常用的六轴传感器原因很实在便宜模块价格通常在个位数人民币比 BMI160、ICM-42688 这些新芯片便宜一大截。资料多从寄存器手册到各种开源库几乎任何问题都能搜到答案。够用它集成了三轴加速度计和三轴陀螺仪做空中鼠标这种对精度要求不极端的场景完全够。自带 DMPMPU6050 内部有一个 Digital Motion Processor可以直接输出四元数省掉主控做姿态融合的算力。但它也有明显的短板必须提前说清楚MPU6050 的陀螺仪零偏随温度漂移比较明显长时间积分会累积误差加速度计噪声大静态下角度抖动可能有 ±0.5°。这两个问题决定了你不能直接拿原始数据去映射鼠标位移必须做滤波和死区处理。我试过直接用原始角速度乘系数当鼠标速度结果就是光标自己慢慢飘手不动它也在动体验非常糟糕。1.3 为什么选 ESP32-C3 而不是 ESP32 或 nRF52840ESP32-C3 是乐鑫的一颗 RISC-V 单核芯片支持 BLE 5.0价格比经典 ESP32 还低。选它的理由原生 BLEESP32-C3 的 BLE 协议栈在 Arduino 环境下通过ESP32 BLE Arduino库就能用HID 设备例程现成。单核 RISC-V功耗比双核 ESP32 低做电池供电的穿戴设备更合适。体积小模组尺寸小方便固定在手上。Arduino 生态esp32board package 直接支持不用折腾 ESP-IDF。有人会问为什么不选 nRF52840那颗芯片的 BLE 协议栈确实更成熟功耗也更低但它的 Arduino 支持相对弱开发门槛高而且价格贵。对于这个项目ESP32-C3 是性价比和开发效率的最佳平衡点。注意ESP32-C3 的 BLE 和 Wi-Fi 共用射频如果你同时开 Wi-Fi 和 BLE会有资源竞争。这个项目只用 BLE所以要把 Wi-Fi 完全关掉否则功耗和稳定性都会受影响。1.4 整体方案选型的三个关键决策在动手之前有三个决策会直接影响最终体验我先把结论摆出来后面再解释决策一姿态解算放在 MCU 还是主机放在 MCU。因为 BLE 的带宽有限如果传原始六轴数据每秒几百字节延迟和丢包都会很明显。在 MCU 里算好角度或角速度只传结果数据量能降到原来的十分之一。决策二用 MPU6050 的 DMP 还是自己写融合算法新手建议先用 DMP它直接输出四元数省事。但 DMP 的配置比较绕而且不同批次的模块 DMP 固件可能不一样。如果你想要更可控的行为自己写一个互补滤波Complementary Filter其实只要十几行代码效果对空中鼠标来说足够。决策三BLE 用 HID 还是自定义 GATT必须用 HID。因为 HID 是操作系统原生支持的标准协议电脑和手机不需要装任何驱动或 App 就能识别成鼠标。自定义 GATT 的话你得在主机端写一个接收程序实用性大打折扣。2. 硬件准备与 MPU6050 核心细节解析2.1 物料清单与接线方案这个项目的硬件非常精简一张表就能列清楚物料型号/规格数量备注主控ESP32-C3 开发板或模组1建议选带 USB 的开发板方便烧录传感器MPU6050 模块1常见 GY-521 模块即可电池3.7V 锂电池1容量 300~500mAh 足够充电模块TP40561带保护板的版本更安全开关微型拨动开关1用于断电导线杜邦线或漆包线若干穿戴场景建议用软线接线方面MPU6050 和 ESP32-C3 之间是标准 I2CMPU6050 的VCC接 ESP32-C3 的3V3MPU6050 的GND接 ESP32-C3 的GNDMPU6050 的SCL接 ESP32-C3 的GPIO6默认 I2C SCLMPU6050 的SDA接 ESP32-C3 的GPIO5默认 I2C SDAMPU6050 的INT接 ESP32-C3 的GPIO4如果用中断读取数据提示MPU6050 模块上通常有AD0引脚接地时 I2C 地址是0x68接 VCC 时是0x69。单个传感器接地即可。这里有个新手常踩的坑ESP32-C3 的 GPIO 编号和经典 ESP32 不一样默认 I2C 引脚是 GPIO5SDA和 GPIO6SCL不是 GPIO21/22。如果你照着 ESP32 的教程接线会发现 I2C 扫描不到设备。我第一次做的时候就因为这个卡了半小时最后用 I2C 扫描程序才定位到问题。2.2 MPU6050 的工作原理与关键寄存器MPU6050 内部有两组 MEMS 传感单元加速度计和陀螺仪。加速度计测量的是三轴线性加速度包含重力陀螺仪测量的是三轴角速度。两者结合才能完整描述物体的姿态。它的数据输出是 16 位有符号整数通过 I2C 读取。关键寄存器如下寄存器地址名称作用0x6BPWR_MGMT_1电源管理唤醒设备0x1BGYRO_CONFIG陀螺仪量程配置0x1CACCEL_CONFIG加速度计量程配置0x3B~0x40ACCEL_XOUT_H 等加速度计数据0x43~0x48GYRO_XOUT_H 等陀螺仪数据0x41~0x42TEMP_OUT温度数据量程的选择直接影响精度和范围。陀螺仪量程有 ±250、±500、±1000、±2000 °/s 四档加速度计有 ±2、±4、±8、±16 g 四档。做空中鼠标手部转动的角速度一般不会超过 300°/s所以陀螺仪选 ±500°/s 档比较合适灵敏度是 65.5 LSB/(°/s)。加速度计选 ±2g 档灵敏度 16384 LSB/g。为什么这么选因为量程越小灵敏度越高分辨率越好。但量程太小会饱和手快速挥动时数据会削顶。±500°/s 是一个经过验证的平衡点我实测手部正常操作不会超过这个范围。2.3 零偏校准绕不开的第一步MPU6050 出厂时的零偏bias是随机的也就是说设备静止时陀螺仪输出的不是 0而是一个几十到几百 LSB 的偏移值。如果不校准这个偏移会被积分成角度误差表现为光标持续漂移。校准的方法很简单设备静止放置连续采样 N 次通常 500~1000 次求平均值这个平均值就是零偏。之后每次读取数据都减去这个零偏。// 陀螺仪零偏校准示例 float gyroBiasX 0, gyroBiasY 0, gyroBiasZ 0; const int CALIB_SAMPLES 1000; void calibrateGyro() { long sumX 0, sumY 0, sumZ 0; for (int i 0; i CALIB_SAMPLES; i) { int16_t gx, gy, gz; readGyroRaw(gx, gy, gz); sumX gx; sumY gy; sumZ gz; delay(2); } gyroBiasX sumX / (float)CALIB_SAMPLES; gyroBiasY sumY / (float)CALIB_SAMPLES; gyroBiasZ sumZ / (float)CALIB_SAMPLES; }注意校准必须在设备完全静止、温度稳定的情况下做。如果你刚焊完板子芯片还是热的校准出来的零偏会不准。建议上电后等 30 秒再校准。2.4 姿态解算互补滤波 vs DMP姿态解算的目的是把加速度和角速度融合成稳定的角度。有两种主流做法方案一使用 MPU6050 内置 DMP。DMP 是芯片内部的协处理器可以直接输出四元数。优点是主控几乎不耗算力输出稳定。缺点是配置复杂需要加载固件而且不同库的兼容性参差不齐。在 Arduino 环境下MPU6050_light和I2Cdevlib都支持 DMP但配置过程对新手不太友好。方案二自己写互补滤波。互补滤波的核心思想是陀螺仪积分得到角度短期准但长期漂加速度计算出的角度长期准但短期噪声大。两者用高通和低通互补就能得到又稳又准的角度。// 互补滤波示例 float angleX 0, angleY 0; const float ALPHA 0.98; // 陀螺仪权重 unsigned long lastTime 0; void updateAngle(float gx, float gy, float ax, float ay, float az) { unsigned long now millis(); float dt (now - lastTime) / 1000.0; lastTime now; // 加速度计算出的角度 float accelAngleX atan2(ay, az) * 180.0 / PI; float accelAngleY atan2(-ax, sqrt(ay*ay az*az)) * 180.0 / PI; // 互补滤波 angleX ALPHA * (angleX gx * dt) (1 - ALPHA) * accelAngleX; angleY ALPHA * (angleY gy * dt) (1 - ALPHA) * accelAngleY; }ALPHA取 0.98 是一个经验值意味着 98% 信任陀螺仪2% 信任加速度计。这个值越大角度越平滑但漂移修正越慢越小修正越快但抖动越明显。我试过 0.95 到 0.99 之间的几个值0.98 在响应速度和稳定性之间平衡最好。对于空中鼠标其实你未必需要绝对角度很多时候直接用角速度陀螺仪数据映射鼠标速度反而更自然。因为鼠标移动本质上是速度而不是位置手转得快光标就动得快手停下光标就停。这种映射方式叫速率控制Rate Control比位置控制更符合直觉。3. BLE HID 实现与固件核心环节3.1 BLE HID 协议栈的基本概念BLE HID 是蓝牙 HID 协议在低功耗蓝牙上的实现。主机电脑、手机作为 HID Host设备我们的鼠标作为 HID Device。设备通过 GATT 服务暴露一个 HID 服务主机订阅这个服务的报告特征Report Characteristic设备往这个特征写数据主机就收到鼠标事件。关键概念HID Report Descriptor描述设备是什么、能发什么数据。鼠标的描述符定义了 X/Y 位移、按键、滚轮等字段。Report Characteristic设备往这里写数据主机从这里读。Input Report设备主动上报的数据比如鼠标移动。Output Report主机发给设备的数据比如设置 LED。ESP32-C3 在 Arduino 环境下ESP32 BLE Arduino库提供了BLEHIDDevice类可以快速搭建 HID 设备。但要注意这个库的 HID 支持并不完整鼠标描述符需要自己写。3.2 鼠标 HID 报告描述符的写法HID 报告描述符是一段二进制数据定义了数据包的格式。一个标准的三键鼠标描述符如下static const uint8_t mouseReportDescriptor[] { 0x05, 0x01, // Usage Page (Generic Desktop) 0x09, 0x02, // Usage (Mouse) 0xA1, 0x01, // Collection (Application) 0x09, 0x01, // Usage (Pointer) 0xA1, 0x00, // Collection (Physical) 0x05, 0x09, // Usage Page (Button) 0x19, 0x01, // Usage Minimum (1) 0x29, 0x03, // Usage Maximum (3) 0x15, 0x00, // Logical Minimum (0) 0x25, 0x01, // Logical Maximum (1) 0x95, 0x03, // Report Count (3) 0x75, 0x01, // Report Size (1) 0x81, 0x02, // Input (Data, Variable, Absolute) 0x95, 0x01, // Report Count (1) 0x75, 0x05, // Report Size (5) 0x81, 0x01, // Input (Constant) 0x05, 0x01, // Usage Page (Generic Desktop) 0x09, 0x30, // Usage (X) 0x09, 0x31, // Usage (Y) 0x15, 0x81, // Logical Minimum (-127) 0x25, 0x7F, // Logical Maximum (127) 0x75, 0x08, // Report Size (8) 0x95, 0x02, // Report Count (2) 0x81, 0x06, // Input (Data, Variable, Relative) 0xC0, // End Collection 0xC0 // End Collection };这段描述符定义了一个报告包1 字节按键低 3 位有效1 字节 X 位移1 字节 Y 位移。位移是相对值范围 -127 到 127。这意味着每次上报的位移不能超过这个范围如果手移动很快需要拆成多次上报。注意位移字段是 8 位有符号数范围只有 ±127。如果你算出来的位移超过这个值必须做限幅clamp否则会溢出变成反向移动。我一开始没做限幅快速挥手时光标会突然往反方向跳排查了很久才发现是溢出。3.3 ESP32-C3 上的 BLE HID 初始化流程初始化 BLE HID 设备的流程大致如下初始化 BLE 栈设置设备名。创建 HID 设备对象设置厂商、产品 ID 等信息。设置报告描述符。启动 HID 服务。开始广播等待主机连接。连接后通过 Input Report 特征发送鼠标数据。#include BLEDevice.h #include BLEServer.h #include BLEHIDDevice.h #include BLEUtils.h BLEServer *pServer; BLEHIDDevice *hid; BLECharacteristic *inputMouse; void setupBLE() { BLEDevice::init(AirMouse); pServer BLEDevice::createServer(); hid new BLEHIDDevice(pServer); inputMouse hid-inputReport(1); // Report ID 1 hid-manufacturer()-setValue(DIY); hid-pnp(0x02, 0x1234, 0x5678, 0x0100); hid-hidInfo(0x00, 0x01); hid-reportMap((uint8_t*)mouseReportDescriptor, sizeof(mouseReportDescriptor)); hid-startServices(); BLEAdvertising *pAdvertising pServer-getAdvertising(); pAdvertising-setAppearance(HID_MOUSE); pAdvertising-addServiceUUID(hid-hidService()-getUUID()); pAdvertising-start(); }发送鼠标数据void sendMouseReport(int8_t dx, int8_t dy, uint8_t buttons) { uint8_t report[3] {(uint8_t)buttons, (uint8_t)dx, (uint8_t)dy}; inputMouse-setValue(report, 3); inputMouse-notify(); }3.4 从姿态到鼠标位移的映射逻辑这是整个项目最需要调参的部分。核心逻辑是读取陀螺仪的角速度乘以一个系数得到鼠标位移。// 主循环 void loop() { int16_t gx, gy, gz; readGyroRaw(gx, gy, gz); // 减去零偏 float gxF (gx - gyroBiasX) / 65.5; // 转换为 °/s float gyF (gy - gyroBiasY) / 65.5; // 死区处理小于阈值的角速度视为 0 if (abs(gxF) DEADZONE) gxF 0; if (abs(gyF) DEADZONE) gyF 0; // 映射为鼠标位移 int8_t dx constrain(gxF * SENSITIVITY, -127, 127); int8_t dy constrain(gyF * SENSITIVITY, -127, 127); sendMouseReport(dx, dy, buttonState); delay(10); // 100Hz 上报率 }三个关键参数DEADZONE死区通常取 1~3 °/s。太小会导致光标抖动太大会导致小幅度移动无响应。SENSITIVITY灵敏度决定手转多快光标动多远。需要根据个人习惯调一般从 0.3 开始试。上报率delay(10)对应 100Hz。BLE HID 的上报率不宜太高否则会丢包也不宜太低否则光标卡顿。100Hz 是一个比较稳的值。提示X 和 Y 轴的映射方向需要根据你的佩戴方式调整。如果光标移动方向和手的动作相反把系数取负即可。我建议先固定一个轴调通再调另一个轴。4. 常见问题与排查技巧实录4.1 编译与烧录阶段的典型报错报错一undefined symbol mpu6050这个报错通常出现在 Keil 或某些 IDE 环境下原因是链接器找不到 MPU6050 相关的函数实现。常见原因库文件没有加入编译路径。头文件声明了函数但源文件没参与编译。库版本和芯片架构不匹配。在 Arduino 环境下这个错误一般不会出现因为库是自动链接的。如果你在 PlatformIO 或 ESP-IDF 下遇到检查platformio.ini或CMakeLists.txt里的库依赖。报错二ESP32-C3 烧录失败ESP32-C3 烧录失败的原因比较多按概率排序现象可能原因解决方法找不到串口驱动未安装安装 CH340 或 CP210x 驱动一直等待连接未进入下载模式按住 BOOT 键再按 RESET烧录中途失败USB 线质量差换一根数据线校验失败波特率过高降到 115200端口被占用串口监视器没关关闭所有串口工具ESP32-C3 的下载模式需要 GPIO9 拉低。大多数开发板有一个 BOOT 按键按住它再按 RESET 就能进入下载模式。如果你用的是模组自己搭的电路需要手动把 GPIO9 接地。4.2 BLE 连接与配对问题问题电脑搜不到设备检查广播是否启动。pAdvertising-start()之后设备才会广播。检查设备名是否为空。有些系统对空名字的设备不显示。检查是否已经被其他设备连接。BLE 设备通常只能被一个主机连接。问题连接后鼠标不动检查 HID 服务是否启动。hid-startServices()必须在广播之前调用。检查报告描述符是否正确。描述符错误会导致主机不识别数据。检查notify()是否被调用。只setValue()不notify()主机收不到数据。问题光标漂移这是最常见的问题原因是陀螺仪零偏没校准好或者校准后温度变化导致零偏漂移。解决方法重新校准确保设备静止。增大死区把小的漂移吃掉。加入温度补偿根据温度修正零偏。4.3 功耗优化与续航ESP32-C3 的 BLE 功耗在活跃状态下大约 30~50mA加上 MPU6050 的 4mA 左右整体在 40~60mA。一块 500mAh 的电池理论续航 8~12 小时。如果想延长续航降低上报率从 100Hz 降到 50Hz功耗能降一些。使用轻睡眠在没有动作时让 ESP32-C3 进入 light sleep有中断时唤醒。关闭不必要的功能Wi-Fi、ADC、LED 全部关掉。降低发射功率BLE 发射功率从默认的 0dBm 降到 -12dBm通信距离缩短但功耗降低。我实测下来把上报率降到 50Hz、发射功率降到 -6dBm续航能提升到 15 小时左右。但上报率降低后光标会有一点卡顿感需要自己权衡。4.4 常见问题速查表问题排查方向快速验证I2C 扫描不到 MPU6050接线、地址、上拉电阻跑 I2C Scanner数据全是 0设备未唤醒检查 PWR_MGMT_1数据跳变严重量程配置错误检查 GYRO_CONFIG光标漂移零偏未校准重新校准光标反向映射系数符号取负BLE 连不上广播、名字、已连接用手机蓝牙搜索鼠标无响应HID 服务、描述符检查主机设备管理器续航短上报率、发射功率降低参数5. 实操心得与进阶方向5.1 几个让我少走弯路的经验第一先跑通 I2C 再碰 BLE。很多人一上来就想把整个系统搭起来结果 BLE 连上了但传感器没数据排查起来两头堵。正确的顺序是先用串口打印 MPU6050 的原始数据确认传感器工作正常再单独测试 BLE HID用一个固定的位移值让光标动起来最后把两者合起来。第二校准要放在固件里自动做。不要每次上电都手动校准。可以在setup()里加一个判断如果检测到设备静止加速度计三轴模长接近 1g陀螺仪输出接近 0就自动校准。这样用户体验好很多。第三死区不是越小越好。我一开始把死区设成 0.5°/s结果光标一直在抖。后来调到 2°/s抖动消失但小幅度移动还是能响应。死区的本质是忽略噪声而 MPU6050 的噪声水平决定了死区的下限。第四BLE 上报率要和主循环解耦。如果你在主循环里既读传感器又发 BLE传感器读取的延迟会影响 BLE 的时序。更好的做法是用一个定时器或者 FreeRTOS 任务让 BLE 上报独立于传感器读取。5.2 这个项目还能怎么扩展空中鼠标只是一个起点同样的硬件链路可以玩出很多花样手势识别在 MCU 里跑一个简单的分类器识别画圈上下挥动等手势映射成不同的快捷键。体感游戏手柄把姿态数据映射成游戏手柄的摇杆输入配合按键做体感游戏。跌倒检测这个在热词里也出现了原理和空中鼠标一样只是判断逻辑不同——检测加速度突变和姿态异常。多设备切换BLE 支持主从切换可以让一个鼠标在多个设备之间切换连接。5.3 关于工具链的一点建议Arduino IDE 对这个项目来说够用但如果你想要更好的开发体验我推荐 PlatformIO VSCode。原因库管理更清晰不会出现版本冲突。代码补全和跳转比 Arduino IDE 强太多。可以方便地切换不同的 ESP32 芯片型号。如果你坚持用 Arduino IDE记得装esp32board package 的 2.0 以上版本老版本对 ESP32-C3 的支持不完整。另外ESP32 BLE Arduino库在 2.0 版本之后有一些 API 变化网上的老教程可能不适用遇到问题优先看官方例程。最后分享一个我踩过的坑ESP32-C3 的 BLE 库在同时使用多个特征时notify()的调用顺序会影响数据完整性。如果你发现鼠标偶尔丢帧试着把setValue()和notify()放在同一个临界区里或者用notify(false)关闭确认机制。这个细节在官方文档里没写是我抓包对比之后才发现的。