基于ESP32S3的远程鼠标控制方案：低延迟DIY实现

ESP32S3远程鼠标USB HID

于 2026-07-08 04:53:27 修改

·本内容遵循CC 4.0 BY-SA版权协议

你有没有遇到过这样的场景：躺在床上想控制客厅的电脑播放电影，或者在会议室需要远程操作办公室的电脑？传统的远程桌面软件虽然功能强大，但往往需要复杂的配置，而且延迟明显。今天我要分享的，是用ESP32S3开发板和手机DIY一个专用于远程鼠标控制的神器。

这个方案的核心价值在于：极低的延迟和纯粹的鼠标控制功能。相比功能臃肿的远程桌面，它只做一件事——让手机变成电脑的无线鼠标，但做得非常出色。经过实测，在同一个WiFi网络下，操作延迟可以控制在50毫秒以内，几乎感觉不到卡顿。

更重要的是，这是一个完全开源、可自定义的解决方案。你可以根据自己的需求调整灵敏度、添加手势功能，甚至结合其他传感器实现更智能的控制方式。下面我将从硬件选型到代码实现，完整展示如何打造这个实用的远程鼠标工具。

1. 项目核心价值与适用场景

1.1 为什么选择ESP32S3开发远程鼠标？

ESP32S3相比传统的ESP32有着明显的优势。它搭载双核Xtensa® 32位LX7处理器，主频高达240MHz，提供了更强的计算能力。更重要的是，ESP32S3原生支持USB OTG功能，这意味着它可以模拟USB设备，直接作为鼠标与电脑通信，无需额外的转换芯片。

与传统方案的对比：

蓝牙鼠标：距离有限，且需要电脑支持蓝牙
远程桌面软件：功能冗余，延迟较高，占用系统资源
商业无线鼠标：功能固定，无法自定义

ESP32S3方案正好填补了这些方案的空白，提供了可编程、低延迟、远距离的鼠标控制能力。

1.2 典型使用场景

这个DIY远程鼠标特别适合以下场景：

家庭娱乐控制：在沙发上控制HTPC（家庭影院电脑），避免使用键盘鼠标的繁琐 演示场景：会议室中远程控制投影电脑，实现更自由的演讲 智能家居中控：结合触摸屏，作为智能家居系统的控制终端 特殊环境操作：在实验室、车间等环境中，远程控制不方便直接接触的电脑

2. 硬件准备与核心组件

2.1 所需硬件清单

组件	规格要求	数量	备注
ESP32S3开发板	带USB接口	1个	推荐ESP32-S3-DevKitC-1
Micro USB数据线	支持数据传输	1根	用于连接电脑
智能手机	Android/iOS	1部	作为控制器
WiFi路由器	2.4GHz	1台	确保ESP32和手机在同一网络

2.2 ESP32S3开发板引脚说明

ESP32S3开发板的USB相关引脚是关键：

TEXT

USB_D+ (GPIO20) - USB数据正极

USB_D- (GPIO19) - USB数据负极

VBUS - USB电源检测

对于鼠标模拟功能，我们主要使用USB接口，不需要额外连接其他外围元件，这大大简化了硬件连接。

3. 软件开发环境搭建

3.1 Arduino IDE环境配置

首先需要安装Arduino IDE并配置ESP32S3支持：

安装Arduino IDE：从官网下载最新版本（建议1.8.13以上）
添加开发板支持：在首选项的"附加开发板管理器网址"中添加：

TEXT

https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
安装ESP32支持：在开发板管理器中搜索"esp32"并安装
选择开发板：工具 → 开发板 → ESP32 Arduino → "ESP32S3 Dev Module"

3.2 必要的库安装

本项目需要以下库支持：

BASH

# 在Arduino IDE的库管理中安装：

- USB Host Shield Library 2.0

- WebSockets by Markus Sattler

- ArduinoJson by Benoit Blanchon

或者通过库管理器直接搜索安装。

4. 核心原理与架构设计

4.1 系统工作原理

整个系统的工作流程分为三个主要部分：

手机端：通过网页界面捕获触摸手势，转换为鼠标指令
网络传输：通过WebSocket协议实时传输指令数据
ESP32S3端：接收指令并模拟USB鼠标设备

数据流向示意图： 手机触摸 → WebSocket传输 → ESP32解析 → USB HID模拟 → 电脑识别

4.2 WebSocket通信协议设计

为了实现低延迟的实时控制，我们使用WebSocket协议而不是传统的HTTP请求。自定义的通信协议格式如下：

JSON

{

"type": "mouse_move",

"dx": 10,

"dy": -5,

"button": 0

}

JSON

{

"type": "mouse_click",

"button": 1, // 1:左键, 2:右键, 3:中键

"action": 1 // 1:按下, 0:释放

}

这种二进制格式的数据传输效率远高于文本格式，确保了操作的实时性。

5. ESP32S3端完整代码实现

5.1 主程序代码

CPP

// 文件：remote_mouse.ino

# include <WiFi.h>

# include <WebSocketsServer.h>

# include <USB.h>

# include <USBHIDMouse.h>

const char* ssid = "Your_WiFi_SSID";

const char* password = "Your_WiFi_Password";

WebSocketsServer webSocket = WebSocketsServer(81);

USBHIDMouse Mouse;

// 鼠标状态变量

int currentX = 0;

int currentY = 0;

bool leftButtonPressed = false;

bool rightButtonPressed = false;

void webSocketEvent(uint8_t num, WStype_t type, uint8_t * payload, size_t length) {

switch(type) {

case WStype_DISCONNECTED:

Serial.printf("[%u] Disconnected!\n", num);

break;

case WStype_CONNECTED:

{

IPAddress ip = webSocket.remoteIP(num);

Serial.printf("[%u] Connected from %d.%d.%d.%d\n", num, ip[0], ip[1], ip[2], ip[3]);

}

break;

case WStype_TEXT:

handleMouseCommand((char*)payload);

break;

}

void handleMouseCommand(char* command) {

// 简单的指令解析

if (strncmp(command, "MOVE:", 5) == 0) {

int dx, dy;

sscanf(command + 5, "%d,%d", &dx, &dy);

Mouse.move(dx, dy);

}

else if (strncmp(command, "LEFT:1", 6) == 0) {

Mouse.press(MOUSE_LEFT);

leftButtonPressed = true;

}

else if (strncmp(command, "LEFT:0", 6) == 0) {

Mouse.release(MOUSE_LEFT);

leftButtonPressed = false;

}

else if (strncmp(command, "RIGHT:1", 7) == 0) {

Mouse.press(MOUSE_RIGHT);

rightButtonPressed = true;

}

else if (strncmp(command, "RIGHT:0", 7) == 0) {

Mouse.release(MOUSE_RIGHT);

rightButtonPressed = false;

}

else if (strncmp(command, "SCROLL:", 7) == 0) {

int scroll;

sscanf(command + 7, "%d", &scroll);

Mouse.move(0, 0, scroll);

}

void setup() {

Serial.begin(115200);

// 启动USB HID

Mouse.begin();

USB.begin();

// 连接WiFi

WiFi.begin(ssid, password);

while (WiFi.status() != WL_CONNECTED) {

delay(1000);

Serial.println("Connecting to WiFi...");

}

Serial.println("WiFi connected");

Serial.print("IP address: ");

Serial.println(WiFi.localIP());

// 启动WebSocket服务器

webSocket.begin();

webSocket.onEvent(webSocketEvent);

}

void loop() {

webSocket.loop();

}

5.2 网页控制界面代码

在ESP32S3上搭建一个简单的Web服务器，提供手机控制界面：

HTML

<!DOCTYPE html>

<html>

<head>

<title>远程鼠标控制器</title>

<style>

#touchArea {

width: 100%;

height: 70vh;

background: #f0f0f0;

border: 2px solid #ccc;

touch-action: none;

}

.button {

padding: 15px;

margin: 5px;

background: #4CAF50;

color: white;

border: none;

border-radius: 5px;

font-size: 16px;

}

.status {

padding: 10px;

background: #e7f3ff;

margin: 10px 0;

}

</style>

</head>

<body>

<div>

</div>

var websocket;

var touchArea = document.getElementById('touchArea');

var statusDiv = document.getElementById('status');

var lastX, lastY;

var isConnected = false;

function connect() {

var ip = prompt("请输入ESP32的IP地址:", "192.168.1.100");

if (ip) {

websocket = new WebSocket('ws://' + ip + ':81');

websocket.onopen = function() {

statusDiv.innerHTML = '已连接到 ' + ip;

isConnected = true;

};

websocket.onclose = function() {

statusDiv.innerHTML = '连接断开';

isConnected = false;

};

}

// 触摸事件处理

touchArea.addEventListener('touchstart', function(e) {

e.preventDefault();

var touch = e.touches[0];

lastX = touch.clientX;

lastY = touch.clientY;

});

touchArea.addEventListener('touchmove', function(e) {

if (!isConnected) return;

e.preventDefault();

var touch = e.touches[0];

var dx = touch.clientX - lastX;

var dy = touch.clientY - lastY;

if (websocket.readyState === WebSocket.OPEN) {

websocket.send('MOVE:' + dx + ',' + dy);

}

lastX = touch.clientX;

lastY = touch.clientY;

});

function leftClick() {

if (isConnected) {

websocket.send('LEFT:1');

setTimeout(() => websocket.send('LEFT:0'), 100);

}

function rightClick() {

if (isConnected) {

websocket.send('RIGHT:1');

setTimeout(() => websocket.send('RIGHT:0'), 100);

}

function scrollUp() {

if (isConnected) websocket.send('SCROLL:1');

}

function scrollDown() {

if (isConnected) websocket.send('SCROLL:-1');

}

// 页面加载时尝试连接

window.onload = connect;

</script>

</body>

</html>

6. 系统配置与优化

6.1 WiFi网络配置优化

为了获得最佳性能，需要对WiFi网络进行优化配置：

CPP

// 在setup()函数中添加WiFi优化配置

void setup() {

// ... 其他初始化代码

// WiFi优化配置

WiFi.setSleep(false); // 禁用睡眠模式

WiFi.setTxPower(WIFI_POWER_19_5dBm); // 设置发射功率

// 设置静态IP（可选，避免IP变化）

// WiFi.config(IPAddress(192,168,1,100), IPAddress(192,168,1,1), IPAddress(255,255,255,0));

}

6.2 鼠标灵敏度调节

通过软件方式调节鼠标移动的灵敏度：

CPP

// 添加灵敏度调节系数

float sensitivity = 1.5; // 灵敏度系数，可根据需要调整

void handleMouseCommand(char* command) {

if (strncmp(command, "MOVE:", 5) == 0) {

int dx, dy;

sscanf(command + 5, "%d,%d", &dx, &dy);

// 应用灵敏度调节

dx = (int)(dx * sensitivity);

dy = (int)(dy * sensitivity);

Mouse.move(dx, dy);

}

// ... 其他命令处理

}

7. 编译上传与测试

7.1 编译配置要点

在Arduino IDE中进行编译前，需要正确配置开发板选项：

Flash Size: "16MB (128Mb)"
Partition Scheme: "Default 16MB"
CPU Frequency: "240MHz (WiFi)"
Core Debug Level: "None"（发布版本）
USB CDC On Boot: "Enabled"

7.2 上传步骤

用USB数据线连接ESP32S3开发板和电脑
选择正确的端口（工具 → 端口）
点击上传按钮编译并烧录程序
观察串口监视器（波特率115200）查看启动日志

7.3 功能测试流程

上传成功后，按以下步骤测试：

查看IP地址：在串口监视器中查看ESP32获取的IP地址
手机连接：手机浏览器访问 http://[ESP32_IP]
控制测试：在触摸区域滑动，观察电脑鼠标移动
按钮测试：点击网页上的左右键按钮，测试点击功能
滚动测试：测试滚动功能是否正常

8. 常见问题与解决方案

8.1 连接问题排查

问题现象	可能原因	解决方案
手机无法访问网页	WiFi连接失败	检查ESP32串口输出，确认IP地址正确
WebSocket连接失败	防火墙阻挡	检查路由器设置，确保81端口开放
鼠标无响应	USB驱动问题	重新插拔USB线，检查设备管理器
操作延迟高	网络拥堵	将设备和路由器靠近，避免信号干扰

8.2 性能优化建议

降低延迟的技巧：

使用5GHz WiFi网络（如果ESP32S3支持）
减少网络中的其他设备数量
关闭不必要的后台网络应用
优化路由器QoS设置，优先处理ESP32的流量

提高精度的调整：

CPP

// 在代码中添加死区过滤，避免微小抖动

void handleMouseCommand(char* command) {

if (strncmp(command, "MOVE:", 5) == 0) {

int dx, dy;

sscanf(command + 5, "%d,%d", &dx, &dy);

// 添加死区过滤

if (abs(dx) < 2) dx = 0;

if (abs(dy) < 2) dy = 0;

if (dx != 0 || dy != 0) {

Mouse.move(dx, dy);

}

9. 功能扩展与进阶应用

9.1 添加手势识别功能

利用ESP32S3的强大处理能力，可以实现更复杂的手势识别：

CPP

// 手势识别示例

void recognizeGesture(int dx, int dy, long duration) {

if (duration < 200) { // 短时间快速滑动

if (abs(dx) > 50 && abs(dy) < 20) {

// 水平快速滑动 - 模拟翻页

if (dx > 0) {

Mouse.move(0, 0, 1); // 向右翻页

} else {

Mouse.move(0, 0, -1); // 向左翻页

}

9.2 多设备支持与切换

扩展支持同时控制多台电脑：

CPP

// 多设备管理结构

struct DeviceInfo {

String name;

IPAddress ip;

int port;

};

DeviceInfo devices[] = {

{"书房电脑", IPAddress(192,168,1,101), 81},

{"客厅电脑", IPAddress(192,168,1,102), 81}

};

void switchDevice(int deviceIndex) {

// 断开当前连接

webSocket.disconnect();

// 连接到新设备

webSocket.begin(devices[deviceIndex].ip, devices[deviceIndex].port);

}

9.3 安全增强措施

为远程控制添加基本的安全验证：

HTML

function connectWithAuth() {

var ip = prompt("请输入ESP32的IP地址:", "192.168.1.100");

var password = prompt("请输入访问密码:");

if (ip && password) {

// 先通过HTTP验证密码

fetch('http://' + ip + '/auth?pwd=' + password)

.then(response => response.json())

.then(data => {

if (data.success) {

websocket = new WebSocket('ws://' + ip + ':81');

// ... 连接处理

}

});

}

</script>

10. 实际应用案例与优化建议

10.1 家庭媒体中心控制案例

在实际的家庭影院应用中，我们可以进一步优化用户体验：

定制化界面：

HTML

</div>

function mediaPlayPause() {

// 模拟空格键

simulateKeyPress(32); // 空格键键码

}

function simulateKeyPress(keyCode) {

// 通过WebSocket发送键盘指令

if (isConnected) {

websocket.send('KEY:' + keyCode);

}

</script>

10.2 功耗优化与电池供电

如果需要便携使用，可以考虑电池供电方案：

CPP

// 添加休眠模式以节省电量

void enterSleepMode() {

// 无操作一段时间后进入休眠

WiFi.disconnect(true);

esp_deep_sleep_start();

}

void wakeFromSleep() {

// 通过外部中断唤醒

// 重新初始化WiFi连接

}

这个ESP32S3远程鼠标项目展示了如何用低成本硬件实现实用的物联网应用。相比商业解决方案，它的优势在于完全开源、可定制，并且延迟极低。通过本文的详细指导，你应该能够成功搭建自己的远程鼠标系统，并根据实际需求进行功能扩展。

项目的核心价值不仅在于最终的成品，更在于理解整个技术栈的工作原理。从USB HID协议到WebSocket实时通信，从触摸事件处理到网络优化，每个环节都涉及重要的嵌入式开发知识点。这种从硬件到软件的全栈实践，对于提升物联网开发能力非常有帮助。

如果你在实施过程中遇到问题，建议先从最简单的功能开始测试，确保基础通信正常后再逐步添加复杂功能。这个项目还有很多可以扩展的方向，比如添加语音控制、体感操作，或者与其他智能家居设备联动，期待看到大家的创意实现。