ESP32-S3无线空鼠开发指南：从硬件到固件实现

1. ESP32-S3无线空鼠项目概述

这个项目使用两块ESP32-S3开发板构建了一套完整的无线空鼠系统，其中一块作为发送端（空鼠本体），另一块作为接收端（USB适配器）。系统采用ESPNOW协议进行无线通信，完美解决了老旧电视、台式机等无蓝牙设备的鼠标控制问题。

我选择ESP32-S3主要基于三点考虑：首先它集成了WiFi和蓝牙双模，为后续功能扩展预留空间；其次S3系列原生支持USB-OTG，这是实现HID设备的关键；最后我手头正好有几片S3-zero开发板，其紧凑的尺寸（仅21x17.6mm）非常适合做成便携设备。虽然用S3做这么简单的功能确实有点"杀鸡用牛刀"，但考虑到开发效率和原型验证，这是最合适的选择。

2. 硬件选型与电路设计

2.1 核心硬件清单

发送端组件：

• ESP32-S3-Zero开发板（主控）
• MPU6050六轴传感器（姿态检测）
• 5个轻触开关（左/右/中键+滚轮上下）
• 3.7V锂电池（供电）
• 充电管理模块（TP4056）

接收端组件：

• ESP32-S3-Zero开发板（主控）
• USB Type-C接口（连接主机设备）

特别注意：经实测ESP32-C3/C6因缺少USB-OTG功能无法作为接收端，只能用作发送端。如果考虑成本，发送端可以用C3，但接收端必须用S3系列。

2.2 关键电路设计要点

发送端电路设计：

1. MPU6050通过I2C连接（SDA:GPIO4, SCL:GPIO5）
2. 按键采用内部上拉设计，按下时接地：
   • 左键: GPIO7
   • 右键: GPIO8
   • 中键: GPIO9
   • 滚轮上: GPIO12
   • 滚轮下: GPIO13
3. 锂电池电压需通过分压电阻接入ADC引脚实现电量检测

接收端电路设计：

1. USB D+/D-直接连接GPIO20/19（S3的USB引脚）
2. 建议增加ESD保护二极管（如SRV05-4）防护USB接口

3. 开发环境搭建

3.1 软件准备清单

• Arduino IDE 2.3.2或更新版本
• 开发板支持包：esp32@2.0.14
• 必需库文件：
  • ESP32-ESPNow（内置）
  • USBHIDMouse（内置）
  • I2Cdev
  • MPU6050_6Axis_MotionApps20

3.2 环境配置步骤

1. 安装Arduino IDE后，在首选项添加开发板管理器网址：

   code复制https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
   

2. 开发板管理器安装"esp32"平台（选择2.0.14版本）
3. 通过库管理器安装I2Cdev和MPU6050库
4. 开发板选择"ESP32S3 Dev Module"，配置参数：
   • USB Mode: Hardware CDC and JTAG
   • USB DFU On: Enable
   • Flash Mode: QIO 80MHz
   • Partition Scheme: Default 16MB

4. 接收端实现详解

4.1 USB HID初始化流程

接收端通过USB HID协议模拟标准鼠标设备，核心代码如下：

cpp复制#include <USB.h>
#include <USBHIDMouse.h>

USBHIDMouse Mouse;

void setup() {
  Mouse.begin(); // 初始化USB HID
  while(!USB.ready()) delay(100); // 等待USB枚举完成
}

关键点：

• 首次插入时电脑需要约30秒安装驱动（仅第一次）
• Windows系统可能需要手动选择"HID-compliant mouse"驱动
• Linux/Mac无需额外驱动即插即用

4.2 ESPNOW通信配置

cpp复制#include <esp_now.h>
#include <WiFi.h>

typedef struct {
  int16_t moveX, moveY;
  uint8_t buttons;
} mouse_data_t;

void setup() {
  WiFi.mode(WIFI_STA);
  esp_now_init();
  esp_now_register_recv_cb([](const uint8_t *mac, const uint8_t *data, int len) {
    // 数据处理回调
  });
}

注意事项：

1. 必须记录接收端MAC地址（通过串口打印），发送端需要此地址
2. ESPNOW信道需与WiFi信道一致（默认0自动选择）
3. 实测通信距离：室内无遮挡约15米，穿墙后降至5-8米

5. 发送端实现详解

5.1 MPU6050姿态解算

核心算法流程：

1. 初始化DMP（Digital Motion Processor）
2. 从FIFO读取四元数数据
3. 转换为欧拉角（Yaw/Pitch/Roll）
4. 计算角度变化量控制光标移动

cpp复制MPU6050 mpu;

void loop() {
  if(mpu.dmpGetCurrentFIFOPacket(fifoBuffer)) {
    mpu.dmpGetQuaternion(&q, fifoBuffer);
    mpu.dmpGetGravity(&gravity, &q);
    mpu.dmpGetYawPitchRoll(ypr, &q, &gravity);
    
    float yawDiff = (ypr[0] - lastYaw) * 180/M_PI;
    float rollDiff = (ypr[2] - lastRoll) * 180/M_PI;
    
    if(abs(yawDiff)>0.1) mouseData.moveX = yawDiff*2.8;
    if(abs(rollDiff)>0.1) mouseData.moveY = -rollDiff*2.8;
  }
}

校准技巧：

• 上电后保持设备静止3秒完成自动校准
• 若光标漂移，可通过mpu.CalibrateAccel(6)和mpu.CalibrateGyro(6)重新校准

5.2 按键扫描优化

采用状态机方式检测按键，避免抖动：

cpp复制void checkButtons() {
  static uint32_t lastCheck = 0;
  if(millis()-lastCheck < 20) return; // 20ms防抖
  
  leftPressed = !digitalRead(PIN_LEFT);
  // 其他按键同理...
  
  lastCheck = millis();
}

6. 系统调试与优化

6.1 参数调优指南

1. 灵敏度调节：

   • 修改MOUSE_SENSITIVITY系数（建议2.5-3.5）
   • 角度阈值ANGLE_THRESHOLD影响微小移动抑制（建议0.05-0.15弧度）

2. 功耗优化：

   • 添加WiFi.setSleep(true)启用WiFi睡眠
   • 调整发送间隔（当前10ms可增至20ms）

3. 运动平滑处理：

   cpp复制// 添加移动平均滤波
   const int filterSize = 3;
   static int16_t xBuf[filterSize], yBuf[filterSize];
   
   xBuf[filterIndex] = rawX;
   yBuf[filterIndex] = rawY;
   mouseData.moveX = (xBuf[0]+xBuf[1]+xBuf[2])/3;
   

6.2 常见问题排查

问题1：接收端无法识别为HID设备

• 检查USB接线（D+/D-必须连接GPIO19/20）
• 确认开发板配置中USB选项已启用
• 尝试更换USB线（有些线仅支持充电）

问题2：光标移动不流畅

• 降低发送频率至15-20ms
• 增加MPU6050的DMP输出速率：

  cpp复制mpu.setDMPEnabled(true);
  mpu.setRate(4); // 0=1kHz, 4=200Hz
  

问题3：按键响应延迟

• 检查按键引脚上拉电阻是否启用
• 减少防抖延时（当前20ms可试降至10ms）

7. 进阶改进方向

7.1 自动配对功能实现

通过以下流程实现免配置配对：

1. 接收端进入配对模式（长按按键3秒）
2. 发送端扫描特定SSID（如"ESP-AirMouse"）
3. 交换配对信息后切换回ESPNOW模式

关键代码片段：

cpp复制// 接收端广播配对信标
void startPairing() {
  WiFi.softAP("ESP-AirMouse");
  esp_now_add_peer(broadcastMac, ESP_NOW_ROLE_COMBO, 1, NULL, 0);
}

// 发送端扫描处理
void scanDone(int found) {
  for(int i=0; i<found; i++) {
    if(WiFi.SSID(i)=="ESP-AirMouse") {
      esp_now_send(targetMac, pairingData, sizeof(pairingData));
    }
  }
}

7.2 多模式切换设计

通过拨码开关选择工作模式：

1. 蓝牙HID模式（连接手机/平板）
2. ESPNOW模式（连接无蓝牙主机）
3. 混合模式（同时保持两种连接）

硬件改进：

• 增加3位拨码开关（GPIO10/11/14）
• 添加0.96寸OLED显示当前模式

7.3 低功耗优化方案

1. 发送端：

   • 启用ESP32轻睡眠模式
   • 运动检测唤醒（利用MPU6050中断）
   • 动态调整发送功率（esp_now_set_wake_window）

2. 接收端：

   • USB总线供电时全性能模式
   • 电池供电时进入PSM模式

实测功耗对比：

8. 项目总结与实用建议

经过两个月的迭代开发，这个无线空鼠系统已经可以稳定运行。实测在智能电视、Windows电脑和树莓派上都能完美兼容。以下是一些实战经验：

1. 外壳设计建议：

   • 发送端推荐3D打印椭圆造型（尺寸约60x40x15mm）
   • 接收端可做成U盘形状方便插拔
   • 按键布局参考传统鼠标，拇指位放置滚轮按键

2. 量产成本控制：

   • 发送端改用ESP32-C3模组（约￥12）
   • 接收端使用ESP32-S3-MINI-1（约￥18）
   • 批量生产BOM成本可控制在￥50以内

3. 用户体验优化：

   • 增加触觉反馈（微型振动电机）
   • 添加RGB指示灯显示连接状态
   • 实现手势操作（如空中画圈=返回）

这个项目的独特价值在于：

• 完全开源可定制（相比商业产品）
• 支持多种连接方式（蓝牙/ESPNOW）
• 可扩展为通用输入设备（如演示器、体感控制器）

对于想复现项目的开发者，建议从接收端开始验证USB HID功能，再逐步添加发送端功能。遇到MPU6050校准问题时，可以先用现成的校准数据（网上有很多分享），等系统能跑了再深入研究自动校准算法。