2、GPIO基础：引脚定义、输入输出模式、上拉下拉电阻、电平逻辑、Python控制GPIO的常用库
GPIO（General Purpose Input/Output，通用输入输出）是嵌入式系统与外部世界交互的最基本通道。在树莓派、Jetson Nano、香橙派等单板计算机上，GPIO引脚允许开发者通过软件直接控制硬件电平，从而实现LED闪烁、按键检测、传感器读取、继电器控制等操作。本章将系统讲解GPIO的引脚定义规则、输入输出模式的工作原理、上拉下拉电阻的作用机制、电平逻辑的判定标准，以及Python中两个最主流的GPIO控制库——RPi.GPIO与gpiozero——的用法与选型建议。理解这些基础概念，是后续实现UART串口通信与自动化设备控制的前提。
上图展示了GPIO知识体系的整体架构。从主控芯片的GPIO控制器出发，左侧四个模块（引脚定义、输入输出模式、上拉下拉电阻、电平逻辑）构成了硬件基础层，右侧的Python库与应用场景则属于软件控制层。理解这些模块之间的关联，是掌握GPIO编程的关键。
2.1 核心原理：GPIO引脚定义与电气特性
GPIO引脚是芯片上可配置为输入或输出的通用引脚。在树莓派40针排针中，并非所有引脚都是GPIO——其中包含电源引脚（3.3V、5V）、地线引脚（GND）以及专用的I2C、SPI、UART复用引脚。开发者必须清楚区分物理引脚编号与逻辑编号。
| 编号体系 | 说明 | 示例 |
|---|---|---|
| 物理引脚（Board） | 按排针实际位置编号，从1到40 | 物理引脚11 |
| BCM编号（Broadcom） | 按芯片内部GPIO编号，与物理位置无关 | BCM17 |
| WiringPi编号 | 早期WiringPi库使用的编号，现已较少使用 | WiringPi 0 |
在电气特性方面，树莓派GPIO采用3.3V逻辑电平，即高电平为3.3V，低电平为0V。GPIO引脚并非5V容忍，直接输入5V信号可能损坏芯片。每个GPIO引脚的最大输出电流约为16mA，总输出电流限制在50mA以内。这些参数决定了驱动外部设备时的电路设计约束。
2.2 输入输出模式与上拉下拉电阻
GPIO引脚可配置为输入模式或输出模式。在输入模式下，引脚读取外部信号的高/低电平状态；在输出模式下，引脚主动输出高或低电平。此外，还有开漏输出模式，此时引脚只能主动拉低，高电平需依靠外部上拉电阻实现。
上拉电阻与下拉电阻的作用是确定引脚在无外部信号驱动时的默认电平。上拉电阻将引脚默认拉至高电平，下拉电阻将引脚默认拉至低电平。树莓派内部提供了可编程的上拉/下拉电阻，阻值约为50kΩ~65kΩ，可通过软件配置。
# RPi.GPIO 设置上拉电阻示例
import RPi.GPIO as GPIO
GPIO.setmode(GPIO.BCM)
GPIO.setup(17, GPIO.IN, pull_up_down=GPIO.PUD_UP) # 启用上拉
GPIO.setup(27, GPIO.IN, pull_up_down=GPIO.PUD_DOWN) # 启用下拉2.3 Python控制GPIO的常用库
Python生态中，RPi.GPIO与gpiozero是两个最常用的GPIO控制库。RPi.GPIO是底层库，直接操作寄存器，API简洁但功能相对基础；gpiozero是更高层的封装，提供了面向对象的接口，内置了LED、Button、Buzzer等常用组件的类，代码更简洁且支持更多高级特性。
| 特性 | RPi.GPIO | gpiozero |
|---|---|---|
| 抽象层级 | 底层，直接操作引脚 | 高层，面向对象 |
| LED控制 | GPIO.output(pin, GPIO.HIGH) | led = LED(17); led.on() |
| 按键检测 | 需自行实现消抖 | 内置消抖与回调 |
| PWM支持 | 支持软件PWM | 支持硬件PWM与软件PWM |
| 适用场景 | 需要精细控制或学习原理 | 快速开发、原型验证 |
# gpiozero 控制LED闪烁示例
from gpiozero import LED
from time import sleep
led = LED(17) # BCM 17
while True:
led.on()
sleep(0.5)
led.off()
sleep(0.5)2.4 实战案例：按键控制LED与状态监控
下面通过一个综合案例，演示如何使用gpiozero库实现按键控制LED，并监控GPIO状态。该案例模拟了工业设备中的启动/停止按钮逻辑。
from gpiozero import LED, Button
from datetime import datetime
import signal
# 初始化硬件
led = LED(17) # BCM 17 接LED
start_btn = Button(27, pull_up=True) # BCM 27 接启动按钮
stop_btn = Button(22, pull_up=True) # BCM 22 接停止按钮
def on_start():
led.on()
print(f"[{datetime.now()}] 启动按钮按下，LED点亮")
def on_stop():
led.off()
print(f"[{datetime.now()}] 停止按钮按下，LED熄灭")
# 绑定事件回调
start_btn.when_pressed = on_start
stop_btn.when_pressed = on_stop
print("系统运行中，按 Ctrl+C 退出")
signal.pause() # 保持程序运行该案例中，gpiozero库自动处理了按键消抖和事件回调，开发者无需关心底层电平变化细节。若使用RPi.GPIO实现相同功能，则需要手动检测电平变化并添加延时消抖，代码量会增加约3倍。
2.5 常见误区与总结复盘
在GPIO编程中，初学者常犯以下错误：
- 混淆编号体系：使用物理引脚编号却调用BCM模式，导致操作错误引脚。解决方法是统一使用一种编号体系，并在代码开头明确注释。
- 忽略电平兼容性：将5V传感器输出直接接入3.3V GPIO，可能损坏引脚。应使用电平转换电路。
- 忘记设置上拉/下拉：输入引脚悬空时电平不确定，导致按键误触发。应始终配置上拉或下拉电阻。
- 未释放GPIO资源：程序异常退出后，GPIO引脚仍保持最后状态。应在程序结尾调用GPIO.cleanup()（RPi.GPIO）或使用gpiozero的自动清理机制。