4、GPIO编程入门：使用RPi.GPIO控制LED、读取按钮状态、理解输入输出模式与上拉/下拉电阻

GPIO（General Purpose Input/Output，通用输入输出）是树莓派与外部世界交互的最基础通道。无论是点亮一盏LED、读取一个按键，还是后续连接温湿度传感器、继电器或电机驱动模块，本质上都是在操作GPIO引脚的电平状态。本章将围绕Python的RPi.GPIO库，系统讲解如何将引脚配置为输入或输出模式，如何通过软件控制LED的亮灭，以及如何正确读取按钮状态并理解上拉/下拉电阻在其中的关键作用。掌握本章内容，是后续所有传感器数据采集项目的硬件操作基石。

上图展示了本章的核心知识框架：树莓派SoC通过GPIO引脚与外部电路交互，左侧为输出模式驱动LED的典型电路，右侧为输入模式读取按钮状态的电路，底部则是Python RPi.GPIO库对这两种模式的软件控制接口。理解这张图，就把握住了GPIO编程的物理本质——软件操作寄存器，寄存器改变引脚电平，电平驱动外部电路。

4.1 核心原理：GPIO的工作模式与电气特性

GPIO引脚在芯片内部是一个多功能的复用引脚，通过软件配置可以工作在输入或输出模式。在输出模式下，引脚由芯片内部的推挽电路驱动，可以主动输出高电平（3.3V）或低电平（0V），用于驱动LED、蜂鸣器、继电器等负载。在输入模式下，引脚呈现高阻态，外部电路的电平状态决定了引脚的逻辑值，用于读取按钮、传感器数字输出等信号。

树莓派的GPIO引脚逻辑电平为3.3V，与5V逻辑不兼容。直接给GPIO引脚施加5V电压会损坏SoC。每个GPIO引脚的最大输出电流约为16mA，所有引脚的总输出电流不宜超过50mA。驱动LED时，必须串联限流电阻，典型值为220Ω~1kΩ，将电流限制在2~10mA范围内，既能保证亮度，又不会损坏引脚。

理解输入模式的关键在于“浮空”概念。当引脚配置为输入且外部没有明确的电平驱动时，引脚电压是不确定的，会受电磁干扰、引脚附近电场影响而随机跳变。这就是为什么直接读取一个悬空按钮的状态会得到不稳定结果。解决浮空问题的方法就是使用上拉或下拉电阻，将引脚在无操作时钳位到一个确定的电平。

4.2 判断方法与操作流程：RPi.GPIO库的标准使用步骤

RPi.GPIO库是树莓派官方推荐的Python GPIO控制库，使用前需要安装：sudo apt install python3-rpi.gpio。库的使用遵循固定的四步流程：导入库、设置模式、配置引脚、执行读写操作。下面以控制LED和读取按钮为例，展示完整的标准流程。

import RPi.GPIO as GPIO
import time

# 1. 设置引脚编号模式
GPIO.setmode(GPIO.BCM)  # 使用BCM编号，对应SoC内部GPIO编号

# 2. 配置引脚模式
LED_PIN = 17
BTN_PIN = 18
GPIO.setup(LED_PIN, GPIO.OUT, initial=GPIO.LOW)  # 输出模式，初始低电平
GPIO.setup(BTN_PIN, GPIO.IN, pull_up_down=GPIO.PUD_DOWN)  # 输入模式，启用下拉电阻

# 3. 主循环
try:
    while True:
        btn_state = GPIO.input(BTN_PIN)  # 读取按钮状态
        if btn_state == GPIO.HIGH:
            GPIO.output(LED_PIN, GPIO.HIGH)  # 按钮按下，点亮LED
        else:
            GPIO.output(LED_PIN, GPIO.LOW)   # 按钮松开，熄灭LED
        time.sleep(0.05)  # 50ms防抖延时
except KeyboardInterrupt:
    pass
finally:
    GPIO.cleanup()  # 清理GPIO状态，恢复默认

上述代码中，GPIO.setmode(GPIO.BCM)指定使用BCM编号方式，这是最常用的方式，因为BCM编号与SoC内部GPIO编号一致，便于查阅官方文档。GPIO.setup()函数的pull_up_down参数用于配置内部上拉或下拉电阻，可选值为GPIO.PUD_OFF（默认）、GPIO.PUD_UP（上拉）和GPIO.PUD_DOWN（下拉）。

操作流程可以归纳为以下步骤清单：

1. 确认引脚编号：查阅树莓派引脚图，确定使用的BCM编号，避免与板载功能冲突。
2. 设置模式：调用GPIO.setmode()，推荐使用BCM模式。
3. 配置引脚方向：调用GPIO.setup()，明确输入或输出，并设置初始状态或上下拉。
4. 执行读写：输出用GPIO.output()，输入用GPIO.input()。
5. 清理资源：程序结束前调用GPIO.cleanup()，释放引脚占用。

4.3 案例拆解：按钮控制LED的完整实战

下面通过一个完整的案例，展示从硬件连接到软件调试的全过程。这个案例是GPIO编程的“Hello World”，但包含了所有关键知识点。

硬件连接：使用面包板搭建电路。LED正极（长脚）串联330Ω限流电阻后连接GPIO17，LED负极（短脚）连接GND。按钮一端连接GPIO18，另一端连接3.3V电源；同时在GPIO18与GND之间连接一个10kΩ下拉电阻（如果使用内部下拉，可省略外部电阻，但为了教学演示，这里使用外部电阻）。

初始现象：直接运行上述代码，发现按钮按下时LED能点亮，但松开后LED有时会闪烁或延迟熄灭。通过示波器观察GPIO18引脚波形，发现松开瞬间存在约20ms的电平抖动，这是机械按钮的物理特性导致的。

分析判断：机械按钮在按下和释放时，金属触点会经历多次弹跳，导致电平在短时间内反复变化。如果不做处理，程序会误判为多次按下。解决方案有两种：硬件上在按钮两端并联一个0.1μF电容进行RC滤波；软件上在检测到电平变化后延时10~20ms再读取一次确认状态。

优化后代码：

import RPi.GPIO as GPIO
import time

GPIO.setmode(GPIO.BCM)
LED_PIN = 17
BTN_PIN = 18
GPIO.setup(LED_PIN, GPIO.OUT, initial=GPIO.LOW)
GPIO.setup(BTN_PIN, GPIO.IN, pull_up_down=GPIO.PUD_DOWN)

def read_button_debounced():
    """带软件防抖的按钮读取函数"""
    if GPIO.input(BTN_PIN) == GPIO.HIGH:
        time.sleep(0.02)  # 20ms延时等待电平稳定
        if GPIO.input(BTN_PIN) == GPIO.HIGH:
            return True
    return False

try:
    while True:
        if read_button_debounced():
            GPIO.output(LED_PIN, GPIO.HIGH)
            print("按钮按下，LED点亮")
            while read_button_debounced():  # 等待按钮释放
                time.sleep(0.01)
        else:
            GPIO.output(LED_PIN, GPIO.LOW)
        time.sleep(0.01)
except KeyboardInterrupt:
    pass
finally:
    GPIO.cleanup()

结果对比：加入防抖后，LED状态切换干净利落，不再出现闪烁。通过串口打印的日志确认，每次按下只触发一次点亮操作。这个案例说明，GPIO编程不仅是简单的读写，还需要考虑硬件特性和信号完整性。

4.4 常见误区与总结复盘

在GPIO编程中，初学者常犯的错误集中在引脚编号混淆、电平逻辑理解偏差和电阻使用不当三个方面。下面通过对比表梳理这些误区。

误区	错误做法	正确做法	后果
引脚编号混淆	使用物理引脚号（如第11脚）直接操作	使用BCM编号或明确调用GPIO.setmode(GPIO.BOARD)	操作了错误的引脚，可能损坏外设
LED限流电阻缺失	LED直接连接GPIO和GND	串联220Ω~1kΩ限流电阻	电流过大烧毁LED或GPIO引脚
输入引脚浮空	按钮一端接GPIO，一端接3.3V，无电阻	启用内部下拉或外接10kΩ下拉电阻	读取状态随机跳变，逻辑不稳定
输出电流超限	用GPIO直接驱动继电器或电机	使用三极管或MOSFET驱动，或加光耦隔离	GPIO引脚烧毁，SoC损坏
未调用cleanup	程序退出后引脚保持占用状态	在finally块中调用GPIO.cleanup()	下次运行报错，引脚状态异常

总结本章要点：GPIO编程的核心是理解输入输出模式的电气特性，输出模式要关注驱动能力和限流，输入模式要解决浮空问题。RPi.GPIO库提供了简洁的API，但真正的工程挑战在于硬件电路设计和信号可靠性。建议读者在面包板上亲手搭建电路，用万用表测量各点电压，观察按钮按下时电平的变化，这样能建立更直观的硬件直觉。