一、先破一个误解：Python 能"直接跑"在 Arduino 上吗

不能——至少 Uno 系列不能。

8-1 讲过：Uno 只有 2KB 内存，而一个 Python 解释器本体就要几百 KB。装不进去。

所以"用 Python 和 Arduino 打交道"这件事，实际上有三条路，先把它们分清楚：

方式 ③ 要用什么板子？ 内存够大的那些：

• Arduino Nano ESP32（官方支持 MicroPython）
• Arduino Nano RP2040 Connect
• 树莓派 Pico（严格说不是 Arduino，但同理）

二、思路：把 Arduino 变成一块"哑巴 I/O 卡"

打个比方：

8-3 的方式 ＝ 你给一个工人写了张施工图，他自己照着干（Arduino 自己有逻辑）。 本节的方式 ＝ 你把工人变成一只听话的手，你让他抬手他就抬手（逻辑全在你这边）。

技术上怎么实现：给 Arduino 烧一份官方提供的标准固件 StandardFirmata。它做的事情只有一件——一直监听串口，收到指令就照做：

Python 发指令："把 13 脚拉高"   →   Arduino 拉高 13 脚
Python 发指令："A0 现在多少？"   →   Arduino 读 A0 并把结果发回来

Firmata 就是一个协议：双方约定好"发这个字节代表做那个动作"。

代价是什么（三条，都要接受）

换来什么？ 不用写一行 C++，改逻辑不用重新上传。 而且——Python 那一整套生态（摄像头、网络、数据库、画图）都能直接调用。

三、动手：三步

3.1 第一步：把 StandardFirmata 烧进 Arduino

在 Arduino IDE 里：文件 → 示例 → Firmata → StandardFirmata，然后点上传。

用 arduino-cli 的话（8-2 装的那个），先找到示例路径：

arduino-cli sketch new ~/Arduino/MyFirmata     # 先建个空程序占位
# 示例文件在核心包里，路径类似：
find ~/.arduino15 -name "StandardFirmata.ino" 2>/dev/null | head -3

找到后把那个文件复制进你的程序目录、改名成同名，再编译上传（或者干脆用 IDE 做这一步，这一步用图形界面更省事）。

看到什么算成功：上传过程无报错。烧完之后板载灯不再闪了（因为 StandardFirmata 什么也不主动做，它只是等命令）。

3.2 第二步：在树莓派上装 Python 库

⚠️ 先回忆 6-5 那个坑：从 Bookworm 起，系统不允许直接 pip install 往全局装包（PEP 668），会报 externally-managed-environment。

所以走 venv：

python3 -m venv ~/arduino-env            # 建一个虚拟环境
source ~/arduino-env/bin/activate        # 激活它
pip install pyfirmata2 pyserial          # 装库

看到什么算成功：提示 Successfully installed pyfirmata2-... pyserial-...

3.3 第三步：跑第一个脚本（用 Python 点灯）

新建 py_blink.py：

from pyfirmata2 import Arduino
import time

board = Arduino('/dev/ttyACM0')      # ← 端口名按你实际的改

try:
    led = board.get_pin('d:13:o')    # 数字脚 13，输出
    for i in range(5):
        led.write(1)                 # 高 → 灯亮
        time.sleep(0.5)
        led.write(0)                 # 低 → 灯灭
        time.sleep(0.5)
finally:
    board.exit()                     # 一定要收尾，否则串口不释放

跑：

python3 py_blink.py

看到什么算成功：板载 L 灯闪 5 次（快闪，每半秒一换），脚本跑完正常退出。

读结果：

四、'd:13:o' 这个字符串怎么读

这是 pyfirmata 的核心写法，三段用冒号隔开：

'd'  :  13  :  'o'
 │       │      └── 模式：o = 输出 / i = 输入 / p = PWM 输出 / s = 舵机
 │       └──────── 脚号
 └──────────────── 类型：d = 数字脚 / a = 模拟脚

完整对照表：

用法：

led  = board.get_pin('d:13:o')
led.write(1)            # 输出：写 1=高、0=低、0.5=半亮（PWM 脚）
led.write(0.5)

btn  = board.get_pin('d:7:i')
btn.read()              # 输入：返回 True / False

pot  = board.get_pin('a:0:i')
pot.read()              # 模拟输入：返回 0.0 ~ 1.0 的浮点数

五、⚠️ 本节最大的坑：必须起 Iterator 线程

现象：读模拟量读到一堆 None／读数一直不动／脚本跑几十秒后崩掉。

原因：Arduino 会源源不断地把模拟值往串口推。如果 Python 不持续去读，数据就会在缓冲区里越堆越多——最后溢出，通信全乱。

解决：开一个后台线程专门负责"收信"：

from pyfirmata2 import Arduino, util

board = Arduino('/dev/ttyACM0')
it = util.Iterator(board)      # 建这个"收信员"
it.start()                     # 让他开始工作

这两行是模拟输入的标配，忘了就等着被坑。

六、动手 Demo：Python 点灯 ＋ 读电位器

硬件：把电位器按 7-5 学的接法接到 Arduino 上（三个脚都要接：两端分别接 5V 和 GND，中间脚接 A0）。

为什么是 5V 而不是 3.3V？因为 Arduino 是 5V 逻辑的板子（8-1 讲过）。这次是接到 Arduino 上，不是接树莓派——别接错了板子。

代码（py_pot.py）：

from pyfirmata2 import Arduino, util
import time

board = Arduino('/dev/ttyACM0')
it = util.Iterator(board)        # 起"收信员"
it.start()

led = board.get_pin('d:13:o')
pot = board.get_pin('a:0:i')     # A0，模拟输入

try:
    print("转一转电位器，看看读数（Ctrl+C 结束）")
    while True:
        v = pot.read()
        if v is not None:
            volt = v * 5.0        # Arduino 的满量程是 5V
            print(f"读数 {v:.3f}   约 {volt:.2f} V")
            # 顺便让灯跟着亮灭：电压超过一半就亮
            led.write(1 if v > 0.5 else 0)
        time.sleep(0.3)
except KeyboardInterrupt:
    print("\n结束")
finally:
    board.exit()

看到什么算成功：

读数 0.000   约 0.00 V
读数 0.253   约 1.27 V
读数 0.508   约 2.54 V
读数 0.997   约 4.99 V

而且转电位器时数字在变，板载灯大致在"一半以上"亮起。

读结果（逐条对）：

七、30 秒实验：亲手量一量这条 USB 的延迟

本节一直在说"延迟 10~25 毫秒"——这个数字其实可以自己量出来。量完，你对"该不该走这条路"就有判断力了。

在 8-4 那个 venv 里跑（记得先激活）：

import time
from pyfirmata2 import Arduino, util

board = Arduino('/dev/ttyACM0')
it = util.Iterator(board)
it.start()
pot = board.get_pin('a:0:i')

time.sleep(1)                    # 等它开始上报数据

t0 = time.perf_counter()
n = 0
while n < 200:
    v = pot.read()
    if v is not None:
        n += 1
    time.sleep(0.005)            # ⚠️ 别读太快（下面解释）
used = time.perf_counter() - t0

print(f"读到 200 个有效值，用了 {used:.2f} 秒")
print(f"平均每个值 {used / 200 * 1000:.1f} 毫秒")
board.exit()

你会看到类似：

读到 200 个有效值，用了 4.30 秒
平均每个值 21.5 毫秒

读结果：

八、什么时候该走这条路，什么时候别走

一句话总结这条路：省事的代价是"离不开"和"慢一点"。

九、常见误区

1. "Python 可以直接跑在 Arduino Uno 上" —— ❌ Uno 不行（2KB 内存装不下解释器）。要在板子上跑 Python，选 Nano ESP32／Nano RP2040 Connect 那类。本节讲的是"从外面指挥"。

2. "不用给 Arduino 烧固件" —— ❌ 必须先烧 StandardFirmata。烧完之后板子就变成"哑巴执行器"了，这也是为什么烧完之后板载灯不再闪。

3. "pyfirmata 和 pyfirmata2 装哪个都行" —— 用 pyfirmata2。原版基本停止维护，老教程里的 pip install pyfirmata 是旧写法。

4. "直接 pip install 就行" —— ❌ 从 Bookworm 起会被 PEP 668 拦下（6-5 讲过）。必须建 venv，而且每次新开终端要重新 activate。

5. "读模拟量直接读就行" —— ⚠️ 两个条件：起 util.Iterator 线程（不起会缓冲溢出）、原版 pyfirmata 还要 enable_reporting()。

6. "这个延迟和本地 GPIO 差不多" —— 差得远。每次操作 10~25 毫秒（要绕一趟 USB），而树莓派本地 GPIO 是微秒级。这是本章最需要权衡的一个数。

7. "Arduino 会记住我写的逻辑" —— ❌ 在 Firmata 模式下它什么逻辑都没有（这正是"哑巴卡"的意思）。树莓派一断，它就冻在那儿。

8. "本节和 8-5 是一件事" —— 不是。本节用的是现成的标准协议（Firmata，规则别人订好了）；8-5 是自己订协议（发什么字符、怎么分隔字段，你自己设计）。前者省事，后者灵活也更快。

9. "电位器两端也接 3.3V 吧" —— ⚠️ 本节是接在 Arduino 上，5V 逻辑，两端接 5V 和 GND。别和 7-5 接在树莓派/ADC 上的接法混了。

• ☐ 下一节（8-5 在树莓派使用 Python 建立串口通信）

相关笔记

• 使用 Arduino IDE 建立 Arduino 程序 —— 上一节：那条"改完要重新上传"的路，本节换成了"只改 Python 一行"
• 在树莓派使用 Python 建立串口通信 —— 下一节：不用 Firmata，自己在串口上订协议，讲透"通话线路"
• Python 函数与模块 —— 本节三个坑的出处：PEP 668、venv 必须激活、装库的两条正路
• 模拟输入 —— 同一颗电位器、同一件"读电压"的事，那里接在树莓派＋MCP3008 上，本节接在 Arduino 上
• 认识 Arduino Uno 开发板 —— 2KB 内存、"有 ADC"这两条，是本节能成立的前提
• 🍓 树莓派 · 索引 —— 全课路线图