ESP32双轮机器人实战：从硬件搭建到避障与WiFi遥控全解析

2026/8/7 12:00:49
ESP32双轮机器人实战：从硬件搭建到避障与WiFi遥控全解析
最近在整理桌面小项目时发现很多朋友对用ESP32制作一个能跑能转的小机器人很感兴趣但网上的资料要么过于零散要么只停留在理论。本文将手把手带你从零搭建一个功能完整的桌面级ESP32双轮机器人。我们将从硬件选型、电路连接到核心代码编写、无线控制再到避障与巡线功能的实现进行全流程拆解。无论你是刚接触嵌入式开发的学生还是想为创客项目寻找灵感的开发者都能通过本文获得一套可直接复用的完整方案。1. 项目背景与核心概念1.1 什么是桌面ESP32双轮机器人桌面ESP32双轮机器人顾名思义是一个以ESP32微控制器为核心采用两轮差速驱动方式能够在桌面等平坦小范围内自主或受控移动的小型机器人平台。它不同于大型工业机器人其特点是成本低、体积小、易于二次开发非常适合用于学习机器人运动控制、传感器集成、无线通信如Wi-Fi/蓝牙以及初步的智能算法如自动避障、巡线等概念。1.2 它能做什么解决什么问题这个项目主要解决的是低成本入门机器人实践的问题。许多机器人教程需要昂贵的开发板或复杂的机械结构而本项目利用常见的ESP32开发板和廉价的电机、传感器构建了一个功能完备的迷你机器人实验平台。通过它你可以学习运动控制理解PWM脉冲宽度调制控制电机速度以及差速转向的原理。实践传感器应用集成超声波测距、红外巡线等传感器让机器人感知环境。掌握无线通信通过Wi-Fi创建Web控制页面或手机APP实现远程遥控。入门简单算法实现自动避障、自动巡线等基础机器人行为。1.3 为什么选择ESP32ESP32是一款集成了Wi-Fi和蓝牙功能的低成本、低功耗的微控制器芯片。相比于传统的Arduino UNO它性能更强双核处理器、内存更大、外设更丰富并且原生支持无线功能无需额外模块。这使得它成为制作物联网设备和智能小车的绝佳选择我们可以轻松为其赋予“联网大脑”。2. 硬件准备与清单在开始编程之前我们需要准备好所有硬件部件。以下是构建一个基础版桌面机器人的核心清单部件名称规格/型号建议数量作用说明主控制器ESP32开发板 (如ESP32 DEVKIT V1)1机器人的大脑负责逻辑控制和通信。电机驱动模块L298N 或 TB6612FNG1提供足够的电流来驱动电机并接收ESP32的PWM信号控制电机转速和方向。直流减速电机3-6V带编码器可选2提供动力。减速电机扭矩更大。带编码器可实现更精确的速度控制。轮子与电机轴配套2与电机直接连接。万向轮/球小型万向轮或金属球1作为机器人的第三支撑点保持平衡。电源18650锂电池两节及电池盒1套为电机和ESP32供电。注意电机驱动模块和ESP32最好分开供电或使用稳压模块。超声波传感器HC-SR041用于前方障碍物距离检测实现避障。红外巡线传感器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.3VTrig(触发) - ESP32 GPIO5Echo(回响) - ESP32 GPIO18Gnd- ESP32GNDESP32自身供电在开发调试阶段可以通过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/WebServerESP32内置用于创建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 Rrawliteral( !DOCTYPE html html head titleESP32 Robot Controller/title meta nameviewport contentwidthdevice-width, initial-scale1 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 h1ESP32 Desktop Robot/h1 div idcontrolPanel divbutton classbtn ontouchstartsendCmd(F) ontouchendsendCmd(S) onmousedownsendCmd(F) onmouseupsendCmd(S)前进/button/div div button classbtn ontouchstartsendCmd(L) ontouchendsendCmd(S) onmousedownsendCmd(L) onmouseupsendCmd(S)左转/button button classbtn idstop ontouchstartsendCmd(S) ontouchendsendCmd(S) onmousedownsendCmd(S) onmouseupsendCmd(S)停止/button button classbtn ontouchstartsendCmd(R) ontouchendsendCmd(S) onmousedownsendCmd(R) onmouseupsendCmd(S)右转/button /div divbutton classbtn ontouchstartsendCmd(B) ontouchendsendCmd(S) onmousedownsendCmd(B) onmouseupsendCmd(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 ModulePort选择对应的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.3VGND共地良好。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机器人是一个融合了硬件连接、嵌入式编程、传感器应用和无线通信的综合性项目。它没有复杂的机械结构却涵盖了智能设备的核心逻辑。希望这篇详细的教程能为你扫清障碍成功创造出属于自己的第一个移动智能体。当你看到它按照你的指令在桌面上灵活移动或者聪明地绕过障碍时那种成就感正是学习和创造的乐趣所在。

相关新闻