【产出】 > 用 gpiozero 库控制树莓派 GPIO:点亮和闪烁 LED、读取按键并响应按下事件,同时搞清楚引脚编号、3.3 V 电平和电流上限,避免一接线就烧坏 GPIO。
【版本】 > 按 gpiozero 官方文档和树莓派官方硬件文档编写,适用于树莓派 5 / 4B / 3B+ / Zero 2 W 与 Raspberry Pi OS Bookworm 及以后版本(gpiozero 已预装)。
一、先记住三条电气规则
树莓派官方文档给出的硬性限制:
| 规则 | 数值 |
|---|---|
| GPIO 电平 | 3.3 V,不耐受 5 V。给引脚接 5 V 可能永久损坏芯片 |
| 单个引脚输出电流 | 最多 16 mA |
| 全部 GPIO 合计输出电流 | 最多 50 mA |
由此得出几个实际做法:
- 接 LED 必须串限流电阻(官方明确要求)。3.3 V 驱动红色 LED,用 220–330 Ω,电流约 4–6 mA。
- 电机不能直接接 GPIO,一定要经过电机驱动板(官方原话:never connect motors directly to GPIO pins)。
- 5 V 的传感器或模块(很多 Arduino 生态的模块)输出信号是 5 V,要加电平转换后才能接 GPIO。
- 接线前确认排针方向。官方提醒:键盘一体机(如树莓派 400 / 500)的排针是旋转 180° 的,照着普通板子的图接会接反。
二、引脚编号:用 GPIO 号,不是物理引脚号
gpiozero 默认使用 BCM(GPIO)编号,并且不能改成别的模式。例如物理第 11 脚是 GPIO17,代码里写 17:
from gpiozero import LED
led = LED(17) # GPIO17
led = LED("BOARD11") # 等价写法:物理第 11 脚
打印对象时显示的始终是 GPIO 编号(GPIO17)。在终端里执行 pinout 可以直接看到当前板子的引脚图。
【注意】 > GPIO2、GPIO3 是 I2C 引脚,板子上焊有固定的 1.8 kΩ 上拉电阻;GPIO0、GPIO1 保留给 HAT 扩展板识别用。做普通输入输出时尽量避开这几个脚。
三、点亮和闪烁 LED
接线:GPIO17 → 330 Ω 电阻 → LED 长脚(正极),LED 短脚 → GND。
from gpiozero import LED
from time import sleep
red = LED(17)
while True:
red.on()
sleep(1)
red.off()
sleep(1)
更简单的写法,用内置的 blink():
from gpiozero import LED
from signal import pause
red = LED(17)
red.blink()
pause()
【提示】 > 为什么最后要写
pause():官方文档说明,脚本运行到末尾进程就会退出,GPIO 可能被复位,LED 也就灭了。pause()让程序一直运行下去,按Ctrl+C结束。
四、读取按键
接线:按键一端接 GPIO2 之外的任意普通 GPIO(下例用 GPIO4,避开 I2C 脚),另一端接 GND。gpiozero 的 Button 默认打开引脚内部上拉,所以不需要外接上拉电阻。
等待按下:
from gpiozero import Button
button = Button(4)
button.wait_for_press()
print("Button was pressed")
事件回调:
from gpiozero import Button
from signal import pause
def say_hello():
print("Hello!")
def say_goodbye():
print("Goodbye!")
button = Button(4)
button.when_pressed = say_hello
button.when_released = say_goodbye
pause()
【注意】 > 赋值时写函数名
say_hello,不要加括号。官方文档专门提醒:写成say_hello()会先执行一次函数,把返回值None赋给when_pressed,之后按键就什么反应都没有了。
五、按键控制 LED
from gpiozero import LED, Button
from signal import pause
led = LED(17)
button = Button(4)
button.when_pressed = led.on
button.when_released = led.off
pause()
想按一下切换一次亮灭,把两行回调换成 button.when_pressed = led.toggle。
六、常见问题
| 现象 | 原因 | 处理 |
|---|---|---|
| LED 不亮 | LED 接反,或者引脚号写成了物理脚号 | 长脚接电阻那端;用 pinout 核对 GPIO 号 |
| 程序一运行完 LED 就灭 | 脚本结束后 GPIO 被复位 | 末尾加 pause() |
| 按键按一下触发好几次 | 机械按键抖动 | Button(4, bounce_time=0.05) |
| 提示引脚被占用 | 另一个程序还在用这个引脚 | 结束之前的 Python 进程后再运行 |
参考资料
- gpiozero 官方示例:https://gpiozero.readthedocs.io/en/stable/recipes.html
- 树莓派官方硬件文档(GPIO 电气参数):https://www.raspberrypi.com/documentation/computers/raspberry-pi.html
评价 (0)