1. 项目概述与核心思路如果你对微控制器和机器人感兴趣但又觉得Arduino生态有点“玩腻了”或者被ESP系列复杂的烧录工具劝退那么树莓派Pico搭配MicroPython绝对是一个让你眼前一亮的组合。我这次做的这个简易避障机器人核心目标就是“极简”和“可复现”。它没有用复杂的舵机云台去扫描环境而是用一个固定朝前的超声波传感器配合车体的原地转向来实现“看左看右择路而行”的避障逻辑。整个项目的硬件成本可以压得很低软件部分更是因为MicroPython的交互特性调试起来异常方便。这个机器人的工作逻辑非常直观上电后它就像个愣头青一样直着往前走。当前方的超声波传感器检测到障碍物时它会紧急刹车。接着它会原地向左转大约90度用超声波测一下左边通道的宽度记录下距离数据然后回转车身再向右转90度测一下右边的距离。最后比较左右两边的测量值选择距离更远即空间更开阔的那一边作为新的前进方向。整个过程就像一个人在陌生走廊里摸索前进一样虽然策略简单但非常有效。我选择树莓派Pico而不是更常见的ESP32主要基于两点考虑。一是对于欧洲的开发者来说Pico的到手价和ESP系列相差无几甚至更有优势。二是它的开发体验对新手极其友好烧录MicroPython固件真的是“拖拽即完成”完全不需要面对esptool.py那样的命令行工具降低了入门门槛。当然Pico的双核RP2040芯片性能也足够应对这种实时性要求不高的控制任务。2. 硬件清单与物料解析一份清晰且可采购的物料清单是项目成功的第一步。下面我列出的不仅是名称还会说明每样东西的具体参数和选择理由帮你避免买错。2.1 核心控制与驱动单元树莓派Pico开发板这是机器人的“大脑”。务必确认你拿到的是基础版Pico而不是Pico W带Wi-Fi。因为我们的项目用不到网络基础版更便宜。购买时可以选择预焊排针的版本能省去你焊接的麻烦。L298N电机驱动模块这是机器人的“肌肉”。选择它是因为其经典、耐用、驱动能力强并且资料极其丰富。市场上常见的小型L298N模块通常集成了5V稳压芯片这非常关键因为它可以为我们后续的Pico和传感器提供稳定的5V电源。注意模块上要有ENA、ENB、IN1~IN4这些引脚。HC-SR04超声波传感器机器人的“眼睛”。这是最通用、廉价的测距模块。它的工作原理是发射一束40kHz的超声波并接收回波通过计算时间差来得到距离。有效测距通常在2cm到400cm之间完全满足室内避障需求。2.2 动力与车体结构二轮小车底盘套件建议直接购买集成好的套件通常包含一个带有钻孔的亚克力或金属底盘。两个TT减速电机工作电压一般为3-6V。一个万向轮作为尾轮提供支撑。配套的螺丝、螺母和铜柱。这种套件省去了你单独匹配电机和车轮的烦恼。2S锂聚合物电池7.4V推荐容量在800mAh到1000mAh之间。2S电池标称电压7.4V满电约8.4V这正好落在L298N模块推荐的驱动电压范围内5V-35V同时也能通过模块上的稳压芯片输出5V。务必配套购买对应的XT60或T插头以及一个电池充电器。电源开关这是一个可选项但强烈建议加上。一个简单的两脚拨动开关串联在电池的正极导线上可以让你安全地切断整个系统的电源比插拔电池插头方便可靠得多。2.3 电子辅料与电路搭建杜邦线准备大量公对公、公对母、母对母的杜邦线用于连接。面包板跳线也可以。洞洞板用于焊接和固定我们的自定义电路比如电平转换和LED电路。大小约5x7cm或7x9cm就足够。LED与电阻蓝色LED x2作为“大灯”连接在Pico的GPIO上机器人前进时点亮。红色LED x2作为“刹车灯”连接在电机驱动逻辑上刹车或后退时点亮。电阻180Ω限流蓝色LED330Ω限流红色LED1kΩ和2kΩ用于电平分压后文详解。NPN三极管如BC547x2用于驱动红色刹车灯。因为Pico的GPIO引脚驱动电流有限约12mA无法直接点亮较亮的LED用三极管做开关可以控制更大的电流。排针排母用于将Pico以可插拔的方式固定在洞洞板上。注意安全第一焊接和电路连接时务必确保电池处于断开状态。连接L298N的电源输入时反复确认正负极红线正黑线负接反极易烧毁模块。3. 电路设计与核心原理剖析光把线连上是不够的理解为什么这么连才能举一反三。整个系统的供电与信号流是核心。3.1 供电系统架构供电是稳定运行的基石。我们采用单电池供电两级电压分配的方案动力电~7.4V2S锂电池直接接入L298N模块的“12V”和“GND”端子。这个电压主要用于驱动两个TT电机。虽然端子写着12V但7.4V完全在其工作范围内电机转速会稍慢但更安全。控制电5VL298N模块上的5V稳压芯片会将输入的7.4V降压到稳定的5V。这个5V有两个用途为Pico供电通过一根导线从L298N的“5V”端子连接到Pico的“VBUS”引脚。切记不是VCC3.3V引脚。VBUS是Pico的USB输入引脚可以接受5V供电。为HC-SR04超声波传感器供电HC-SR04需要5V工作电压。这样整个系统只需要一块电池简洁高效。电源开关就串联在电池正极与L298N“12V”端子之间。3.2 关键信号连接与电平转换这是最容易出错的地方。树莓派Pico的GPIO引脚逻辑电平是3.3V而一些模块如经典的L298N虽然能接受3.3V控制信号但为了确保可靠性有时需要电平匹配。更重要的是HC-SR04的Echo引脚输出是5V直接接Pico的GPIO会损坏芯片Pico控制L298N输出GPIO2- L298NIN1GPIO3- L298NIN2这两路控制电机A即左轮GPIO4- L298NIN3GPIO5- L298NIN4这两路控制电机B即右轮GPIO6- L298NENAGPIO7- L298NENB这两个使能引脚用PWM输出可调速直接接高电平则全速电平考量Pico的3.3V输出对于L298N的输入来说通常可以被识别为高电平其阈值一般在2V左右。实测是可行的但如果你发现电机控制不灵可以考虑将ENA和ENB直接接到5V上放弃PWM调速或者使用一个简单的3.3V转5V电平转换模块。HC-SR04连接Pico输入需降压GPIO14- HC-SR04Trig触发信号Pico输出3.3VHC-SR04能识别HC-SR04Echo-电平分压电路-GPIO15回波信号5V必须降压5V转3.3V电平分压电路这是必须的用一个1kΩ电阻和一个2kΩ电阻串联。将HC-SR04的Echo引脚接到1kΩ电阻一端1kΩ电阻另一端接2kΩ电阻并从这两个电阻的连接点引出线到Pico的GPIO15。2kΩ电阻的另一端接地GND。这样5V输入会在中点分压得到大约 5V * (2k/(1k2k)) ≈ 3.33V完美适配Pico。原理图如下所示HC-SR04 Echo (5V) ---[1kΩ]---|---- To Pico GPIO15 (约3.3V) | [2kΩ] | GND3.3 灯光指示电路灯光不仅酷炫更是重要的调试状态指示。蓝色头灯直接将两个蓝色LED的正极通过180Ω限流电阻分别接到Pico的两个GPIO如GPIO12和GPIO13负极接地。在代码中机器人前进时点亮它们。红色刹车灯这里需要一点技巧。我们不能直接用Pico的GPIO驱动因为刹车灯要在电机反转刹车或后退时点亮而电机反转信号是L298N的IN1/IN2或IN3/IN4产生的。我们可以利用L298N的输出逻辑。以左轮为例当IN1HIGH,IN2LOW时电机正转IN1LOW,IN2HIGH时反转。我们可以用一个或逻辑当IN2为高电平时即反转状态点亮刹车灯。实现方法将IN2信号来自Pico3.3V连接到一个BC547三极管的基极通过一个1kΩ电阻限流。三极管的发射极接地集电极连接红色LED的负极LED正极通过330Ω电阻接5V。当IN2为高电平三极管导通LED负极被拉低到地形成回路LED点亮。右轮刹车灯同理接在IN4上。4. 软件编程与MicroPython实战硬件搭好就成功了一半。另一半在软件里。MicroPython的交互式REPL读取-求值-打印循环让调试变得像对话一样简单。4.1 开发环境搭建与固件烧录安装Thonny IDE这是最推荐给MicroPython新手的集成开发环境。去官网下载对应你操作系统的版本安装即可。烧录MicroPython固件用Micro-USB数据线连接Pico到电脑。按住Pico板上的BOOTSEL按钮不放再插入USB线如果还没插的话然后松开按钮。此时电脑会识别到一个名为RPI-RP2的可移动磁盘。从树莓派官网下载最新的uf2格式MicroPython固件文件。将其拖拽到RPI-RP2磁盘中。Pico会自动重启固件烧录完成。配置Thonny打开Thonny在右下角选择解释器选择“MicroPython (Raspberry Pi Pico)”。如果连接成功下方的ShellREPL区域会显示MicroPython的版本信息并出现提示符。你可以尝试输入print(“Hello, Pico!”)并回车看到输出就说明环境没问题了。4.2 核心代码模块解析我们将代码分成几个函数模块来写这样结构清晰易于调试。下面我结合代码片段讲解关键逻辑。from machine import Pin, PWM, Timer import time # 1. 引脚定义 # 电机控制引脚 IN1 Pin(2, Pin.OUT) # 左轮正转 IN2 Pin(3, Pin.OUT) # 左轮反转 IN3 Pin(4, Pin.OUT) # 右轮正转 IN4 Pin(5, Pin.OUT) # 右轮反转 ENA Pin(6, Pin.OUT) # 左轮使能 可替换为PWM(6, freq1000)进行调速 ENB Pin(7, Pin.OUT) # 右轮使能 # 超声波传感器引脚 TRIG Pin(14, Pin.OUT) ECHO Pin(15, Pin.IN) # 头灯和刹车灯引脚 (示例需根据实际电路调整) HEADLIGHT_L Pin(12, Pin.OUT) HEADLIGHT_R Pin(13, Pin.OUT) # 刹车灯通常由电机反转信号通过硬件电路控制此处不定义GPIO # 2. 初始化函数 def init_motors(): 初始化电机停止状态 ENA.value(1) # 使能电机如果接PWM这里就是 pwm_l.duty_u16(65535) ENB.value(1) stop() def stop(): 刹车/停止 IN1.value(0); IN2.value(0) IN3.value(0); IN4.value(0) HEADLIGHT_L.value(0) # 停车时关大灯 HEADLIGHT_R.value(0) def forward(): 前进 IN1.value(1); IN2.value(0) # 左轮正转 IN3.value(1); IN4.value(0) # 右轮正转 HEADLIGHT_L.value(1) # 前进时开大灯 HEADLIGHT_R.value(1) def turn_left(duration_ms500): 原地左转左轮反转右轮正转 IN1.value(0); IN2.value(1) IN3.value(1); IN4.value(0) time.sleep_ms(duration_ms) stop() def turn_right(duration_ms500): 原地右转 IN1.value(1); IN2.value(0) IN3.value(0); IN4.value(1) time.sleep_ms(duration_ms) stop() # 3. 超声波测距函数 def get_distance(): 测量前方距离返回厘米值 TRIG.value(0) time.sleep_us(2) TRIG.value(1) # 发送10us的高电平触发脉冲 time.sleep_us(10) TRIG.value(0) # 等待回波引脚变高并记录时间 while ECHO.value() 0: pulse_start time.ticks_us() while ECHO.value() 1: pulse_end time.ticks_us() pulse_duration time.ticks_diff(pulse_end, pulse_start) # 声音速度约343米/秒即0.0343厘米/微秒。来回距离所以除以2。 distance_cm (pulse_duration * 0.0343) / 2 return distance_cm # 4. 扫描决策函数 def scan_and_decide(scan_angle_time500): 执行左右扫描并返回选择的方向 left 或 right print(Obstacle detected! Scanning...) # 向左扫描 turn_left(scan_angle_time) # 左转约90度 time.sleep_ms(200) # 等待车身稳定 distance_left get_distance() print(fLeft distance: {distance_left} cm) # 转回前方即向右转回 turn_right(scan_angle_time) # 向右扫描 turn_right(scan_angle_time) # 从原始位置向右转 time.sleep_ms(200) distance_right get_distance() print(fRight distance: {distance_right} cm) # 转回前方即向左转回 turn_left(scan_angle_time) # 决策逻辑选择距离更大的一边 if distance_left distance_right: print(Turning left.) return left else: print(Turning right.) return right # 5. 主循环 def main(): init_motors() safe_distance 20 # 厘米小于此距离认为有障碍 print(Robot started! Press CtrlC in Thonny to stop.) try: while True: dist get_distance() # print(fFront distance: {dist} cm) # 调试时可开启 if dist safe_distance: forward() # 安全继续前进 else: stop() time.sleep_ms(500) # 停一下 direction scan_and_decide() # 向选定的方向转90度然后继续前进 if direction left: turn_left(500) else: turn_right(500) time.sleep_ms(200) # 转向后稍作停顿 time.sleep_ms(100) # 主循环延迟避免测距过于频繁 except KeyboardInterrupt: stop() print(Robot stopped by user.) # 运行主程序 if __name__ __main__: main()代码要点解析get_distance()函数这是超声波测距的核心。它先发送一个10微秒的高脉冲触发信号然后监听ECHO引脚的高电平持续时间。这个时间就是超声波从发射到返回的总时间。计算距离时注意单位换算和除以2因为是往返距离。scan_and_decide()函数实现了机器人的“思考”过程。通过控制左右轮差速实现原地转向scan_angle_time参数控制转向时间需要根据你的电机速度和地面摩擦力实际调整以接近90度转向。全局变量safe_distance这是最重要的一个可调参数。在室内建议从15-25厘米开始测试。太小了容易撞上太大了则会在开阔地频繁转向。异常处理主循环用try...except包裹这样你在Thonny里按CtrlC可以优雅地停止机器人而不是直接拔电。4.3 上传与自动运行在Thonny中编写好代码后点击“文件”-“另存为”选择“Raspberry Pi Pico”。将文件命名为main.py。这是关键MicroPython设备上电后会自动寻找并执行名为main.py的文件。保存后你可以直接点击Thonny的运行按钮进行测试。测试无误后按一下Pico的复位键RST或者重新上电机器人就会自动开始执行main.py里的main()函数了。5. 机械组装与调试心得硬件和软件都准备好了最后一步是把它们有机地组合起来并调教到最佳状态。5.1 分步组装流程底盘与电机首先将两个TT电机用配套的螺丝螺母固定在小车底盘的两侧。注意电机的出轴方向要一致通常都朝前或都朝后。安装好轮子和尾部的万向球轮。核心主板将树莓派Pico、L298N模块、以及焊接好电平转换电阻和LED驱动三极管的洞洞板通过铜柱和螺丝固定在底盘的中部。布局原则重心尽量低、左右尽量平衡、接线尽可能短且整齐。L298N模块可能会发热注意不要被其他部件紧密包裹。传感器安装将HC-SR04超声波传感器安装在底盘的最前端尽可能高地朝前放置以减少地面反射的干扰。可以用热熔胶或螺丝固定。布线这是最考验耐心的一步。按照前面的电路图用杜邦线连接所有模块。建议用不同颜色的线区分电源正极红色、电源地黑色和信号线其他颜色。电源线可以粗一些。所有连接完成后用扎带或胶带将线束整理固定防止运动中缠绕或脱落。电池安装将2S电池用魔术贴或扎带固定在底盘上。通常放在底盘后半部分以平衡前部传感器的重量。5.2 上电前终极检查在接上电池之前拿出万用表进行最后一次“静态检查”检查短路测量电池接口的正负极之间电阻不应接近0欧姆。测量Pico的VBUS和GND之间、L298N的5V和GND之间也应有一定阻值。检查电压暂时不接Pico和传感器只给L298N接上电池打开开关测量其5V输出端子确认电压在4.8V-5.2V之间。检查关键信号确认HC-SR04的Echo引脚与Pico的GPIO15之间已经串联了1k和2k的分压电阻。5.3 系统调试与参数微调上电后机器人可能不会立刻完美工作需要耐心调试电机转向校正如果机器人命令前进却原地转圈说明两个电机的转向定义反了。很简单只需在代码中交换控制该电机的两个IN引脚的值。例如左轮前进应该是IN11, IN20如果反了就改成IN10, IN21。转向角度校准turn_left()和turn_right()函数中的duration_ms参数决定了转向时间。你需要在地面上画一个“十”字让机器人中心对准交点执行一次转向看它是否接近旋转90度。通过调整这个时间参数来校准。超声波测距稳定性在REPL中单独反复调用get_distance()函数对准墙壁等固定物体看返回值是否稳定。如果跳动很大可以尝试在函数中增加多次测量取平均值的逻辑。避障灵敏度调整safe_distance是核心参数。在复杂环境中如桌椅腿可以适当调大如25cm在开阔环境可以调小如15cm以获得更流畅的行进。功耗与运行时间如果发现运行时间远短于电池标称容量计算的时间检查是否有短路或局部过热。电机堵转被卡住时电流极大会快速消耗电池并损坏驱动芯片。代码中可以增加检测如果get_distance()长期小于一个极小的值如5cm可能意味着卡死应进入停止并报警状态。实操心得调试的“二分法”当机器人行为异常时不要一下子怀疑所有部分。采用“二分法”隔离问题先断开电机只测试超声波传感器在REPL里的读数是否正常然后单独给电机驱动信号看轮子是否按指令转动最后再整合。用print()函数在关键步骤输出状态信息是MicroPython调试中最强大的武器。6. 常见问题与进阶优化即使按照指南操作你也可能会遇到一些典型问题。这里我列出一个速查表并分享一些让机器人更“聪明”的进阶思路。6.1 故障排查速查表现象可能原因排查步骤上电无任何反应1. 电池电量耗尽或开关未开。2. L298N的5V输出异常。3. Pico未正确供电或损坏。1. 用万用表测电池电压应7V。2. 测L298N的5V输出端子。3. 用USB线单独给Pico供电看能否连接Thonny。电机不转或单侧不转1. 电机线接触不良或断开。2. L298N使能引脚ENA/ENB未接高电平/PWM。3. 控制逻辑错误IN1/IN2组合不对。4. 电机本身损坏。1. 检查电机接线是否牢靠。2. 检查ENA/ENB引脚是否接好并置为高电平。3. 在REPL中手动设置IN1/IN2的值观察电机反应。4. 直接将电机接电池短暂测试看是否转动。超声波传感器一直返回超大或超小值1. 接线错误特别是Trig和Echo接反。2. Echo引脚5V未做电平分压可能已损坏Pico的GPIO。3. 传感器前方有强吸音材料或角度不对。1. 核对Trig、Echo、VCC、GND四根线。2.立即检查电平分压电路用万用表测量接入GPIO15的电压是否在3.3V左右。3. 对准平整硬质表面测试。机器人行为混乱乱转1. 电源干扰导致Pico复位或信号错乱。2. 电机产生的电火花干扰了传感器或Pico。3. 代码逻辑错误如循环延迟不当。1. 在Pico的VBUS和GND之间并联一个100uF的电解电容稳压滤波。2. 在电机的两个引脚之间焊接一个0.1uF的瓷片电容抑制火花。3. 检查代码中time.sleep的延迟是否太短导致状态来不及切换。转向角度不准1. 地面摩擦力不均如地毯 vs 地板。2. 两个电机转速有细微差异。3.turn_left/right函数中的延时参数未校准。1. 在相同地面环境下进行校准。2. 接受微小误差或尝试使用PWM对两个电机进行微调使转速一致。3. 反复测试调整duration_ms参数。6.2 功能扩展与优化思路这个基础版本只是一个起点你可以在此基础上添加更多功能PWM调速将代码中的ENA Pin(6, Pin.OUT)改为ENA PWM(Pin(6), freq1000)并在初始化时设置ENA.duty_u16(32768)50%占空比。这样可以通过改变duty_u16的值0-65535来无级调速让机器人慢速巡航更省电也更像“思考”。增加状态显示添加一个OLED显示屏I2C接口实时显示前方距离、电池电压、当前状态前进、左转、右转等信息极大方便调试。“记忆”功能让机器人具备简单的“迷宫探索”能力。例如当左右距离都小于安全距离时让它原路倒退一段再重新扫描而不是原地打转。多传感器融合在车身侧面加装红外避障传感器用于检测贴近的障碍物弥补超声波传感器近距离探测的盲区和误差。遥控与自主切换增加一个蓝牙模块如HC-05或2.4G射频模块编写一个简单的手机APP或遥控器程序实现手动遥控与自动避障模式的切换。这个基于树莓派Pico的避障机器人项目从硬件焊接、电路理解到软件编程、系统调试完整地走完了一个嵌入式原型开发的全流程。它最宝贵的价值不在于做出了一个多智能的机器人而在于通过这个具体的载体你将枯燥的GPIO控制、传感器通信、电机驱动等知识点串联了起来并且获得了“从零到一”的完整工程实践体验。当你看到它成功避开桌腿的那一刻那种成就感是无可替代的。希望这份详细的指南能帮你扫清障碍顺利享受到动手创造的乐趣。