1. 项目概述：ESP32-S3蓝牙空鼠开发全记录
最近完成了一个基于ESP32-S3的蓝牙空中鼠标项目，主要目标是实现躺在床上刷抖音的"懒人操作"。这个设备不仅能模拟鼠标滑动视频，还能一键进入/退出评论区、控制视频倍速播放。作为一个硬件爱好者，我想把整个开发过程记录下来，包括硬件选型、代码实现和踩坑经验。
这个项目的核心是将ESP32-S3开发板模拟成蓝牙HID键鼠设备。与市面上现成的刷抖音神器相比，我特别增加了两个实用功能：一键查看评论区（不用再费力点击小图标）和手动倍速播放（按住按键加速，松开恢复）。这些功能在现有产品中很难找到，也是我决定自己开发的主要原因。
2. 硬件选型与设计思路
2.1 核心硬件组件
我选择的都是常见模块，方便初学者复现：
主控芯片：ESP32-S3-Zero开发板（约30元）
- 自带BLE蓝牙和2.4G WiFi
- 体积小巧(约24x18mm)，GPIO引脚够用
- 内置WS2812 RGB LED，可用于状态指示
运动传感器：MPU6050六轴陀螺仪（约13元）
- 通过I2C通信
- 提供三轴加速度和三轴陀螺仪数据
- 足够用于基础的体感鼠标控制
输入设备：五向导航按键模块（约4元）
- 包含上下左右中五个方向键
- 额外带两个微动开关（SET/RST）
- 所有按键共用一个GND，简化布线
电源系统：
- 3.7V锂电池（1200mAh，约10元）
- TP4056充放电管理模块（约0.6元）
- 单键双稳态开关模块（约4.5元）
2.2 硬件设计考量
在设计硬件连接时，我特别考虑了以下几点：
- 模块化布局：将电源区与功能区分离，便于后期扩展
- 引脚分配：优先使用开发板一侧的GPIO，方便布线
- 供电稳定：为后续可能添加的显示屏预留了3.3V稳压电路
- 可扩展性：保留了两个备用按键和多个GPIO接口
硬件连接时特别注意：MPU6050的INT引脚虽然代码中有定义，但实际并未使用，因此无需连接。这是我初期调试时的一个小坑，后来发现相关代码是AI生成的多余部分。
3. 软件开发环境搭建
3.1 开发工具链配置
我选择使用VSCode + Arduino Maker Workshop扩展的开发方式，相比原生Arduino IDE有以下优势：
- 代码补全和语法检查更强大
- 扩展生态丰富（如串口监视器、Git集成）
- 项目管理更方便
具体安装步骤：
- 在VSCode中安装Arduino Maker Workshop扩展
- 添加ESP32开发板支持（国内镜像源）：
code复制https://jihulab.com/esp-mirror/espressif/arduino-esp32/-/raw/gh-pages/package_esp32_index_cn.json - 选择ESP32-S3-Zero开发板
- 设置串口和上传速率（115200bps）
3.2 关键库安装与修改
项目依赖三个主要库：
-
ESP32-BLE-Combo（蓝牙键鼠复合设备）
- 需要手动下载ZIP安装
- 必须修改源代码中的string类型转换问题
- 可自定义蓝牙设备名称
-
MPU6050_6Axis_MotionApps20（陀螺仪数据处理）
- 通过库管理器安装1.4.4版本
- 需要校准传感器偏移量
- 使用DMP（数字运动处理器）获取稳定数据
-
Adafruit_NeoPixel（RGB LED控制）
- 用于显示蓝牙连接状态
- 可设置亮度节省电量
库安装常见问题：如果编译出现"cannot convert 'std::string' to 'String'"错误，需要修改BleComboKeyboard.cpp和.h文件中的相关代码，将std::string改为String类型。
4. 核心功能实现解析
4.1 蓝牙HID设备初始化
cpp复制#include <BleCombo.h>
void setup() {
Keyboard.begin();
Mouse.begin();
}
这段简单的代码背后，ESP32会同时广播键盘和鼠标两种HID服务，让手机将其识别为复合输入设备。实测发现，Android系统对这种复合设备的兼容性很好。
4.2 抖音视频滑动控制
通过模拟鼠标滚轮实现视频切换：
cpp复制if(digitalRead(BUTTON_DOWN) == LOW){
Mouse.move(0, 0, -20); // 向下滚动
}
这里的关键点是：
- 移动值设置为20是个经验值，太小滑动不明显，太大会跳过视频
- 添加了200ms的动作间隔，防止按键抖动导致多次触发
4.3 一键进入评论区实现
这是项目的难点之一，因为手机抖音不支持键盘快捷键。我的解决方案是：
- 将屏幕右下角设为坐标系原点
- 通过相对移动将指针定位到评论区图标位置
- 模拟鼠标点击
cpp复制// 移动到右下角
for(int i=0; i<15; i++){
Mouse.move(0, 100, 0); // 向下移动
delay(50);
}
// 移动到评论区图标
for(int i=0; i<10; i++){
Mouse.move(0, -100, 0); // 向上移动
delay(50);
}
Mouse.click(MOUSE_LEFT); // 点击
不同手机需要调整移动步数和延迟参数，这是调试中最耗时的部分。建议先在代码中定义好这些参数，方便随时调整。
4.4 体感鼠标控制实现
通过MPU6050获取设备姿态，转换为鼠标移动：
cpp复制mpu.dmpGetQuaternion(&q, fifoBuffer);
mpu.dmpGetGravity(&gravity, &q);
mpu.dmpGetYawPitchRoll(ypr, &q, &gravity);
float yawDiff = ypr[0] - lastYaw;
float rollDiff = ypr[2] - lastRoll;
if(abs(yawDiff) > 0.1){ // 过滤微小抖动
int16_t mouseX = yawDiff * 2.8 * 5;
int16_t mouseY = -rollDiff * 2.8 * 5;
Mouse.move(mouseX, mouseY, 0);
}
灵敏度调节技巧：
- 修改MOUSE_SENSITIVITY系数（代码中为2.8）
- 调整ANGLE_THRESHOLD（当前为0.1弧度）过滤微小移动
- 改变陀螺仪安装方向会影响移动轴向，需要相应调整代码
5. 硬件连接与调试要点
5.1 电路连接示意图
以下是核心模块的连接方式：
| 模块 | ESP32引脚 | 说明 |
|---|---|---|
| MPU6050 VCC | 3.3V | 注意不要接5V |
| MPU6050 SDA | GPIO4 | 可自定义 |
| MPU6050 SCL | GPIO5 | 可自定义 |
| 导航键UP | GPIO12 | 内部上拉 |
| 导航键DOWN | GPIO13 | 内部上拉 |
| 电池正极 | 5V引脚 | 通过开关模块 |
5.2 常见问题排查
-
蓝牙连接不稳定
- 检查天线是否未被遮挡
- 尝试降低RGB LED亮度（高亮度可能干扰无线信号）
- 确保电池电压充足（低于3.3V可能导致射频性能下降）
-
陀螺仪数据异常
- 重新校准传感器（mpu.CalibrateAccel/Gyro）
- 检查I2C引脚是否接触良好
- 确保MPU6050水平放置时进行初始化
-
按键响应不灵敏
- 增加按键消抖时间（代码中ACTION_DELAY）
- 检查引脚上拉电阻是否启用
- 确认按键硬件连接正确（共地设计容易接错）
6. 成本优化与改进方向
6.1 现有方案成本分析
我的初版原型机成本约93元，主要花费在：
- ESP32-S3-Zero开发板（30元）
- MPU6050模块（13元）
- 锂电池及充电电路（约15元）
实际上可以通过以下方式大幅降低成本：
- 改用ESP32-C3系列开发板（最低仅6元）
- 选择更便宜的陀螺仪模块（如MPU6050国产版约5元）
- 使用普通按键替代导航键模块
6.2 未来改进计划
-
自动设备识别
- 检测连接设备是手机还是平板
- 自动切换控制模式（鼠标/键盘快捷键）
-
增加OLED显示屏
- 显示连接状态
- 提供参数调节界面
- 实现配置保存功能
-
PCB设计优化
- 将洞洞板方案转为定制PCB
- 集成充电电路和稳压模块
- 缩小整体体积至50×30mm以内
-
外壳设计改进
- 优化人体工学设计
- 增加防滑处理
- 预留电池更换窗口
7. 开发心得与实用建议
经过这个项目的实践，我总结了几点重要经验：
-
模块测试要彻底：特别是MPU6050这样的传感器，务必单独测试确认工作正常后再集成
-
增量开发很重要：先实现基础功能（如蓝牙连接），再逐步添加复杂功能（体感控制）
-
参数需要现场调试：如评论区定位参数，必须在实际使用的手机上调试
-
注意电源管理：无线模块和传感器同时工作时的电流需求往往被低估
对于想复现这个项目的朋友，我的建议是：
- 先从简化版开始（只实现视频滑动功能）
- 使用面包板进行原型验证
- 准备好万用表和逻辑分析仪等调试工具
- 多查阅ESP32官方文档，了解蓝牙HID协议细节
这个项目最有价值的部分不是最终成品，而是开发过程中积累的硬件调试经验和解决问题的思路。当你看到自己设计的设备能完美控制手机时，那种成就感是买现成产品无法比拟的。