1. 项目缘起与整体设计思路1.1 为什么选择 Freenove ESP32 小车套件作为改造平台手头这台 Freenove ESP32 四驱小车套件是我两年前买来学 Arduino 的入门玩具。它自带一块 ESP32-WROVER-E 模组、四路直流减速电机、一块 8x16 的 LED 点阵屏、一个超声波测距模块、一个红外接收头还有一堆杜邦线和亚克力结构件。原厂配套的例程跑完一遍之后它就被我扔在角落里吃灰了。直到最近整理桌面看着它落满灰尘的样子突然冒出一个念头能不能把它改造成一个有“性格”的桌面宠物机器人而不是一个只会按固定路线跑圈的遥控车这个想法落地之后我给它取名叫Nova。Nova 的核心定位很明确一个放在办公桌上、能对环境和人的互动做出即时反馈的小型机器人。它不需要多强的算力也不需要多复杂的机械结构但必须满足三个条件——反应要快、表情要丰富、交互要自然。ESP32 双核 240MHz 的主频、内置 Wi-Fi 和蓝牙、丰富的 GPIO 和外设接口正好能撑起这个定位。而且 Freenove 这套底盘的机械结构已经调好了省去了大量装配和调试的时间我可以把精力集中在“让它活起来”这件事上。选 ESP32 而不是 Arduino Uno 或者树莓派理由很直接。Arduino Uno 没有无线能力做出来的东西只能插着线跑失去了桌面宠物的灵动感树莓派虽然性能强但功耗高、启动慢而且用 Python 写底层电机控制会有明显的延迟抖动。ESP32 刚好卡在中间有无线、有双核、有硬件定时器和 LEDC 外设、功耗还低用 Arduino 框架或者 ESP-IDF 都能开发生态成熟踩坑成本低。Freenove 的套件里还附带了一块扩展板把电机驱动、LED 点阵、超声波接口都集成好了接线基本是即插即用这对快速原型验证非常友好。1.2 Nova 的核心功能定义与交互逻辑Nova 的功能设计围绕“桌面宠物”这个场景展开我把它拆成了四个层次。第一层是基础运动四驱底盘支持前进、后退、转向和原地旋转运动逻辑用 ESP32 的 LEDC 外设生成 PWM 波控制电机转速通过调整两路 PWM 的占空比实现差速转向。第二层是表情系统8x16 的 LED 点阵屏用来显示眼睛、嘴巴和简单动画比如眨眼、眯眼、张嘴、生气时眼睛变红等。第三层是环境感知超声波模块负责检测前方障碍物红外接收头用来接收遥控器指令后续还计划加一个温湿度传感器做环境数据采集。第四层是无线交互ESP32 内置 Wi-Fi 和蓝牙我打算做一个简单的 Web 页面和蓝牙串口控制通道用手机就能直接操控 Nova 的动作和表情。交互逻辑上Nova 的状态机设计得比较克制。它默认处于“待机”状态眼睛缓慢眨眼偶尔左右张望当超声波检测到有人靠近时切换到“警觉”状态眼睛睁大、身体微微后退如果收到遥控指令进入“执行”状态按照指令运动或表演动作执行完毕后自动回到待机。这个状态机用 FreeRTOS 的两个任务来实现一个任务负责传感器数据采集和状态判断另一个任务负责电机控制和 LED 点阵刷新。两个任务通过队列通信避免阻塞。ESP32 双核的优势在这里体现得很明显——一个核跑传感器和逻辑另一个核跑显示和电机互不干扰刷新率和响应速度都能稳住。1.3 开发环境选型PlatformIO 还是 Arduino IDE开发环境这块我纠结了一阵。Arduino IDE 上手快Freenove 官方例程也是基于 Arduino IDE 写的直接打开就能编译烧录。但 Arduino IDE 的代码补全和库管理实在太弱了项目稍微大一点就难以维护。我最终选了PlatformIO VS Code这套组合。PlatformIO 的库依赖管理是声明式的在platformio.ini里写清楚依赖库和版本号换台电脑也能一键还原环境。而且 PlatformIO 支持多环境配置我可以同时维护 ESP32 的 Arduino 框架版本和 ESP-IDF 版本方便对比测试。安装过程不复杂但有几个坑得提前说。VS Code 装好之后在扩展市场搜 PlatformIO IDE 安装首次启动会自动下载 PlatformIO Core 和工具链。国内网络环境下这一步可能会很慢甚至超时我的做法是提前配置好镜像源或者手动下载离线包。PlatformIO 的离线包在官网有提供下载后解压到~/.platformio目录下即可。另外ESP32 的编译速度在 Windows 上确实偏慢第一次编译一个中等规模的项目可能要两三分钟。我的经验是把项目放在 SSD 上、关闭杀毒软件的实时扫描、在platformio.ini里开启编译缓存这三招下来编译时间能砍掉一半左右。2. 核心硬件解析与接线要点2.1 ESP32 主控板与扩展板的引脚分配Freenove 套件里的 ESP32 主控板是标准的 38 引脚布局但扩展板把大部分引脚都占用了留给用户自定义的引脚其实不多。我在规划 Nova 的硬件接线时先把扩展板的原理图翻出来看了一遍确认了每个功能模块占用的 GPIO。电机驱动用的是 TB6612FNG四路电机占用了 GPIO 12、13、14、15、16、17、18、19 这八个引脚其中四个是方向控制四个是 PWM 调速。LED 点阵屏用的是 MAX7219 驱动芯片占用 GPIO 5、18、23 三个引脚做 SPI 通信。超声波模块占用 GPIO 34 和 35这两个是输入专用引脚不能做输出。红外接收头占用 GPIO 39。剩下的可用引脚里我挑了两个做扩展GPIO 25 和 GPIO 26 留给温湿度传感器 DHT22GPIO 27 留给一个蜂鸣器做声音反馈。这里有个细节要注意ESP32 的 GPIO 34 到 39 是输入专用没有内部上拉电阻接按钮或者传感器的时候必须外接上拉电阻否则读数会飘。我一开始没注意超声波模块的 Echo 引脚接在 GPIO 35 上读数一直不稳定后来在模块端加了一个 10K 的上拉电阻才解决。提示ESP32 的 GPIO 6 到 GPIO 11 连接的是内部 SPI Flash绝对不要用来接外部设备否则会导致程序无法启动。GPIO 0 是启动模式选择引脚上电时如果被拉低会进入下载模式做产品的时候要避免外部电路在启动瞬间把它拉低。2.2 电机驱动与电源管理的实操细节TB6612FNG 这颗电机驱动芯片比传统的 L298N 好用很多导通电阻小、发热低、支持 PWM 频率高。Freenove 扩展板上已经焊好了这颗芯片电机接口也是标准的 PH2.0 端子直接插上就行。但电源部分需要特别注意。套件里配的是四节 AA 电池盒输出电压在 4.8V 到 6V 之间而 ESP32 的工作电压是 3.3V电机驱动逻辑电平也是 3.3V。扩展板上有一颗 AMS1117-3.3 稳压芯片把电池电压降到 3.3V 给 ESP32 供电。问题在于当四个电机同时启动的瞬间电流会突然拉大导致 3.3V 电压跌落ESP32 会复位。我实测过四节满电的镍氢电池在电机堵转时电压能从 5.2V 瞬间掉到 3.8V 以下AMS1117 的压差不够输出就稳不住。解决办法有两个。方案一是换电池用两节 18650 锂电池串联电压 7.4V经过 AMS1117 降到 3.3V 时压差充足电压跌落的影响小很多。方案二是加电容在扩展板的电源输入端并联一个 470uF 到 1000uF 的电解电容再并一个 0.1uF 的陶瓷电容滤高频。我两个方案都上了现在四驱同时启动也不会复位。另外电机电源和逻辑电源最好分开走线避免电机电流在地线上产生压降干扰 ESP32 的模拟采样。扩展板本身没有做电源隔离我在电池盒和扩展板之间加了一个拨动开关方便断电重启。2.3 LED 点阵屏的驱动原理与刷新策略8x16 的 LED 点阵屏是 Nova 表情系统的核心。这块屏用的是 MAX7219 驱动芯片每颗芯片驱动 8x8 的 LED 矩阵两块级联组成 8x16。MAX7219 通过 SPI 接口接收数据刷新率最高可以到 800Hz人眼完全看不到闪烁。但 Arduino 的LedControl库默认刷新率比较低而且每次刷新都要占用 CPU 时间。我的做法是用 ESP32 的硬件 SPI 加上 DMA 传输把刷新任务放在一个独立的 FreeRTOS 任务里优先级设低一点每 10ms 刷新一次。这样主循环完全不受影响表情动画也能保持流畅。表情数据我定义成了一个二维数组每个表情是一帧 8x16 的位图用uint8_t数组存储。比如“眨眼”动画就是三帧眼睛全开、半闭、全闭循环播放。为了节省内存我把所有表情帧放在 PROGMEM 里需要的时候再读出来。这里有个坑MAX7219 的数据格式是每列 8 位对应 8 行 LED而我的位图是按行定义的所以写入之前要做一次转置。我写了一个简单的转置函数在初始化的时候把位图预处理成 MAX7219 需要的格式运行时直接查表省去了实时计算的开销。3. 软件架构与核心代码实现3.1 FreeRTOS 双核任务划分与通信机制Nova 的软件架构基于 FreeRTOS我把功能拆成了三个任务。任务一是传感器采集运行在 Core 0 上每 50ms 读一次超声波距离和红外接收状态把数据打包成结构体通过队列发送给逻辑任务。任务二是行为逻辑也运行在 Core 0 上从队列里取传感器数据根据当前状态机决定下一步动作把电机指令和表情指令分别发送到两个队列。任务三是执行输出运行在 Core 1 上从队列里取指令驱动电机和刷新 LED 点阵。三个任务通过 FreeRTOS 的队列通信队列长度都设成 5满了就丢弃最旧的数据保证实时性。任务优先级的分配有讲究。传感器采集任务优先级设成 3行为逻辑设成 2执行输出设成 4。执行输出的优先级最高因为电机控制和 LED 刷新对时序要求最严格延迟超过 20ms 人眼就能看出卡顿。传感器采集优先级中等超声波模块本身有测量周期读太快也没意义。行为逻辑优先级最低因为它只做决策不直接控制硬件偶尔延迟一下不影响体验。栈大小方面传感器任务给了 2048 字节逻辑任务 4096 字节输出任务 3072 字节。ESP32 的 RAM 有 520KB这点开销完全不是问题。// 队列定义 QueueHandle_t sensorQueue xQueueCreate(5, sizeof(SensorData)); QueueHandle_t motorQueue xQueueCreate(5, sizeof(MotorCmd)); QueueHandle_t faceQueue xQueueCreate(5, sizeof(FaceCmd)); // 任务创建 xTaskCreatePinnedToCore(sensorTask, Sensor, 2048, NULL, 3, NULL, 0); xTaskCreatePinnedToCore(logicTask, Logic, 4096, NULL, 2, NULL, 0); xTaskCreatePinnedToCore(outputTask, Output, 3072, NULL, 4, NULL, 1);3.2 超声波测距的滤波与避障逻辑超声波模块 HC-SR04 的原始读数抖动很大直接拿来用会导致 Nova 频繁误判。我用了两个手段做滤波。第一是硬件层面在 Echo 引脚上加了一个 RC 低通滤波电阻 1K电容 0.1uF把高频噪声滤掉。第二是软件层面连续读五次去掉最大值和最小值剩下的取平均。这样处理之后读数稳定性明显提升在 30cm 范围内的波动能控制在 1cm 以内。避障逻辑我设计得比较保守。当距离小于 15cm 时Nova 进入“警觉”状态眼睛睁大身体后退 10cm当距离小于 8cm 时进入“躲避”状态快速后退并转向直到距离大于 20cm 才恢复。这里有个细节超声波模块的测量角度只有 15 度左右如果障碍物在侧面它是测不到的。所以我在底盘左右两侧各加了一个红外避障传感器作为补充。红外传感器的输出是数字信号直接接 GPIO 就行代码里用外部中断处理响应速度比轮询快很多。float readUltrasonic() { digitalWrite(TRIG_PIN, LOW); delayMicroseconds(2); digitalWrite(TRIG_PIN, HIGH); delayMicroseconds(10); digitalWrite(TRIG_PIN, LOW); long duration pulseIn(ECHO_PIN, HIGH, 30000); float distance duration * 0.034 / 2; return distance; } float filteredDistance() { float readings[5]; for (int i 0; i 5; i) { readings[i] readUltrasonic(); delay(10); } // 排序后去掉最大最小值 // ... 省略排序代码 return (readings[1] readings[2] readings[3]) / 3.0; }3.3 LED 点阵表情动画的实现与优化表情动画的实现分三步定义帧数据、预处理转置、定时刷新。帧数据我用了一个 Python 脚本从图片生成把 8x16 的黑白图片转成uint8_t数组每个字节代表一列。生成之后直接粘贴到代码里放在 PROGMEM 中。预处理转置在setup()里做一次把行优先的位图转成列优先的格式存到一个全局数组里。刷新任务每 10ms 调用一次refreshDisplay()从当前动画帧里取数据通过 SPI 写到 MAX7219。动画切换我用了一个简单的状态变量currentAnim每个动画有一个帧数组和帧率。比如“眨眼”动画有三帧帧率 100ms“生气”动画有两帧帧率 200ms循环播放。切换动画的时候直接改currentAnim和对应的帧指针刷新任务下一轮就会用新数据。这里要注意动画切换的原子性如果刷新任务正在读帧数据主逻辑突然改了指针可能会读到半新半旧的数据。我的做法是用一个互斥锁保护动画状态切换的时候先拿锁改完再释放。ESP32 的 FreeRTOS 支持递归互斥锁用起来很方便。提示MAX7219 的 SPI 时钟频率最高支持 10MHz但实际用的时候建议降到 1MHz 到 4MHz走线长或者干扰大的时候更稳定。我在platformio.ini里把 SPI 频率设成了 2MHz刷新 8x16 的点阵完全够用也没有出现花屏。4. 无线交互与扩展功能4.1 ESP32 内嵌 Web 页面的实现方式Nova 的 Web 控制页面跑在 ESP32 上用的是ESPAsyncWebServer库。这个库比标准的WebServer库好用很多支持异步处理不会阻塞主循环。页面本身是一个简单的 HTML 文件包含几个按钮前进、后退、左转、右转、停止还有一个表情选择下拉框。按钮点击的时候浏览器发送一个 GET 请求到 ESP32比如/move?dirforwardESP32 解析参数后把指令发到电机队列。HTML 文件我放在 LittleFS 文件系统里而不是直接嵌在代码里。这样做的好处是修改页面不用重新编译固件直接通过串口或者 OTA 上传新的 HTML 文件就行。PlatformIO 对 LittleFS 的支持很好在platformio.ini里加一行board_build.filesystem littlefs然后把 HTML 文件放在data目录下编译的时候会自动打包成镜像。上传的时候用pio run --target uploadfs命令几秒钟就搞定。// Web 服务器路由 server.on(/move, HTTP_GET, [](AsyncWebServerRequest *request){ String dir request-getParam(dir)-value(); MotorCmd cmd; if (dir forward) cmd {200, 200}; else if (dir backward) cmd {-200, -200}; else if (dir left) cmd {-150, 150}; else if (dir right) cmd {150, -150}; else cmd {0, 0}; xQueueSend(motorQueue, cmd, 0); request-send(200, text/plain, OK); });4.2 蓝牙串口控制与手机 App 配网除了 Wi-FiNova 还支持蓝牙串口控制。ESP32 的经典蓝牙和 BLE 都支持我用的是经典蓝牙的 SPP 协议手机端装一个通用的蓝牙串口 App 就能连。代码里用BluetoothSerial库初始化之后SerialBT.available()就能读到手机发来的指令。指令格式和 Web 页面保持一致比如发送MOVE:F表示前进FACE:2表示切换到第二个表情。蓝牙的好处是不需要配网开机就能连适合在没有 Wi-Fi 的环境下快速控制。配网这块我用了WiFiManager库第一次上电的时候 Nova 会开一个热点手机连上之后弹出配置页面输入 Wi-Fi 密码后自动保存并重启。后续上电会自动连接保存的 Wi-Fi连不上就重新开热点。这个库的好处是不需要在代码里硬编码 Wi-Fi 密码分享给别人的时候也不用担心密码泄露。不过WiFiManager的默认超时是 180 秒我改成了 60 秒避免长时间卡在配网模式。4.3 温湿度传感器与边缘 AI 的初步尝试温湿度传感器我选的是 DHT22精度比 DHT11 高不少温度误差正负 0.5 度湿度误差正负 2%。接线很简单VCC 接 3.3VGND 接地数据脚接 GPIO 25中间加一个 10K 的上拉电阻。代码里用DHTesp库读取数据每 2 秒读一次读到的温湿度显示在 Web 页面上同时根据温度调整 Nova 的表情——温度高于 30 度时显示“热”的表情低于 10 度时显示“冷”的表情。这个功能虽然简单但让 Nova 有了对环境的基本感知不再只是一个遥控玩具。边缘 AI 这块我还在摸索阶段。ESP32 的算力有限跑不了复杂的神经网络但跑一些简单的分类模型还是可以的。我试过用 TensorFlow Lite for Microcontrollers 部署一个三层的全连接网络输入是超声波距离、红外状态、温湿度输出是“前进”“后退”“转向”三个动作。模型训练在电脑上完成量化成 int8 之后只有几 KB推理时间在 10ms 以内。不过实际效果一般因为训练数据太少模型容易过拟合。后续打算加一个 MPU6050 陀螺仪采集更多维度的数据再重新训练一版。5. 常见问题与排查实录5.1 编译与烧录阶段的典型问题问题一PlatformIO 编译 ESP32 项目时报错fatal error: esp32-hal.h: No such file or directory。这个通常是平台包没装全在 PlatformIO 的 PIO Home 里点 Platforms搜 espressif32重新安装一遍。如果还是不行删掉~/.platformio目录下的packages文件夹重新编译让 PlatformIO 自动下载依赖。问题二烧录时提示Failed to connect to ESP32: Timed out waiting for packet header。检查 USB 线是不是只供电不传数据换一根线试试。如果线没问题按住开发板上的 BOOT 键再点烧录等出现Connecting...的时候松开。Freenove 的板子有自动下载电路正常情况下不需要手动按但如果串口被其他程序占用了自动下载会失败。关掉串口监视器和其他占用串口的软件再试。问题三Windows 上编译速度特别慢每次都要好几分钟。在platformio.ini里加build_cache_dir .pio/build_cache开启编译缓存。另外把项目目录加到 Windows Defender 的排除列表里实时扫描对编译速度影响很大。如果还是慢考虑换 Linux 或者 macOS 开发同样的项目在 Ubuntu 上编译只要 30 秒左右。5.2 运行阶段的硬件与软件故障排查问题四电机启动时 ESP32 复位。前面电源部分已经分析过根本原因是电压跌落。先加电容470uF 起步不行就换 18650 电池。另外检查电机线有没有短路四驱底盘的电机线在亚克力板边缘容易磨破皮我用热缩管把裸露的接头都包了一遍。问题五LED 点阵显示花屏或者闪烁。先检查 SPI 线有没有接好MAX7219 的 DIN、CLK、CS 三根线要远离电机线避免干扰。如果线没问题把 SPI 频率降到 1MHz 试试。还有一种可能是刷新任务和主循环抢 SPI 总线确保只有刷新任务在操作 MAX7219其他任务不要直接调 SPI。问题六超声波读数一直不变或者跳变。检查 Echo 引脚有没有上拉电阻GPIO 34 到 39 是输入专用没有内部上拉。另外超声波模块对电源噪声很敏感在 VCC 和 GND 之间并一个 0.1uF 的陶瓷电容效果立竿见影。如果还是不行换一个超声波模块HC-SR04 的品控参差不齐我买到过一批次品读数完全不能用。问题七Web 页面打不开或者响应很慢。先确认 ESP32 和手机在同一个 Wi-Fi 网络下然后检查ESPAsyncWebServer的端口是不是 80。如果路由器开了 AP 隔离设备之间不能互访需要在路由器设置里关掉。另外WiFiManager配网之后ESP32 的 IP 地址可能会变在串口监视器里打印一下 IP用新 IP 访问。5.3 常见问题速查表现象可能原因排查方法解决方案编译报错找不到头文件平台包缺失检查~/.platformio/packages重装 espressif32 平台烧录超时串口被占用或线材问题换线、关串口监视器手动按 BOOT 键烧录电机启动复位电源电压跌落万用表测 3.3V 电压加电容或换 18650 电池LED 点阵花屏SPI 干扰或频率过高降低 SPI 频率远离电机线加屏蔽超声波读数异常缺上拉电阻或电源噪声检查 GPIO 34-39 上拉加 10K 上拉和 0.1uF 电容Web 页面无法访问网络隔离或 IP 变化串口打印 IP关 AP 隔离用新 IP蓝牙连不上配对信息冲突删除手机端配对记录重新配对重启 ESP32提示ESP32 的 GPIO 12 是启动模式引脚之一如果外部电路在上电时把它拉高ESP32 会进入错误的启动模式。Freenove 扩展板上 GPIO 12 接了电机驱动上电瞬间电机驱动的输入阻抗可能会影响电平导致偶尔启动失败。我的做法是在 GPIO 12 和 GND 之间加一个 10K 的下拉电阻确保上电时电平稳定。6. 个人实操心得与后续扩展方向6.1 从零到一搭建 Nova 的几点体会这个项目从起意到基本能用前后花了大概三周时间大部分时间不是在写代码而是在调硬件和排查各种莫名其妙的故障。最大的体会是电源设计比代码重要得多。我一开始把精力都放在软件架构上结果电机一启动就复位查了两天才发现是电源问题。后来换了 18650 电池、加了电容所有莫名其妙的复位和花屏问题都消失了。如果你也要做类似的项目先把电源方案定下来再动代码能省掉很多返工。第二个体会是不要追求一步到位。我最初想把所有功能都塞进去结果代码越写越乱调试难度指数级上升。后来我改成增量开发先让电机能转再加 LED 点阵再加超声波最后加无线控制。每加一个功能就测试一遍确保之前的没问题再继续。这样虽然看起来慢但实际效率高很多出了问题也能快速定位是哪个环节引入的。第三个体会是善用现成的库但要知道库的边界。Arduino 生态的库很多但质量参差不齐。ESPAsyncWebServer和WiFiManager这两个库帮我省了大量时间但LedControl库的性能不行我最后还是自己写了 SPI 刷新逻辑。选库的时候先看 GitHub 的 star 数和最近更新时间太老的库慎用ESP32 的 Arduino 核心更新很快老库可能不兼容。6.2 Nova 后续可以怎么玩Nova 目前的功能还比较基础后续我打算从三个方向扩展。第一是加一个摄像头模块ESP32-CAM 或者外接 OV2640做简单的图像识别比如识别手势或者颜色让 Nova 能对人的动作做出反应。第二是加一个麦克风模块用 INMP441 做声音采集检测拍手或者特定频率的声音实现声控唤醒。第三是加一个舵机云台让超声波模块能旋转扫描实现更广的探测范围同时云台的动作也能作为表情的一部分让 Nova 的“肢体语言”更丰富。软件层面我打算把行为逻辑从硬编码的状态机改成基于规则引擎的决策系统用 JSON 配置文件定义状态和转移条件这样调整行为不用重新编译固件改配置文件就行。另外还想试试 ESP-IDF 的原生开发对比一下和 Arduino 框架在性能和资源占用上的差异。ESP32 的蓝牙 Mesh 功能也很有意思如果做多个 Nova可以让它们之间互相通信实现群体行为比如一起前进、一起转向像一群小动物一样。最后分享一个我在调试过程中发现的小技巧。ESP32 的串口日志默认输出到 UART0但如果你用 USB 转串口模块接在 GPIO 16 和 17 上可以把日志重定向到 UART2这样 UART0 就空出来做其他用途。在platformio.ini里加-D CORE_DEBUG_LEVEL3可以控制日志级别调试的时候开 verbose发布的时候关掉能省不少串口带宽。这个技巧在同时用串口和蓝牙的时候特别有用避免日志和蓝牙数据抢串口。