很多人在刚接触硬件开发时都会问我想用Python控制开发板是选Arduino还是树莓派这个问题我刚开始做项目的时候也纠结过后来踩了一圈坑才明白它不是一道二选一的题。Arduino是一个以单片机为核心的开发平台树莓派是一台能跑Linux系统的微型主机两者的工作方式、适合的任务、甚至“用Python控制”的实现路径都完全不同。这篇文章我想把这两个平台搭配Python的玩法、环境配置、典型项目思路、常见报错和排查链路都梳理一遍给正准备入门或者已经在折腾的朋友一个相对完整的参考。1. 先把Arduino和树莓派的定位搞清楚再决定Python脚本往哪个方向写1.1 Arduino是单片机树莓派是Linux小主机Arduino的硬件核心是AVR、ARM等单片机芯片比如最常见的Arduino Uno用的是ATmega328P只有2KB RAM、32KB Flash。烧录代码后程序是裸机运行的没有操作系统这个概念上电即跑中断响应级别是微秒到毫秒级。所以Arduino天生适合做实时性要求比较高的底层控制比如驱动舵机、直流电机、读取编码器、处理传感器中断信号。树莓派则完全不同。以树莓派4B为例它是一颗四核ARM Cortex-A72处理器内存从2GB到8GB跑着完整的Linux系统树莓派OS、Ubuntu等。它本质上是一台小型电脑可以同时开Python进程、数据库、Web服务甚至加载本地神经网络模型做推理。树莓派虽然也带GPIO引脚但Linux系统不是实时系统普通GPIO翻转会有调度延迟所以树莓派更适合做“大脑”而不是做“肌肉”。很多人一上来就问Arduino和树莓派哪个强这其实是在拿螺丝刀和电钻比谁更硬要看具体拧什么螺丝。我做过的几个项目里凡是涉及精确时间控制的比如平衡小车、机械臂关节底层几乎都是Arduino凡是涉及视觉识别、路径规划、物联网上报的跑在树莓派上更顺手。1.2 Python在两种板上承担的角色完全不同这个点特别容易混淆必须先说清楚。普通Arduino Uno、Nano这类板子固件里跑的不是Python出厂默认引导程序烧录的是C代码。所谓“用Python控制Arduino”实际指的是两种常见做法第一种Python程序运行在PC或者树莓派上通过USB串口、UART、WiFi或蓝牙给Arduino发指令Arduino解析指令后去操作引脚。这也是最稳定、最通用的方式。我早期做智能小车项目时就是树莓派上跑Python做视觉识别识别到目标后通过串口发一个简单的字符命令Arduino那边根据命令控制电机转速和方向。第二种给支持MicroPython的板子烧MicroPython固件比如ESP32、树莓派Pico、部分STM32开发板然后直接在板子上运行Python脚本。注意这种Python不是CPython的完整实现而是一个精简的嵌入式Python解释器。Arduino Uno和Nano的AVR芯片内存太小装不下MicroPython所以这类玩法主要集中在ESP32和RP2040板子上。树莓派上的Python则是标准的CPython环境可以直接调用GPIO库读写引脚不需要中间转换层。你可以把树莓派当作一个可以直接控制硬件的通用计算机这也是它做原型开发特别方便的原因。1.3 两者搭配的典型场景我整理了一个我常用的对比表方便你在方案选型时快速判断对比项Arduino Uno/Nano树莓派 4B/5核心部件单片机AVR/ARMARM处理器 Linux系统内存2KB~几百KB2GB~8GB操作系统无裸机LinuxGPIO实时性高微秒级中断有调度延迟适合毫秒级控制Python支持需串口通信或MicroPython固件原生Python GPIO库适合任务传感器采集、电机控制、信号处理视觉识别、Web服务、边缘计算、复杂逻辑典型项目智能小车底盘、舵机云台、温湿度采集摄像头识别、家庭服务器、机器人主控实际项目里我更喜欢树莓派Arduino的搭配。树莓派负责“想”Arduino负责“做”。比如做一台可以自动跟随的机器人树莓派用摄像头识别目标计算位置偏移通过串口把转向角度和速度发给ArduinoArduino再去控制电机。这样即使树莓派某个进程卡住Arduino也能维持基本运动逻辑不会让小车原地乱撞。2. Arduino搭配Python的常见玩法串口通信和Firmata协议2.1 Arduino IDE安装、库位置改动的常见操作玩Arduino第一步是装IDE。官方IDE有1.8.x经典版和2.x新版我建议直接用Arduino IDE 2.x界面更现代自动补全和烧录监控都集成得比较好。装完后马上会碰到一个问题第三方库或者自己写的库默认放在用户目录下的Arduino/libraries文件夹里。比如Windows下是C:\Users\你的用户名\Documents\Arduino\librariesLinux下是~/Arduino/libraries。这个默认路径在两种情况下会让你难受一是系统盘空间不够二是你希望把库和项目一起放到移动硬盘上方便多台电脑同步。改库位置的方法很简单在Arduino IDE里打开“文件 → 首选项”找到“项目文件夹位置”或“Sketchbook location”改成你想要的目录IDE会自动把库目录切到新路径下的libraries子目录。改完之后一定要重启IDE否则有些库还是读不到。还有一个硬核办法用符号链接把旧位置链接到新位置适合那种IDE版本升级后迁移配置的场景。我实际踩过的坑是改了项目文件夹位置后旧项目使用的相对路径全部失效很多第三方库的下载和更新也会指向新目录所以迁移时最好先把旧库完整备份然后逐个测试哪些库能用别一股脑全删。2.2 pySerial通信最小可运行的上位机例子串口是Python控制Arduino的最常见方式。Arduino端先写一个简单的C程序接收字符指令并控制LED// Arduino端 const int ledPin 13; void setup() { pinMode(ledPin, OUTPUT); Serial.begin(9600); } void loop() { if (Serial.available() 0) { char cmd Serial.read(); if (cmd 1) { digitalWrite(ledPin, HIGH); Serial.println(led_on); } else if (cmd 0) { digitalWrite(ledPin, LOW); Serial.println(led_off); } } }烧录好之后PC端先用pip install pyserial安装pySerial然后跑这个Python脚本import serial import time # Windows下一般是COM3、COM4Linux下是/dev/ttyUSB0或/dev/ttyACM0 ser serial.Serial(/dev/ttyUSB0, 9600, timeout1) # 等Arduino重启完成避免立刻发指令被忽略 time.sleep(2) ser.write(b1) response ser.readline() print(response.decode().strip()) ser.write(b0) response ser.readline() print(response.decode().strip()) ser.close()这个例子的核心逻辑就是“Python发命令Arduino执行命令再回传结果”。实际项目里我不会用这么简单的字符协议但思路是一样的双方约定一个命令集比如MOVE F 100表示前进100毫秒MOVE B 50表示后退50毫秒Arduino端用String或者字符数组解析Python端用serial.write发送。需要注意几个细节波特率两端必须一致USB串口设备在Linux下需要权限没用root权限时经常遇到PermissionError解决办法是把当前用户加入dialout组sudo usermod -a -G dialout $USER2.3 pyfirmata控制舵机不刷固件的便捷方案如果你想跳过自己写Arduino C代码直接用Python操作引脚可以试试Firmata协议。Firmata是一个跑在Arduino上的通用固件通过串口把Arduino的引脚操作暴露给上位机。操作步骤在Arduino IDE里选择“文件 → 示例 → Firmata → StandardFirmata”上传到板子。PC端安装pyfirmatapip install pyfirmata断开Arduino连接的时候重新插一下USB让StandardFirmata跑起来然后运行Python脚本。控制舵机的示例from pyfirmata import Arduino, SERVO import time # Linux下常见设备名Windows用COM口 board Arduino(/dev/ttyUSB0) # 第9号数字引脚SERVO模式 pin board.get_pin(d:9:S) pin.write(90) # 转90度 time.sleep(1) pin.write(0) # 转0度 time.sleep(1) pin.write(180) # 转180度 board.exit()pyfirmata的d:9:S意思是digital引脚9SERVO模式。舵机是接信号线到9号引脚、电源线和地线按接线图接好注意舵机需要的电流比较大别直接用小开发板上的3.3V供电最好用外接5V电源共地后才能正常工作。这种方案的好处是开发速度快不用频繁在IDE和Python之间来回切换烧录坏处是Firmata协议有一定的通信开销高频实时控制场景下比如动态平衡、高速PWM输出不太够用。我建议用它做原型验证最终产品还是写C更可控。2.4 wokwi仿真平台适合验证逻辑有时候手边没有硬件或者想给项目写文档、做演示可以用Wokwi这个浏览器仿真平台。它支持Arduino Uno、ESP32、树莓派Pico等多种开发板可以直接在网页里搭建电路模拟LED、舵机、传感器、LCD屏幕等外设。Wokwi对Python的作用更多是验证串口通信协议。你可以先在Wokwi里搭一个Arduino仿真环境写好C固件然后本机Python通过串口连到仿真端口跑通指令流程后再挪到真实硬件上。这样能省不少来回烧录的时间也适合在没硬件的电脑上临时测试PySerial代码。不过要提醒一句仿真永远不等于真实硬件。Wokwi对时序的模拟比较理想化真实场景里的电源噪声、电平抖动、串口收发延迟这些坑它不会帮你暴露出来。所以我的用法是逻辑先用仿真验证物理问题还是得上真板子踩。3. 树莓派从系统安装到Python控制的完整链路3.1 系统烧录、换源、Python环境配置树莓派上跑Python第一步是把系统装好。最推荐的是Raspberry Pi Imager官方烧录工具选择目标SD卡、选择系统镜像然后写入。树莓派5目前推荐装最新的树莓派OS基于Debian的bookworm分支如果要在树莓派上跑需要大量x86兼容软件的场景也可以装Ubuntu 22.04 Server或Desktop版本。装完系统后进入终端的第一个操作就是更新软件源。树莓派官方源在国外国内直连经常慢到怀疑人生所以很多人会换用清华镜像源。对Ubuntu 22.04来说典型的做法是把/etc/apt/sources.list里的ports.ubuntu.com替换成清华镜像因为树莓派是arm64架构。树莓派OS则是改/etc/apt/sources.list.d/raspi.list和/etc/apt/sources.list里的权限与源地址。换源的命令不复杂但很多版本差异会导致源文件路径不一样。我的建议是动手改之前先确认自己的系统版本lsb_release -a cat /etc/os-release然后用sed或者nano修改对应文件。改完一定要执行sudo apt update sudo apt upgrade -y如果在apt update过程中频繁报错先检查网络是否能访问镜像站再看文件里是否有多余空格或注释符。热词里经常出现“树莓派换源买到了什么版本”其实就说明很多人卡在版本兼容这一步。系统源搞定后Python环境反而简单。树莓派OS和Ubuntu都自带Python 3但系统自带的Python版本可能不够新。我建议用python3 --version检查如果需要升级用sudo apt install python3 python3-pip python3-venv装好基础工具。这里我强烈建议使用虚拟环境后面会细说。3.2 GPIO库选型RPi.GPIO、GPIO Zero、pigpio对比树莓派上用Python控制GPIO核心是选库。我遇到过很多新手上来就装RPi.GPIO结果树莓派5上跑不了或者频繁警告。这不是代码问题而是RPi.GPIO这几年维护缓慢新内核上兼容性变差。库名称维护状态适用板型特点RPi.GPIO旧更新较少树莓派4B及之前经典库教程多但新系统兼容性差GPIO Zero官方推荐活跃树莓派5也支持接口简洁适合快速原型pigpio较活跃树莓派4B/5需验证支持硬件PWM、远程GPIO控制lgpio新面向新内核树莓派5libgpiod封装性能好如果你用的是树莓派5我建议优先使用GPIO Zero或者lgpio如果只是做个简单测试且系统还是旧版本树莓派OS那RPi.GPIO也不是不能用只是装的时候要用pip install RPi.GPIO时注意区分是系统仓库里的版本还是社区修复版。GPIO Zero的写法很直观from gpiozero import LED from time import sleep led LED(17) # BCM编号17号引脚 led.on() sleep(1) led.off()一个LED和按钮都能用几行代码驱动。它的代码风格比较接近“声明式”对新手友好但底层参数调节不够细。做PWM呼吸灯、舵机这类需要精确脉宽控制时我反而会用pigpio或者直接操作系统接口。3.3 引脚编号与PWM输出细节树莓派引脚有两个常用编号体系BOARD物理引脚号和BCMBroadcom芯片名。GPIO Zero默认用的是BCM编号比如LED(17)就是把BCM 17映射到物理引脚11。接错板子的时候经常看到有人一脸懵因为BCM 17和物理引脚17并不是同一个位置用之前最好拿一张引脚图对照一下。PWM输出是树莓派的一个弱项。普通GPIO的软件PWM由Linux内核调度产生精度一般做呼吸灯没问题但控制航模舵机或者做电调信号时就不够稳。树莓派的硬件PWM只有少数几个引脚支持比如BCM 12、13、18、19。我的建议是需要稳定PWM时优先选这些引脚并且用pigpio这类库来初始化和输出。软件PWM驱动舵机的典型代码import pigpio import time servo_gpio 18 pi pigpio.pi() # 50Hz舵机脉宽范围500us到2500us pi.set_servo_pulsewidth(servo_gpio, 1000) # 大约0度 time.sleep(1) pi.set_servo_pulsewidth(servo_gpio, 1500) # 90度 time.sleep(1) pi.set_servo_pulsewidth(servo_gpio, 2000) # 180度 pi.stop()注意set_servo_pulsewidth的单位是微秒不是占空比。这个方法的好处是底层用的硬件定时器输出比较稳定。给舵机供电时同样要注意外部电源共地我见过太多人把舵机直接接树莓派5V口结果电压被拉低、系统重启。3.4 摄像头模块与视觉方向的衔接树莓派搭配摄像头最常见的就是OV5647模块也就是大家常说的树莓派Camera Module V1/V2。树莓派OS新版本里拍照和视频采集推荐用libcamera工具链和picamera2 Python库。安装sudo apt install python3-picamera2拍照from picamera2 import Picamera2 picam2 Picamera2() config picam2.create_still_configuration() picam2.configure(config) picam2.start() picam2.capture_file(test.jpg) picam2.stop()这个流程在树莓派4B和5上都能跑通。注意启用摄像头前需要在raspi-config里开启Camera接口否则Picamera2()初始化会报错。开摄像头后如果系统很卡多半是内存不足可以在/boot/firmware/config.txt里调大gpu_mem或者使用分辨率更低的预览模式。摄像头和Python结合后最常见的进阶方向是部署自己的YOLOv5模型做目标检测。你可以在PC上训练好模型导出为TorchScript或ONNX格式然后放到树莓派上跑推理。这里有个容易被忽视的问题树莓派4B/5的内存和CPU算力有限YOLOv5的nano模型勉强能实时跑标准版会非常慢。优化思路一般是先降低输入分辨率、再用ONNX Runtime或TensorRT优化最后如果还不够就考虑外接Edge TPU或NPU模块。树莓派5上部署YOLOv5我建议先用纯CPU版本跑通流程再一步步做推理加速。4. 实际项目中我会怎么选择几个典型组合方案4.1 PC Python Arduino的入门组合如果你是第一次做硬件和Python结合的项目我推荐先用PC跑PythonUSB线连接Arduino做一个最简单的温湿度采集或者LED控制。这个组合的价值在于分工清晰Python端可以方便地打印日志、画曲线、存数据库Arduino端负责处理传感器数据和引脚输出。入门项目可以做这样一个系统Arduino接DHT11温湿度传感器定时读取并发送到串口Python通过pySerial读取串口数据解析成结构化数据Python把数据写入CSV或者用Flask开一个本地网页实时展示温度曲线。这个组合不需要树莓派也不涉及复杂的Linux配置最适合把“串口通信”这个底座打牢。4.2 树莓派单独完成采集、控制与推理如果项目需要视觉能力同时又要驱动一定数量的外设可以考虑树莓派单机方案。比如做一个视觉跟随小车树莓派接摄像头识别目标通过GPIO控制电机驱动模块全程Python一个进程搞定不需要另外一块主控板。这种方案的优点是软件栈统一开发效率高缺点是GPIO实时性有限、功耗比Arduino高、一旦Linux系统卡死外设也跟着失控。所以我给这种方案划了一条线外设数量尽量少于五个控制频率不要超过几十赫兹比如摄像头追踪目标、控制两路电机这种场景完全够用。4.3 树莓派Arduino的主从异构方案项目越来越复杂之后我会回到“树莓派做主控、Arduino做执行器”的异构方案。这也是很多成熟机器人项目的基线架构。通信方式一般有两种树莓派的UART串口连接Arduino或者USB线连接。UART需要先启用树莓派的串口功能并在/boot/firmware/config.txt里把串口映射到GPIO引脚USB连接则更简单即插即用。通信协议我建议用两行以内的约定不要一开始就上复杂协议# Python发送给Arduino的指令格式 MOVE 100 50 # 前进速度100转向50 SERVO 9 90 # 9号舵机转90度Arduino端用Serial.readStringUntil(\n)接收一整行再用空格拆分成命令和参数。Python端用serial.write((cmd \n).encode())发送。这个方案的实时闭环仍然由Arduino负责树莓派挂了Arduino也会维持最后一条指令安全性高很多。4.4 几种方案怎么选我给一个快速判断顺序判断顺序其实就三步先问这个项目有没有视觉或复杂AI需求有就加重树莓派再问这个项目的外设控制是否需要微秒级实时性需要就加Arduino最后问项目规模是否允许功耗大、体积大部分允许就用树莓派单机。如果两个答案都偏向中间那就采用主从异构方案。硬件选型没有绝对正确只有适不适合当前任务。5. 常见故障的排查链路从板上红灯到Python报错5.1 Arduino上传超时和端口识别不到这个报错在所有Arduino新人里几乎都会出现症状一模一样点上传按钮进度条卡几秒然后提示avrdude: stk500_getsync() attempt 1 of 10: not in sync或Problem uploading to board。我的排查顺序是这样的先看板子型号是否选对。偷懒选成Arduino Uno但手里是Nano或者NodeMCU肯定超时。再看端口是不是被占用。Arduino IDE自带的串口监视器、Python脚本、其他串口工具同时开着同一个串口很容易导致上传失败。关掉其他程序再试。拔掉所有外围设备只留USB线。外设短路或大电流干扰经常导致复位失败。Windows环境下检查设备管理器如果显示CH340或者CP210x说明用了国产USB转串口芯片需要装对应驱动。Linux下用ls /dev/ttyUSB*或/dev/ttyACM*查看设备是否存在。如果一直失败检查板子的旧Bootloader问题。很多便宜的Uno兼容板用的是老版本Bootloader需要在IDE的“工具 → 处理器”里选择ATmega328P (Old Bootloader)。我曾经排查过一块上传一直失败的板子最后发现是USB线太细导致供电不稳。换一条带屏蔽的USB线立刻好了。USB线这东西往往是最容易被忽略的坑。5.2 树莓派红灯闪烁、磁盘写入被拒绝树莓派板载红色LED闪烁通常意味着系统启动失败或者供电不足。刚通电时红灯常亮是正常的但如果在开机过程中持续闪烁甚至熄灭最大嫌疑是电源不能提供足够的电流。手机充电器标称5V 2A实际很多是虚标接上鼠标键盘就没有余量了。建议直接换5V 3A以上的独立电源最好用树莓派官方电源。另一种红灯闪烁的情况是SD卡上的系统文件损坏。我经历过树莓派5突然红灯狂闪拔下来把SD卡插到电脑上读卡器提示分区无法访问。这种情况只能重新烧录镜像。如果是重要数据没备份很多文件可能已经找不回来了。所以我现在的习惯是系统配置好之后立刻做一次完整镜像备份用dd或者Raspberry Pi Imager的“读取备份”功能都行。磁盘写入被拒绝这个热词我推测是烧录镜像或者挂载SD卡时遇到的问题。在Windows上烧录工具提示“访问被拒绝”通常是因为杀毒软件在后台占用SD卡或者系统把SD卡分区识别为正在使用中的可移动磁盘。关闭杀毒软件、重新插拔读卡器之后重试大概率能解决。在Linux/macOS上如果mount之后写入失败检查SD卡是否被设为只读很多SD卡侧面有个小的写保护锁。5.3 SSH连不上或只能进命令行没有图形界面树莓派OS默认不开SSH服务。无显示器第一次连接时烧录系统后需要在SD卡的boot分区放一个名为ssh的空文件这样开机后才会启动SSH服务。不放这个文件任何SSH客户端都连不上。局域网内连接方式ssh pi树莓派IP如果不知道树莓派的IP从路由器后台找设备列表或者用ping raspberrypi.local解析mDNS地址。树莓派5的默认主机名可能已经变了最好在配置时自己改成一个好记的名字。“只能进命令行没有图形界面”这个问题一般是因为安装的是Lite版系统或者开机默认进入命令行模式。如果你想要图形界面执行sudo raspi-config在“System Options → Boot / Auto Login”里选择Desktop Autologin重启后进入桌面。还有一个场景是用VSCode远程开发你只通过SSH连上后在VSCode里安装Remote-SSH扩展再打开远程文件夹就能看到图形化的文件树和终端窗口这个体验比纯命令行友好很多。5.4 Python库装了却导入失败树莓派上最常见的Python报错是ModuleNotFoundError: No module named xxx。明明刚用pip install装过但运行时还是找不到。原因八成是你装了虚拟环境之外的包或者用错了解释器。排查思路用which python3和which pip3确认当前使用的是哪个解释器。用python3 -m pip --version检查包安装路径。如果系统里有多个Python版本比如树莓派OS自带的3.9和后来手动编译的3.11pip装的包可能只进了3.9但python3打开的却是3.11。最稳妥的解决方案是永远在虚拟环境里运行项目python3 -m venv ~/myenv source ~/myenv/bin/activate pip install pyserial python-dotenv虚拟环境的好处是每个项目有独立的依赖目录不会和系统包互相污染。树莓派5上部署YOLOv5这类依赖很多的项目如果不拆环境极容易遇到“A库需要numpy 1.xB库需要numpy 2.x”的冲突。至于热词里出现的“要安装缺失的节点请先在你的python环境中运行pip install -u --pre comfyui-m”这是某些AI绘图工具在检测到Python依赖不完整时的固定提示。遇到这种提示先看它希望你激活哪个环境再按提示安装即可本质就是上面说的环境和依赖管理问题。6. 最后分享几个我自己的使用习惯做了几年软硬结合的项目最深的体会是先把链路跑通再谈优化。很多新手喜欢一开始就搭一套复杂的架构结果Arduino端还在调舵机树莓派那边又要跑数据库最后哪头都没搞利索。我自己现在的流程是二十行代码先点亮一盏灯然后串口发一个字符逐步把链路所有环节验证一遍再往上面堆功能。硬件实验最怕的其实是供电。Arduino外接直流电机时电机的瞬时启动电流很大和传感器共用一路电源会导致电压跌落轻则数据异常重则单片机复位。树莓派更敏感所以我在所有项目里都会准备一个稳压模块或者独立电源然后保证所有模块共地。还有一点日志和数据记录一定要早做。Python做上位机时随手把原始串口数据用CSV存下来排错的时候能救你命。我有一次调一个看似随机出现的通信丢包问题就是因为保存了时间戳之后才发现在整秒时刻板子会重启最后定位到是舵机峰值电流打掉了电源电压。最后想说的是Arduino和树莓派之间的选择会随着项目变化而变化今天做小车可能觉得树莓派方便明天做精确控制又觉得Arduino更稳。没必要把自己绑定在某一个平台上两者配合着用才是做嵌入式系统最舒服的状态。如果这篇文章能让你少踩几个我踩过的坑那就很值了。
Python控制硬件：Arduino与树莓派选型、搭配与排错指南
很多人在刚接触硬件开发时都会问我想用Python控制开发板是选Arduino还是树莓派这个问题我刚开始做项目的时候也纠结过后来踩了一圈坑才明白它不是一道二选一的题。Arduino是一个以单片机为核心的开发平台树莓派是一台能跑Linux系统的微型主机两者的工作方式、适合的任务、甚至“用Python控制”的实现路径都完全不同。这篇文章我想把这两个平台搭配Python的玩法、环境配置、典型项目思路、常见报错和排查链路都梳理一遍给正准备入门或者已经在折腾的朋友一个相对完整的参考。1. 先把Arduino和树莓派的定位搞清楚再决定Python脚本往哪个方向写1.1 Arduino是单片机树莓派是Linux小主机Arduino的硬件核心是AVR、ARM等单片机芯片比如最常见的Arduino Uno用的是ATmega328P只有2KB RAM、32KB Flash。烧录代码后程序是裸机运行的没有操作系统这个概念上电即跑中断响应级别是微秒到毫秒级。所以Arduino天生适合做实时性要求比较高的底层控制比如驱动舵机、直流电机、读取编码器、处理传感器中断信号。树莓派则完全不同。以树莓派4B为例它是一颗四核ARM Cortex-A72处理器内存从2GB到8GB跑着完整的Linux系统树莓派OS、Ubuntu等。它本质上是一台小型电脑可以同时开Python进程、数据库、Web服务甚至加载本地神经网络模型做推理。树莓派虽然也带GPIO引脚但Linux系统不是实时系统普通GPIO翻转会有调度延迟所以树莓派更适合做“大脑”而不是做“肌肉”。很多人一上来就问Arduino和树莓派哪个强这其实是在拿螺丝刀和电钻比谁更硬要看具体拧什么螺丝。我做过的几个项目里凡是涉及精确时间控制的比如平衡小车、机械臂关节底层几乎都是Arduino凡是涉及视觉识别、路径规划、物联网上报的跑在树莓派上更顺手。1.2 Python在两种板上承担的角色完全不同这个点特别容易混淆必须先说清楚。普通Arduino Uno、Nano这类板子固件里跑的不是Python出厂默认引导程序烧录的是C代码。所谓“用Python控制Arduino”实际指的是两种常见做法第一种Python程序运行在PC或者树莓派上通过USB串口、UART、WiFi或蓝牙给Arduino发指令Arduino解析指令后去操作引脚。这也是最稳定、最通用的方式。我早期做智能小车项目时就是树莓派上跑Python做视觉识别识别到目标后通过串口发一个简单的字符命令Arduino那边根据命令控制电机转速和方向。第二种给支持MicroPython的板子烧MicroPython固件比如ESP32、树莓派Pico、部分STM32开发板然后直接在板子上运行Python脚本。注意这种Python不是CPython的完整实现而是一个精简的嵌入式Python解释器。Arduino Uno和Nano的AVR芯片内存太小装不下MicroPython所以这类玩法主要集中在ESP32和RP2040板子上。树莓派上的Python则是标准的CPython环境可以直接调用GPIO库读写引脚不需要中间转换层。你可以把树莓派当作一个可以直接控制硬件的通用计算机这也是它做原型开发特别方便的原因。1.3 两者搭配的典型场景我整理了一个我常用的对比表方便你在方案选型时快速判断对比项Arduino Uno/Nano树莓派 4B/5核心部件单片机AVR/ARMARM处理器 Linux系统内存2KB~几百KB2GB~8GB操作系统无裸机LinuxGPIO实时性高微秒级中断有调度延迟适合毫秒级控制Python支持需串口通信或MicroPython固件原生Python GPIO库适合任务传感器采集、电机控制、信号处理视觉识别、Web服务、边缘计算、复杂逻辑典型项目智能小车底盘、舵机云台、温湿度采集摄像头识别、家庭服务器、机器人主控实际项目里我更喜欢树莓派Arduino的搭配。树莓派负责“想”Arduino负责“做”。比如做一台可以自动跟随的机器人树莓派用摄像头识别目标计算位置偏移通过串口把转向角度和速度发给ArduinoArduino再去控制电机。这样即使树莓派某个进程卡住Arduino也能维持基本运动逻辑不会让小车原地乱撞。2. Arduino搭配Python的常见玩法串口通信和Firmata协议2.1 Arduino IDE安装、库位置改动的常见操作玩Arduino第一步是装IDE。官方IDE有1.8.x经典版和2.x新版我建议直接用Arduino IDE 2.x界面更现代自动补全和烧录监控都集成得比较好。装完后马上会碰到一个问题第三方库或者自己写的库默认放在用户目录下的Arduino/libraries文件夹里。比如Windows下是C:\Users\你的用户名\Documents\Arduino\librariesLinux下是~/Arduino/libraries。这个默认路径在两种情况下会让你难受一是系统盘空间不够二是你希望把库和项目一起放到移动硬盘上方便多台电脑同步。改库位置的方法很简单在Arduino IDE里打开“文件 → 首选项”找到“项目文件夹位置”或“Sketchbook location”改成你想要的目录IDE会自动把库目录切到新路径下的libraries子目录。改完之后一定要重启IDE否则有些库还是读不到。还有一个硬核办法用符号链接把旧位置链接到新位置适合那种IDE版本升级后迁移配置的场景。我实际踩过的坑是改了项目文件夹位置后旧项目使用的相对路径全部失效很多第三方库的下载和更新也会指向新目录所以迁移时最好先把旧库完整备份然后逐个测试哪些库能用别一股脑全删。2.2 pySerial通信最小可运行的上位机例子串口是Python控制Arduino的最常见方式。Arduino端先写一个简单的C程序接收字符指令并控制LED// Arduino端 const int ledPin 13; void setup() { pinMode(ledPin, OUTPUT); Serial.begin(9600); } void loop() { if (Serial.available() 0) { char cmd Serial.read(); if (cmd 1) { digitalWrite(ledPin, HIGH); Serial.println(led_on); } else if (cmd 0) { digitalWrite(ledPin, LOW); Serial.println(led_off); } } }烧录好之后PC端先用pip install pyserial安装pySerial然后跑这个Python脚本import serial import time # Windows下一般是COM3、COM4Linux下是/dev/ttyUSB0或/dev/ttyACM0 ser serial.Serial(/dev/ttyUSB0, 9600, timeout1) # 等Arduino重启完成避免立刻发指令被忽略 time.sleep(2) ser.write(b1) response ser.readline() print(response.decode().strip()) ser.write(b0) response ser.readline() print(response.decode().strip()) ser.close()这个例子的核心逻辑就是“Python发命令Arduino执行命令再回传结果”。实际项目里我不会用这么简单的字符协议但思路是一样的双方约定一个命令集比如MOVE F 100表示前进100毫秒MOVE B 50表示后退50毫秒Arduino端用String或者字符数组解析Python端用serial.write发送。需要注意几个细节波特率两端必须一致USB串口设备在Linux下需要权限没用root权限时经常遇到PermissionError解决办法是把当前用户加入dialout组sudo usermod -a -G dialout $USER2.3 pyfirmata控制舵机不刷固件的便捷方案如果你想跳过自己写Arduino C代码直接用Python操作引脚可以试试Firmata协议。Firmata是一个跑在Arduino上的通用固件通过串口把Arduino的引脚操作暴露给上位机。操作步骤在Arduino IDE里选择“文件 → 示例 → Firmata → StandardFirmata”上传到板子。PC端安装pyfirmatapip install pyfirmata断开Arduino连接的时候重新插一下USB让StandardFirmata跑起来然后运行Python脚本。控制舵机的示例from pyfirmata import Arduino, SERVO import time # Linux下常见设备名Windows用COM口 board Arduino(/dev/ttyUSB0) # 第9号数字引脚SERVO模式 pin board.get_pin(d:9:S) pin.write(90) # 转90度 time.sleep(1) pin.write(0) # 转0度 time.sleep(1) pin.write(180) # 转180度 board.exit()pyfirmata的d:9:S意思是digital引脚9SERVO模式。舵机是接信号线到9号引脚、电源线和地线按接线图接好注意舵机需要的电流比较大别直接用小开发板上的3.3V供电最好用外接5V电源共地后才能正常工作。这种方案的好处是开发速度快不用频繁在IDE和Python之间来回切换烧录坏处是Firmata协议有一定的通信开销高频实时控制场景下比如动态平衡、高速PWM输出不太够用。我建议用它做原型验证最终产品还是写C更可控。2.4 wokwi仿真平台适合验证逻辑有时候手边没有硬件或者想给项目写文档、做演示可以用Wokwi这个浏览器仿真平台。它支持Arduino Uno、ESP32、树莓派Pico等多种开发板可以直接在网页里搭建电路模拟LED、舵机、传感器、LCD屏幕等外设。Wokwi对Python的作用更多是验证串口通信协议。你可以先在Wokwi里搭一个Arduino仿真环境写好C固件然后本机Python通过串口连到仿真端口跑通指令流程后再挪到真实硬件上。这样能省不少来回烧录的时间也适合在没硬件的电脑上临时测试PySerial代码。不过要提醒一句仿真永远不等于真实硬件。Wokwi对时序的模拟比较理想化真实场景里的电源噪声、电平抖动、串口收发延迟这些坑它不会帮你暴露出来。所以我的用法是逻辑先用仿真验证物理问题还是得上真板子踩。3. 树莓派从系统安装到Python控制的完整链路3.1 系统烧录、换源、Python环境配置树莓派上跑Python第一步是把系统装好。最推荐的是Raspberry Pi Imager官方烧录工具选择目标SD卡、选择系统镜像然后写入。树莓派5目前推荐装最新的树莓派OS基于Debian的bookworm分支如果要在树莓派上跑需要大量x86兼容软件的场景也可以装Ubuntu 22.04 Server或Desktop版本。装完系统后进入终端的第一个操作就是更新软件源。树莓派官方源在国外国内直连经常慢到怀疑人生所以很多人会换用清华镜像源。对Ubuntu 22.04来说典型的做法是把/etc/apt/sources.list里的ports.ubuntu.com替换成清华镜像因为树莓派是arm64架构。树莓派OS则是改/etc/apt/sources.list.d/raspi.list和/etc/apt/sources.list里的权限与源地址。换源的命令不复杂但很多版本差异会导致源文件路径不一样。我的建议是动手改之前先确认自己的系统版本lsb_release -a cat /etc/os-release然后用sed或者nano修改对应文件。改完一定要执行sudo apt update sudo apt upgrade -y如果在apt update过程中频繁报错先检查网络是否能访问镜像站再看文件里是否有多余空格或注释符。热词里经常出现“树莓派换源买到了什么版本”其实就说明很多人卡在版本兼容这一步。系统源搞定后Python环境反而简单。树莓派OS和Ubuntu都自带Python 3但系统自带的Python版本可能不够新。我建议用python3 --version检查如果需要升级用sudo apt install python3 python3-pip python3-venv装好基础工具。这里我强烈建议使用虚拟环境后面会细说。3.2 GPIO库选型RPi.GPIO、GPIO Zero、pigpio对比树莓派上用Python控制GPIO核心是选库。我遇到过很多新手上来就装RPi.GPIO结果树莓派5上跑不了或者频繁警告。这不是代码问题而是RPi.GPIO这几年维护缓慢新内核上兼容性变差。库名称维护状态适用板型特点RPi.GPIO旧更新较少树莓派4B及之前经典库教程多但新系统兼容性差GPIO Zero官方推荐活跃树莓派5也支持接口简洁适合快速原型pigpio较活跃树莓派4B/5需验证支持硬件PWM、远程GPIO控制lgpio新面向新内核树莓派5libgpiod封装性能好如果你用的是树莓派5我建议优先使用GPIO Zero或者lgpio如果只是做个简单测试且系统还是旧版本树莓派OS那RPi.GPIO也不是不能用只是装的时候要用pip install RPi.GPIO时注意区分是系统仓库里的版本还是社区修复版。GPIO Zero的写法很直观from gpiozero import LED from time import sleep led LED(17) # BCM编号17号引脚 led.on() sleep(1) led.off()一个LED和按钮都能用几行代码驱动。它的代码风格比较接近“声明式”对新手友好但底层参数调节不够细。做PWM呼吸灯、舵机这类需要精确脉宽控制时我反而会用pigpio或者直接操作系统接口。3.3 引脚编号与PWM输出细节树莓派引脚有两个常用编号体系BOARD物理引脚号和BCMBroadcom芯片名。GPIO Zero默认用的是BCM编号比如LED(17)就是把BCM 17映射到物理引脚11。接错板子的时候经常看到有人一脸懵因为BCM 17和物理引脚17并不是同一个位置用之前最好拿一张引脚图对照一下。PWM输出是树莓派的一个弱项。普通GPIO的软件PWM由Linux内核调度产生精度一般做呼吸灯没问题但控制航模舵机或者做电调信号时就不够稳。树莓派的硬件PWM只有少数几个引脚支持比如BCM 12、13、18、19。我的建议是需要稳定PWM时优先选这些引脚并且用pigpio这类库来初始化和输出。软件PWM驱动舵机的典型代码import pigpio import time servo_gpio 18 pi pigpio.pi() # 50Hz舵机脉宽范围500us到2500us pi.set_servo_pulsewidth(servo_gpio, 1000) # 大约0度 time.sleep(1) pi.set_servo_pulsewidth(servo_gpio, 1500) # 90度 time.sleep(1) pi.set_servo_pulsewidth(servo_gpio, 2000) # 180度 pi.stop()注意set_servo_pulsewidth的单位是微秒不是占空比。这个方法的好处是底层用的硬件定时器输出比较稳定。给舵机供电时同样要注意外部电源共地我见过太多人把舵机直接接树莓派5V口结果电压被拉低、系统重启。3.4 摄像头模块与视觉方向的衔接树莓派搭配摄像头最常见的就是OV5647模块也就是大家常说的树莓派Camera Module V1/V2。树莓派OS新版本里拍照和视频采集推荐用libcamera工具链和picamera2 Python库。安装sudo apt install python3-picamera2拍照from picamera2 import Picamera2 picam2 Picamera2() config picam2.create_still_configuration() picam2.configure(config) picam2.start() picam2.capture_file(test.jpg) picam2.stop()这个流程在树莓派4B和5上都能跑通。注意启用摄像头前需要在raspi-config里开启Camera接口否则Picamera2()初始化会报错。开摄像头后如果系统很卡多半是内存不足可以在/boot/firmware/config.txt里调大gpu_mem或者使用分辨率更低的预览模式。摄像头和Python结合后最常见的进阶方向是部署自己的YOLOv5模型做目标检测。你可以在PC上训练好模型导出为TorchScript或ONNX格式然后放到树莓派上跑推理。这里有个容易被忽视的问题树莓派4B/5的内存和CPU算力有限YOLOv5的nano模型勉强能实时跑标准版会非常慢。优化思路一般是先降低输入分辨率、再用ONNX Runtime或TensorRT优化最后如果还不够就考虑外接Edge TPU或NPU模块。树莓派5上部署YOLOv5我建议先用纯CPU版本跑通流程再一步步做推理加速。4. 实际项目中我会怎么选择几个典型组合方案4.1 PC Python Arduino的入门组合如果你是第一次做硬件和Python结合的项目我推荐先用PC跑PythonUSB线连接Arduino做一个最简单的温湿度采集或者LED控制。这个组合的价值在于分工清晰Python端可以方便地打印日志、画曲线、存数据库Arduino端负责处理传感器数据和引脚输出。入门项目可以做这样一个系统Arduino接DHT11温湿度传感器定时读取并发送到串口Python通过pySerial读取串口数据解析成结构化数据Python把数据写入CSV或者用Flask开一个本地网页实时展示温度曲线。这个组合不需要树莓派也不涉及复杂的Linux配置最适合把“串口通信”这个底座打牢。4.2 树莓派单独完成采集、控制与推理如果项目需要视觉能力同时又要驱动一定数量的外设可以考虑树莓派单机方案。比如做一个视觉跟随小车树莓派接摄像头识别目标通过GPIO控制电机驱动模块全程Python一个进程搞定不需要另外一块主控板。这种方案的优点是软件栈统一开发效率高缺点是GPIO实时性有限、功耗比Arduino高、一旦Linux系统卡死外设也跟着失控。所以我给这种方案划了一条线外设数量尽量少于五个控制频率不要超过几十赫兹比如摄像头追踪目标、控制两路电机这种场景完全够用。4.3 树莓派Arduino的主从异构方案项目越来越复杂之后我会回到“树莓派做主控、Arduino做执行器”的异构方案。这也是很多成熟机器人项目的基线架构。通信方式一般有两种树莓派的UART串口连接Arduino或者USB线连接。UART需要先启用树莓派的串口功能并在/boot/firmware/config.txt里把串口映射到GPIO引脚USB连接则更简单即插即用。通信协议我建议用两行以内的约定不要一开始就上复杂协议# Python发送给Arduino的指令格式 MOVE 100 50 # 前进速度100转向50 SERVO 9 90 # 9号舵机转90度Arduino端用Serial.readStringUntil(\n)接收一整行再用空格拆分成命令和参数。Python端用serial.write((cmd \n).encode())发送。这个方案的实时闭环仍然由Arduino负责树莓派挂了Arduino也会维持最后一条指令安全性高很多。4.4 几种方案怎么选我给一个快速判断顺序判断顺序其实就三步先问这个项目有没有视觉或复杂AI需求有就加重树莓派再问这个项目的外设控制是否需要微秒级实时性需要就加Arduino最后问项目规模是否允许功耗大、体积大部分允许就用树莓派单机。如果两个答案都偏向中间那就采用主从异构方案。硬件选型没有绝对正确只有适不适合当前任务。5. 常见故障的排查链路从板上红灯到Python报错5.1 Arduino上传超时和端口识别不到这个报错在所有Arduino新人里几乎都会出现症状一模一样点上传按钮进度条卡几秒然后提示avrdude: stk500_getsync() attempt 1 of 10: not in sync或Problem uploading to board。我的排查顺序是这样的先看板子型号是否选对。偷懒选成Arduino Uno但手里是Nano或者NodeMCU肯定超时。再看端口是不是被占用。Arduino IDE自带的串口监视器、Python脚本、其他串口工具同时开着同一个串口很容易导致上传失败。关掉其他程序再试。拔掉所有外围设备只留USB线。外设短路或大电流干扰经常导致复位失败。Windows环境下检查设备管理器如果显示CH340或者CP210x说明用了国产USB转串口芯片需要装对应驱动。Linux下用ls /dev/ttyUSB*或/dev/ttyACM*查看设备是否存在。如果一直失败检查板子的旧Bootloader问题。很多便宜的Uno兼容板用的是老版本Bootloader需要在IDE的“工具 → 处理器”里选择ATmega328P (Old Bootloader)。我曾经排查过一块上传一直失败的板子最后发现是USB线太细导致供电不稳。换一条带屏蔽的USB线立刻好了。USB线这东西往往是最容易被忽略的坑。5.2 树莓派红灯闪烁、磁盘写入被拒绝树莓派板载红色LED闪烁通常意味着系统启动失败或者供电不足。刚通电时红灯常亮是正常的但如果在开机过程中持续闪烁甚至熄灭最大嫌疑是电源不能提供足够的电流。手机充电器标称5V 2A实际很多是虚标接上鼠标键盘就没有余量了。建议直接换5V 3A以上的独立电源最好用树莓派官方电源。另一种红灯闪烁的情况是SD卡上的系统文件损坏。我经历过树莓派5突然红灯狂闪拔下来把SD卡插到电脑上读卡器提示分区无法访问。这种情况只能重新烧录镜像。如果是重要数据没备份很多文件可能已经找不回来了。所以我现在的习惯是系统配置好之后立刻做一次完整镜像备份用dd或者Raspberry Pi Imager的“读取备份”功能都行。磁盘写入被拒绝这个热词我推测是烧录镜像或者挂载SD卡时遇到的问题。在Windows上烧录工具提示“访问被拒绝”通常是因为杀毒软件在后台占用SD卡或者系统把SD卡分区识别为正在使用中的可移动磁盘。关闭杀毒软件、重新插拔读卡器之后重试大概率能解决。在Linux/macOS上如果mount之后写入失败检查SD卡是否被设为只读很多SD卡侧面有个小的写保护锁。5.3 SSH连不上或只能进命令行没有图形界面树莓派OS默认不开SSH服务。无显示器第一次连接时烧录系统后需要在SD卡的boot分区放一个名为ssh的空文件这样开机后才会启动SSH服务。不放这个文件任何SSH客户端都连不上。局域网内连接方式ssh pi树莓派IP如果不知道树莓派的IP从路由器后台找设备列表或者用ping raspberrypi.local解析mDNS地址。树莓派5的默认主机名可能已经变了最好在配置时自己改成一个好记的名字。“只能进命令行没有图形界面”这个问题一般是因为安装的是Lite版系统或者开机默认进入命令行模式。如果你想要图形界面执行sudo raspi-config在“System Options → Boot / Auto Login”里选择Desktop Autologin重启后进入桌面。还有一个场景是用VSCode远程开发你只通过SSH连上后在VSCode里安装Remote-SSH扩展再打开远程文件夹就能看到图形化的文件树和终端窗口这个体验比纯命令行友好很多。5.4 Python库装了却导入失败树莓派上最常见的Python报错是ModuleNotFoundError: No module named xxx。明明刚用pip install装过但运行时还是找不到。原因八成是你装了虚拟环境之外的包或者用错了解释器。排查思路用which python3和which pip3确认当前使用的是哪个解释器。用python3 -m pip --version检查包安装路径。如果系统里有多个Python版本比如树莓派OS自带的3.9和后来手动编译的3.11pip装的包可能只进了3.9但python3打开的却是3.11。最稳妥的解决方案是永远在虚拟环境里运行项目python3 -m venv ~/myenv source ~/myenv/bin/activate pip install pyserial python-dotenv虚拟环境的好处是每个项目有独立的依赖目录不会和系统包互相污染。树莓派5上部署YOLOv5这类依赖很多的项目如果不拆环境极容易遇到“A库需要numpy 1.xB库需要numpy 2.x”的冲突。至于热词里出现的“要安装缺失的节点请先在你的python环境中运行pip install -u --pre comfyui-m”这是某些AI绘图工具在检测到Python依赖不完整时的固定提示。遇到这种提示先看它希望你激活哪个环境再按提示安装即可本质就是上面说的环境和依赖管理问题。6. 最后分享几个我自己的使用习惯做了几年软硬结合的项目最深的体会是先把链路跑通再谈优化。很多新手喜欢一开始就搭一套复杂的架构结果Arduino端还在调舵机树莓派那边又要跑数据库最后哪头都没搞利索。我自己现在的流程是二十行代码先点亮一盏灯然后串口发一个字符逐步把链路所有环节验证一遍再往上面堆功能。硬件实验最怕的其实是供电。Arduino外接直流电机时电机的瞬时启动电流很大和传感器共用一路电源会导致电压跌落轻则数据异常重则单片机复位。树莓派更敏感所以我在所有项目里都会准备一个稳压模块或者独立电源然后保证所有模块共地。还有一点日志和数据记录一定要早做。Python做上位机时随手把原始串口数据用CSV存下来排错的时候能救你命。我有一次调一个看似随机出现的通信丢包问题就是因为保存了时间戳之后才发现在整秒时刻板子会重启最后定位到是舵机峰值电流打掉了电源电压。最后想说的是Arduino和树莓派之间的选择会随着项目变化而变化今天做小车可能觉得树莓派方便明天做精确控制又觉得Arduino更稳。没必要把自己绑定在某一个平台上两者配合着用才是做嵌入式系统最舒服的状态。如果这篇文章能让你少踩几个我踩过的坑那就很值了。