2小时跑通一台ESP32智能小车接线、测距、自主避障的完整走查【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32小车在客厅里自己绕开一只拖鞋前进停原地转了半圈再上路。它没有视觉只靠一个超声波模块和两条 PWM 线在干活。这台ESP32智能小车的全部成本在 120-160 元之间从第一次接线到闭环避障跑通大概 2.5-4 小时快的话晚饭前能收尾。项目定位这个仓库是 ESP32 芯片的 Arduino 开发核心库它提供 PWM 输出、串口、WiFi 等硬件抽象以及仓库内自带的 WiFi、WebServer、ESPmDNS 等网络库让小车代码不用碰寄存器。避障逻辑本身只有三档 if-else真正的工程量在接线和调试上。仓库里不包含底盘、电机这类物理件需要另备。动手前准备硬件、软件、时间三列并排类别项目为什么选这个硬件ESP32 DevKitC约 40-50 元引脚全、资料多引脚分布见官方布局图硬件N20 减速电机一对约 25-35 元带编码器后续想闭环留了余地硬件TB6612FNG 驱动板约 10-15 元3.3V 逻辑电平直接对接 ESP32省掉电平转换比 L298N 体积小、发热低小车身塞得下硬件HC-SR04 超声波模块约 6-8 元2-400cm 量程覆盖室内避障接口只有 Trig/Echo 两根信号线硬件18650 电池盒 底盘结构件约 40-50 元电池单独供电避免电机电流尖峰干扰 3.3V 系统软件Arduino IDE2.x 即可仓库官方文档就是按 IDE 流程写的排查资料好找软件arduino-esp32 开发板支持包官方文档里的 Boards Manager 两步安装法见下文时间接线 40-60 分钟 / 调电机 30 分钟 / 测距加闭环 60-90 分钟多数超时的时间花在检查第 3 步的接线核心走查按操作顺序走完五步第一步配 arduino-esp32 开发环境先烧通 Blink打开 Arduino IDE进入文件 → 首选项在附加开发板管理器网址里填入官方稳定版包地址https://espressif.github.io/arduino-esp32/package_esp32_index.json这一步的具体位置和字段名如下面两张截图完整流程写在 官方安装文档。Arduino IDE 首选项窗口arduino-esp32 开发环境配置的网址填入位置保存后打开工具 → 开发板 → 开发板管理器搜到 esp32 安装装完记得回到工具菜单选中具体型号比如 ESP32 Dev Module。开发板管理器安装 ESP32 开发板支持包arduino-esp32 开发环境配置的第二步插上板子选对 COM 口把自带例程 Files → Examples → Basics → Blink 烧进去。应该看到板载 LED 以 1 秒周期闪烁。现象不对就先查端口列表里有没有新出现的 COM 口C3、S3 这类带串口的型号有时还需要按住 BOOT 键再点上传。Blink 不通后面一切免谈这一步不通就翻 官方 FAQ 和 问题排查页。第二步接线顺序与最易接错的 3 组线接线前把电池拔下来先只连 USB 做信号部分最后一步再合上电池。驱动板 4 个方向脚接 GPIO25、26、27、14两个 PWM 脚接 GPIO32、33超声波 Trig 接 GPIO13、Echo 接 GPIO12ESP32 与驱动板 GND 必须共地。引脚位置对着官方布局图找别靠数丝印。ESP32 DevKitC 引脚布局ESP32 电机驱动接线与超声波模块接线的引脚位置参考最易接错的 3 组线按出事概率排序超声波 VCC/EchoHC-SR04 的 5V 供电引脚接错位置会烧模块Echo 是 5V 电平信号接 GPIO12 属于兼容引脚接成 3.3V 专用脚可能读不到回波。左右电机的两根方向线对调不会烧东西但前进变后退排查时先怀疑它。驱动板 VCC 与 ESP32 5V 口混接电机大电流直接灌进开发板稳压电路这是最贵的一组错误电池只接驱动板别想走捷径。第三步先让两个轮子听话再谈智能这段做循环控制初始化左右两个 LEDC PWM 通道再分别写不同占空比用负值表示反转。上电后应该看到左轮正转、右轮反转小车原地顺时针转。ledcAttach(32, 5000, 10); // 左轮 ledcAttach(33, 5000, 10); // 右轮 ledcWrite(32, 1023); ledcWrite(33, -1023);现象不对的三种查法不转查电机两根线是否真的接到驱动板对应相线只有一侧转查那侧方向脚有没有接对、电机线有没有接反两侧都转但方向诡异查方向脚是否对调。PWM 每个参数能干什么仓库里有对应说明LEDC API 文档例子里的函数写法可对照 基础教程。第四步单独验证超声波读数把超声波模块朝开阔方向装好单独跑一段读数程序。这段做两件事Trig 拉一个 10 微秒脉冲发波再用 pulseIn 量回波高电平宽度乘 0.034 换算成厘米串口每秒打印一次。digitalWrite(13, HIGH); delayMicroseconds(10); digitalWrite(13, LOW); float ms pulseIn(12, HIGH, 30000); float cm ms * 0.034;正常现象读数在 2-400cm 之间随距离平滑变化手挡在 30cm 处读数应该在 28-32cm 附近跳动。现象不对先查两处读数恒为 0 或 999查 Trig/Echo 是不是接反、Echo 脚是否 3.3V 专用读数乱跳查模块 VCC 有没有和电机线缠在一起。第五步闭环跑起来把第三、四步拼进同一个 loop决策只有三档if (cm 25) { ledcWrite(32, 1023); ledcWrite(33, 1023); } else if (cm 12) { ledcWrite(32, 600); ledcWrite(33, 600); } else { ledcWrite(32, -800); ledcWrite(33, -800); delay(400); ledcWrite(33, -800); ledcWrite(32, 800); }预期现象小车前方 25cm 内出现物体就减速12cm 内停住后退 400ms 再原地左转转完重新上路。跑起来之后先别急着加功能让它空转十分钟观察有没有在某个固定位置反复横跳有的话那个位置就是测距盲区或电源毛刺点。原理轻讲超声波测距状态机逻辑整套小车里最值得拆的是测距这段本质是一个单步状态机空闲 → 发 10us 触发脉冲 → 等 Echo 变高 → 等 Echo 变低 → 用宽度算距离。pulseIn 的第三个参数是超时没收到回波就返回 0对应前方是吸音软物或超出 400cm。换算系数 0.034 来自声速 340m/s 对折波走个来回1ms 对应 17cm除以 2 就是 0.017cm/us 的单向值再乘 2写代码时直接用 0.034。2cm 以内是模块死区读数是垃圾值别在这段区间做决策。决策用三档阈值而不是精确厘米数是因为这个读数的抖动比想象大档位之间留够余量小车行为才稳定。调试现场两个真实卡点场景一小车直行时偶尔单侧轮子抽搐。当时先查的是方向脚万用表量了四根线都没问题又去查电池电压掉电量着量着发现抽搐只发生在占空比大于 800 的时候。最后原因是 TB6612 的 IN1/IN2 两根方向线并排走线时压线皮磨破大电流时刻两线间歇短路驱动板进入半桥保护状态。把线分开 1cm 以上并用热缩管包住抽搐消失。这类时好时坏先查线皮再怀疑芯片顺序反了要多花一倍时间。场景二前方明明没人读数在 15cm 和 40cm 之间跳。第一反应是模块坏了换了一个读数照样跳。接着查走线把超声波排线挪离电机线 5cm跳变频率降了一半但没根除。最后定位到电源电池只接了驱动板ESP32 走 USB 供电两个地之间有一根细共地线电机启动时的电流尖峰在这根线上压出 100mV 级的波动3.3V 参考跟着抖。把电池盒加了一路 3.3V 直供 ESP32、共地线加粗之后读数稳住了。分岔路径三条不预设先后的扩展方向只加红外侧避障1-2 小时两颗 GP2Y0A02 接模拟脚读 analogRead 加两行 if 就能补上左右盲区。最便宜的一条路适合只想让车不撞墙的学生。接 WiFi 手机遥控半天仓库自带 WebServer 库起个本地页面用浏览器当遥控器传感器数据顺带回传。ESP32 作为 WiFi 站点的连接示意如下仓库 API 层面有 WiFi 文档 可查。ESP32 WiFi STA 工作模式小车远程遥控与状态回传的连接基础MQTT 上云1-2 天用仓库里的 ESPmDNS 解决局域网发现再配 MQTT 客户端把避障事件和里程上报做教学演示时多台小车的数据可以汇总到一块大屏。这条路的工程量在网络侧车端改动很小。收尾走通这条线的关键就三件事接线别错、PWM 方向别反、测距状态机读通。深入细节查 ESP32 基础教程、LEDC 驱动说明 和 问题排查。【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
