基于MicroPython与ESP32的WiFi智能小车：从硬件搭建到Web控制全流程

1. 项目概述：当MicroPython遇见ESP32，一台智能小车就此诞生

如果你手头有一块ESP32开发板，几个电机和轮子，再加上一点对物联网和嵌入式开发的好奇心，那么制作一台属于自己的WiFi遥控小车，绝对是一个能让你从入门到精通的绝佳项目。这不仅仅是把几个模块拼在一起，更是一个融合了硬件控制、无线通信和Web服务开发的微型系统工程。我最近就基于MicroPython和ESP32，完整地走了一遍这个流程，从电路焊接、固件烧录，到代码编写、网页控制，最终让一台小车在我的局域网里灵活跑动。整个过程充满了挑战，也收获了不少只有亲手做过才能体会到的“坑”和技巧。

这个项目的核心，就是利用ESP32强大的WiFi和蓝牙功能，以及MicroPython简洁高效的编程体验，构建一个可以通过浏览器控制的移动平台。你不再需要复杂的Arduino IDE配置，也不用头疼于C++的指针和内存管理，Python的语法让控制逻辑变得异常清晰。通过内置的Web服务器（比如我用的MicroDot），你可以创建一个简单的控制页面，用手机或电脑的浏览器就能实时发送前进、后退、转向等指令。这听起来是不是比传统的红外或蓝牙遥控更有意思？它不仅是一个玩具，更是学习物联网设备开发、网络通信协议和实时控制系统的绝佳载体。

2. 核心硬件选型与电路设计思路

2.1 主控芯片：为什么是ESP32？

在众多微控制器中，选择ESP32作为这个项目的核心，几乎是必然的。首先，它原生集成了双核处理器、WiFi和蓝牙，这意味着我们无需额外模块就能实现网络连接，极大地简化了硬件设计和成本。其次，它对MicroPython的支持已经非常成熟，有稳定的固件和活跃的社区。相比于STM32等芯片，ESP32刷写MicroPython固件的流程堪称“傻瓜式”，通过一条USB线就能完成，对新手极其友好。

注意：市面上ESP32的型号变体很多，如ESP32-S2、ESP32-S3、ESP32-C3等。对于小车项目，推荐最经典的ESP32-WROOM-32或ESP32-DevKitC开发板。它们GPIO口丰富，供电简单，且资料最多。避免使用仅支持单核或无蓝牙的简化版本，虽然便宜，但可能在某些库的兼容性上遇到问题。

2.2 电机驱动方案：L298N还是TB6612？

小车的动力来源是直流电机，而微控制器的GPIO口无法直接驱动，必须借助电机驱动模块。这里有两个主流选择：经典的L298N和更现代的TB6612。

我最初用的是手头闲置的L298N，它皮实耐用，驱动能力强，但发热量也大，效率相对较低。在调试过程中，我发现当电池电压下降时，L298N的压降会更明显，导致电机乏力。后来换成了TB6612，体验提升巨大。TB6612采用MOSFET设计，效率高、发热小，而且支持更高的PWM频率，让电机运行更平稳安静。对于小车这种电池供电的设备，效率就是续航。

接线要点：

• 电源隔离：务必为电机驱动模块提供独立的电源（通常是7-12V的电池组），并与ESP32的3.3V逻辑电源共地。切勿直接用ESP32的5V输出驱动电机，电流不够，还会干扰核心板稳定。
• PWM频率设置：在MicroPython中，初始化PWM时，建议将频率设置为1000Hz。频率太低电机会啸叫，太高则驱动芯片可能响应不了。machine.PWM(machine.Pin(12), freq=1000)
• 使能引脚：TB6612的STBY（待机）引脚或L298N的使能引脚，一定要接高电平（VCC）或通过MCU控制使其有效，否则电机不会转动。这是我调试时第一个卡住的地方。

2.3 电源管理：稳定压倒一切

小车的“心脏病”很多源于电源。ESP32在WiFi全功率工作时，峰值电流可能超过500mA。电机启动瞬间的冲击电流更大。如果使用常见的5V移动电源或9V电池直接供电，电压会被拉垮，导致ESP32不断重启。

我的方案是使用一节18650锂电池（3.7V）搭配一个DC-DC降压模块，输出稳定的5V给ESP32。电机则使用另一组电池（如两节18650串联，7.4V）供电。如果想让结构更紧凑，可以选用带有充放电管理功能的18650电池 shield，它能提供5V和3.3V输出，但需注意其5V输出的电流承载能力（通常1A左右），同时驱动ESP32和电机可能吃紧，最好还是将电机电源分开。

实操心得：在面包板搭建原型阶段，就用万用表实时监测ESP32的VCC电压。当同时启动WiFi和电机时，观察电压是否有明显跌落（如从5V跌到4.5V以下）。如果有，说明电源功率不足，这是后续一切灵异故障（如WiFi断连、控制失灵）的根源。

3. MicroPython固件烧录与基础环境搭建

3.1 固件获取与烧录工具选择

首先，你需要为ESP32刷入MicroPython固件。前往MicroPython官网下载最新的稳定版ESP32固件（.bin文件）。烧录工具我强烈推荐esptool.py，它是一个命令行工具，功能强大且稳定。

不要被命令行吓倒，其操作非常固定。在电脑上安装Python后，通过pip安装即可：pip install esptool。连接ESP32到电脑，确认其串口号（在Windows设备管理器的“端口”中查看，如COM3；在Linux/macOS下通常是/dev/ttyUSB0）。

关键的擦除和烧录命令如下：

# 擦除整个Flash esptool.py --chip esp32 --port COM3 erase_flash # 烧录固件，注意替换your_firmware.bin为实际文件名 esptool.py --chip esp32 --port COM3 --baud 460800 write_flash -z 0x1000 your_firmware.bin

--baud 460800设置较高的波特率可以加快烧录速度。0x1000是固件在Flash中的起始地址，对于ESP32的MicroPython固件，这个值通常是固定的。

3.2 首次交互与网络配置

烧录成功后，使用串口终端工具（如PuTTY、Thonny IDE的串口终端，或者更简单的screen、minicom）连接ESP32。波特率设置为115200。上电后，你会看到MicroPython的启动信息和一个>>>的REPL（交互式解释器）提示符。在这里，你可以直接输入Python代码并立即执行，比如print(“Hello, RoboCar!”)。

要让小车联网，你需要编写一个boot.py或main.py文件。我习惯将WiFi连接代码放在boot.py中，这样板子一启动就会自动连接。使用network模块：

import network import time def connect_wifi(ssid, password): wlan = network.WLAN(network.STA_IF) wlan.active(True) if not wlan.isconnected(): print(‘Connecting to network...’) wlan.connect(ssid, password) # 等待连接，最多10秒 for i in range(10): if wlan.isconnected(): break time.sleep(1) if wlan.isconnected(): print(‘Network config:’, wlan.ifconfig()) else: print(‘Connection failed’) # 可以考虑在这里启动AP模式，作为备选方案 # 替换成你的WiFi信息 connect_wifi(‘Your_SSID’, ‘Your_Password’)

将这段代码通过串口工具或Thonny IDE保存为boot.py到ESP32的文件系统中。重启后，它就会自动执行并连接网络。连接成功后，记下打印出的IP地址（如192.168.1.100），这就是我们后续Web服务器的访问地址。

4. 运动控制核心：电机驱动与PWM调速

4.1 GPIO引脚分配与初始化

在编写驱动代码前，必须规划好GPIO引脚。以TB6612驱动两个电机为例，每个电机需要两个输入引脚（IN1, IN2）控制方向，一个PWM引脚控制速度。假设我们如下分配（具体请根据你的接线调整）：

• 左电机：IN1 -> GPIO12, IN2 -> GPIO13, PWM -> GPIO14
• 右电机：IN3 -> GPIO25, IN4 -> GPIO26, PWM -> GPIO27

此外，TB6612的STBY引脚接GPIO15，用于总使能。

初始化代码如下：

from machine import Pin, PWM # 定义引脚 STBY = Pin(15, Pin.OUT) STBY.value(1) # 解除待机 # 左电机方向控制 L_IN1 = Pin(12, Pin.OUT) L_IN2 = Pin(13, Pin.OUT) # 左电机PWM速度控制，频率1000Hz L_PWM = PWM(Pin(14), freq=1000, duty_u16=0) # 初始占空比为0，电机停止 # 右电机方向控制 R_IN1 = Pin(25, Pin.OUT) R_IN2 = Pin(26, Pin.OUT) # 右电机PWM R_PWM = PWM(Pin(27), freq=1000, duty_u16=0)

4.2 封装电机控制函数

为了让控制逻辑清晰，我们将电机的基本动作封装成函数。一个电机的运动状态无非是正转、反转、停止和刹车。通过设置IN1/IN2的高低电平组合来控制方向，通过调整PWM的duty_u16值（范围0-65535）来控制速度。

def motor_left(speed): “”“控制左电机，speed范围-100到100，负值为反转”“” if speed > 0: L_IN1.value(1) L_IN2.value(0) L_PWM.duty_u16(int(speed * 655.35)) # 将百分比转换为0-65535 elif speed < 0: L_IN1.value(0) L_IN2.value(1) L_PWM.duty_u16(int(-speed * 655.35)) else: # speed == 0，刹车模式（短路刹车，停止更快） L_IN1.value(1) L_IN2.value(1) L_PWM.duty_u16(0) def motor_right(speed): # 同理实现右电机控制... pass def car_stop(): “”“紧急停止，两个电机都刹车”“” motor_left(0) motor_right(0)

这里有一个关键点：当speed=0时，我设置了IN1=IN2=1，这是TB6612的“短路刹车”模式，能让电机快速停止，比单纯关闭PWM（惯性滑行）的响应更好。但请注意，L298N模块可能不支持这种模式，需要设置为IN1=IN2=0（自由停止）。

4.3 实现差速转向

小车转向不是靠舵机，而是通过左右轮的速度差实现的。例如，左转时，右轮速度大于左轮速度；原地旋转时，左右轮速度大小相等、方向相反。

def car_move(speed_left, speed_right): “”“直接控制左右轮速度”“” motor_left(speed_left) motor_right(speed_right) def car_forward(speed): “”“前进”“” car_move(speed, speed) def car_backward(speed): “”“后退”“” car_move(-speed, -speed) def car_turn_left(speed): “”“左转（原地或弧线，取决于差速大小），这里实现为原地左转”“” car_move(-speed, speed) def car_turn_right(speed): “”“原地右转”“” car_move(speed, -speed)

你可以进一步丰富这个控制库，比如加入“弧线转向”（一个轮子快，一个轮子慢）等更平滑的动作。

5. 构建Web控制服务器：MicroDot实战

5.1 为什么选择MicroDot？

MicroPython上能跑的Web框架有好几个，如microdot、picoweb等。我选择MicroDot，因为它极其轻量，核心只有一个文件，功能却足够我们使用：路由、请求处理、模板渲染（如果需要）。对于只需要提供几个API接口和控制页面的小车来说，它再合适不过。

首先，需要将MicroDot的库文件上传到ESP32。你可以直接从GitHub下载microdot.py，然后通过Thonny IDE或ampy工具上传到板子的文件系统根目录。

5.2 创建服务器与路由处理

我们的服务器需要做两件事：1. 提供一个简单的HTML控制页面；2. 提供接收控制命令的API接口。

import microdot as md from microdot import Microdot, Response app = Microdot() # 创建应用实例 # 提供静态HTML控制页面 @app.route(‘/‘) def index(request): html = “”“ <!DOCTYPE html> <html> <head> <title>WiFi RoboCar Controller</title> <meta name=“viewport” content=“width=device-width, initial-scale=1.0”> <style> body { text-align: center; font-family: Arial; } .control-pad { margin: 20px auto; width: 300px; height: 300px; position: relative; } .btn { position: absolute; width: 80px; height: 80px; font-size: 24px; border: none; border-radius: 10px; background: #4CAF50; color: white; touch-action: manipulation; /* 防止移动端触摸延迟 */ } #forward { top: 0; left: 110px; } #backward { bottom: 0; left: 110px; } #left { top: 110px; left: 0; } #right { top: 110px; right: 0; } #stop { top: 110px; left: 110px; } </style> </head> <body> <h1>MicroPython RoboCar Controller</h1> <p>Connected to: <span id=“ip”>””” + get_ip_address() + “”“</span></p> <div class=“control-pad”> <button class=“btn” id=“forward” onmousedown=“sendCmd(‘F’)” ontouchstart=“sendCmd(‘F’)” onmouseup=“sendCmd(‘S’)” ontouchend=“sendCmd(‘S’)”>↑</button> <button class=“btn” id=“backward” onmousedown=“sendCmd(‘B’)” ontouchstart=“sendCmd(‘B’)” onmouseup=“sendCmd(‘S’)” ontouchend=“sendCmd(‘S’)”>↓</button> <button class=“btn” id=“left” onmousedown=“sendCmd(‘L’)” ontouchstart=“sendCmd(‘L’)” onmouseup=“sendCmd(‘S’)” ontouchend=“sendCmd(‘S’)”>←</button> <button class=“btn” id=“right” onmousedown=“sendCmd(‘R’)” ontouchstart=“sendCmd(‘R’)” onmouseup=“sendCmd(‘S’)” ontouchend=“sendCmd(‘S’)”>→</button> <button class=“btn” id=“stop” onclick=“sendCmd(‘S’)”>STOP</button> </div> <script> function sendCmd(cmd) { fetch(‘/cmd/’ + cmd).catch(e => console.log(‘Error:’, e)); } // 防止手机浏览器在触摸按钮时滚动页面 document.addEventListener(‘touchmove’, function(e) { if(e.target.classList.contains(‘btn’)) e.preventDefault(); }, { passive: false }); </script> </body> </html> “”“ return Response(html, headers={‘Content-Type’: ‘text/html’}) # 命令处理API @app.route(‘/cmd/<command>’) def handle_command(request, command): speed = 70 # 默认速度百分比 if command == ‘F’: car_forward(speed) elif command == ‘B’: car_backward(speed) elif command == ‘L’: car_turn_left(speed) elif command == ‘R’: car_turn_right(speed) elif command == ‘S’: car_stop() else: return {‘error’: ‘Unknown command’}, 400 return {‘status’: ‘OK’, ‘command’: command} def get_ip_address(): import network wlan = network.WLAN(network.STA_IF) if wlan.isconnected(): return wlan.ifconfig()[0] return ‘Not Connected’ # 启动服务器 if __name__ == ‘__main__’: print(‘Starting Web Server on http://‘ + get_ip_address() + ‘:80‘) app.run(host=‘0.0.0.0’, port=80, debug=True)

这个HTML页面设计了一个简单的十字控制面板，按钮使用了onmousedown和ontouchstart来触发开始动作，用onmouseup和ontouchend来触发停止，实现了“按下即走，松开即停”的自然操控感，同时兼容电脑和手机浏览器。

5.3 服务器部署与优化

将上述所有代码整合到一个main.py文件中，并上传到ESP32。重启后，小车会先连接WiFi，然后启动Web服务器。在浏览器中输入ESP32的IP地址，就能看到控制页面了。

实操心得：ESP32的内存有限（通常约500KB可用RAM），在运行Web服务器和处理并发请求时压力较大。因此，务必注意：

1. 保持HTML页面精简：不要引入大型CSS/JS库，内联小量样式和脚本即可。
2. 及时释放资源：MicroDot默认会为每个请求创建新对象，在处理完请求后，确保没有意外的内存泄漏。对于简单的API，这通常不是问题。
3. 处理异常断开：网络不稳定时，客户端可能异常断开。确保你的控制命令函数（如car_forward）有超时机制，或者定期发送“心跳”命令来维持状态，避免小车因最后一个命令一直执行而失控。
4. 端口占用：确保端口80没有被其他服务占用。如果连接失败，可以尝试换用其他端口（如8080），并在访问时加上端口号http://192.168.1.100:8080。

6. 功能扩展与进阶玩法

基础的控制实现后，这个平台还有巨大的扩展空间。你可以为小车增加“眼睛”和“耳朵”，让它更智能。

6.1 增加状态反馈与传感器集成

目前的控制是单向的，你不知道小车的电量、速度或前方是否有障碍。我们可以轻松集成传感器并通过Web页面显示数据。

• 超声波测距：加一个HC-SR04模块，测量前方距离。在Web页面上新增一个区域，通过JavaScript定期（如每秒一次）向ESP32发送请求获取距离数据并更新显示。当距离过近时，服务器端可以自动发送停止命令。
• 电池电压监测：通过ESP32的ADC引脚连接一个分压电路，监测电池电压。在Web页面上显示电量百分比或低压警告。
• 摄像头图传：这需要更强大的硬件（如ESP32-CAM），但原理相通。你可以使用MicroPython的camera模块捕获图像，然后通过服务器提供静态图片流或简单的MJPEG视频流，在网页上显示实时画面，实现第一人称视角（FPV）驾驶。

6.2 实现自动巡航与避障

结合超声波传感器和简单的状态机逻辑，你可以让小车实现自主避障。代码逻辑可以放在一个独立的线程或异步任务中，与Web服务器并行运行。

import _thread import time def auto_pilot(): while True: distance = get_ultrasonic_distance() # 假设有这个函数 if distance < 20: # 距离小于20厘米 car_stop() time.sleep(0.5) car_backward(50) time.sleep(0.8) car_turn_right(70) # 随机选择一个方向转向 time.sleep(0.5) car_stop() else: car_forward(60) time.sleep(0.1) # 控制循环频率 # 在合适的时机（如连接WiFi后）启动自动巡航线程 # _thread.start_new_thread(auto_pilot, ())

注意：MicroPython的线程支持有限，且全局变量需要小心处理以避免竞态条件。更稳健的做法是使用asyncio库进行异步编程，将传感器读取、电机控制和网络服务都作为异步任务来管理。

6.3 优化控制协议与低延迟

当前的/cmd/<command>API对于简单控制足够，但如果你追求更低的延迟和更流畅的控制体验，可以考虑以下优化：

1. WebSocket通信：替代HTTP轮询或短连接。WebSocket能保持长连接，实现双向、低延迟的实时通信。有MicroPython的WebSocket库可用，但实现稍复杂。
2. 命令队列与消抖：在服务器端维护一个命令队列，并设置一个消抖（debounce）机制。当快速接收到多个相同命令时，只执行一次，防止电机因频繁启停而抖动。
3. 速度滑块：在网页上增加一个速度滑块，将速度值实时发送给小车，实现无级变速，而不是固定的几个档位。

7. 常见问题与深度排查实录

即使按照步骤操作，你也可能会遇到一些棘手的问题。下面是我在项目中踩过的坑和解决方案。

7.1 WiFi连接不稳定或无法连接

• 现象：ESP32反复重启，或boot.py中打印Connection failed。
• 排查：
  1. 检查SSID和密码：确保没有空格或中文字符。最好先在REPL里手动执行连接代码测试。
  2. 信号强度：ESP32的WiFi天线性能一般。确保路由器距离不要太远，或中间障碍物过多。
  3. 电源问题：这是最常见的原因！用万用表测量ESP32的3.3V或5V输入引脚，在启动WiFi时电压是否稳定。如果跌落严重，必须加强电源。
  4. 路由器设置：有些路由器设置了MAC地址过滤或仅支持某些WiFi模式（如仅5GHz）。尝试将路由器频段改为2.4GHz，并检查加密方式是否为WPA2-PSK（AES）。

7.2 电机不转或转动异常

• 现象：代码无误，但电机不转；或只有一个电机转，另一个抖动。
• 排查：
  1. 使能引脚：确认电机驱动模块的使能引脚（如TB6612的STBY）已接高电平。
  2. 电源共地：确保电机驱动板的电源地（GND）和ESP32的GND已经连接在一起。这是必须的，否则逻辑电平无法正确识别。
  3. PWM频率与占空比：用示波器或逻辑分析仪检查PWM引脚是否有波形输出。如果没有，检查GPIO引脚号是否设置正确。如果占空比一直为0，电机自然不会转。确保你的speed参数正确传递到了duty_u16函数。
  4. 电流不足：电机启动瞬间需要较大电流（堵转电流更大）。如果电池电量不足或电源线太细，电压会被拉低，导致驱动芯片复位或ESP32重启。尝试单独给电机供电。

7.3 Web页面无法访问或控制延迟高

• 现象：能ping通ESP32的IP，但浏览器打不开页面；或按钮按下后小车反应慢半拍。
• 排查：
  1. 防火墙/杀毒软件：暂时关闭电脑的防火墙和杀毒软件，排除本地拦截。
  2. 服务器未启动：在REPL中检查是否有Starting Web Server...的打印信息。如果没有，检查main.py是否有语法错误，或者是否因为内存不足而启动失败。
  3. 内存泄漏：长时间运行后，如果控制越来越卡，可能是内存泄漏。在REPL中使用import gc; gc.mem_free()查看剩余内存。在代码中适当位置（如每次处理完请求后）手动调用gc.collect()进行垃圾回收。
  4. 网络拥堵：确保你的手机/电脑和ESP32在同一个局域网子网内。如果家里有多个AP或子网，可能无法直接访问。
  5. 浏览器缓存：尝试使用浏览器的无痕模式访问，或强制刷新（Ctrl+F5）。

7.4 代码上传失败或文件系统错误

• 现象：使用Thonny或ampy上传文件时提示超时、失败，或文件内容乱码。
• 排查：
  1. 串口占用：确保没有其他软件（如之前的串口终端、Arduino IDE）占用了ESP32的串口。
  2. 文件系统损坏：MicroPython的文件系统（LittleFS或FAT）偶尔可能损坏。可以尝试重新擦除Flash并烧录固件，这会清空所有文件。所以重要的代码最好在电脑上有备份。
  3. 使用稳定的工具：对于文件操作，Thonny IDE的集成环境比命令行工具ampy更稳定可靠，推荐使用。

这个项目从硬件焊接到最后代码调试，每一步都可能遇到小问题，但解决问题的过程正是学习嵌入式开发最宝贵的部分。当你最终看到小车在浏览器指令下精准移动时，那种成就感是无与伦比的。它不仅是一个遥控车，更是一个可无限扩展的智能移动平台，你可以在此基础上添加摄像头、机械臂、环境传感器，甚至结合机器学习，做出更有趣的应用。