Freenove ESP32小车改造：桌面宠物机器人Nova的表情与双通道控制-开发者社区

1. 从一辆吃灰的 Freenove 小车到会撒娇的 Nova

去年年底收拾工作台，翻出来一套 Freenove ESP32 四驱小车套件。买的时候雄心勃勃想搞循迹避障，结果焊完底盘、跑通蓝牙遥控之后就扔在角落吃灰了。这次重新捡起来，我给自己定了个不太一样的题目：不做那种"能跑就行"的遥控车，而是把它改造成一个有性格、会表达、能互动的桌面宠物机器人，名字就叫 Nova。

这个项目的核心思路其实很朴素：Freenove 套件本身提供了底盘、电机驱动、ESP32-WROVER 主控、超声波和红外模块，硬件底子够用；真正缺的是"灵魂"——也就是让这台车表现出情绪、对触摸和距离有反应、能通过网页和蓝牙两种方式被操控。所以 Nova 的定位是：一台基于 Freenove ESP32 小车套件的桌面宠物机器人，具备表情显示、触摸互动、避障撒娇、Web 与蓝牙双通道控制能力。

适合谁来参考？如果你手上有 Freenove ESP32 套件（或者任何 ESP32 四驱底盘），会一点 Arduino 或 PlatformIO，想从"点亮 LED"进阶到"做一个完整的小项目"，那这篇内容基本可以照着抄。如果你只是想了解 ESP32 在机器人项目里的工程组织方式，也能从里面拿到不少可复用的经验。整篇我会围绕硬件改造、固件架构、表情系统、双通道通信、以及调试踩坑这几块展开，尽量把每个"为什么这么设计"讲清楚。

2. Nova 的硬件改造：在 Freenove 底盘上做减法而不是加法

2.1 为什么我砍掉了循迹和红外模块

Freenove 套件原配的传感器挺全：四路循迹、超声波、红外接收、蓝牙。但做宠物机器人，循迹模块基本用不上——Nova 不需要沿着黑线走，它需要的是"感知人的存在"。所以我把底盘上那排循迹传感器全部拆掉，只保留超声波（HC-SR04）和一颗朝前的红外避障模块。

这么做的理由很实际：循迹模块装在底盘底部，走线要穿过底板，拆掉之后底盘腾出了一大块空间，正好用来放一块 0.96 寸 OLED 和触摸传感器。做减法比做加法难，因为每砍一个模块都要确认它不会影响核心体验。循迹砍掉不影响，因为 Nova 的移动逻辑是"随机漫步 + 遇障转向"，不需要精确路径。

2.2 表情屏和触摸传感器的选型与接线

表情显示我选了 SSD1306 驱动的 0.96 寸 I2C OLED，128x64 分辨率。为什么不用 TFT 彩屏？两个原因：一是 I2C 只占两根线（GPIO21/22），省引脚；二是 OLED 黑底白字做"眼睛"效果特别干净，成本也低。接线很简单：

OLED VCC → 3.3V，GND → GND，SCL → GPIO22，SDA → GPIO21
触摸传感器（TTP223）OUT → GPIO4，VCC → 3.3V，GND → GND

TTP223 这颗触摸芯片实测非常稳，隔着 2mm 亚克力板也能触发。我把它贴在车顶盖内侧，手指一碰车顶，Nova 就会"眨眼"并发出开心的表情。这里有个细节：TTP223 默认输出是高电平有效，但它的灵敏度可以通过板载电容调节，如果发现误触发频繁，把灵敏度调低一档会好很多。

2.3 供电与走线的几个坑

Freenove 底盘用的是 4 节 AA 电池盒（约 6V），经过板载稳压给 ESP32 供 3.3V。但 OLED 和触摸传感器都从 3.3V 取电后，我发现电机启动瞬间 OLED 会闪一下——典型的电压跌落。解决办法是在 OLED 的 VCC 和 GND 之间并一颗 100uF 电解电容，就近储能。这个技巧在电机类项目里几乎是标配，但很多教程不会提。

走线方面，我用扎带把杜邦线沿着底盘边缘固定，避免卷入轮子。ESP32 的 GPIO 引脚在 Freenove 板子上是引出排针，插拔方便，但长期震动容易松，建议用热熔胶点一下关键接头。

3. 固件架构：为什么我最终选了 PlatformIO 而不是 Arduino IDE

3.1 Arduino IDE 的离线包困境

一开始我用的是 Arduino IDE + esp32 离线包，毕竟 Freenove 官方教程就是这套。但项目一复杂问题就来了：我想把代码拆成motor.cpp、display.cpp、sensor.cpp、web.cpp多个文件，Arduino IDE 的多文件管理靠标签页，改一个函数要在几个标签间来回跳，而且没有真正的头文件依赖分析。更头疼的是库版本管理——OLED 库、WebServer 库、蓝牙库混在一起，升级一个经常崩另一个。

Windows 上编译 ESP32 本来就慢，Arduino IDE 每次全量编译要等两三分钟，改一行代码等一次，效率极低。我试过用 arduino-cli 做命令行编译，速度好一点，但依赖管理还是老样子。

3.2 PlatformIO 带来的工程化收益

换成 PlatformIO（VS Code 插件）之后，体验完全不一样。platformio.ini里把依赖写清楚：

[env:esp32dev] platform = espressif32 board = esp32dev framework = arduino monitor_speed = 115200 lib_deps = adafruit/Adafruit SSD1306@^2.5.7 adafruit/Adafruit GFX Library@^1.11.5 bblanchon/ArduinoJson@^6.21.3 build_flags = -DCORE_DEBUG_LEVEL=3

lib_deps会自动下载对应版本的库，换电脑、重装环境都不用重新配。增量编译也快得多，改一个 cpp 文件通常十几秒就烧录完。对于任何超过 500 行的 ESP32 项目，我都强烈建议直接上 PlatformIO，省下来的时间远超学习成本。

3.3 config.h：把可变参数集中管理

Nova 的固件里有一个config.h，把所有可能调整的参数集中在一起：

// config.h #define PIN_TOUCH 4 #define PIN_TRIG 5 #define PIN_ECHO 18 #define PIN_OLED_SDA 21 #define PIN_OLED_SCL 22 #define MOTOR_SPEED 180 #define OBSTACLE_CM 20 #define WIFI_SSID "your_ssid" #define WIFI_PASS "your_pass" #define BLE_NAME "Nova"

这么做的好处是：调参不用翻遍所有源文件，改一个地方全局生效。而且分享代码给别人时，对方只需要改config.h就能跑起来，不用理解整个工程。这是我在多个 ESP32 项目里总结出来的习惯，强烈推荐。

4. Nova 的表情系统：用 128x64 像素做出"情绪"

4.1 表情的本质是眼睛形状和眨眼节奏

OLED 只有 128x64，画不了复杂图形，但做表情足够了。我把"脸"抽象成两只眼睛，每只眼睛用圆角矩形或圆形表示，通过改变眼睛的高度、位置、开合程度来表达情绪。核心函数是drawEye(x, y, w, h, openness)，openness从 0 到 1 控制眼睛睁开程度。

开心：眼睛弯成上弧线，配合快速眨眼
困倦：眼睛半闭，眨眼间隔拉长到 3 秒
惊讶：眼睛变圆变大，瞳孔缩小
生气：眼睛压扁成横线，微微下移

这套逻辑不需要任何图片资源，纯几何绘制，代码量小、刷新快。实测 I2C OLED 全屏刷新约 20ms，做 10fps 的动画完全够用。

4.2 眨眼与情绪状态机

Nova 的情绪用一个简单的状态机管理：

enum Mood { HAPPY, SLEEPY, SURPRISED, ANGRY, IDLE }; Mood currentMood = IDLE; unsigned long lastBlink = 0; unsigned long blinkInterval = 2000;

主循环里根据传感器事件切换情绪：触摸触发 → HAPPY；超过 30 秒无互动 → SLEEPY；超声波检测到 20cm 内障碍 → SURPRISED 并后退；连续被"逼到墙角" → ANGRY。状态机是宠物机器人的灵魂，没有它，Nova 就只是一台会动的车。

4.3 让表情和动作联动

光有表情不够，动作要配合。比如 HAPPY 时，Nova 会原地转圈；SURPRISED 时快速后退并左右摆头；SLEEPY 时缓慢前后微动，像打瞌睡。动作和表情的联动通过一个performAction(Mood)函数统一调度，避免逻辑散落各处。

这里有个经验：动作时长要和表情切换节奏对齐。我一开始让转圈持续 3 秒，但表情 1 秒就切回 IDLE 了，看起来像"笑到一半突然面瘫"。后来把动作时长和表情持续时间绑定在同一个变量里，观感立刻自然了。

5. Web 与蓝牙双通道控制：ESP32 内嵌网页的实战细节

5.1 用 LittleFS 托管网页而不是硬编码字符串

很多 ESP32 内嵌 Web 教程直接把 HTML 写成 C++ 字符串，改一个标点都要重新编译烧录。我用 PlatformIO 的 LittleFS 文件系统，把index.html、style.css、app.js放进data/目录，通过uploadfs命令单独上传，改网页不用重编固件。

; platformio.ini 追加 board_build.filesystem = littlefs

上传命令：pio run --target uploadfs。网页里通过fetch('/api/status')轮询 Nova 的状态，通过fetch('/api/command?cmd=forward')发指令。这套结构清晰、易维护，是 ESP32 Web 项目的标准做法。

5.2 蓝牙 BLE 作为备用通道

Web 控制依赖 WiFi，但有时候在户外没网，蓝牙就派上用场了。Nova 同时开了一个 BLE 服务，手机用任意 BLE 调试 App 就能连上发指令。BLE 和 Web 共用同一套命令解析函数handleCommand(String cmd)，避免逻辑重复。

这里要注意：ESP32 同时跑 WiFi 和 BLE 会争抢射频资源，实测同时开启时 BLE 延迟会变大。我的做法是默认只开 WiFi，检测到 10 秒内没有 Web 连接就自动切到 BLE 模式，反之亦然。这个切换逻辑写在主循环里，用millis()计时，不需要额外任务。

5.3 命令协议设计

命令用简单的字符串协议，方便调试：

命令	动作	表情
forward	前进	IDLE
back	后退	SURPRISED
left / right	转向	IDLE
spin	原地转圈	HAPPY
sleep	停止	SLEEPY
wake	唤醒	HAPPY

协议越简单越好，因为调试时你可能直接用串口手敲命令。我甚至在handleCommand里加了一个debug命令，返回当前所有传感器读数，排查问题时特别有用。

6. 调试踩坑实录：那些教程不会告诉你的问题

6.1 电机干扰导致 I2C 通信失败

这是最坑的一个问题。Nova 一动起来，OLED 就花屏或者直接黑掉。排查了半天，最后用示波器看 I2C 波形才发现：电机启动瞬间，SDA/SCL 线上有大量毛刺。根因是电机和 ESP32 共用电源，电机换向时产生的高频噪声串到了 I2C 总线。

解决方案有三层：一是在电机两端各并一颗 0.1uF 陶瓷电容，吸收换向尖峰；二是 OLED 就近加 100uF 电解电容；三是 I2C 线尽量短，远离电机线。三层做完之后，连续跑一小时不再花屏。电机项目里 I2C 花屏，九成是电源噪声，先查这个方向。

6.2 超声波在运动中读数跳变

HC-SR04 静止时读数很准，但 Nova 一边走一边测距时，数据会突然跳到 200cm 以上。原因是电机震动影响了超声波模块的晶振，加上运动时声波反射路径变化。我的处理是加一个滑动窗口滤波：连续读 5 次，去掉最大最小值取平均，并且只在 Nova 停止或慢速时做精确测距，快速移动时用红外模块兜底。

6.3 触摸传感器的误触发

TTP223 贴在车顶，但电机一转就误触发。一开始以为是灵敏度太高，调低之后还是偶发。后来发现是触摸传感器的地线和电机地线共用，电机电流在地线上产生的压降被触摸芯片当成了信号。解决办法是给触摸传感器单独走一根地线回到电源负极，不和电机共地。这个细节非常隐蔽，但效果立竿见影。

6.4 编译速度优化

Windows 上 PlatformIO 首次编译 ESP32 要几分钟，后续增量编译快很多。如果还是嫌慢，可以：关闭杀毒软件对.pio目录的实时扫描；把项目放在 SSD 上；platformio.ini里加build_cache_dir复用编译缓存。我实测这些做完，增量编译从 40 秒降到 15 秒左右。