ESP32双轮机器人实战：从硬件搭建到避障与WiFi遥控全解析-尧图网络科技

最近在整理桌面小项目时，发现很多朋友对用ESP32制作一个能跑能转的小机器人很感兴趣，但网上的资料要么过于零散，要么只停留在理论。本文将手把手带你从零搭建一个功能完整的桌面级ESP32双轮机器人。我们将从硬件选型、电路连接，到核心代码编写、无线控制，再到避障与巡线功能的实现，进行全流程拆解。无论你是刚接触嵌入式开发的学生，还是想为创客项目寻找灵感的开发者，都能通过本文获得一套可直接复用的完整方案。

1. 项目背景与核心概念

1.1 什么是桌面ESP32双轮机器人？

桌面ESP32双轮机器人，顾名思义，是一个以ESP32微控制器为核心，采用两轮差速驱动方式，能够在桌面等平坦小范围内自主或受控移动的小型机器人平台。它不同于大型工业机器人，其特点是成本低、体积小、易于二次开发，非常适合用于学习机器人运动控制、传感器集成、无线通信（如Wi-Fi/蓝牙）以及初步的智能算法（如自动避障、巡线）等概念。

1.2 它能做什么？解决什么问题？

这个项目主要解决的是低成本入门机器人实践的问题。许多机器人教程需要昂贵的开发板或复杂的机械结构，而本项目利用常见的ESP32开发板和廉价的电机、传感器，构建了一个功能完备的迷你机器人实验平台。通过它，你可以：

学习运动控制：理解PWM（脉冲宽度调制）控制电机速度，以及差速转向的原理。
实践传感器应用：集成超声波测距、红外巡线等传感器，让机器人感知环境。
掌握无线通信：通过Wi-Fi创建Web控制页面或手机APP，实现远程遥控。
入门简单算法：实现自动避障、自动巡线等基础机器人行为。

1.3 为什么选择ESP32？

ESP32是一款集成了Wi-Fi和蓝牙功能的低成本、低功耗的微控制器芯片。相比于传统的Arduino UNO，它性能更强（双核处理器）、内存更大、外设更丰富，并且原生支持无线功能，无需额外模块。这使得它成为制作物联网设备和智能小车的绝佳选择，我们可以轻松为其赋予“联网大脑”。

2. 硬件准备与清单

在开始编程之前，我们需要准备好所有硬件部件。以下是构建一个基础版桌面机器人的核心清单：

部件名称	规格/型号建议	数量	作用说明
主控制器	ESP32开发板 (如ESP32 DEVKIT V1)	1	机器人的大脑，负责逻辑控制和通信。
电机驱动模块	L298N 或 TB6612FNG	1	提供足够的电流来驱动电机，并接收ESP32的PWM信号控制电机转速和方向。
直流减速电机	3-6V，带编码器（可选）	2	提供动力。减速电机扭矩更大。带编码器可实现更精确的速度控制。
轮子	与电机轴配套	2	与电机直接连接。
万向轮/球	小型万向轮或金属球	1	作为机器人的第三支撑点，保持平衡。
电源	18650锂电池两节及电池盒	1套	为电机和ESP32供电。注意：电机驱动模块和ESP32最好分开供电或使用稳压模块。
超声波传感器	HC-SR04	1	用于前方障碍物距离检测，实现避障。
红外巡线传感器	TCRT5000 (单路或多路)	1-3个	用于检测地面黑线，实现巡线功能。
杜邦线	公对公、公对母	若干	连接各模块。
车体平台	亚克力板、3D打印件或小车底盘套件	1	用于固定所有部件。

重要提示：对于初次尝试，建议先购买一个现成的智能小车底盘套件，它通常包含了车架、电机、轮子和万向轮，可以省去很多机械安装的麻烦。

3. 电路连接详解

正确的电路连接是机器人能动起来的基础。这里我们以ESP32 + L298N电机驱动 + HC-SR04为例进行说明。

3.1 电机驱动模块（L298N）接线

L298N模块是控制电机的核心。它有两路输出（OUT1/OUT2 和 OUT3/OUT4），分别控制两个电机。

电源连接：
- 12V/5V输入：接电机电源（如两节18650电池，约7.4V）。这个电源专门给电机供电。
- GND：接电机电源的负极，并且需要与ESP32的GND相连，形成共地。
- 5V输出：可以给ESP32供电（如果输入电压不高，如7.4V）。更稳妥的做法是ESP32使用独立的USB供电或通过稳压模块从电池取电。
控制信号连接：
- IN1, IN2：连接ESP32的任意两个GPIO引脚（如GPIO12, GPIO13），控制电机A的正反转。
- IN3, IN4：连接ESP32的另外两个GPIO引脚（如GPIO14, GPIO15），控制电机B的正反转。
- ENA, ENB：使能端。需要连接ESP32支持PWM输出的引脚（如GPIO16, GPIO17）。通过给这两个引脚输入PWM信号，可以无级调节电机的速度。

3.2 ESP32与传感器接线

HC-SR04超声波模块：
- Vcc-> ESP323.3V
- Trig(触发) -> ESP32 GPIO5
- Echo(回响) -> ESP32 GPIO18
- Gnd-> ESP32GND
ESP32自身供电：在开发调试阶段，可以通过Micro-USB线连接电脑供电。最终可以接一个独立的5V稳压模块从总电池取电。

接线总结图（文字描述）：

电机A： L298N(OUT1, OUT2) -> 左电机 电机B： L298N(OUT3, OUT4) -> 右电机 电源： 电池+ -> L298N(12V), 电池- -> L298N(GND) & ESP32(GND) 控制： ESP32(GPIO12) -> L298N(IN1) ESP32(GPIO13) -> L298N(IN2) ESP32(GPIO14) -> L298N(IN3) ESP32(GPIO15) -> L298N(IN4) ESP32(GPIO16) -> L298N(ENA) // PWM ESP32(GPIO17) -> L298N(ENB) // PWM 传感器： ESP32(GPIO5) -> HC-SR04(Trig) ESP32(GPIO18) -> HC-SR04(Echo)

4. 软件环境搭建与核心库

我们将使用Arduino IDE进行开发，因为它对初学者友好，库生态丰富。

4.1 安装Arduino IDE与ESP32支持

从Arduino官网下载并安装最新版Arduino IDE。
打开IDE，点击文件->首选项，在“附加开发板管理器网址”中输入：
```
https://espressif.github.io/arduino-esp32/package_esp32_index.json
```
点击工具->开发板->开发板管理器，搜索“esp32”，找到并安装“Espressif Systems”提供的ESP32开发板支持包。

4.2 安装所需库

本项目主要依赖以下库，均可在Arduino IDE的库管理中搜索安装：

WiFi/WebServer：ESP32内置，用于创建Wi-Fi热点和Web服务器。
ESPAsyncWebServer(推荐)：一个高效的异步Web服务器库，比内置库更好用。需要通过GitHub或手动安装。
NewPing：一个优秀的超声波传感器库，简化了测距代码，并解决了回声丢失等问题。

5. 核心代码实现：让机器人动起来

我们分步骤实现机器人的基础功能。

5.1 电机控制基础函数

首先，定义引脚并编写控制单个电机运动的函数。我们使用ledc函数来生成PWM信号，这是ESP32上更推荐的方式。

// 电机控制引脚定义 // 左侧电机 const int leftMotorIN1 = 12; const int leftMotorIN2 = 13; const int leftMotorENA = 16; // PWM引脚 // 右侧电机 const int rightMotorIN1 = 14; const int rightMotorIN2 = 15; const int rightMotorENB = 17; // PWM引脚 // PWM通道和频率设置 const int pwmChannel_L = 0; const int pwmChannel_R = 1; const int pwmFreq = 1000; // 频率1kHz const int pwmResolution = 8; // 分辨率8位，即速度值0-255 void setupMotorPins() { // 设置电机控制引脚为输出模式 pinMode(leftMotorIN1, OUTPUT); pinMode(leftMotorIN2, OUTPUT); pinMode(rightMotorIN1, OUTPUT); pinMode(rightMotorIN2, OUTPUT); // 配置LEDC PWM功能 ledcSetup(pwmChannel_L, pwmFreq, pwmResolution); ledcSetup(pwmChannel_R, pwmFreq, pwmResolution); // 将PWM通道绑定到对应的引脚 ledcAttachPin(leftMotorENA, pwmChannel_L); ledcAttachPin(rightMotorENB, pwmChannel_R); } // 控制单个电机运动 void setMotor(int in1, int in2, int pwmChannel, int speed) { // speed范围：-255 ~ 255，负值代表反转 bool direction = speed > 0; speed = abs(speed); speed = constrain(speed, 0, 255); // 限制速度范围 digitalWrite(in1, direction ? HIGH : LOW); digitalWrite(in2, direction ? LOW : HIGH); ledcWrite(pwmChannel, speed); // 写入PWM值控制速度 } // 封装好的机器人动作函数 void robotMove(int leftSpeed, int rightSpeed) { setMotor(leftMotorIN1, leftMotorIN2, pwmChannel_L, leftSpeed); setMotor(rightMotorIN1, rightMotorIN2, pwmChannel_R, rightSpeed); } void robotStop() { robotMove(0, 0); } void robotForward(int speed) { robotMove(speed, speed); } void robotBackward(int speed) { robotMove(-speed, -speed); } void robotTurnLeft(int speed) { // 左轮后退，右轮前进，实现原地左转 robotMove(-speed, speed); } void robotTurnRight(int speed) { // 左轮前进，右轮后退，实现原地右转 robotMove(speed, -speed); }

5.2 超声波避障功能

利用HC-SR04传感器，让机器人在前进时自动避开障碍物。

#include <NewPing.h> #define TRIGGER_PIN 5 #define ECHO_PIN 18 #define MAX_DISTANCE 200 // 最大测量距离200cm NewPing sonar(TRIGGER_PIN, ECHO_PIN, MAX_DISTANCE); unsigned int getDistance() { delay(30); // 两次测量间短暂延迟，确保传感器稳定 unsigned int distance = sonar.ping_cm(); // 获取厘米距离 if (distance == 0) distance = MAX_DISTANCE; // 如果为0，视为超出范围 return distance; } void autoAvoidance() { unsigned int distance = getDistance(); Serial.print("Distance: "); Serial.println(distance); if (distance < 20) { // 如果前方20cm内有障碍物 robotStop(); delay(200); robotBackward(150); // 后退 delay(300); robotTurnRight(180); // 右转 delay(400); robotStop(); delay(200); } else { robotForward(180); // 否则前进 } }

5.3 创建Wi-Fi Web遥控器

这是项目的亮点之一，通过手机或电脑浏览器即可遥控机器人。

#include <WiFi.h> #include <ESPAsyncWebServer.h> // 设置你的Wi-Fi热点名称和密码 const char* ssid = "ESP32_Robot_AP"; const char* password = "12345678"; AsyncWebServer server(80); // 创建服务器对象，端口80 const char index_html[] PROGMEM = R"rawliteral( <!DOCTYPE html> <html> <head> <title>ESP32 Robot Controller</title> <meta name="viewport" content="width=device-width, initial-scale=1"> <style> body { text-align: center; font-family: Arial; } .btn { background-color: #4CAF50; border: none; color: white; padding: 20px; text-align: center; text-decoration: none; display: inline-block; font-size: 24px; margin: 10px; cursor: pointer; border-radius: 50%%; width: 100px; height: 100px; } .btn:active { background-color: #3e8e41; } #stop { background-color: #f44336; } #controlPanel { margin-top: 50px; } </style> </head> <body> <h1>ESP32 Desktop Robot</h1> <div id="controlPanel"> <div><button class="btn" ontouchstart="sendCmd('F')" ontouchend="sendCmd('S')" onmousedown="sendCmd('F')" onmouseup="sendCmd('S')">前进</button></div> <div> <button class="btn" ontouchstart="sendCmd('L')" ontouchend="sendCmd('S')" onmousedown="sendCmd('L')" onmouseup="sendCmd('S')">左转</button> <button class="btn" id="stop" ontouchstart="sendCmd('S')" ontouchend="sendCmd('S')" onmousedown="sendCmd('S')" onmouseup="sendCmd('S')">停止</button> <button class="btn" ontouchstart="sendCmd('R')" ontouchend="sendCmd('S')" onmousedown="sendCmd('R')" onmouseup="sendCmd('S')">右转</button> </div> <div><button class="btn" ontouchstart="sendCmd('B')" ontouchend="sendCmd('S')" onmousedown="sendCmd('B')" onmouseup="sendCmd('S')">后退</button></div> </div> <script> function sendCmd(cmd) { var xhr = new XMLHttpRequest(); xhr.open("GET", "/action?cmd=" + cmd, true); xhr.send(); } </script> </body> </html> )rawliteral"; void setupWiFiController() { // 启动AP模式 WiFi.softAP(ssid, password); IPAddress IP = WiFi.softAPIP(); Serial.print("AP IP address: "); Serial.println(IP); // 处理根路径请求，返回控制页面 server.on("/", HTTP_GET, [](AsyncWebServerRequest *request){ request->send_P(200, "text/html", index_html); }); // 处理控制命令 server.on("/action", HTTP_GET, [](AsyncWebServerRequest *request){ String cmd; if (request->hasParam("cmd")) { cmd = request->getParam("cmd")->value(); Serial.println("Received command: " + cmd); // 根据命令执行动作 if (cmd == "F") robotForward(200); else if (cmd == "B") robotBackward(200); else if (cmd == "L") robotTurnLeft(180); else if (cmd == "R") robotTurnRight(180); else if (cmd == "S") robotStop(); } request->send(200, "text/plain", "OK: " + cmd); }); server.begin(); // 启动服务器 Serial.println("HTTP server started"); }

5.4 主程序逻辑整合

最后，在setup()和loop()中整合所有功能。

#define MODE_AUTO_AVOIDANCE 0 #define MODE_WIFI_CONTROL 1 int currentMode = MODE_WIFI_CONTROL; // 初始为Wi-Fi遥控模式 void setup() { Serial.begin(115200); setupMotorPins(); robotStop(); // 初始化时确保电机停止 if (currentMode == MODE_WIFI_CONTROL) { setupWiFiController(); Serial.println("Setup done. Mode: Wi-Fi Control"); } else { Serial.println("Setup done. Mode: Auto Avoidance"); } } void loop() { if (currentMode == MODE_AUTO_VOIDANCE) { autoAvoidance(); // 自动避障模式 delay(100); // 主循环延迟 } // Wi-Fi控制模式无需在loop中做任何事，服务器会自动处理请求 }

6. 组装、上传与测试

6.1 机械组装

将电机安装到底盘上，并装好轮子。
将万向轮安装到底盘前部或后部中心位置。
使用尼龙柱或螺丝将ESP32、L298N模块、电池盒固定到底盘上。注意布局合理，避免线路缠绕。
按照第3章的电路图，用杜邦线连接所有模块。建议用不同颜色的线区分电源、地和信号线。

6.2 代码上传与测试步骤

用USB线将ESP32连接至电脑。
在Arduino IDE中选择正确的开发板型号和端口。
- 开发板：ESP32 Dev Module
- Port：选择对应的COM口
将完整的代码（整合了电机控制、避障和Wi-Fi）复制到IDE中。
点击上传按钮。首次上传可能需要按住ESP32上的BOOT按钮。
上传成功后，打开串口监视器，设置波特率为115200。你将看到初始化信息。
功能测试：
- 手动测试：可以暂时修改setup()函数，调用robotForward(150)等函数，观察小车是否按预期运动。
- Wi-Fi遥控测试：用手机或电脑搜索名为“ESP32_Robot_AP”的Wi-Fi热点，连接密码是“12345678”。连接后，在浏览器输入192.168.4.1（具体IP以串口输出为准），打开控制页面进行遥控。
- 避障测试：将模式切换为MODE_AUTO_AVOIDANCE，上传代码。将小车放在空旷处，它应向前直行，当用手在前方阻挡时，它应执行后退、转弯的避障动作。

7. 常见问题与排查思路

在制作过程中，你可能会遇到以下问题：

问题现象	可能原因	排查思路与解决方案
电机完全不转	1. 电源未接通或电压不足。 2. L298N使能端(ENA/ENB)未接或未给高电平/PWM。 3. 控制信号线接错或接触不良。	1. 用万用表检查电机驱动模块和ESP32的供电电压。 2. 确保ENA/ENB已连接并正确初始化（代码中使用了PWM）。 3. 逐一检查IN1~IN4的接线，并尝试在代码中单独测试每个引脚输出。
电机只朝一个方向转	1. 电机两根线接反。 2. 控制正反转的两个GPIO引脚逻辑设置错误。	1. 交换电机的两根线。 2. 检查`setMotor`函数中`digitalWrite`的逻辑，确保正转和反转时两个IN引脚的电平是相反的。
Wi-Fi热点搜不到	1. ESP32的Wi-Fi功能初始化失败。 2. 热点名称有误或密码不符合要求（至少8位）。 3. 手机等设备距离太远或有干扰。	1. 查看串口打印，确认`WiFi.softAP()`是否执行成功。 2. 确保SSID和密码定义正确。 3. 靠近ESP32重试。
网页能打开但控制无效	1. Web服务器路由处理错误。 2. 前端JS代码中发送的URL与后端不匹配。 3. 控制命令处理函数未正确调用电机动作。	1. 打开浏览器开发者工具（F12）的“网络”标签，查看点击按钮时是否有请求发出，以及响应状态。 2. 核对`server.on(“/action”, …)`中的路径是否与前端`/action?cmd=`一致。 3. 在命令处理函数中加入串口打印，确认收到命令。
超声波测距不准或不稳定	1. 传感器供电不稳（必须接3.3V）。 2. 触发和回声信号受到电机干扰。 3. 测量间隔太短。	1. 确保Vcc接3.3V，GND共地良好。 2. 将传感器远离电机和驱动模块，或为电机驱动模块电源加滤波电容。 3. 在`getDistance()`函数中已添加`delay(30)`，确保测量间隔。
代码上传失败	1. 驱动未安装（CP2102或CH340）。 2. 开发板型号或端口选错。 3. 上传时未按BOOT键（某些板子需要）。	1. 安装对应的USB转串口驱动。 2. 在IDE中仔细核对选择。 3. 参考具体ESP32开发板的上传说明。

8. 功能扩展与进阶优化

基础功能实现后，你可以尝试以下扩展，让机器人更智能：

增加巡线功能：
- 在车底安装2-3个TCRT5000红外传感器。
- 编写代码读取传感器值（遇到黑线输出高电平，白底输出低电平）。
- 实现PID算法或简单的if-else逻辑，让小车沿着黑色轨迹线行驶。
增加蓝牙控制：
- 利用ESP32内置的蓝牙功能，创建一个简单的手机APP（可使用MIT App Inventor或编写Android Studio应用）通过蓝牙串口发送控制指令。
使用电池供电并优化电源管理：
- 为ESP32和传感器增加一个5V稳压模块（如AMS1117-5.0），从总电池取电。
- 增加一个开关，方便控制总电源。
- 考虑增加电池电压检测，低电量时报警。
增加状态反馈：
- 在Web控制页面上实时显示超声波测距数据、电池电压等。
- 这需要用到WebSocket或服务器推送事件(SSE)技术，ESPAsyncWebServer库支持WebSocket，可以实现双向实时通信。
结构优化与外观装饰：
- 使用3D打印为你的机器人设计一个酷炫的外壳。
- 增加LED灯，用PWM控制实现呼吸灯或转向指示灯效果。

从零开始搭建一个桌面ESP32机器人，是一个融合了硬件连接、嵌入式编程、传感器应用和无线通信的综合性项目。它没有复杂的机械结构，却涵盖了智能设备的核心逻辑。希望这篇详细的教程能为你扫清障碍，成功创造出属于自己的第一个移动智能体。当你看到它按照你的指令在桌面上灵活移动，或者聪明地绕过障碍时，那种成就感正是学习和创造的乐趣所在。